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

CKTIS / JavaScript

Desestructuración de objetos

La desestructuración de objetos lee propiedades por clave en lugar de por posición. Permite declarar variables, asignar valores a destinos existentes, definir valores predeterminados y reunir las propiedades restantes.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

const { name, theme: colorTheme = "light", ...rest } = profile;
let score;
({ points: score } = profile);
const { [key]: value, settings: { mode } = {} } = options;
function readName({ name = "Guest" } = {}) { return name; }

La desestructuración de objetos usa un patrón entre {} para leer propiedades por clave. En const { name } = profile, la variable name recibe el valor de profile.name. El patrón { name: displayName } lee la misma clave y guarda el valor en la variable displayName, sin cambiar el nombre de la propiedad. Con { [key]: value } se calcula la clave; { settings: { mode } } lee una propiedad anidada y solo crea un enlace para mode.

En una declaración con const, let o var, o en un parámetro de función, el patrón crea enlaces. La asignación ({ points: score } = profile) escribe en la variable existente score; una propiedad que admite escritura también puede servir de destino. En una sentencia independiente, los paréntesis impiden que la llave inicial se interprete como el comienzo de un bloque.

En { theme = "light" }, la expresión predeterminada solo se evalúa si la lectura devuelve undefined, por ejemplo si no se encuentra la propiedad. Los valores null, false y 0 se conservan. Aplicar un patrón de objeto a null o a undefined provoca un TypeError, incluso en un patrón anidado. En function readName({ name = "Guest" } = {}), el valor predeterminado del parámetro = {} se aplica si se omite el argumento o si vale undefined, pero no si vale null.

La búsqueda de una clave explícita puede encontrar una propiedad heredada. En cambio, ...rest solo copia las propiedades propias enumerables restantes a un objeto nuevo, incluidas las que tienen una clave de tipo símbolo. La copia es superficial: los valores que son objetos siguen compartiéndose. ...rest debe ir al final, sin coma después.

Esta es una sintaxis de ECMAScript 2024, no una API del navegador. En entornos JavaScript antiguos, comprueba la compatibilidad de las formas que uses, en especial ...rest.

Ejemplos

{
  const profile = { name: "Mira", theme: undefined, badge: null, points: 7 };
  const { name: displayName, theme = "light", badge = "none", ...rest } = profile;
  let score;
  ({ points: score } = profile);
  console.log(`${displayName} | ${theme} | ${badge} | ${score} | ${Object.keys(rest).join(",")}`);
}

Resultado

Mira | light | null | 7 | points

`displayName` recibe el valor de `name`, `theme` toma su valor predeterminado y `badge` conserva `null`. La asignación escribe `7` en `score`; `points` es la única clave de `rest`.

Lecciones relacionadas

  • JavaScript · Lección 39 · Avanzado · Versión: 4
  • JavaScript · Lección 5 · Básico · Versión: 4
  • JavaScript · Lección 18 · Básico · Versión: 4
  • JavaScript · Lección 2 · Intermedio · Versión: 3
  • JavaScript · Lección 8 · Intermedio · Versión: 3
  • JavaScript · Lección 10 · Intermedio · Versión: 3

Fuentes