CKTIS / JavaScript
Деструктуриране на параметри на функции
Използвайте шаблони в списъка с параметри, за да извличате свойства на обекти или стойности от итерируеми стойности. Разграничете стойността по подразбиране на целия параметър от тези вътре в шаблона.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }При деструктуриране на параметри шаблонът за свързване се записва направо в списъка с параметри на функцията. При обикновен параметър шаблонът използва стойността за една позиция в списъка с аргументи и създава локални имена, достъпни в тялото на функцията. Параметърът за останалите аргументи (...) също може да използва шаблон за свързване, но тогава се деструктурира масивът, в който са събрани останалите аргументи. Аргументите продължават да се подават по позиция, а не по име.
Обектният шаблон { label } прочита свойството по име и създава локално име label. Записът { label: name } прочита същото свойство, но свързва стойността му с локалното име name. Шаблонът за масив [count] взема първата стойност по реда на обхождане от масив или друга итерируема стойност.
Външните стойности по подразбиране = {} и = [] заменят целия аргумент преди деструктурирането, но само ако е пропуснат или е undefined. Вътрешните стойности по подразбиране, например в name = "untitled" и count = 1, се използват само ако извлечената стойност е undefined, например когато липсва свойство или итераторът не предоставя следваща стойност. При null, 0, false и "" стойностите по подразбиране не се използват.
Ако подадете null като целия аргумент за който и да е от двата шаблона, се хвърля грешка TypeError, преди да се изпълни тялото на функцията. Без външна стойност по подразбиране същата грешка възниква, ако пропуснете аргумента или подадете undefined. Шаблонът за масив хвърля TypeError и при стойност, която не е итерируема. Деструктурирането не замества проверката на входните данни.
Примери
function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
return `${name}: ${count}`;
}
console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));Резултат
untitled: 1 draft: 0 null: 1
Първото извикване използва и двете нива на стойности по подразбиране. Второто запазва `0`. При третото `label` е `null` и не се заменя, а празният масив води до използване на `count = 1`.
Свързани уроци
- JavaScript · Урок 2 · Средно · Версия: 3