11. rest引数 — 個数が決まらない引数を受け取る

引数名の前に ... を付けると、その位置以降の引数を何個でもまとめて受け取れる rest引数になります。受け取った値は関数の中で配列になるため、型は ...nums: number[] のように配列の型で書きます。

実務では、合計を計算する、文字列をつなぎ合わせるなど「引数の個数が呼び出しごとに変わる」関数で使います。固定の引数と組み合わせることもでき、その場合は rest引数を必ず引数リストの最後に置きます。

つまずきポイントは型の書き方です。呼び出すときは数値を1個ずつ渡しますが、受け取る側ではまとめて配列になるので、型は number ではなく number[] と書きます。関数の中では普通の配列としてループやメソッドが使えます。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

TypeScript

// ...nums は「残りの引数を全部まとめた配列」になる
function sum(...nums: number[]): number {
  let total = 0;
  for (const n of nums) {
    total = total + n;
  }
  return total;
}

console.log(sum(1, 2, 3));
console.log(sum(10, 20, 30, 40));
console.log(sum()); // 0個でもOK(空の配列になる)

// 固定の引数と組み合わせるときは rest引数を最後に置く
function joinWords(separator: string, ...words: string[]): string {
  return words.join(separator);
}
console.log(joinWords("-", "2026", "06", "12"));

サンプルコードで身につける(5本) →

学んだ概念を、素朴な例から実務寄りの例まで5つの具体例で確認します。

公式ドキュメントで詳しく ↗