CKTIS / JavaScript
Desestructuración de parámetros de función
Escribe patrones en la lista de parámetros para extraer propiedades de objetos o valores de iterables. Distingue el valor por defecto del parámetro completo de los valores por defecto dentro del patrón.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }Desestructurar parámetros consiste en escribir un patrón de vinculación directamente en la lista de parámetros de la función. Para un parámetro ordinario, el patrón usa el valor que corresponde a una sola posición de argumento y crea vínculos locales disponibles en el cuerpo de la función. Un parámetro rest (...) también puede usar un patrón de vinculación, pero en ese caso se desestructura el array que contiene los argumentos restantes. Los argumentos siguen siendo posicionales, no nombrados.
El patrón de objeto { label } lee la propiedad por su nombre y crea un vínculo local llamado label. { label: name } lee la misma propiedad, pero vincula su valor al nombre local name. El patrón de array [count] toma el primer valor en orden de iteración, ya sea de un array o de otro iterable.
Los valores por defecto externos = {} y = [] sustituyen el argumento completo antes de desestructurarlo, solo si se omite o vale undefined. Los valores por defecto internos, como en name = "untitled" y count = 1, se aplican solo si el valor extraído es undefined, por ejemplo, si falta una propiedad o el iterador no proporciona otro valor. null, 0, false y "" no activan los valores por defecto.
Pasar null como argumento completo a cualquiera de los dos patrones lanza un TypeError antes de que se ejecute el cuerpo de la función. Sin valor por defecto externo, omitir el argumento o pasar undefined también provoca ese error. Un patrón de array también lanza un TypeError si el valor no es iterable. Desestructurar no sustituye la validación de los datos de entrada.
Ejemplos
function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
return `${name}: ${count}`;
}
console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));Resultado
untitled: 1 draft: 0 null: 1
La primera llamada usa ambos niveles de valores por defecto. La segunda conserva `0`. En la tercera, `label` vale `null` y no se reemplaza, mientras que el array vacío activa `count = 1`.
Lecciones relacionadas
- JavaScript · Lección 2 · Intermedio · Versión: 3