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

js
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:

  1. Nicht-negative ganzzahlige Indizes in aufsteigender numerischer Reihenfolge (aber als Strings)
  2. Andere String-Schlüssel in der Reihenfolge ihrer Erstellung
  3. 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()

js
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 GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
ownKeys

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch