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

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

Fuentes