本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

TypeError: x is not a function

関数でないものを呼んだときに出ます。綴り違い、配列でない値、this の外れ、読み込み方の食い違いなど、原因ごとに確認の手順と修正例を載せています。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

() を付けて呼んだものが、関数ではなかったときに出ます。

javascript失敗・注意の例

const user = { name: 'あかり' };

console.log(user.getName());
固定例の期待出力 · Node 24.22.3
TypeError: user.getName is not a function
表示用コードUTF-8 · LF

プロパティは読めています。user.getName は undefined で、 それを呼ぼうとして落ちました。

Cannot read properties of undefined とは止まる場所が違います。あちらは1つ手前が undefined のときです。

example.js

const user = { name: 'あかり' };

console.log(user.getName);
console.log(typeof user.getName);
固定例の期待出力 · Node 24.22.3
undefined
undefined
表示用コードUTF-8 · LF

まず typeof で確かめます。値の型は原因を絞る手掛かりですが、それだけで読み込みや上書きのどちらかを確定できるわけではありません。

原因1: 名前が違う

大文字・小文字、単数・複数、綴りを確認します。エラー文に呼び出した式が含まれる場合は、それが手掛かりです。

javascript失敗・注意の例

const nums = [3, 1, 2];

console.log(nums.lenght);
console.log(nums.foreach(n => n));
固定例の期待出力 · Node 24.22.3
undefined
TypeError: nums.foreach is not a function
表示用コードUTF-8 · LF

length を lenght、forEach を foreach と書いています。

よくある間違い 正しい名前
foreach forEach
toLowercase toLowerCase
lenght length
push() を文字列に 文字列に push は無い

正しい名前で呼びます。配列を変換したい場合は forEach() の代わりに map() を選びます。

example.js

const nums = [3, 1, 2];

console.log(nums.length);
nums.forEach(n => console.log(n));
固定例の期待出力 · Node 24.22.3
3
3
1
2
表示用コードUTF-8 · LF

原因2: そのものに、その関数が無い

型が違えば持っているものも違います。

javascript失敗・注意の例

const text = 'あいうえお';

console.log(text.push('か'));
固定例の期待出力 · Node 24.22.3
TypeError: text.push is not a function
表示用コードUTF-8 · LF

文字列には配列用の push() メソッドがありません。文字列は変更できない値なので、+ や concat() で別の文字列を作ります。

example.js

const text = 'あいうえお';

console.log(text + 'か');
console.log(text.concat('か'));
console.log(text);
固定例の期待出力 · Node 24.22.3
あいうえおか
あいうえおか
あいうえお
表示用コードUTF-8 · LF

似た形で間違えやすいものを並べます。

example.js

console.log(typeof [].map);
console.log(typeof ''.map);
console.log(typeof ({}).map);
console.log(typeof document);
固定例の期待出力 · Node 24.22.3
function
undefined
undefined
undefined
表示用コードUTF-8 · LF

通常のオブジェクトや文字列には .map() がありません。一方、map() 自体は call() で配列に似た値へ適用できます。配列以外には一切使えないわけではありません。 document は Node のこの実行環境やブラウザーの Worker にはありません。通常のブラウザー画面では利用できます。

配列のつもりが配列でない

値だけを変換するなら Object.values()、鍵も必要なら Object.entries() で配列にします。 配列を受け取る契約なら、渡す側の入力を直す必要があります。

javascript失敗・注意の例

const scores = { math: 80, english: 95 };

