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

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