CKTIS / JavaScript
Desestructuración de objetos, parámetros predeterminados y propiedades abreviadas
Lee opciones de un solo argumento, distingue el valor predeterminado del parámetro completo de los de cada propiedad y construye el resultado con la sintaxis abreviada.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
function configure({ limit: maxItems = 10, enabled = true } = {}) {
return { maxItems, enabled };
}En la firma de configure, { limit: maxItems = 10, enabled = true } es un patrón de desestructuración. La función recibe un solo argumento posicional, no argumentos con nombre. El patrón lee limit en la variable local maxItems y enabled en una variable del mismo nombre.
El = {} externo crea un objeto vacío nuevo cuando se omite el argumento o se pasa explícitamente undefined. Los valores predeterminados internos = 10 y = true se aplican por separado, solo si la lectura de la propiedad correspondiente da undefined, incluido el caso en que no se encuentra la propiedad. Los valores de propiedad null, 0, false y "" se conservan. En cambio, configure(null) lanza un TypeError antes de ejecutar el cuerpo de la función. Sin el = {} externo, omitir el argumento también provocaría un TypeError.
Las expresiones predeterminadas se evalúan en el momento de la llamada y solo si hacen falta. Pueden usar parámetros anteriores ya inicializados, pero no declaraciones del cuerpo de la función. Al leer una propiedad se puede recorrer la cadena de prototipos o ejecutar un getter, así que el patrón no comprueba el tipo del valor ni si la propiedad es propia del objeto.
En return { maxItems, enabled }, las llaves delimitan un literal que crea un objeto nuevo, no un patrón. Aquí, la sintaxis abreviada tiene el mismo efecto que { maxItems: maxItems, enabled: enabled }: las claves se toman de los nombres locales, por lo que el resultado tiene la clave maxItems, no limit. Esta sintaxis está especificada en ECMAScript 2024; comprueba que sea compatible con los entornos de ejecución antiguos a los que te dirijas.
Ejemplos
function configure({ limit: maxItems = 10, enabled = true } = {}) {
return { maxItems, enabled };
}
console.log(JSON.stringify(configure()));
console.log(JSON.stringify(configure(undefined)));
console.log(JSON.stringify(configure({ limit: 0, enabled: false })));
console.log(JSON.stringify(configure({ limit: undefined, enabled: null })));
try {
configure(null);
} catch (error) {
console.log(error.name);
}Resultado
{"maxItems":10,"enabled":true}
{"maxItems":10,"enabled":true}
{"maxItems":0,"enabled":false}
{"maxItems":10,"enabled":null}
TypeErrorLas dos primeras llamadas dan el mismo resultado. La tercera conserva `0` y `false`, la cuarta sustituye solo `undefined` y la última muestra `TypeError` porque el argumento completo es `null`.
Lecciones relacionadas
- JavaScript · Lección 42 · Avanzado · Versión: 4