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

JavaScript / コードを試す

push() / pop() / shift() / unshift()

4つとも元の配列を書き換えます。それぞれの戻り値、空配列で何が返るか、配列を丸ごと足すと入れ子になる理由、元を変えずに同じことをする書き方までを実行して確かめます。

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

4つとも元の配列を書き換えます。 新しい配列は返りません。

example.js

const items = [1, 2, 3];

console.log(items.push(4));
console.log(items);
console.log(items.pop());
console.log(items);
固定例の期待出力 · Node 24.22.3
4
[ 1, 2, 3, 4 ]
4
[ 1, 2, 3 ]
表示用コードUTF-8 · LF

戻り値が違います。

  • push() … 足したあとの長さ
  • pop() … 取り出した要素

4つの違い

メソッド 場所 戻り値
push(値) 末尾に足す 足したあとの長さ
pop() 末尾から取る 取った要素
unshift(値) 先頭に足す 足したあとの長さ
shift() 先頭から取る 取った要素
example.js

const items = [1, 2, 3];

console.log(items.shift());
console.log(items);
console.log(items.unshift(0));
console.log(items);
固定例の期待出力 · Node 24.22.3
1
[ 2, 3 ]
3
[ 0, 2, 3 ]
表示用コードUTF-8 · LF

足す系は長さ、取る系は要素、と覚えると取り違えません。

先頭を触る shift() / unshift() は、後ろの要素を全部ずらします。件数が多いと末尾より遅くなります。

空の配列では

example.js

const items = [];

console.log(items.pop());
console.log(items.shift());
console.log(items.length);
console.log(items.push());
固定例の期待出力 · Node 24.22.3
undefined
undefined
0
0
表示用コードUTF-8 · LF

例外にはなりません。 undefined が返るだけです。

「取れた」のか「空だった」のかを、戻り値だけでは区別できません。 undefined を要素として入れている配列では、なおさら分かりません。 先に length を見てください。

配列を足すと入れ子になる

javascript失敗・注意の例

const items = [1, 2];

items.push([3, 4]);

console.log(items);
固定例の期待出力 · Node 24.22.3
[ 1, 2, [ 3, 4 ] ]
表示用コードUTF-8 · LF

push() は渡したものをそのまま1つの要素として入れます。

中身を並べたいなら、スプレッド構文で開いてください。

example.js

const items = [1, 2];

items.push(...[3, 4]);

console.log(items);
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3, 4 ]
表示用コードUTF-8 · LF

concat() なら、元を変えずに繋げた新しい配列が返ります。

example.js

const items = [1, 2];

console.log(items.concat([3, 4]));
console.log(items);
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3, 4 ]
[ 1, 2 ]
表示用コードUTF-8 · LF

push(...huge) は引数として全部展開するので、要素が非常に多いと上限に当たることがあります。件数が読めないときは concat() かループを使ってください。

元を変えたくないとき

書き換えたくないなら、そもそも使わないのがいちばん簡単です。

example.js

const items = [1, 2, 3];

console.log([...items, 4]);
console.log([0, ...items]);
console.log(items);
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3, 4 ]
[ 0, 1, 2, 3 ]
[ 1, 2, 3 ]
表示用コードUTF-8 · LF

取り除く・置き換える側にも、元を変えない対があります(ES2023)。

example.js

const items = [1, 2, 3];

console.log(items.toSpliced(0, 1));
console.log(items.with(0, 99));
console.log(items.toReversed());
console.log(items);
固定例の期待出力 · Node 24.22.3
[ 2, 3 ]
[ 99, 2, 3 ]
[ 3, 2, 1 ]
[ 1, 2, 3 ]
表示用コードUTF-8 · LF
書き換える 元を変えない
push() / unshift() [...items, x] / [x, ...items]
pop() / shift() items.slice(0, -1) / items.slice(1)
splice() toSpliced()
items[0] = x with(0, x)
reverse() toReversed()
sort() toSorted()

toSpliced() / with() / toReversed() は Node 20 / Chrome 110 / Safari 16 より前では使えません。

→ slice() と splice()

よくある間違い

戻り値を新しい配列だと思う

javascript失敗・注意の例

const items = [1, 2, 3];
const added = items.push(4);

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

返るのは長さです。配列ではありません。 added.map(...) と書けば、そこで落ちます。

const だから安全だと思う

example.js

const items = [1, 2, 3];

items.push(4);

console.log(items);
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3, 4 ]
表示用コードUTF-8 · LF

const が固定するのは名前と値の結びつきで、中身ではありません。 → TypeError: Assignment to constant variable.

共有している配列に push() すると、見ている全員に影響します。

繰り返しの中で shift() する

javascript失敗・注意の例

const queue = [1, 2, 3];

for (let i = 0; i < queue.length; i++) {
  queue.shift();
}

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

取り出すたびに length が減るので、途中で条件が成立して止まります。

全部取り出すなら while にしてください。

example.js

const queue = [1, 2, 3];
const done = [];

while (queue.length > 0) {
  done.push(queue.shift());
}

console.log(done, queue);
固定例の期待出力 · Node 24.22.3
[ 1, 2, 3 ] []
表示用コードUTF-8 · LF

まとめ

  • 4つとも元を書き換える
  • 足す系は長さ、取る系は要素を返す
  • 空配列では undefined。例外にはならない
  • 配列を push() すると入れ子になる。... で開く
  • 元を変えないなら [...items, x] や toSpliced() / with()
  • const でも中身は変わる

出典

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