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 Eigenschaftsschlü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 Eigenschaftsschlüssel des target-Objekts, einschließlich Zeichenfolgen und Symbole. Für die meisten Objekte wird das Array in folgender Reihenfolge vorliegen:

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

Ausnahmen

TypeError

Wird ausgelöst, wenn target kein Objekt ist.

Beschreibung

Reflect.ownKeys() bietet die reflektive Semantik, um alle Eigenschaftsschlüssel eines Objekts abzurufen. Es ist der einzige Weg, um alle eigenen Eigenschaften – aufzählbare und nicht aufzählbare, Zeichenfolgen und Symbole – in einem Aufruf abzurufen, ohne zusätzliche Filterlogik. Beispielsweise nimmt Object.getOwnPropertyNames() den Rückgabewert von Reflect.ownKeys() und filtert nur Zeichenfolgenwerte, während Object.getOwnPropertySymbols() nur Symbolwerte filtert. Da normale Objekte [[OwnPropertyKeys]] implementieren, um alle Zeichenfolgen-Schlüssel vor Symbol-Schlüsseln zurückzugeben, ist Reflect.ownKeys(target) normalerweise äquivalent zu Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target)). Wenn das Objekt jedoch über eine benutzerdefinierte [[OwnPropertyKeys]]-Methode verfügt (wie zum Beispiel durch einen Proxy-Handler ownKeys), kann die Reihenfolge der Schlüssel unterschiedlich sein.

Reflect.ownKeys() ruft die [[OwnPropertyKeys]]-Methode interne Objekte 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

BCD tables only load in the browser

Siehe auch