JavaScript / コードを試す
TypeError: x is not a function
関数でないものを呼んだときに出ます。綴り違い、配列でない値、this の外れ、読み込み方の食い違いなど、原因ごとに確認の手順と修正例を載せています。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
() を付けて呼んだものが、関数ではなかったときに出ます。
const user = { name: 'あかり' };
console.log(user.getName());TypeError: user.getName is not a function
プロパティは読めています。user.getName は undefined で、
それを呼ぼうとして落ちました。
Cannot read properties of undefined
とは止まる場所が違います。あちらは1つ手前が undefined のときです。
const user = { name: 'あかり' }; console.log(user.getName); console.log(typeof user.getName);
undefined undefined
まず typeof で確かめます。値の型は原因を絞る手掛かりですが、それだけで読み込みや上書きのどちらかを確定できるわけではありません。
原因1: 名前が違う
大文字・小文字、単数・複数、綴りを確認します。エラー文に呼び出した式が含まれる場合は、それが手掛かりです。
const nums = [3, 1, 2];
console.log(nums.lenght);
console.log(nums.foreach(n => n));undefined TypeError: nums.foreach is not a function
length を lenght、forEach を foreach と書いています。
| よくある間違い | 正しい名前 |
|---|---|
foreach |
forEach |
toLowercase |
toLowerCase |
lenght |
length |
push() を文字列に |
文字列に push は無い |
正しい名前で呼びます。配列を変換したい場合は forEach() の代わりに map() を選びます。
const nums = [3, 1, 2]; console.log(nums.length); nums.forEach(n => console.log(n));
3 3 1 2
原因2: そのものに、その関数が無い
型が違えば持っているものも違います。
const text = 'あいうえお';
console.log(text.push('か'));TypeError: text.push is not a function
文字列には配列用の push() メソッドがありません。文字列は変更できない値なので、+ や concat() で別の文字列を作ります。
const text = 'あいうえお'; console.log(text + 'か'); console.log(text.concat('か')); console.log(text);
あいうえおか あいうえおか あいうえお
似た形で間違えやすいものを並べます。
console.log(typeof [].map); console.log(typeof ''.map); console.log(typeof ({}).map); console.log(typeof document);
function undefined undefined undefined
通常のオブジェクトや文字列には .map() がありません。一方、map() 自体は call() で配列に似た値へ適用できます。配列以外には一切使えないわけではありません。
document は Node のこの実行環境やブラウザーの Worker にはありません。通常のブラウザー画面では利用できます。
配列のつもりが配列でない
値だけを変換するなら Object.values()、鍵も必要なら Object.entries() で配列にします。
配列を受け取る契約なら、渡す側の入力を直す必要があります。
const scores = { math: 80, english: 95 };
console.log(scores.map(v => v * 2));TypeError: scores.map is not a function
const scores = { math: 80, english: 95 }; console.log(Object.keys(scores)); console.log(Object.values(scores).map(v => v * 2)); console.log(Object.entries(scores).map(([k, v]) => `${k}:${v}`));
[ 'math', 'english' ] [ 160, 190 ] [ 'math:80', 'english:95' ]
原因3: 同じ名前で上書きした
変数や引数が、関数と同じ名前になっていることがあります。
function calc(sum) {
return sum();
}
console.log(calc(10));TypeError: sum is not a function
sum は引数で受け取った 10 です。関数ではありません。
関数を受け取る設計なら、関数を渡します。数値を使う設計なら、sum() と呼ばず数値として処理します。
function calc(sum) { return sum(); } console.log(calc(() => 10));
10
同じことは、あとから代入した場合にも起きます。
let handler = () => 'ok';
handler = 'ok';
console.log(handler());TypeError: handler is not a function
呼び出す設計なら、変数には関数を保持します。
const handler = () => 'ok'; console.log(handler());
ok
原因4: this が外れている
メソッドを関数として取り出すと、this が付いてきません。
class Counter {
constructor() {
this.n = 0;
}
add() {
this.n += 1;
return this.n;
}
}
const c = new Counter();
const add = c.add;
console.log(add());TypeError: Cannot read properties of undefined (reading 'n')
この例はプロパティ読取時点の別エラーです。this を伴う呼び出しでは、どの値を読む段階で止まったかも確認します。
const obj = {
items: [1, 2],
show() {
return this.items.join(',');
},
};
const show = obj.show;
console.log(show());TypeError: Cannot read properties of undefined (reading 'join')
読んでいるものが items ではなくjoinになっています。ここに違いが出ます。
| 書いた場所 | 外れたときの this |
落ちる場所 |
|---|---|---|
class の中 |
undefined(クラスは常に strict) |
this.n の時点 |
| オブジェクトリテラルのメソッド(strict でない) | globalThis |
this.items は undefined になり、その .join |
上のクラスの例が reading 'n' で、こちらが reading 'join' なのはこのためです。
モジュール(import / export のファイル)は常に strictなので、
実際のコードではクラスと同じく this が undefined になります。
このページの実行環境は strict ではないため、globalThis のほうの結果が出ています。
直しかた
呼び出しごと渡すか、bind() で結びつけます。
const obj = { items: [1, 2], show() { return this.items.join(','); }, }; console.log(obj.show()); const bound = obj.show.bind(obj); console.log(bound()); const wrapped = () => obj.show(); console.log(wrapped());
1,2 1,2 1,2
原因5: 読み込み方が食い違っている
名前付きexportの format は import { format } from './utils.js'、default exportは import format from './utils.js' のように対応させます。
ただし、取り違えが必ずこのTypeErrorになるわけではありません。
| 状況 | 確認すること |
|---|---|
| 名前付きexportしかないES Moduleからdefaultをimportした | 対応するexportがなく、本文実行前に SyntaxError となる場合がある |
| namespaceを関数として呼んだ | import * as utils の utils は関数そのものではない。公開されている関数を選ぶ |
| CommonJSとES Modulesを混ぜた | Nodeの版と相互運用規則。defaultが指す値と、利用できる名前付きexportを確認する |
| scriptの実行順が想定と違う | 読み込み完了前に使っていないか、async / defer と依存関係を確認する |
このページの実行欄は複数ファイルのモジュール読込には対応していません。実際のモジュール環境で、書き出し側の形式と受け取った値を確認します。
値が undefined や {} というだけでは、読み込み側・書き出し側のどちらが誤りかは確定できません。
括弧を余分に付けていないか
関数が返した値を、もう一度呼んでしまう間違いです。
function greet() {
return 'こんにちは';
}
console.log(greet()());TypeError: greet(...) is not a function
この実行環境では greet(...) is not a function になります。
(...) が付いていたら、呼んだ結果を呼んでいるという合図です。
文字列を返す上の greet なら、呼び出しを一度にします。
function greet() { return 'こんにちは'; } console.log(greet());
こんにちは
関数を返す関数なら、二度の呼び出しは正しい書き方です。
function greeter(name) { return () => `こんにちは、${name}`; } console.log(greeter('あかり')());
こんにちは、あかり
処理系によって文言が違う
| 処理系 | 文言の例(公式資料に基づく表記) |
|---|---|
| V8 / Firefox / Safari | TypeError: x is not a function |
呼び出した式・エンジン・版で文言は変わります。全文字列だけで同じ原因と断定しないでください。
このページの実行例は、記事冒頭に示したNodeの版で確認しています。上の表は各ブラウザーで今回発生させた実測ではありません。
スタックトレースで見る位置
エラー名とメッセージに続く、自分のコードを指す最初の位置を手掛かりにします。
at 関数名 (ファイル:行:列) や 関数名@ファイル:行:列 など形式には差があります。
その呼び出しの直前の値を調べ、必要なら呼び出し元へさかのぼります。ライブラリ内の行も原因に関係する場合があるため、一律に無視はしません。
探しかたの順序
- エラー文とスタックを見る。呼び出した式が文言にあれば手掛かりにする
- 呼ぶ直前で
typeofを出す。undefinedなら値の欠落など、objectなら関数以外の値を調べる undefinedだったら … 綴り違い(原因1)/型が違う(原因2)/読み込み(原因5)objectや数値だったら … 入力の型や、同じ名前での上書き(原因3)を調べる- 呼んだ結果をさらに呼んでいないか、戻り値と括弧を確認する
const user = { name: 'あかり' }; console.log(typeof user.getName); console.log(typeof user.name); console.log(Object.keys(user));
undefined string [ 'name' ]
Object.keys() で実際に何を持っているかを並べると、綴り違いはすぐ見つかります。
ほかのエラー
- SyntaxError: Unexpected token … 構文として読めず、そのスクリプトの本体は実行されない
- RangeError: Maximum call stack size exceeded … 呼び出しが深すぎる。終了条件のない再帰や、終了までの呼び出しが深すぎる場合など
- Cannot read properties of undefined
… 1つ手前が
undefinedだった