CKTIS / JavaScript
Деструктуриране на масиви в параметри на функции
Шаблон за масив в списъка с параметри разопакова един итерируем аргумент. Стойността по подразбиране за целия аргумент е отделна от тези за елементите.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }В списъка с параметри [first, third] е шаблон за обвързване на стойности като в масив. Той разопакова един аргумент, а не задава два отделни параметъра. При извикване локалните имена се инициализират в реда на обхождане, преди да се изпълни тялото на функцията. Може да се подаде масив или друга итерируема стойност, например Set; обикновен обект с числови ключове и свойство length не е достатъчен.
В [first = 1, , third = 3, ...rest] празното място между запетаите пропуска втората стойност. ...rest събира останалите стойности в нов масив. Това е елемент за остатъка в шаблона, а не параметър за остатъка, който събира отделни аргументи на извикването. Трябва да е последен и след него не може да има запетая.
Външното = [] заменя целия аргумент само ако е пропуснат или е undefined. Вътрешните стойности по подразбиране = 1 и = 3 се използват, ако съответната стойност липсва или е undefined. Стойност null в масива остава null. Ако целият аргумент е null или друга неитерируема стойност, възниква TypeError, преди да се изпълни тялото. Без = [] пропускането на аргумента или подаването на undefined също води до TypeError.
Примери
function describe([first = 1, , third = 3, ...rest] = []) {
return [first, third, rest];
}
console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));
try {
describe(null);
} catch (error) {
console.log(error.name);
}Резултат
[1,3,[]] [1,null,[40,50]] [10,30,[]] TypeError
Първото извикване използва и двете нива на стойности по подразбиране. При второто `20` се пропуска, `null` се запазва, а `rest` е `[40,50]`. Третото показва, че може да се използва и `Set`. Последното извежда името на грешката, а не съобщение, което зависи от средата за изпълнение.
Свързани уроци
- JavaScript · Урок 28 · Средно · Версия: 3