WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.keys — eigene aufzählbare Objektschlüssel

Object.keys(obj) gibt ein neues Array mit den eigenen aufzählbaren Zeichenfolgeschlüsseln eines Objekts zurück. Geerbte, nicht aufzählbare Eigenschaften und Symbol-Schlüssel werden ausgeschlossen. Bei gewöhnlichen Objekten stehen Schlüssel, die Array-Indizes sind, vor den übrigen Zeichenfolgeschlüsseln.

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

Syntax

Object.keys(obj)

Object.keys(obj) ist eine statische Methode von Object, die ein neues Array mit Eigenschaftsnamen zurückgibt. Sie berücksichtigt nur eigene Eigenschaften, also solche, die nicht von einem Prototyp geerbt wurden, deren Attribut enumerable auf true gesetzt ist und deren Schlüssel eine Zeichenfolge ist. Das Ergebnis enthält Zeichenfolgen, auch wenn die Schlüssel als Zahlen geschrieben wurden. Symbol-Schlüssel werden ausgeschlossen.

Bei gewöhnlichen Objekten stehen Schlüssel, die Array-Indizes sind, in aufsteigender numerischer Reihenfolge vor den übrigen Zeichenfolgeschlüsseln, die nach der Reihenfolge der Eigenschaftserstellung angeordnet sind. Das ist weder eine alphabetische Sortierung noch eine Regel für jede wie eine Zahl aussehende Zeichenfolge: "02" ist kein Array-Index. Proxy-Objekte können die Reihenfolge beeinflussen und während der Aufzählung Code ausführen.

Anders als for...in berücksichtigt die Methode keine geerbten aufzählbaren Eigenschaften. Reflect.ownKeys(obj) schließt dagegen auch eigene, nicht aufzählbare Eigenschaften und Symbol-Schlüssel ein. Object.keys selbst liest keine Eigenschaftswerte und ruft deren Getter nicht auf; das zurückgegebene Array wird bei Änderungen am Objekt nicht aktualisiert.

null und undefined führen zu einem TypeError. Andere primitive Werte werden in Objekte umgewandelt: Object.keys("ab") ergibt ["0","1"], während Object.keys(42) [] ergibt. Dies ist eine ECMAScript-Sprach-API, keine Browser-API; die Ausführung des Beispiels in Node.js belegt nicht die Kompatibilität mit einem bestimmten Browser.

Beispiele

const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;

console.log(JSON.stringify(Object.keys(item)));

Ergebnis

["2","10","name"]

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen