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 Zeichenfolgen und Symbole. Für die meisten Objekte wird das Array in folgender Reihenfolge sein:

Nicht-negative ganzzahlige Indizes in aufsteigender numerischer Reihenfolge (aber als Zeichenfolgen)
Andere Zeichenfolgen-Schlüssel in der Reihenfolge ihrer Erstellung
Symbol-Schlüssel in der Reihenfolge ihrer Erstellung.

Ausnahmen

TypeError: Wird ausgelöst, wenn target kein Objekt ist.

Reflect.ownKeys() bietet die reflektierende Semantik zum Abrufen aller Eigenschaften-Schlüssel eines Objekts. Es ist die einzige Möglichkeit, um alle eigenen Eigenschaften – aufzählbar und nicht aufzählbar, Zeichenfolgen und Symbole – in einem einzigen Aufruf zu erhalten, ohne zusätzliches Filter-Logik. Zum Beispiel nimmt Object.getOwnPropertyNames() den Rückgabewert von Reflect.ownKeys() und filtert nur die Zeichenfolgenwerte, während Object.getOwnPropertySymbols() nur die Symbolwerte filtert. Da normale Objekte [[OwnPropertyKeys]] implementieren, um zuerst alle Zeichenfolgen-Schlüssel zurückzugeben, bevor Symbol-Schlüssel, ist Reflect.ownKeys(target) normalerweise äquivalent zu Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target)). Wenn jedoch das Objekt eine benutzerdefinierte [[OwnPropertyKeys]]-Methode hat (wie zum Beispiel durch einen Proxy's ownKeys Handler), kann die Reihenfolge der Schlüssel unterschiedlich sein.

Reflect.ownKeys() ruft die [[OwnPropertyKeys]] interne Objektmethode des target ab.

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® 2026 Language Specification # sec-reflect.ownkeys