Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Składnia parametrów domyślnych

Zapis `parametr = wyrażenie` w definicji funkcji określa wartość używaną wtedy, gdy argument pominięto lub przekazano jako `undefined`.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

function f(a, b = a) { /* ... */ }
const g = (a, b = a) => b;
function h({ x = 1 } = {}) { return x; }

W liście parametrów funkcji, metody lub funkcji strzałkowej zapisz parametr = wyrażenie. Wartość domyślna jest używana tylko wtedy, gdy argument na danej pozycji pominięto lub przekazano undefined. Wartości null, false, 0 i "" przechodzą bez zmian. Aby użyć wartości domyślnej na wcześniejszej pozycji i podać argument na późniejszej, przekaż undefined na wcześniejszej pozycji.

Parametry są inicjalizowane od lewej do prawej przed wykonaniem ciała funkcji. Inicjalizator jest obliczany przy każdym wywołaniu, w którym jest potrzebny, więc items = [] tworzy za każdym takim razem nową tablicę. Inicjalizator może odczytać wcześniejszy parametr, ale próba odczytu późniejszego parametru przed jego inicjalizacją zgłasza ReferenceError. Deklaracje z ciała funkcji nie są widoczne dla inicjalizatorów.

W zapisie function h({ x = 1 } = {}) { return x; } zewnętrzne = {} działa, gdy argument pominięto lub wynosi on undefined; wewnętrzne x = 1 działa, gdy właściwości x brak lub ma ona wartość undefined. Wywołanie h(null) zgłasza TypeError: zewnętrzna wartość domyślna nie zastępuje null, a null nie można destrukturyzować.

Parametr bez wartości domyślnej może wystąpić po parametrze z wartością domyślną, ale nie wlicza się do length funkcji. Właściwość ta liczy tylko parametry przed pierwszym parametrem z inicjalizatorem całego parametru i zawsze pomija parametr resztowy. Parametr resztowy nie może mieć inicjalizatora.

Przykłady

{
  function collect(value, label = value, items = []) {
    items.push(label);
    return items;
  }

  console.log(JSON.stringify(collect("A")));
  console.log(JSON.stringify(collect("B", undefined)));
  console.log(JSON.stringify(collect("C", null)));
  console.log(JSON.stringify(collect("D", false, ["start"])));
  console.log(String(collect.length));
}

Wynik

["A"]
["B"]
[null]
["start",false]
1

Pominięcie `label` lub przekazanie `undefined` powoduje użycie `value`, ale `null` i `false` pozostają bez zmian. Pierwsze trzy wywołania tworzą osobne tablice; czwarte dopisuje element do przekazanej tablicy. `collect.length` wynosi `1`, bo liczy się tylko `value`.

Powiązane lekcje

  • JavaScript · Lekcja 21 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 27 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 29 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 44 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4

Źródła