Reflect.ownKeys()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.
Die statische Methode Reflect.ownKeys() gibt ein Array mit den eigenen Property-Keys des Objekts target zurück.
Probieren Sie es aus
const object = {
property1: 42,
property2: 13,
};
const array = [];
console.log(Reflect.ownKeys(object));
// Expected output: Array ["property1", "property2"]
console.log(Reflect.ownKeys(array));
// Expected output: Array ["length"]
Syntax
Reflect.ownKeys(target)
Parameter
target-
Das Zielobjekt, dessen eigene Property-Keys abgerufen werden sollen.
Rückgabewert
Ein Array mit den eigenen Property-Keys des Objekts target, einschließlich Strings und Symbols. Bei den meisten Objekten enthält das Array die Keys in folgender Reihenfolge:
- Nicht negative ganzzahlige Indizes in aufsteigender numerischer Reihenfolge (als Strings)
- Andere String-Keys in der Reihenfolge, in der die Properties erstellt wurden
- Symbol-Keys in der Reihenfolge, in der die Properties erstellt wurden
Ausnahmen
TypeError-
Wird ausgelöst, wenn
targetkein Objekt ist.
Beschreibung
Reflect.ownKeys() ermöglicht es, alle Property-Keys eines Objekts durch Reflexion abzurufen. Es ist die einzige Möglichkeit, mit einem einzigen Aufruf und ohne zusätzliche Filterlogik alle eigenen Property-Keys zu erhalten – aufzählbare und nicht aufzählbare, Strings und Symbols. Beispielsweise übernimmt Object.getOwnPropertyNames() den Rückgabewert von Reflect.ownKeys() und filtert daraus nur die String-Werte, während Object.getOwnPropertySymbols() nur die Symbol-Werte herausfiltert. Da gewöhnliche Objekte [[OwnPropertyKeys]] so implementieren, dass alle String-Keys vor den Symbol-Keys zurückgegeben werden, ist Reflect.ownKeys(target) normalerweise gleichbedeutend mit Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target)). Wenn das Objekt jedoch über eine benutzerdefinierte [[OwnPropertyKeys]]-Methode verfügt (etwa durch den ownKeys-Handler eines Proxys), kann die Reihenfolge der Keys abweichen.
Reflect.ownKeys() ruft die objektinterne Methode [[OwnPropertyKeys]] von target auf.
Beispiele
Reflect.ownKeys() verwenden
Reflect.ownKeys({ z: 3, y: 2, x: 1 }); // [ "z", "y", "x" ]
Reflect.ownKeys([]); // ["length"]
const sym = Symbol.for("comet");
const sym2 = Symbol.for("meteor");
const obj = {
[sym]: 0,
str: 0,
773: 0,
0: 0,
[sym2]: 0,
"-1": 0,
8: 0,
"second str": 0,
};
Reflect.ownKeys(obj);
// [ "0", "8", "773", "str", "-1", "second str", Symbol(comet), Symbol(meteor) ]
// Indexes in numeric order,
// strings in insertion order,
// symbols in insertion order
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-reflect.ownkeys |