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

JavaScript / コードを試す

関数の引数 — 既定値・可変長・分割代入

既定値が働くのは undefined のときだけです。null では働きません。可変長引数の受け取り方、オブジェクトで受けて名前を付ける書き方、length が数えない引数までを実行して確かめます。

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

= で既定値を書けます。働くのは undefined のときだけです。

example.js

function greet(name = 'あなた', mark = '!') {
  return name + mark;
}

console.log(greet());
console.log(greet('あ'));
console.log(greet(undefined, '?'));
固定例の期待出力 · Node 24.22.3
あなた!
あ!
あなた?
表示用コードUTF-8 · LF

undefined を渡すと渡していないのと同じ扱いになります。 だから「2番目だけ指定したい」ときに undefined を書けます。

null では働かない

javascript失敗・注意の例

function greet(name = 'あなた') {
  return name + '!';
}

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

null は「値として渡された」ので、既定値に置き換わりません。

null も既定値にしたいなら ?? を使います。

example.js

function greet(name) {
  return (name ?? 'あなた') + '!';
}

console.log(greet(null));
console.log(greet(undefined));
console.log(greet(''));
固定例の期待出力 · Node 24.22.3
あなた!
あなた!
!
表示用コードUTF-8 · LF

空文字はそのまま通ります。|| にすると空文字も置き換わるので注意してください。 → なぜ typeof null は "object" なのか

何個でも受け取る

... を付けた引数(残余引数)は、残り全部を配列で受けます。

example.js

function sum(...nums) {
  return nums.reduce((total, n) => total + n, 0);
}

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

渡されなければ空配列です。undefined にはなりません。

前に固定の引数を置けます。残余引数は最後にしか書けません。

example.js

function head(first, ...rest) {
  return [first, rest];
}

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

古い書き方の arguments は、アロー関数では使えず、配列でもありません。新しく書くなら残余引数を使ってください。

オブジェクトで受ける

引数が3つを超えたら、オブジェクトで受けるほうが読みやすくなります。

example.js

function show({ name, city = '不明' } = {}) {
  return `${name}/${city}`;
}

console.log(show({ name: 'あ', city: '東京' }));
console.log(show({ name: 'い' }));
console.log(show());
固定例の期待出力 · Node 24.22.3
あ/東京
い/不明
undefined/不明
表示用コードUTF-8 · LF
  • 呼び出し側から「何を渡しているか」が読めます
  • 順番を覚えなくてよくなります
  • あとから項目を足しても、既存の呼び出しが壊れません

= {} を付けているのは、引数そのものを省けるようにするためです。 付けないと、何も渡さなかったときに落ちます。

javascript失敗・注意の例

function show({ name }) {
  return name;
}

console.log(show());
固定例の期待出力 · Node 24.22.3
TypeError: Cannot destructure property 'name' of 'undefined' as it is undefined.
表示用コードUTF-8 · LF

→ 入れ子のオブジェクトを安全に扱う

length は全部を数えない

example.js

function f(a, b = 1, ...c) {}
function g(a, b) {}

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

length が数えるのは、既定値と残余引数が出てくる前までです。 f は3つ書いてあるのに 1 です。

「この関数は何個の引数を取るか」の答えとしては使えません。 引数の個数に応じて処理を変えたいなら、残余引数で受けて nums.length を見てください。

余分に渡しても落ちない

example.js

function add(a, b) {
  return a + b;
}

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

多すぎても少なすぎても例外になりません。

足りない分は undefined になり、計算に使うと NaN になります。 「呼び方を間違えても動いてしまう」ので、既定値を書いておく価値があります。

example.js

function add(a = 0, b = 0) {
  return a + b;
}

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

既定値には式が書ける

example.js

function makeTag(name, label = name.toUpperCase()) {
  return `${name}:${label}`;
}

console.log(makeTag('a'));
console.log(makeTag('a', 'B'));
固定例の期待出力 · Node 24.22.3
a:A
a:B
表示用コードUTF-8 · LF

前の引数を使えます。 評価されるのは呼ばれたときなので、 毎回新しい値になります。

ただし後ろの引数は使えません。 まだ決まっていないからです。

よくある間違い

既定値にオブジェクトを書いて共有されると思う

example.js

function push(value, list = []) {
  list.push(value);
  return list;
}

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

毎回新しい配列が作られます。 前の呼び出しの結果は残りません。

他の言語では既定値が1度だけ評価され、共有されてしまうものがあります。JavaScript は呼ばれるたびに評価します。

引数を書き換える

javascript失敗・注意の例

function addTax(price) {
  price = price * 1.1;
  return price;
}

const original = 100;

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

数値は複製されるので元は変わりません。ですがオブジェクトは変わります。

javascript失敗・注意の例

function rename(user) {
  user.name = '変えた';
  return user;
}

const user = { name: 'あ' };

rename(user);

console.log(user);
固定例の期待出力 · Node 24.22.3
{ name: '変えた' }
表示用コードUTF-8 · LF

受け取ったオブジェクトを書き換えないでください。 新しいものを返すほうが、呼び出し側から見て安全です。

example.js

function rename(user, name) {
  return { ...user, name };
}

const user = { name: 'あ' };

console.log(rename(user, '変えた'));
console.log(user);
固定例の期待出力 · Node 24.22.3
{ name: '変えた' }
{ name: 'あ' }
表示用コードUTF-8 · LF

まとめ

  • 既定値が働くのはundefinedのときだけ。null では働かない
  • null も含めるなら ??
  • ...rest は残り全部を配列で受ける。無ければ空配列
  • 引数が多いならオブジェクトで受ける。= {} を忘れない
  • length は既定値の手前まで。引数の個数ではない
  • 多すぎても少なすぎても落ちない。足りない分は undefined
  • 受け取ったオブジェクトを書き換えない

出典

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