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

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 target kein Objekt ist.

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

Specification
ECMAScript® 2026 Language Specification # sec-reflect.ownkeys