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