Reflect.ownKeys()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Die Reflect.ownKeys()
statische Methode gibt ein Array der eigenen Eigenschaften-Schlüssel des target
Objekts zurück.
Probieren Sie es aus
const object1 = {
property1: 42,
property2: 13,
};
const array1 = [];
console.log(Reflect.ownKeys(object1));
// Expected output: Array ["property1", "property2"]
console.log(Reflect.ownKeys(array1));
// Expected output: Array ["length"]
Syntax
Reflect.ownKeys(target)
Parameter
target
-
Das Zielobjekt, von dem die eigenen Schlüssel abgerufen werden sollen.
Rückgabewert
Ein Array
der eigenen Eigenschaften-Schlüssel des target
Objekts, einschließlich Strings und Symbole. Für die meisten Objekte wird das Array in folgender Reihenfolge sein:
- Nicht-negative ganzzahlige Indizes in aufsteigender numerischer Reihenfolge (aber als Strings)
- Andere String-Schlüssel in der Reihenfolge ihrer Erstellung
- Symbol-Schlüssel in der Reihenfolge ihrer Erstellung.
Ausnahmen
TypeError
-
Ausgelöst, wenn
target
kein Objekt ist.
Beschreibung
Reflect.ownKeys()
liefert die reflektive Semantik zum Abrufen aller Eigenschaften-Schlüssel eines Objekts. Es ist der einzige Weg, um alle eigenen Eigenschaften – sowohl aufzählbare als auch nicht aufzählbare, Strings und Symbole – in einem Aufruf zu erhalten, ohne zusätzliche Filterlogik zu verwenden. Zum Beispiel nimmt Object.getOwnPropertyNames()
den Rückgabewert von Reflect.ownKeys()
und filtert nur String-Werte heraus, während Object.getOwnPropertySymbols()
nur Symbolwerte herausfiltert. Da normale Objekte [[OwnPropertyKeys]]
implementieren, um alle String-Schlüssel vor den Symbol-Schlüsseln zurückzugeben, ist Reflect.ownKeys(target)
normalerweise gleichbedeutend mit Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target))
. Wenn das Objekt jedoch eine benutzerdefinierte [[OwnPropertyKeys]]
-Methode hat (z. B. durch den ownKeys
-Handler eines Proxys), kann die Reihenfolge der Schlüssel abweichen.
Reflect.ownKeys()
ruft die [[OwnPropertyKeys]]
interne Methode eines Objekts von target
auf.
Beispiele
Verwendung von Reflect.ownKeys()
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
Specification |
---|
ECMAScript® 2025 Language Specification # sec-reflect.ownkeys |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ownKeys |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support