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