JavaScript / コードを試す
push() / pop() / shift() / unshift()
4つとも元の配列を書き換えます。それぞれの戻り値、空配列で何が返るか、配列を丸ごと足すと入れ子になる理由、元を変えずに同じことをする書き方までを実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
4つとも元の配列を書き換えます。 新しい配列は返りません。
const items = [1, 2, 3]; console.log(items.push(4)); console.log(items); console.log(items.pop()); console.log(items);
4 [ 1, 2, 3, 4 ] 4 [ 1, 2, 3 ]
戻り値が違います。
push()… 足したあとの長さpop()… 取り出した要素
4つの違い
| メソッド | 場所 | 戻り値 |
|---|---|---|
push(値) |
末尾に足す | 足したあとの長さ |
pop() |
末尾から取る | 取った要素 |
unshift(値) |
先頭に足す | 足したあとの長さ |
shift() |
先頭から取る | 取った要素 |
const items = [1, 2, 3]; console.log(items.shift()); console.log(items); console.log(items.unshift(0)); console.log(items);
1 [ 2, 3 ] 3 [ 0, 2, 3 ]
足す系は長さ、取る系は要素、と覚えると取り違えません。
先頭を触る shift() / unshift() は、後ろの要素を全部ずらします。件数が多いと末尾より遅くなります。
空の配列では
const items = []; console.log(items.pop()); console.log(items.shift()); console.log(items.length); console.log(items.push());
undefined undefined 0 0
例外にはなりません。 undefined が返るだけです。
「取れた」のか「空だった」のかを、戻り値だけでは区別できません。
undefined を要素として入れている配列では、なおさら分かりません。
先に length を見てください。
配列を足すと入れ子になる
const items = [1, 2];
items.push([3, 4]);
console.log(items);[ 1, 2, [ 3, 4 ] ]
push() は渡したものをそのまま1つの要素として入れます。
中身を並べたいなら、スプレッド構文で開いてください。
const items = [1, 2]; items.push(...[3, 4]); console.log(items);
[ 1, 2, 3, 4 ]
concat() なら、元を変えずに繋げた新しい配列が返ります。
const items = [1, 2]; console.log(items.concat([3, 4])); console.log(items);
[ 1, 2, 3, 4 ] [ 1, 2 ]
push(...huge) は引数として全部展開するので、要素が非常に多いと上限に当たることがあります。件数が読めないときは concat() かループを使ってください。
元を変えたくないとき
書き換えたくないなら、そもそも使わないのがいちばん簡単です。
const items = [1, 2, 3]; console.log([...items, 4]); console.log([0, ...items]); console.log(items);
[ 1, 2, 3, 4 ] [ 0, 1, 2, 3 ] [ 1, 2, 3 ]
取り除く・置き換える側にも、元を変えない対があります(ES2023)。
const items = [1, 2, 3]; console.log(items.toSpliced(0, 1)); console.log(items.with(0, 99)); console.log(items.toReversed()); console.log(items);
[ 2, 3 ] [ 99, 2, 3 ] [ 3, 2, 1 ] [ 1, 2, 3 ]
| 書き換える | 元を変えない |
|---|---|
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 より前では使えません。
よくある間違い
戻り値を新しい配列だと思う
const items = [1, 2, 3];
const added = items.push(4);
console.log(added);4
返るのは長さです。配列ではありません。
added.map(...) と書けば、そこで落ちます。
const だから安全だと思う
const items = [1, 2, 3]; items.push(4); console.log(items);
[ 1, 2, 3, 4 ]
const が固定するのは名前と値の結びつきで、中身ではありません。
→ TypeError: Assignment to constant variable.
共有している配列に push() すると、見ている全員に影響します。
繰り返しの中で shift() する
const queue = [1, 2, 3];
for (let i = 0; i < queue.length; i++) {
queue.shift();
}
console.log(queue);[ 3 ]
取り出すたびに length が減るので、途中で条件が成立して止まります。
全部取り出すなら while にしてください。
const queue = [1, 2, 3]; const done = []; while (queue.length > 0) { done.push(queue.shift()); } console.log(done, queue);
[ 1, 2, 3 ] []
まとめ
- 4つとも元を書き換える
- 足す系は長さ、取る系は要素を返す
- 空配列では
undefined。例外にはならない - 配列を
push()すると入れ子になる。...で開く - 元を変えないなら
[...items, x]やtoSpliced()/with() constでも中身は変わる