Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Obliczane klucze właściwości i metod

Nawiasy kwadratowe w definicji właściwości lub metody pozwalają wyznaczyć jej klucz z wyrażenia. Klucz jest ustalany podczas tworzenia obiektu; późniejsza zmiana użytej zmiennej nie zmienia nazwy właściwości.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

({ [keyExpression]: value, [methodKeyExpression](parameters) { /* body */ } })

W literale obiektu zapis [expression]: value oblicza wyrażenie i używa wyniku jako klucza właściwości. Zapis [expression](parameters) {} definiuje metodę o obliczanej nazwie, bez dwukropka ani słowa function. Ta składnia nazw metod działa również w klasach.

Przy wyznaczaniu klucza właściwości JavaScript najpierw konwertuje obiekt na wartość prymitywną. Jeśli otrzymana lub już prymitywna wartość jest symbolem, staje się kluczem bez zmian. W przeciwnym razie JavaScript konwertuje ją na łańcuch znaków. Dlatego [1] i ["1"] oznaczają ten sam klucz, a w przypadku standardowego obiektu opakowującego symbol kluczem jest sam symbol, nie łańcuch znaków. W literale obiektu wyrażenie klucza jest obliczane podczas tworzenia obiektu, a nie przy każdym odczycie.

Odróżniaj definicję { [key]: value } od dostępu obj[key]. Zapis { key: value } używa dosłownej nazwy key, a obj.key odczytuje tę właśnie nazwę, nie wartość zmiennej. Nawiasy są potrzebne także przy wywołaniu metody, której nazwę przechowuje zmienna: obj[methodKey]().

Składnia pochodzi z ECMAScript 2015 i jest szeroko obsługiwana przez współczesne przeglądarki; nie wymaga Web API. JSON nie dopuszcza obliczanych kluczy ani metod. Szczególny przypadek: ["__proto__"]: value tworzy zwykłą własną właściwość, natomiast __proto__: value w literale obiektu jest składnią ustawiania prototypu.

Identyfikatory objęte tym wpisem: Computed property and method keys.

Przykłady

let key = "score";
const methodKey = "read";
const record = {
  [key]: 7,
  [methodKey]() {
    return this.score;
  },
};
key = "other";
console.log(record.score);
console.log(record[methodKey]());
console.log(record[key]);

Wynik

7
7
undefined

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła