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 der eigenen Eigenschaften-Schlüssel des target Objekts 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, von dem die eigenen Schlüssel abgerufen werden sollen.
Rückgabewert
Ein Array der eigenen Eigenschaften-Schlüssel des target Objekts, einschließlich Zeichenketten und Symbole. Für die meisten Objekte wird das Array in folgender Reihenfolge sein:
- Nicht-negative Integer-Indizes in aufsteigender numerischer Reihenfolge (aber als Zeichenketten)
- Andere Zeichenkettenschlüssel in der Reihenfolge der Eigenschaftserstellung
- Symbolschlüssel in der Reihenfolge der Eigenschaftserstellung.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
targetkein Objekt ist.
Beschreibung
Reflect.ownKeys() bietet die reflektierende Semantik zum Abrufen aller Eigenschaften-Schlüssel eines Objekts. Es ist der einzige Weg, um alle eigenen Eigenschaften – aufzählbar und nicht aufzählbar, Zeichenketten 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 zu Zeichenkettenwerten, während Object.getOwnPropertySymbols() nur zu Symbolwerten filtert. Da normale Objekte [[OwnPropertyKeys]] implementieren, um alle Zeichenkettenschlüssel vor Symbolschlü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 (wie zum Beispiel durch den ownKeys Handler eines Proxys), kann die Reihenfolge der Schlüssel unterschiedlich sein.
Reflect.ownKeys() ruft die [[OwnPropertyKeys]] Objektinterne Methode 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
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-reflect.ownkeys |