Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

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

Notacja nawiasowa `obj[expr]` pozwala odczytać lub przypisać właściwość wybraną przez wyrażenie, zamiast używać stałej nazwy po kropce.

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

Składnia

obj[expr]             // read using a computed key
obj[expr] = value     // assign using a computed key
obj?.[expr]           // optional computed access
obj.name              // access the fixed string key "name"
({ [expr]: value })   // define a property in an object literal

W zapisie obj[expr] JavaScript oblicza wartość wyrażenia expr i na jej podstawie wybiera właściwość do odczytu lub przypisania. Zapis obj.key zawsze oznacza klucz "key"; obj[key] korzysta z wartości zmiennej key. Natomiast { [expr]: value } definiuje właściwość podczas tworzenia obiektu, a nie odczytuje jej z istniejącego obiektu.

Konwersja ToPropertyKey najpierw sprowadza wartość klucza do wartości pierwotnej. Jeśli wynikiem jest Symbol, zachowuje go; w przeciwnym razie zamienia wynik na napis. Dlatego obj[1] i obj["1"] wskazują tę samą właściwość. Notacja nawiasowa obsługuje napisy ze spacjami, ale obj["#secret"] nie daje dostępu do prywatnego pola klasy #secret.

W zwykłym obiekcie odczyt może znaleźć właściwość odziedziczoną lub wywołać getter. Brak właściwości w całym łańcuchu prototypów daje undefined, tak samo jak odczyt właściwości o wartości undefined. Użyj Object.hasOwn(obj, key), aby sprawdzić, czy właściwość należy bezpośrednio do obiektu. W przypadku kluczy z niezaufanych danych sprawdzaj je względem listy dozwolonych kluczy przed odczytem lub zapisem; samo Object.hasOwn nie zastępuje takiej kontroli.

Zwykły odczyt z null lub undefined zgłasza TypeError, jeśli wcześniej nie wystąpi inny błąd. Zapis obj?.[expr] zwraca undefined dla takiej podstawy bez obliczania expr. Nie przechwytuje błędów gettera i nie może być celem przypisania. To składnia JavaScriptu, nie interfejs DOM; w starszych środowiskach sprawdź obsługę ?. i Object.hasOwn.

Przykłady

{
  const key = "display count";
  const tag = Symbol("status");
  const obj = { key: 0, [key]: 2, [tag]: "ready" };

  obj[key] = obj[key] + 1;
  console.log(obj[key]);
  console.log(obj.key);
  console.log(obj[tag]);

  const absent = null;
  console.log(String(absent?.[key]));
}

Wynik

3
0
ready
undefined

`obj[key]` zmienia wartość z `2` na `3`, ale `obj.key` nadal daje `0`. `obj[tag]` odczytuje `ready` spod klucza typu `Symbol`, a dostęp opcjonalny na `null` daje `undefined`.

Powiązane lekcje

  • JavaScript · Lekcja 38 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 44 · Zaawansowany · Wersja: 4

Źródła