function [nome]([param1[ = valorPredefinido1 ][, ..., paramN[ = valorPredefinidoN ]]]) {   instruções}

Em JavaScript, os parâmetros de funções temundefined como valor predefinido. Contudo, em alguns casos pode ser útil utilizar algum outro valor. É nesta situação em que os parâmetros predefinidos podem ser úteis.

No passado, a estratégia de definir valores padrão para parâmetros era testar os valores do parâmetros no corpo da função e atribuir um valor se este forundefined. No exemplo a seguir, se nenhum valor for fornecido parab na chamada, este valor seráundefined, quandoa*b for calculado resultaria emNaN. No entanto, isto é capturado na segunda linha definindo um valor padrão para b:

function multiply(a, b) {  b = typeof b !== "undefined" ? b : 1;  return a * b;}multiply(5, 2); // 10multiply(5, 1); // 5multiply(5); // 5

Com o parâmetros predefinidos a checagem no corpo da função nao é mais necessária. Agora você pode simplesmente colocar 1 como valor padrão parab na declaração da função:

function multiply(a, b = 1) {  return a * b;}multiply(5, 2); // 10multiply(5, 1); // 5multiply(5); // 5

Na segunda chamada aqui, mesmo se o segundo argumento é definido explicitamente comoundefined (com exceção denull) quando chamado, o valor para o argumentonum será o padrão.

function test(num = 1) {  console.log(typeof num);}test();          // 'number' (num é definido para 1)test(undefined); // 'number' (num é definido para 1 também)// teste com outros values "falsy":test('');        // 'string' (num é definido para '')test(null);      // 'object' (num é definido para null)

Os parâmetros predefinidos são avaliados no momento da chamada da função, então diferente de ex.: Python, um novo objeto é criado cada vez que a funçao é chamada.

function append(value, array = []) {  array.push(value);  return array;}append(1); //[1]append(2); //[2], not [1, 2]

Este mesmo comportamento é aplicado para funções e variáveis:

function callSomething(thing = something()) {  return thing;}function something() {  return "sth";}callSomething(); //sth

Parâmetros que já foram avaliados ficam disponíveis para uso para os parâmetros seguintes:

function singularAutoPlural(singular, plural = singular+"s",                            rallyingCry = plural + " ATTACK!!!") {  return [singular, plural, rallyingCry ];}//["Gecko","Geckos", "Geckos ATTACK!!!"]singularAutoPlural("Gecko");//["Fox","Foxes", "Foxes ATTACK!!!"]singularAutoPlural("Fox","Foxes");//["Deer", "Deer", "Deer ... change."]singularAutoPlural("Deer", "Deer", "Deer peaceably and respectfully   petition the government for positive change.")

Esta funcionalidade torna-se uma maneira direta e demonstra quantos casos extremos são manipulados.

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:      a;    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;    default:  }  return [a, b, c, d, e, f, g];}withDefaults.call({ value: "=^_^=" });// [undefined, 5, 5, ":P", window, arguments, "=^_^="]withoutDefaults.call({ value: "=^_^=" });// [undefined, 5, 5, ":P", window, arguments, "=^_^="]

Introduzido no Gecko 33. Funções declaradas no corpo da função não podem ser referenciada dentro de parâmetos padrão e lançará umReferenceError (atualmente umTypeError no SpiderMonkey, vejaErro do Firefox 1022967). Parâmetros padrão são sempre executados primeiro, declarações de funções dentro do corpo de outra função são avaliadas depois.

// Não funciona! Throws ReferenceError.function f(a = go()) {  function go() {    return ":P";  }}

Antes do Gecko 26, o seguinte código resultaria em umSyntaxError. Isto foi corrigido noErro do Firefox 777060 e funciona como esperado em versões posteriores:

function f(x = 1, y) {  return [x, y];}f(); // [1, undefined]

É possível definir valores padrões com a notaçãodestructuring assignment:

function f([x, y] = [1, 2], { z: z } = { z: 3 }) {  return x + y + z;}f(); // 6

• Original proposal at ecmascript.org