This page was translated from English by the community.Learn more and join the MDN Web Docs community.
기본값 매개변수
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016년 9월.
기본값 함수 매개변수 (default function parameter)를 사용하면 값이 전달되지 않거나undefined인 경우 명명된 매개변수를 기본값으로 초기화할 수 있습니다.
시도해 보기
function multiply(a, b = 1) { return a * b;}console.log(multiply(5, 2));// Expected output: 10console.log(multiply(5));// Expected output: 5구문
function fnName(param1 = defaultValue1, /* …, */ paramN = defaultValueN) { // …}설명
JavaScript에서, 함수의 매개변수는undefined
다음 예제에서multiply가 호출될 때b에 대한 값이 제공되지 않으면a * b를 평가할 때b의 값은undefined가 되고multiply는NaN을 반환합니다.
function multiply(a, b) { return a * b;}multiply(5, 2); // 10multiply(5); // NaN !과거에 기본값을 설정하는 일반적인 방법은 함수 본문에서 매개변수 값을 테스트하고undefined인 경우 값을 할당하는 것이었습니다. 다음 예제에서는multiply가 하나의 인수로만 호출되는 경우b가1로 설정됩니다.
function multiply(a, b) { b = typeof b !== "undefined" ? b : 1; return a * b;}multiply(5, 2); // 10multiply(5); // 5기본 매개변수를 사용하면 함수 내부의 검사는 더 이상 필요하지 않습니다. 이제 함수 머리(head)에서b에1을 기본값으로 지정할 수 있습니다.
function multiply(a, b = 1) { return a * b;}multiply(5, 2); // 10multiply(5); // 5multiply(5, undefined); // 5매개변수는 여전히 왼쪽에서 오른쪽으로 설정되어 나중에 기본값이 없는 매개변수가 있더라도 기본값을 덮어씁니다.
function f(x = 1, y) { return [x, y];}f(); // [1, undefined]f(2); // [2, undefined]참고 :첫 번째 기본 매개변수와 그 이후의 모든 매개변수는 함수의length에 영향을 미치지 않습니다.
기본 매개변수 생성자는 함수 본문에서 생성된 범위의 상위인 자체 범위에서 동작합니다.
즉, 이전 매개변수는 이후 매개변수의 생성자에서 참조할 수 있습니다. 그러나 함수 본문에 선언된 함수와 변수는 기본값 매개변수 생성자에서 참조할 수 없으며, 이를 시도하면 런타임ReferenceError가 발생합니다. 여기에는 함수 본문에서var로 선언된 변수도 포함됩니다.
예를 들어, 다음 함수는 기본 매개변수 값에 함수 본문의 하위 범위에 대한 접근 권한이 없기 때문에 호출될 때ReferenceError를 발생시킵니다.
function f(a = go()) { function go() { return ":P"; }}f(); // ReferenceError: go가 정의되지 않았습니다.이 함수는 매개변수a의 값을 출력하는데, 변수var a는 매개변수 목록의 상위 범위가 아닌 함수 본문에 대해 생성된 범위에만 올라가기 때문에b에는 값이 표시되지 않습니다.
function f(a, b = () => console.log(a)) { var a = 1; b();}f(); // undefinedf(5); // 5예제
undefined vs 다른 거짓같은 값(falsy values) 전달하기
아래 예제중 두 번째 호출에서, 첫 번째 인수가 명시적으로undefined(null 또는 다른falsy 값은 아니지만)로 설정되어 있어도 여전히num 인수의 값은 여전히 기본값입니다.
function test(num = 1) { console.log(typeof num);}test(); // 'number' (num은 1로 설정됨)test(undefined); // 'number' (num이 역시 1로 설정됨)// 다른 falsy values로 테스트 하기test(""); // 'string' (num은 ''로 설정됨)test(null); // 'object' (num은 null로 설정됨)호출 시 평가
기본 인수는 호출 시에 평가됩니다. 그래서 Python과 달리 함수가 호출될 때마다 새 객체가 생성됩니다.
function append(value, array = []) { array.push(value); return array;}append(1); // [1]append(2); // [2], [1, 2]가 아니라이는 심지어 함수와 변수에도 적용됩니다.
function callSomething(thing = something()) { return thing;}let numberOfTimesCalled = 0;function something() { numberOfTimesCalled += 1; return numberOfTimesCalled;}callSomething(); // 1callSomething(); // 2이전 매개 변수는 이후 매개 변수의 기본값으로 사용할 수 있습니다
앞서 정의한 매개변수(왼쪽)는 나중에 정의한 매개변수의 기본값으로 사용할 수 있습니다.
function greet(name, greeting, message = `${greeting} ${name}`) { return [name, greeting, message];}greet("David", "Hi"); // ["David", "Hi", "Hi David"]greet("David", "Hi", "Happy Birthday!"); // ["David", "Hi", "Happy Birthday!"]이 기능은 다음과 같이 대략적으로 계산할 수 있으며, 이는 처리되는 경계 조건(edge case)의 수를 보여줍니다.
function go() { return ":P";}function withDefaults( a, b = 5, c = b, d = go(), e = this, f = arguments, g = this.value,) { return [a, b, c, d, e, f, g];}function withoutDefaults(a, b, c, d, e, f, g) { switch (arguments.length) { case 0: case 1: b = 5; case 2: c = b; case 3: d = go(); case 4: e = this; case 5: f = arguments; case 6: g = this.value; } return [a, b, c, d, e, f, g];}withDefaults.call({ value: "=^_^=" });// [undefined, 5, 5, ":P", {value:"=^_^="}, arguments, "=^_^="]withoutDefaults.call({ value: "=^_^=" });// [undefined, 5, 5, ":P", {value:"=^_^="}, arguments, "=^_^="]기본값이 할당된 구조화된 매개변수
구조 분해 할당 구문을 사용하여 기본값 할당을 사용할 수 있습니다.
이를 수행하는 일반적인 방법은 빈 객체/배열을 구조 분해된 매개변수의 기본값으로 설정하는 것입니다.(예:[x = 1, y = 2] = []) 이렇게 하면 함수에 아무 것도 전달하지 않고도 해당 값이 미리 채워져 있을 수 있습니다.
function preFilledArray([x = 1, y = 2] = []) { return x + y;}preFilledArray(); // 3preFilledArray([]); // 3preFilledArray([2]); // 4preFilledArray([2, 3]); // 5// 객체에서도 동일하게 작동합니다.function preFilledObject({ z = 3 } = {}) { return z;}preFilledObject(); // 3preFilledObject({}); // 3preFilledObject({ z: 2 }); // 2명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-function-definitions |