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 literalW 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