TypeError
別名: is not a function / Cannot read properties of undefined
TypeError は、値の型や状態がその操作に合わないときに投げられる例外である。
JavaScript では関数でない値の呼び出しや undefined のプロパティ読み取りで、Python では型の合わない演算で発生する。
公開:
定義
TypeError は、操作の書き方は正しいのに、対象の値がその操作に合わないときに投げられる例外である。
JavaScript では、関数でない値を呼んだときや、undefined や null のプロパティを読んだときに出る。
Python にも同じ名前の組み込み例外があり、型の合わない値に演算や関数を適用すると発生する。
詳細
JavaScript でよく見るメッセージは x is not a function と Cannot read properties of undefined の 2 つである。
どちらも、値が想定と違う型だったことを示している。
ライブラリの更新でメソッドが消えた場合は、呼び出した時点で undefined を関数として扱うので TypeError になる。
strict モードでは、getter しか無いプロパティへの代入も TypeError になる。
Python では "a" + 1 のように文字列と整数を + でつなぐと、TypeError で止まる。
メッセージの一覧は MDN(新しいタブで開く) にまとまっている。
よくある誤解
TypeError は、TypeScript の型エラーとは別のものである。
TypeScript の型エラーはコンパイル時に tsc が報告し、TypeError は実行時に JavaScript エンジンが投げる。
型検査を通ったコードでも、外部から届いた値や any を経由した値で TypeError は起きる。
名前そのものが見つからない場合は ReferenceError になる。
関連
Express 5 で消えたメソッドを呼んだ例は Express 5「req.param is not a function」の原因と直し方 にある。
Python の例は Python で「TypeError: can only concatenate str (not "int") to str」が直らない を参照する。
値が無いことを表す undefined も合わせて読むと、原因の切り分けが早くなる。