CKTIS / JavaScript
Declaración con desestructuración de objetos
Una declaración con desestructuración de objetos crea enlaces de variables a partir de las propiedades del origen. El patrón permite cambiar los nombres, definir valores predeterminados y reunir las propiedades restantes.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const { property, key: local = fallback, [computedKey]: selected, nested: { inner } = {}, ...rest } = source;
let { property: mutable } = source;
var { property: variable } = source;En una declaración ordinaria como const { property } = source;, las llaves delimitan un patrón de enlace, no un literal de objeto. La expresión source es el inicializador obligatorio. const y let tienen ámbito de bloque; const impide reasignar el enlace, pero no modificar un objeto. Dentro de una función, var tiene ámbito de función, no de bloque.
{ key: local } lee key y declara local, no key. { [computedKey]: selected } calcula la clave, y un patrón anidado lee propiedades en el nivel siguiente. Una expresión predeterminada solo se evalúa si la lectura devuelve undefined, por ejemplo cuando falta la propiedad. No sustituye null, false ni 0. Desestructurar null o undefined lanza un TypeError, incluso dentro de un patrón anidado.
Una propiedad seleccionada explícitamente puede ser heredada. ...rest copia superficialmente en un objeto nuevo solo las propiedades propias y enumerables restantes, incluidas las que tienen claves Symbol. En una declaración debe ir al final, enlazar un identificador y no llevar una coma detrás. La desestructuración no valida los datos de entrada; leer una propiedad puede ejecutar un getter.
({ property } = source); asigna un valor a una variable existente en vez de declararla. Al comienzo de una instrucción, los paréntesis evitan que { se interprete como el inicio de un bloque. ECMAScript 2024 especifica esta sintaxis; comprueba su compatibilidad con el entorno de ejecución de destino.
Ejemplos
{
const key = "theme";
const source = { name: "Ada", theme: null, active: false };
const {
name: displayName,
[key]: theme = "light",
settings: { density = "compact" } = {},
...rest
} = source;
console.log(JSON.stringify([displayName, theme, density, rest]));
}Resultado
["Ada",null,"compact",{"active":false}]`name` se vincula a `displayName` y `theme` conserva `null`. Como falta `settings`, se usa primero el valor predeterminado `{}` y después `density` toma el valor `"compact"`. En `rest` solo queda `active: false`.
Lecciones relacionadas
- JavaScript · Lección 1 · Avanzado · Versión: 4
- JavaScript · Lección 8 · Avanzado · Versión: 4
- JavaScript · Lección 11 · Avanzado · Versión: 4
Fuentes
- ECMAScript 2024 Language Specification — Let and Const Declarations
- ECMAScript 2024 Language Specification — Variable Statement
- ECMAScript 2024 Language Specification — Destructuring Binding Patterns
- ECMAScript 2024 Language Specification — CopyDataProperties
- ECMAScript 2024 Language Specification — Destructuring Assignment
- MDN — Destructuring