WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.getOwnPropertyNames — Namen eigener Eigenschaften

Object.getOwnPropertyNames(obj) gibt ein neues Array mit Zeichenfolgeschlüsseln zurück. Bei gewöhnlichen Objekten sind es die Schlüssel aller eigenen Eigenschaften mit Zeichenfolgeschlüsseln, auch der nicht aufzählbaren. Symbol-Schlüssel werden ausgelassen; bei einem Proxy kann die ownKeys-Falle die Liste beeinflussen.

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.getOwnPropertyNames(obj)

Object.getOwnPropertyNames(obj) ist eine statische Methode: Rufe sie auf Object auf, nicht auf dem untersuchten Objekt. Sie gibt ein neues Array zurück, das nur die Zeichenfolgeschlüssel aus dem Ergebnis der internen Operation [[OwnPropertyKeys]] enthält, ohne Eigenschaftsdeskriptoren zu prüfen. Bei gewöhnlichen Objekten sind das alle eigenen Zeichenfolgeschlüssel unabhängig vom Attribut enumerable, aber keine Schlüssel geerbter Eigenschaften. Die Methode gibt Schlüssel zurück, keine Eigenschaftswerte.

Bei gewöhnlichen Objekten berücksichtigt Object.keys(obj) nur aufzählbare eigene Eigenschaften mit Zeichenfolgeschlüsseln. Object.getOwnPropertySymbols(obj) gibt eigene Symbol-Schlüssel zurück, während Reflect.ownKeys(obj) sowohl eigene Zeichenfolgeschlüssel als auch eigene Symbol-Schlüssel zurückgibt, einschließlich der Schlüssel nicht aufzählbarer Eigenschaften. „Eigen“ und „aufzählbar“ bezeichnen unterschiedliche Merkmale.

Bei gewöhnlichen Objekten erscheinen Namen, die Array-Indizes sind, zuerst in aufsteigender numerischer Reihenfolge; die übrigen Zeichenfolgeschlüssel folgen in der Reihenfolge, in der die Eigenschaften erstellt wurden. Das ist keine alphabetische Sortierung. Proxy-Objekte können die Liste und Reihenfolge über die ownKeys-Falle anpassen, soweit die Einschränkungen der Spezifikation eingehalten werden. Ist das Zielobjekt erweiterbar, kann die Falle einen Zeichenfolgeschlüssel ohne zugehörigen Deskriptor einer eigenen Eigenschaft melden oder den Zeichenfolgeschlüssel einer konfigurierbaren eigenen Eigenschaft des Zielobjekts weglassen.

null und undefined verursachen einen TypeError; andere primitive Werte werden in Objekte umgewandelt. Das Beispiel zeigt die Reihenfolge der Indizes und die Aufnahme von hidden, das bei dieser Verwendung von Object.defineProperty standardmäßig nicht aufzählbar ist. Die Eigenschaft inherited und der Symbol-Schlüssel werden ausgelassen.

Beispiele

const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';

console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));

Ergebnis

["2","10","label","hidden"]
["2","10","label"]

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