Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Dostęp do właściwości za pomocą obliczanego klucza

Notacja nawiasowa `obj[expr]` wybiera właściwość na podstawie wartości wyrażenia. Pozwala odczytywać i zapisywać właściwości oraz wywoływać metody pod kluczami ustalanymi w czasie wykonywania.

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

Składnia

object[expression]
object[expression] = value
object[expression](...args)
object?.[expression]

obj[expr] oblicza wartość expr, aby wybrać klucz właściwości. obj.key zawsze używa tekstowego klucza "key", a obj[key] korzysta z wartości zmiennej key. Nawiasy pozwalają używać między innymi kluczy ze spacjami. Zapis { [expr]: value } to obliczana nazwa właściwości w literale obiektu: definiuje właściwość, zamiast odczytywać ją z istniejącego obiektu.

Operacja ToPropertyKey sprowadza wartość klucza do wartości prymitywnej: zachowuje wartość typu Symbol, a pozostałe wartości zamienia na tekst. Dlatego obj[1] i obj["1"] wskazują tę samą właściwość. Konwersja obiektu użytego jako klucz może uruchomić kod i zgłosić wyjątek.

Zwykły odczyt może sięgnąć do łańcucha prototypów i wywołać getter. Brak właściwości daje undefined, ale istniejąca właściwość również może dać undefined. Object.hasOwn(obj, key) sprawdza, czy właściwość jest własna. obj[key] = value podlega zwykłym regułom przypisania, a w bezpośrednim wywołaniu obj[key]() odbiorcą jest obj, tak jak w obj.method().

Zwykły odczyt z null lub undefined zgłasza TypeError. obj?.[expr] dla takiej podstawy zwraca undefined bez obliczania expr; nie można użyć tego zapisu po lewej stronie przypisania. Notacja nawiasowa należy do ECMAScript, a nie do interfejsów przeglądarki. Sprawdź obsługę ?. i Object.hasOwn w docelowym środowisku.

Nawiasy nie weryfikują klucza pochodzącego z zewnątrz. Przed odczytem lub zapisem na podstawie danych z niezaufanego źródła ogranicz klucze do jawnej listy dozwolonych wartości. Samo Object.hasOwn nie sprawdza uprawnień.

Przykłady

{
  const key = "total points";
  const token = Symbol("bonus");
  const scores = { [key]: 7, [token]: 2, "1": "first" };

  console.log(`before: ${scores[key]}`);
  scores[key] = 9;
  console.log(`after: ${scores[key]}`);
  console.log(`literal key: ${scores.key}`);
  console.log(`symbol key: ${scores[token]}`);
  console.log(`numeric key: ${scores[1]}`);

  let evaluations = 0;
  const missing = null;
  console.log(`optional: ${missing?.[evaluations++]}`);
  console.log(`evaluations: ${evaluations}`);
}

Wynik

before: 7
after: 9
literal key: undefined
symbol key: 2
numeric key: first
optional: undefined
evaluations: 0

Przykład zmienia wartość pod kluczem ze spacją i pokazuje, że `scores.key` szuka dosłownego klucza `"key"`. Ostatni odczyt pomija `evaluations++`, dlatego licznik pozostaje równy `0`.

Powiązane lekcje

  • JavaScript · Lekcja 24 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 25 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 29 · Zaawansowany · Wersja: 4

Źródła