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

JavaScript / コードを試す

RangeError: Invalid array length

new Array() や length への代入に、負の数・小数・NaN・大きすぎる数を渡すと出ます。許される範囲、new Array(3) と Array.of(3) の違い、計算結果が NaN になる経路まで確かめます。

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

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

配列の長さになれない数を渡すと出ます。

javascript失敗・注意の例

new Array(-1);
固定例の期待出力 · Node 24.22.3
RangeError: Invalid array length
表示用コードUTF-8 · LF

長さは0以上、2の32乗未満の整数だけです。それ以外は全部これになります。

何が通って、何が落ちるか

example.js

for (const value of [0, 3, -1, 1.5, NaN, 2 ** 32, 2 ** 32 - 1]) {
  try {
    console.log(String(value).padEnd(12), '-> length', new Array(value).length);
  } catch (error) {
    console.log(String(value).padEnd(12), '->', error.name);
  }
}
固定例の期待出力 · Node 24.22.3
0            -> length 0
3            -> length 3
-1           -> RangeError
1.5          -> RangeError
NaN          -> RangeError
4294967296   -> RangeError
4294967295   -> length 4294967295
表示用コードUTF-8 · LF
  • 負の数 … 落ちる
  • 小数 … 落ちる(1.5 は整数ではない)
  • NaN … 落ちる
  • 2の32乗ちょうど … 落ちる。1つ手前までが上限

原因1: 計算結果が NaN になっている

実務でいちばん多い形です。

example.js

const total = Number('三件');
const size = 2;

console.log(total);
console.log(Math.ceil(total / size));
固定例の期待出力 · Node 24.22.3
NaN
NaN
表示用コードUTF-8 · LF

Number() が NaN を返し、そのまま長さに使われています。

javascript失敗・注意の例

const count = Number('三件');

new Array(count);
固定例の期待出力 · Node 24.22.3
RangeError: Invalid array length
表示用コードUTF-8 · LF

落ちた場所ではなく、NaN が生まれた場所を探してください。 → 文字列を数値に変換する

NaN かどうかは Number.isNaN() で確かめます。

example.js

function makeSlots(count) {
  if (!Number.isInteger(count) || count < 0) {
    throw new RangeError(`件数が数値ではありません: ${count}`);
  }

  return new Array(count).fill(null);
}

console.log(makeSlots(3));

try {
  makeSlots(Number('三件'));
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
[ null, null, null ]
RangeError: 件数が数値ではありません: NaN
表示用コードUTF-8 · LF

自分で投げるほうが、原因がその場で分かります。

原因2: 引き算で負になった

example.js

const total = 3;
const shown = 5;

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

「残りの数だけ枠を作る」ような計算で、表示済みが総数を超えると負になります。

Math.max(0, ...) で床を作ってください。

example.js

const total = 3;
const shown = 5;

console.log(new Array(Math.max(0, total - shown)).length);
固定例の期待出力 · Node 24.22.3
0
表示用コードUTF-8 · LF

原因3: length に代入した

example.js

const list = [1, 2, 3];

try {
  list.length = -1;
} catch (error) {
  console.log(error.name + ': ' + error.message);
}

list.length = 1;

console.log(list);
固定例の期待出力 · Node 24.22.3
RangeError: Invalid array length
[ 1 ]
表示用コードUTF-8 · LF

length への代入は切り詰めとして働きます。負の数は入れられません。

空にしたいなら list.length = 0 です。 ただし、同じ配列を指している変数がすべて影響を受けます。新しい配列を作るほうが安全なことも多くあります。

new Array(3) と Array.of(3) は別物

ここも取り違えやすいところです。

example.js

console.log(new Array(3));
console.log(new Array(3).length);
console.log(Array.of(3));
console.log(new Array(3, 4));
固定例の期待出力 · Node 24.22.3
[ <3 empty items> ]
3
[ 3 ]
[ 3, 4 ]
表示用コードUTF-8 · LF
  • 数を1つだけ渡す → 長さの指定
  • 2つ以上渡す → 要素として並ぶ
  • Array.of() → いつでも要素

new Array(3) が作るのは穴が3つ並んだ配列です。 map() を通しても何も起きません。

example.js

console.log(new Array(3).map((_, i) => i));
console.log(Array.from({ length: 3 }, (_, i) => i));
console.log(new Array(3).fill(0));
固定例の期待出力 · Node 24.22.3
[ <3 empty items> ]
[ 0, 1, 2 ]
[ 0, 0, 0 ]
表示用コードUTF-8 · LF

連番を作るなら Array.from()、同じ値で埋めるなら fill() です。 → 配列の基本

似ているエラーとの違い

文言 意味
Invalid array length 長さになれない数を渡した
Cannot read properties of undefined 範囲の外を読んだあとの中身
x is not a function Array を関数でないものと取り違えた
Maximum call stack size exceeded 再帰が止まらない

実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。

探しかたの順序

  1. new Array() か length = に渡している値を、そのまま出す
  2. NaN なら → 数値変換まで遡る(Number() / parseInt() / 割り算)
  3. 負の数なら → 引き算に Math.max(0, ...) を入れる
  4. 小数なら → Math.ceil() / Math.floor() で整数にする

まとめ

  • 長さは0以上・2の32乗未満の整数だけ
  • いちばん多い原因は NaN。 数値変換の失敗が伝わってきている
  • 引き算で負になる経路には Math.max(0, ...)
  • length への代入は切り詰め。負の数は入れられない
  • new Array(3) は穴3つ、Array.of(3) は要素1つ
  • 連番は Array.from()、埋めるなら fill()

出典

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