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

JavaScript / コードを試す

Array.prototype.slice() と splice()

名前が似ている slice() と splice() は、まったく別のものです。取り出すだけか元を書き換えるか、引数の意味の違い、負の数の扱い、浅いコピーになる点までを実行して確かめます。

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

slice() は、配列の一部を新しい配列にして返します。元の配列は変わりません。

example.js

const fruits = ['あ', 'い', 'う', 'え', 'お'];

console.log(fruits.slice(1, 3));
console.log(fruits);
固定例の期待出力 · Node 24.22.3
[ 'い', 'う' ]
[ 'あ', 'い', 'う', 'え', 'お' ]
表示用コードUTF-8 · LF

splice() は名前が似ていますが、元の配列を書き換えます。

example.js

const fruits = ['あ', 'い', 'う', 'え', 'お'];

console.log(fruits.splice(1, 2));
console.log(fruits);
固定例の期待出力 · Node 24.22.3
[ 'い', 'う' ]
[ 'あ', 'え', 'お' ]
表示用コードUTF-8 · LF

戻り値は同じでも、fruits が変わっています。 文字が1つ違うだけで、まったく別のものです。

slice() splice()
元の配列 変わらない 書き換わる
第2引数 終わりの位置 取り除く個数
戻り値 取り出した部分 取り除いた部分
要素を足す できない できる

slice(start, end)

第2引数は終わりの位置で、そこは含みません。

example.js

const fruits = ['あ', 'い', 'う', 'え', 'お'];

console.log(fruits.slice(2));
console.log(fruits.slice(-2));
console.log(fruits.slice());
console.log(fruits.slice(3, 1));
固定例の期待出力 · Node 24.22.3
[ 'う', 'え', 'お' ]
[ 'え', 'お' ]
[ 'あ', 'い', 'う', 'え', 'お' ]
[]
表示用コードUTF-8 · LF
  • 省略すると最後まで
  • 負の数は後ろから数えます
  • 引数なしは全部の複製
  • start が end より後ろなら空配列。入れ替えてはくれません

考え方は文字列の slice()と同じです。

複製は「浅い」

slice() が作るのは新しい配列ですが、中身は同じものを指しています。

example.js

const rows = [{ n: 1 }];
const copied = rows.slice();

copied[0].n = 99;

console.log(rows[0].n);
console.log(copied === rows, copied[0] === rows[0]);
固定例の期待出力 · Node 24.22.3
99
false true
表示用コードUTF-8 · LF

配列そのものは別(false)でも、中のオブジェクトは同じ(true)です。 これを浅いコピーと呼びます。 複製したつもりで元が変わるのは、ここが原因であることがほとんどです。

→ オブジェクトを結合する

splice(start, 削除数, 足すもの...)

第2引数は取り除く個数です。位置ではありません。

example.js

const items = ['あ', 'い', 'う'];

console.log(items.splice(1, 0, 'X', 'Y'));
console.log(items);
固定例の期待出力 · Node 24.22.3
[]
[ 'あ', 'X', 'Y', 'い', 'う' ]
表示用コードUTF-8 · LF

削除数を0にすると、取り除かずに差し込むだけになります。 何も取り除いていないので、戻り値は空配列です。

置き換えもできます。

example.js

const items = ['あ', 'い', 'う'];

console.log(items.splice(1, 1, 'Z'));
console.log(items);
固定例の期待出力 · Node 24.22.3
[ 'い' ]
[ 'あ', 'Z', 'う' ]
表示用コードUTF-8 · LF

削除数を省くと、そこから後ろが全部消えます。

example.js

const nums = [1, 2, 3, 4];

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

開始位置には負の数も使えます。

example.js

const nums = [1, 2, 3, 4];

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

元を変えたくないなら toSpliced()

splice() と同じことを、元を変えずにします(ES2023)。

example.js

const nums = [1, 2, 3];

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

Node 20 / Chrome 110 / Safari 16 より前の環境では使えません。

よくある間違い

splice() の第2引数を位置だと思う

javascript失敗・注意の例

const fruits = ['あ', 'い', 'う', 'え', 'お'];

console.log(fruits.splice(1, 3));
固定例の期待出力 · Node 24.22.3
[ 'い', 'う', 'え' ]
表示用コードUTF-8 · LF

1番目から3番目まで、のつもりが3個取り除かれています。 slice(1, 3) なら2個です。同じ数字を渡しても結果が違います。

splice() の戻り値を「残り」だと思う

javascript失敗・注意の例

const fruits = ['あ', 'い', 'う'];
const rest = fruits.splice(0, 1);

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

返るのは取り除いたほうです。残りは元の配列(fruits)に入っています。

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

javascript失敗・注意の例

const nums = [1, 2, 2, 3];

for (let i = 0; i < nums.length; i++) {
  if (nums[i] === 2) nums.splice(i, 1);
}

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

2 が1つ残りました。 取り除くと後ろが前に詰まるのに、i は進んでしまうので1つ飛ばして見ています。

filter() を使えば、この問題は起きません。

example.js

const nums = [1, 2, 2, 3];

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

取り除きたいときは、まず filter() を考えてください。 → 配列を変換する・絞り込む

まとめ

  • slice() は取り出すだけ。元は変わらない
  • splice() は元を書き換える。第2引数は個数
  • slice() の複製は浅いコピー。中のオブジェクトは共有される
  • splice(i, 0, x) で差し込み、splice(i, 1, x) で置き換え
  • 元を変えたくないなら toSpliced()
  • 繰り返しの中で splice() しない。 filter() を使う

出典

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