TypeScriptのEventTargetにvalueがないエラーの直し方

​​TypeScript​JavaScript,React,トラブルシュート

TypeScript のエラー「Property 'value' does not exist on type 'EventTarget'.」は、イベントの e.target から value を読もうとしたときに出ます。e.target の型が、どの要素か分からない EventTarget になっているためです。addEventListener なら instanceof HTMLInputElement で確かめ、React なら e.currentTarget.value を読むか onChange を使うと、エラーは消えます。

フォームの入力欄に打った文字を、addEventListener で受け取る input イベントや、React の onInput で読む場面で出るエラーです。私は検証環境で tsc と、エディターが使う言語サーバーの両方でこのエラーを起こし、メッセージの全文と、直すと消えることを確かめました。直したコードはブラウザで動かし、入力した文字を読めることも確かめています。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4 です。TypeScript 7.0.2、React 19.3.1、@types/react 19.3.0 を使い、比べるために TypeScript 5.9.3 と 6.0.3 でも同じファイルを tsc にかけました。エディターの表示は、VS Code などのエディター本体ではなく、TypeScript 7 の tsc が持つ言語サーバー(tsc --lsp --stdio)を直接動かして確かめました。ブラウザは Playwright から動かした Chromium 153 です。VS Code の画面での見え方、Vue などほかのフレームワークで出る場合は試していません。

エラーの全文

検証環境で、空のフォルダーに TypeScript 7.0.2 を入れ、npx tsc --init で tsconfig.json を作りました。できた tsconfig.json には "strict": true が入っていました。lib の指定はなく、ブラウザの DOM の型はそのまま使えます。

src/dom-input.ts に、id が name の入力欄に input イベントのリスナーを付け、打った文字を表示するコードを書きました。

ts
const input = document.querySelector<HTMLInputElement>("#name");

input?.addEventListener("input", (e) => {
  console.log(e.target.value);
});

npx tsc --noEmit を実行すると、このファイルについて次の2行が出ました(終了コードは1)。src には、このあとで出てくるほかのファイルも置いていたので、ここではこのファイルの分だけを載せます。

text
src/dom-input.ts(4,15): error TS18047: 'e.target' is possibly 'null'.
src/dom-input.ts(4,24): error TS2339: Property 'value' does not exist on type 'EventTarget'.

--pretty を付けると、どこが問題なのかが波線で示されます(色を付けるための制御文字は消し、ほかのファイルの分と最後の集計は省いています)。

text
src/dom-input.ts:4:15 - error TS18047: 'e.target' is possibly 'null'.

4   console.log(e.target.value);
                ~~~~~~~~

src/dom-input.ts:4:24 - error TS2339: Property 'value' does not exist on type 'EventTarget'.

4   console.log(e.target.value);
                         ~~~~~

エラーは2つです。1つ目の TS18047 は「e.target は null かもしれない」という意味です。2つ目の TS2339 が、このお題のエラーで、「EventTarget 型には value というプロパティがない」という意味です。波線は value に引かれています。

e.target?.value のように ?. を付けると、TS18047 は消えますが、TS2339 は残りました。

text
src/dom-input-chain.ts(4,25): error TS2339: Property 'value' does not exist on type 'EventTarget'.

エディターでも同じエラーが出る

言語サーバーは、エディターに診断(エラーの位置とメッセージ)を返す仕組みです(Language Server Protocol の仕様の、診断の説明(英語))。TypeScript 7 の tsc は、この言語サーバーとしても動きます(TypeScript 7 の移植作業のリポジトリの説明(英語))。TypeScript 7.0.2 の言語サーバーを tsc --lsp --stdio で起動し、エディターと同じ手順で src/dom-input.ts を開かせると、次の診断が返ってきました。返ってきた JSON を、私が書いた小さなスクリプトで1件1行に整えて表示しています(ホバーの行は省いています)。

