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

JavaScript / コードを試す

TypeError: Assignment to constant variable.

const で宣言した変数に代入し直すと出ます。const が固定するのは「値」ではなく「結びつき」で、配列やオブジェクトの中身は変えられます。その線引きと直し方を実行して確かめます。

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

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

const で宣言した変数に、もう一度代入したときに出ます。

javascript失敗・注意の例

const count = 1;

count = 2;
固定例の期待出力 · Node 24.22.3
TypeError: Assignment to constant variable.
表示用コードUTF-8 · LF

直し方は2つです。入れ直すなら let、入れ直さないなら中身を変えます。

example.js

let count = 1;

count = 2;

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

const が固定しているもの

const が固定するのは名前と値の結びつきで、値そのものではありません。

配列やオブジェクトなら、中身は変えられます。

example.js

const list = [1, 2];
const config = { retry: 1 };

list.push(3);
config.retry = 5;

console.log(list);
console.log(config);
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3 ]
{ retry: 5 }
表示用コードUTF-8 · LF

エラーになりません。 list が指している配列は同じままで、その中身を変えただけだからです。

一方、丸ごと別のものに差し替えると落ちます。

javascript失敗・注意の例

const list = [1, 2];

list = [3];
固定例の期待出力 · Node 24.22.3
TypeError: Assignment to constant variable.
表示用コードUTF-8 · LF
やること const で
x = 別の値 エラー
x.prop = 値 できる
x.push(値) できる
x[0] = 値 できる

中身も変えたくないなら

Object.freeze() で凍結します。

example.js

const config = Object.freeze({ retry: 1 });

config.retry = 5;

console.log(config);
console.log(Object.isFrozen(config));
固定例の期待出力 · Node 24.22.3
{ retry: 1 }
true
表示用コードUTF-8 · LF

代入は無視されただけで、エラーは出ていません。 気づかないまま「設定が反映されない」ことになります。

'use strict' の中なら、はっきり落ちます。

example.js

'use strict';

const config = Object.freeze({ retry: 1 });

try {
  config.retry = 5;
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
TypeError: Cannot assign to read only property 'retry' of object '#<Object>'
表示用コードUTF-8 · LF

文言が違うことに注意してください。 こちらは Assignment to constant variable. ではありません。

import / export のあるファイル(モジュール)は、書かなくても strict モードです。 実務では落ちるほうが普通だと思ってください。

Object.freeze() が固めるのは1段だけです。中の入れ子は凍りません。

原因: for の書き方

javascript失敗・注意の例

for (const i = 0; i < 2; i++) {
  console.log(i);
}
固定例の期待出力 · Node 24.22.3
0
TypeError: Assignment to constant variable.
表示用コードUTF-8 · LF

1回だけ回って落ちます。 i++ が代入だからです。

for...of なら const で書けます。繰り返しごとに新しく作られるので、代入になりません。

example.js

for (const n of [1, 2]) {
  console.log(n);
}
固定例の期待出力 · Node 24.22.3
1
2
表示用コードUTF-8 · LF
書き方 const
for (let i = 0; ...) 使えない。let を使う
for (const x of ...) 使える
for (const k in ...) 使える

原因: あとで入れるつもりだった

javascript失敗・注意の例

const result = null;

if (true) {
  result = '見つかった';
}
固定例の期待出力 · Node 24.22.3
TypeError: Assignment to constant variable.
表示用コードUTF-8 · LF

あとから入れるなら let です。 ただ、多くの場合は書き換えずに済みます。

example.js

const result = true ? '見つかった' : null;

console.log(result);
固定例の期待出力 · Node 24.22.3
見つかった
表示用コードUTF-8 · LF

入れ直さない形に書けるなら、そのほうが安全です。 どこで値が変わったか探さなくて済みます。

似ているエラーとの違い

文言 いつ出るか
Assignment to constant variable. const の変数に代入した
Cannot assign to read only property 'x' of ... 凍結したオブジェクトの中身に代入した(strict)
Cannot access 'x' before initialization 宣言より前で使った → 別ページ
x is not defined そもそも宣言していない

実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。自分の環境で出た文言で検索してください。

探しかたの順序

  1. エラーの行で代入している変数名を見る
  2. その変数の宣言を探す。const になっているはず
  3. 入れ直す必要が本当にあるか考える
    • ある → let にする
    • ない → 中身を変えるか、三項演算子で1回で決める

まとめ

  • const が固定するのは結びつき。値の中身ではない
  • 配列やオブジェクトの中身は変えられる
  • 中身も守るなら Object.freeze()。ただし黙って無視される(strict なら例外)
  • for (const i = 0; ...) は書けない。for...of なら書ける
  • 入れ直さない形にできるなら、そのほうがよい

const にした配列やオブジェクトの中身を、元に影響させずに変えたいときは、複製のしかたを知っておくと早く済みます。 → オブジェクトを結合する

出典

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