console.log(scores.map(v => v * 2));
固定例の期待出力 · Node 24.22.3
TypeError: scores.map is not a function
表示用コードUTF-8 · LF
example.js

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}`));
固定例の期待出力 · Node 24.22.3
[ 'math', 'english' ]
[ 160, 190 ]
[ 'math:80', 'english:95' ]
表示用コードUTF-8 · LF

原因3: 同じ名前で上書きした

変数や引数が、関数と同じ名前になっていることがあります。

javascript失敗・注意の例

function calc(sum) {
  return sum();
}

console.log(calc(10));
固定例の期待出力 · Node 24.22.3
TypeError: sum is not a function
表示用コードUTF-8 · LF

sum は引数で受け取った 10 です。関数ではありません。 関数を受け取る設計なら、関数を渡します。数値を使う設計なら、sum() と呼ばず数値として処理します。

example.js

function calc(sum) {
  return sum();
}

console.log(calc(() => 10));
固定例の期待出力 · Node 24.22.3
10
表示用コードUTF-8 · LF

同じことは、あとから代入した場合にも起きます。

javascript失敗・注意の例

let handler = () => 'ok';

handler = 'ok';

console.log(handler());
固定例の期待出力 · Node 24.22.3
TypeError: handler is not a function
表示用コードUTF-8 · LF

呼び出す設計なら、変数には関数を保持します。

example.js

const handler = () => 'ok';

console.log(handler());
固定例の期待出力 · Node 24.22.3
ok
表示用コードUTF-8 · LF

原因4: this が外れている

メソッドを関数として取り出すと、this が付いてきません。

javascript失敗・注意の例

class Counter {
  constructor() {
    this.n = 0;
  }
  add() {
    this.n += 1;
    return this.n;
  }
}

const c = new Counter();
const add = c.add;

console.log(add());
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'n')
表示用コードUTF-8 · LF

この例はプロパティ読取時点の別エラーです。this を伴う呼び出しでは、どの値を読む段階で止まったかも確認します。

javascript失敗・注意の例

const obj = {
  items: [1, 2],
  show() {
    return this.items.join(',');
  },
};

const show = obj.show;

console.log(show());
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'join')
表示用コードUTF-8 · LF

読んでいるものが 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() で結びつけます。

example.js

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());
固定例の期待出力 · Node 24.22.3
1,2
1,2
1,2
表示用コードUTF-8 · LF

原因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 や {} というだけでは、読み込み側・書き出し側のどちらが誤りかは確定できません。

括弧を余分に付けていないか

関数が返した値を、もう一度呼んでしまう間違いです。

javascript失敗・注意の例

function greet() {
  return 'こんにちは';
}

console.log(greet()());
固定例の期待出力 · Node 24.22.3
TypeError: greet(...) is not a function
表示用コードUTF-8 · LF

この実行環境では greet(...) is not a function になります。 (...) が付いていたら、呼んだ結果を呼んでいるという合図です。

文字列を返す上の greet なら、呼び出しを一度にします。

example.js

function greet() {
  return 'こんにちは';
}

console.log(greet());
固定例の期待出力 · Node 24.22.3
こんにちは
表示用コードUTF-8 · LF

関数を返す関数なら、二度の呼び出しは正しい書き方です。

example.js

function greeter(name) {
  return () => `こんにちは、${name}`;
}

console.log(greeter('あかり')());
固定例の期待出力 · Node 24.22.3
こんにちは、あかり
表示用コードUTF-8 · LF

処理系によって文言が違う

処理系 文言の例(公式資料に基づく表記)
V8 / Firefox / Safari TypeError: x is not a function

呼び出した式・エンジン・版で文言は変わります。全文字列だけで同じ原因と断定しないでください。

このページの実行例は、記事冒頭に示したNodeの版で確認しています。上の表は各ブラウザーで今回発生させた実測ではありません。

スタックトレースで見る位置

エラー名とメッセージに続く、自分のコードを指す最初の位置を手掛かりにします。 at 関数名 (ファイル:行:列) や 関数名@ファイル:行:列 など形式には差があります。 その呼び出しの直前の値を調べ、必要なら呼び出し元へさかのぼります。ライブラリ内の行も原因に関係する場合があるため、一律に無視はしません。

探しかたの順序

  1. エラー文とスタックを見る。呼び出した式が文言にあれば手掛かりにする
  2. 呼ぶ直前で typeof を出す。undefined なら値の欠落など、object なら関数以外の値を調べる
  3. undefined だったら … 綴り違い(原因1)/型が違う(原因2)/読み込み(原因5)
  4. object や数値だったら … 入力の型や、同じ名前での上書き(原因3)を調べる
  5. 呼んだ結果をさらに呼んでいないか、戻り値と括弧を確認する
example.js

const user = { name: 'あかり' };

console.log(typeof user.getName);
console.log(typeof user.name);
console.log(Object.keys(user));
固定例の期待出力 · Node 24.22.3
undefined
string
[ 'name' ]
表示用コードUTF-8 · LF

Object.keys() で実際に何を持っているかを並べると、綴り違いはすぐ見つかります。

ほかのエラー

出典

この教材の原文(Markdown・別タブ)