text
server: typescript-go 7.0.2
diagnostics (2):
  4:15-4:23 severity=1 source=ts code=18047 'e.target' is possibly 'null'.
  4:24-4:29 severity=1 source=ts code=2339 Property 'value' does not exist on type 'EventTarget'.

4:24-4:29 は、4行目の24文字目から、29文字目の手前までで、tsc --pretty の value の波線と同じ範囲です。severity=1 は LSP の仕様でエラーを表す値で、code=2339 は TS2339 のことです。メッセージの文面も tsc と同じでした。

e.target が EventTarget 型になっている理由

言語サーバーで e.target の target にカーソルを合わせると、ホバーには (property) Event.target: EventTarget | null と出ました。TypeScript が持っている DOM の型では、Event の target は EventTarget | null です。リスナーを入力欄に付けていても、HTMLInputElement にはなりません。

target は、イベントが起きた要素そのものを指します(MDN の Event.target の説明(英語))。イベントは子の要素から親の要素へ伝わる(バブリングする)ので、リスナーを付けた要素と target は同じとは限りません。リスナーを付けた要素は、currentTarget が指します(MDN の Event.currentTarget の説明(英語))。どの要素で起きたイベントか、TypeScript には分からないので、value を持つとは言えない EventTarget 型になっています。

このエラーは型の上だけの問題です。直す前の src/dom-input.ts を、型チェックをせずに(esbuild で型の注釈だけを取り除いて)ブラウザで動かし、入力欄に「neko」と打つと、コンソールには次のように表示されました。

text
n
ne
nek
neko

実行すれば値は読めるのに、TypeScript からは e.target が入力欄だと分からない、という状況です。

addEventListener で直す3つの方法

リスナーを付けた変数をそのまま使う

リスナーを付けた入力欄が変数にあるなら、e.target を通さずに、その変数から value を読むのがいちばん簡単です。

ts
const input = document.querySelector<HTMLInputElement>("#name");

input?.addEventListener("input", () => {
  console.log("closure:", input.value);
});

querySelector の結果の型は HTMLInputElement | null ですが、ホバーで見ると、リスナーの中の input は const input: HTMLInputElement で、null は外れていました。

instanceof で入力欄かどうかを確かめる

1つのリスナーで、いくつもの要素のイベントを受けるとき(親の要素にリスナーを付けるときなど)は、e.target を使うしかありません。その場合は、instanceof で入力欄かどうかを確かめます。

ts
const input = document.querySelector<HTMLInputElement>("#name");

input?.addEventListener("input", (e) => {
  if (e.target instanceof HTMLInputElement) {
    console.log("instanceof:", e.target.value);
  }
});

if で確かめたあとは、TypeScript が e.target の型を絞り込みます(公式ハンドブックの、instanceof による型の絞り込みの説明(英語))。ホバーで見ると、if の行の e.target は EventTarget | null ですが、if の中の e.target は HTMLInputElement になっていました。null も instanceof で外れるので、TS18047 も一緒に消えます。

as で型を指定する

as で「これは入力欄だ」と TypeScript に伝えても、エラーは消えます。

ts
const input = document.querySelector<HTMLInputElement>("#name");

input?.addEventListener("input", (e) => {
  const target = e.target as HTMLInputElement;
  console.log("as:", target.value);
});
注意

as は型を指定するだけで、実行時には何も確かめません(公式ハンドブックの、型アサーションの説明(英語))。e.target が入力欄でなかったとしても、TypeScript はエラーを出しません。どの要素で起きたイベントか分からない場面では、instanceof で確かめるほうを選んでください。

React では onChange と onInput で出るかどうかが違う

React でも同じエラーが出ます。ただし、出るかどうかはイベントの種類で変わりました。次のように、onChange と onInput に同じ書き方の関数を渡してみました。

tsx
import { useState } from "react";

export function InlineFields() {
  const [name, setName] = useState("");

  return (
    <>
      <input value={name} onChange={(e) => setName(e.target.value)} />
      <input value={name} onInput={(e) => setName(e.target.value)} />
    </>
  );
}

