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

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

Източници