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

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}
TypeError

Las 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

Fuentes