WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Eigenschaftszugriff mit berechnetem Schlüssel

Die Klammernotation `obj[expr]` wählt eine Eigenschaft anhand eines Ausdruckswerts aus. Damit lassen sich Eigenschaften lesen oder schreiben und Methoden aufrufen, deren Schlüssel erst zur Laufzeit feststehen.

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

Syntax

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

Bei obj[expr] bestimmt der Wert von expr den Eigenschaftsschlüssel. obj.key verwendet immer den Zeichenkettenschlüssel "key", obj[key] dagegen den Wert der Variablen key. Eckige Klammern erlauben auch Schlüssel mit Leerzeichen. In { [expr]: value } kennzeichnen sie einen berechneten Eigenschaftsnamen: Die Eigenschaft wird im Objektliteral definiert, nicht aus einem vorhandenen Objekt gelesen.

ToPropertyKey wandelt den Schlüsselwert in einen primitiven Wert um. Ein Symbol bleibt erhalten, jeder andere Wert wird zur Zeichenkette. Deshalb bezeichnen obj[1] und obj["1"] dieselbe Eigenschaft. Bei der Umwandlung eines Objekts als Schlüssel kann Code ausgeführt und eine Ausnahme ausgelöst werden.

Ein gewöhnlicher Lesezugriff kann der Prototypenkette folgen und einen Getter aufrufen. Eine fehlende Eigenschaft ergibt undefined, doch auch eine vorhandene kann undefined liefern. Object.hasOwn(obj, key) prüft, ob die Eigenschaft dem Objekt selbst gehört. Für obj[key] = value gelten die üblichen Zuweisungsregeln. Beim direkten Aufruf obj[key]() ist obj der Empfänger, genau wie bei obj.method().

Ein direkter Lesezugriff auf null oder undefined löst einen TypeError aus. Bei einem solchen Basiswert ergibt obj?.[expr] ohne Auswertung von expr den Wert undefined; diese Form ist kein gültiges Zuweisungsziel. Die Klammernotation gehört zu ECMAScript und ist keine Browser-API. Prüfe, ob die Zielumgebung ?. und Object.hasOwn unterstützt.

Eckige Klammern prüfen keine von außen gelieferten Schlüssel. Beschränke bei nicht vertrauenswürdigen Eingaben die Schlüssel vor dem Lesen oder Schreiben auf eine explizite Liste erlaubter Werte. Object.hasOwn allein prüft keine Berechtigungen.

Beispiele

{
  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}`);
}

Ergebnis

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

Das Beispiel ändert den Wert zu einem Schlüssel mit Leerzeichen und zeigt, dass `scores.key` nach dem wörtlichen Schlüssel `"key"` sucht. Der letzte Zugriff überspringt `evaluations++`, daher bleibt der Zähler bei `0`.

Zugehörige Lektionen

  • JavaScript · Lektion 24 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 25 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 29 · Fortgeschritten · Version: 4

Quellen