Object.keys()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

Die statische MethodeObject.keys() gibt ein Array der eigenen aufzählbaren, mit String-Schlüssel versehenen Eigenschaftsnamen eines gegebenen Objekts zurück.

Probieren Sie es aus

const object = {  a: "some string",  b: 42,  c: false,};console.log(Object.keys(object));// Expected output: Array ["a", "b", "c"]

Syntax

Object.keys(obj)

Rückgabewert

Ein Array von Strings, die die eigenen aufzählbaren, mit String-Schlüssel versehenen Eigenschaftenschlüssel des gegebenen Objekts darstellen.

Object.keys() gibt ein Array zurück, dessen Elemente Strings sind, die den aufzählbaren, mit String-Schlüssel versehenen Eigenschaftsnamen entsprechen, die direkt auf demobject gefunden werden. Dies ist das Gleiche wie das Iterieren mit einerfor...in Schleife, mit dem Unterschied, dass einefor...in Schleife auch Eigenschaften in der Prototyp-Kette aufzählt. Die Reihenfolge des vonObject.keys() zurückgegebenen Arrays ist die gleiche wie die, die von einerfor...in Schleife bereitgestellt wird.

Wenn Sie die Eigenschaftswerte benötigen, verwenden Sie stattdessenObject.values(). Wenn Sie sowohl die Eigenschaftsschlüssel als auch die Werte benötigen, verwenden Sie stattdessenObject.entries().

Beispiele

Verwendung von Object.keys()

// Basic arrayconst arr = ["a", "b", "c"];console.log(Object.keys(arr)); // ['0', '1', '2']// Array-like objectconst obj = { 0: "a", 1: "b", 2: "c" };console.log(Object.keys(obj)); // ['0', '1', '2']// Array-like object with random key orderingconst anObj = { 100: "a", 2: "b", 7: "c" };console.log(Object.keys(anObj)); // ['2', '7', '100']// getFoo is a non-enumerable propertyconst myObj = Object.create(  {},  {    getFoo: {      value() {        return this.foo;      },    },  },);myObj.foo = 1;console.log(Object.keys(myObj)); // ['foo']

Wenn Siealle mit String-Schlüssel versehenen eigenen Eigenschaften, einschließlich nicht aufzählbarer, wünschen, sieheObject.getOwnPropertyNames().

Verwendung von Object.keys() mit Primitiven

Nicht-Objekt-Argumente werdenzu Objekten gezwungen.undefined undnull können nicht zu Objekten gezwungen werden und werfen sofort einenTypeError. Nur Strings können eigene aufzählbare Eigenschaften haben, während alle anderen Primitiven ein leeres Array zurückgeben.

// Strings have indices as enumerable own propertiesconsole.log(Object.keys("foo")); // ['0', '1', '2']// Other primitives except undefined and null have no own propertiesconsole.log(Object.keys(100)); // []

Hinweis:In ES5 führte das Übergeben eines Nicht-Objekts anObject.keys() zu einemTypeError.