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 statische Methode Reflect.ownKeys()
gibt ein Array der eigenen Eigenschaften-Schlüssel des target
Objekts zurück.
Probieren Sie es aus
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 der Reihenfolge sein von:
- Nicht-negative Ganzzahlindizes in aufsteigender numerischer Reihenfolge (aber als Strings)
- Andere Zeichenfolgeschlüssel in der Reihenfolge der Erstellung der Eigenschaften
- Symbolschlüssel in der Reihenfolge der Erstellung der Eigenschaften.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn
target
kein Objekt ist.
Beschreibung
Reflect.ownKeys()
bietet die reflektive Semantik zum Abrufen aller Eigenschaften-Schlüssel eines Objekts. Es ist der einzige Weg, um alle eigenen Eigenschaften – aufzählbar und nicht aufzählbar, Strings und Symbole – in einem Aufruf zu erhalten, ohne zusätzliche Filterlogik. Zum Beispiel nimmt Object.getOwnPropertyNames()
den Rückgabewert von Reflect.ownKeys()
und filtert nur String-Werte, während Object.getOwnPropertySymbols()
nur Symbolwerte filtert. Da normale Objekte [[OwnPropertyKeys]]
implementieren, um alle String-Schlüssel vor Symbolschlüsseln zurückzugeben, ist Reflect.ownKeys(target)
normalerweise äquivalent zu Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target))
. Wenn das Objekt jedoch eine benutzerdefinierte [[OwnPropertyKeys]]
-Methode hat (wie durch einen Proxy's ownKeys
Handler), kann die Reihenfolge der Schlüssel abweichen.
Reflect.ownKeys()
ruft die [[OwnPropertyKeys]]
interne Objektmethode 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 Language Specification # sec-reflect.ownkeys |
Browser-Kompatibilität
BCD tables only load in the browser