CKTIS / JavaScript
Reflect.ownKeys — alle eigenen Property-Schlüssel
Reflect.ownKeys(target) verlangt ein Objekt. Bei einem gewöhnlichen Objekt gibt die Methode alle eigenen Schlüssel als Array zurück: Zeichenfolgen und Symbole, auch für nicht aufzählbare Properties. Geerbte Properties werden ausgelassen. Die ownKeys-Falle eines Proxy kann ändern, welche Schlüssel zurückgegeben werden.
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
Reflect.ownKeys(target)Reflect.ownKeys(target) erstellt ein neues Array mit Schlüsseln. Ist target ein gewöhnliches Objekt, enthält das Array die Schlüssel aller eigenen Properties, sowohl aufzählbarer als auch nicht aufzählbarer. Die Elemente sind Zeichenfolgen oder Symbole, nicht die Werte der Properties. Die Prototypkette wird nicht durchsucht. Ein Argument, das kein Objekt ist, einschließlich null oder einer Zeichenfolge, führt zu einem TypeError; es wird nicht automatisch in ein Objekt umgewandelt.
Bei gewöhnlichen Objekten kommen zuerst Schlüssel, die Array-Indizes sind, in aufsteigender numerischer Reihenfolge, danach andere Zeichenfolgen in der Reihenfolge, in der die Properties erstellt wurden, und zuletzt Symbole in der Reihenfolge, in der die zugehörigen Properties erstellt wurden. Daher steht "2" vor "10", auch wenn sie in umgekehrter Reihenfolge hinzugefügt wurden; die Schlüssel selbst bleiben Zeichenfolgen.
Im Gegensatz dazu gibt Object.keys nur aufzählbare Zeichenfolgenschlüssel zurück. Object.getOwnPropertyNames umfasst eigene Zeichenfolgenschlüssel, während Object.getOwnPropertySymbols eigene Symbole umfasst. Verwende Reflect.ownKeys, wenn du beide Schlüsselarten ohne Filterung nach Aufzählbarkeit benötigst.
Die Methode ruft die interne Operation [[OwnPropertyKeys]] auf. Bei einem Proxy kann dadurch die ownKeys-Falle ausgelöst werden; somit kann Benutzercode ausgeführt, eine Ausnahme ausgelöst oder eine andere zulässige Reihenfolge als bei einem gewöhnlichen Objekt zurückgegeben werden. Die Falle kann auch die Schlüsselmenge ändern: Ist das Zielobjekt des Proxy erweiterbar, darf sie Schlüssel konfigurierbarer eigener Properties auslassen oder zusätzliche Schlüssel melden, für die das Zielobjekt keinen eigenen Property-Deskriptor hat. Die Schlüssel nicht konfigurierbarer eigener Properties müssen enthalten sein. Ist das Zielobjekt nicht erweiterbar, muss die zurückgegebene Schlüsselmenge genau der Menge seiner eigenen Schlüssel entsprechen. Gehe nicht davon aus, dass jedes exotische Objekt die gewöhnliche Reihenfolge verwendet. Dies ist eine ECMAScript-Sprach-API; allein das Vorhandensein von Node 24 in einem Repository belegt keine Unterstützung im Zielbrowser.
Beispiele
const tag = Symbol("tag");
const target = Object.create({ inherited: true });
target["10"] = "ten";
target["2"] = "two";
target.name = "Ada";
Object.defineProperty(target, "hidden", { value: 42 });
target[tag] = "metadata";
const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);Ergebnis
2 | 10 | name | hidden | Symbol(tag) true
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.