Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Desestructuración de arrays en parámetros de función

Un patrón de array en la lista de parámetros descompone un solo argumento iterable. Los valores por defecto del argumento y de cada elemento son independientes.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }

En la lista de parámetros, [first, third] es un patrón de vinculación de array que descompone un solo argumento, no dos parámetros separados. En cada llamada, el patrón inicializa los nombres locales en el orden de iteración antes de ejecutar el cuerpo de la función. Se puede pasar un array u otro iterable, como un Set; un objeto ordinario con claves numéricas y una propiedad length no basta.

En [first = 1, , third = 3, ...rest], el hueco entre las comas omite el segundo valor. ...rest recoge los valores restantes en un array nuevo. Es un elemento de resto dentro del patrón, no un parámetro rest que recoge argumentos separados de la llamada. Debe ir al final y no puede llevar una coma detrás.

El = [] externo sustituye el argumento completo solo si se omite o es undefined. Los valores por defecto internos = 1 y = 3 se aplican si el valor correspondiente falta o es undefined. Un null dentro del array sigue siendo null. Si el argumento completo es null u otro valor no iterable, se lanza un TypeError antes de ejecutar el cuerpo. Sin = [], omitir el argumento o pasar undefined también lanza un TypeError.

Ejemplos

function describe([first = 1, , third = 3, ...rest] = []) {
  return [first, third, rest];
}

console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));

try {
  describe(null);
} catch (error) {
  console.log(error.name);
}

Resultado

[1,3,[]]
[1,null,[40,50]]
[10,30,[]]
TypeError

La primera llamada usa ambos niveles de valores por defecto. En la segunda se omite `20`, se conserva `null` y `rest` es `[40,50]`. La tercera muestra que un `Set` también funciona. La última muestra el nombre del error en lugar de un mensaje propio del entorno de ejecución.

Lecciones relacionadas

  • JavaScript · Lección 28 · Intermedio · Versión: 3

Fuentes