tsc のエラーは、onInput の9行目の1つだけでした。

text
src/react-inline.tsx(9,60): error TS2339: Property 'value' does not exist on type 'EventTarget'.

ホバーで見ると、onChange の e は React.ChangeEvent<HTMLInputElement, HTMLInputElement>、onInput の e は React.InputEvent<HTMLInputElement> でした。

React の型(@types/react 19.3.0)では、イベントの型のもとになる SyntheticEvent の target は EventTarget で、currentTarget は EventTarget & HTMLInputElement のように、リスナーを付けた要素の型です。InputEvent はこのとおりですが、ChangeEvent は target も要素の型にしてあります。型定義のコメントによると、change イベントを出すフォームの要素は入れ子にならないので、target が <input> だと分かるからです。React の公式リファレンスにある、入力欄の値を state で管理する例でも、onChange={e => setFirstName(e.target.value)} と書いています(<input> のリファレンスの、state で入力欄を管理する例(英語))。

onInput のように ChangeEvent 以外のイベントで値を読むときは、e.currentTarget.value を使います。次のように、関数を別に書いて型を付けた場合も同じです。

tsx
import { useState, type InputEvent } from "react";

export function NameField() {
  const [name, setName] = useState("");

  const handleInput = (e: InputEvent<HTMLInputElement>) => {
    setName(e.currentTarget.value);
  };

  return (
    <>
      <input id="react-name" value={name} onInput={handleInput} />
      <p id="react-out">{name}</p>
    </>
  );
}

handleInput の中を e.target.value にしたファイルでは、src/react-input.tsx(7,22): error TS2339: Property 'value' does not exist on type 'EventTarget'. が出ました。直したファイルの e.currentTarget にカーソルを合わせると、型は EventTarget & HTMLInputElement でした。React の公式リファレンスでも、currentTarget は「ハンドラーを付けた要素」、target は「イベントが起きた要素(離れた子の要素かもしれない)」と説明されています(React のイベントオブジェクトの説明(英語))。

onChange 用に関数を別に書くときは、ChangeEvent<HTMLInputElement> を型に付ければ、e.target.value のままでエラーは出ませんでした。

tsx
const handleChange = (e: ChangeEvent<HTMLInputElement>) => {
  setName(e.target.value);
};

FormEvent<HTMLInputElement> を付けた場合も、e.target.value は同じ TS2339 になりました。さらに言語サーバーは、FormEvent に 'FormEvent' is deprecated. という診断(severity=4。LSP の仕様ではエラーではなくヒント)を返しました。@types/react 19.3.0 の型定義には、FormEvent は実在しないイベントで、ChangeEvent・InputEvent・SubmitEvent などを使うように、と書かれています。

直したらエラーが消えたこと

ここまでの直したファイル(変数をそのまま使う、instanceof、as、React の currentTarget、ChangeEvent)だけを src に置いて npx tsc --noEmit を実行すると、何も表示されずに終了コード 0 で終わりました。言語サーバーに開かせても、どのファイルも diagnostics (0): で、エラーは返ってきませんでした。

直したコードをまとめてブラウザで動かし、それぞれの入力欄に「neko」と打ちました。addEventListener の3つの書き方は、1文字打つごとに打った文字を表示しました(最後の1回分だけを載せます)。React の2つの部品も、入力欄の下の段落に「neko」と表示しました。下の react-out: と react-out2: の行は、その段落の文字を、検証用のスクリプトが読み出して表示したものです。

text
closure: neko
instanceof: neko
as: neko
react-out: neko
react-out2: neko

TypeScript 5.9.3 と 6.0.3 でも、直す前のファイルで同じ番号と文面のエラーが出ました。tsc の終了コードは、5.9.3 と 6.0.3 では 2、7.0.2 では 1 でした。

​Posted by 86