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

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 der Reihenfolge sein von:

  1. Nicht-negative Ganzzahlindizes in aufsteigender numerischer Reihenfolge (aber als Strings)
  2. Andere Zeichenfolgeschlüssel in der Reihenfolge der Erstellung der Eigenschaften
  3. Symbolschlüssel in der Reihenfolge der Erstellung der Eigenschaften.

Ausnahmen

TypeError

Wird ausgelöst, wenn target kein Objekt ist.

Beschreibung

Reflect.ownKeys() bietet die reflektive Semantik zum Abrufen aller Eigenschaften-Schlüssel eines Objekts. Es ist der einzige Weg, um alle eigenen Eigenschaften – aufzählbar und nicht aufzählbar, Strings 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 String-Werte, während Object.getOwnPropertySymbols() nur Symbolwerte filtert. Da normale Objekte [[OwnPropertyKeys]] implementieren, um alle String-Schlüssel vor Symbolschlüsseln zurückzugeben, ist Reflect.ownKeys(target) normalerweise äquivalent zu Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target)). Wenn das Objekt jedoch eine benutzerdefinierte [[OwnPropertyKeys]]-Methode hat (wie durch einen Proxy's ownKeys Handler), kann die Reihenfolge der Schlüssel abweichen.

Reflect.ownKeys() ruft die [[OwnPropertyKeys]] interne Objektmethode 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 Language Specification
# sec-reflect.ownkeys

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch