База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Деструктуриране на обекти, параметри по подразбиране и съкратен запис на свойства

Прочети настройки от един аргумент, разграничи стойността по подразбиране за целия параметър от тези за отделните свойства и създай резултата със съкратения запис.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

В сигнатурата на configure записът { limit: maxItems = 10, enabled = true } е шаблон за деструктуриране. Функцията приема един позиционен аргумент, а не именувани аргументи. Шаблонът прочита свойството limit в локалната променлива maxItems, а свойството enabled — в едноименна променлива.

Външното = {} създава нов празен обект, когато аргументът липсва или изрично е подадено undefined. Вътрешните = 10 и = true се прилагат независимо само ако прочитането на съответното свойство върне undefined, включително когато свойството не е намерено. Стойностите на свойства null, 0, false и "" се запазват. За разлика от това configure(null) предизвиква TypeError, преди да се изпълни тялото на функцията. Без външното = {} пропускането на аргумента също би предизвикало TypeError.

Изразите за стойности по подразбиране се изчисляват при извикване и само при нужда. Те могат да използват предходни, вече инициализирани параметри, но не и декларации в тялото на функцията. Прочитането на свойство може да обходи прототипната верига или да извика getter. Затова шаблонът не проверява нито типа на стойността, нито дали свойството принадлежи пряко на обекта.

В return { maxItems, enabled } фигурните скоби ограждат обектен литерал, който създава нов обект, а не шаблон. Тук съкратеният запис има същия ефект като { maxItems: maxItems, enabled: enabled }: ключовете идват от локалните имена, затова резултатът има ключ maxItems, а не limit. Този синтаксис е описан в ECMAScript 2024; провери поддръжката му в по-старите среди, в които искаш да изпълняваш кода.

Примери

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);
}

Резултат

{"maxItems":10,"enabled":true}
{"maxItems":10,"enabled":true}
{"maxItems":0,"enabled":false}
{"maxItems":10,"enabled":null}
TypeError

Първите две извиквания дават еднакъв резултат. Третото запазва `0` и `false`, четвъртото замества само `undefined`, а последното извежда `TypeError`, защото целият аргумент е `null`.

Свързани уроци

  • JavaScript · Урок 42 · Напреднало · Версия: 4

Източници