Object.keys()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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

In diesem Artikel

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 dem object gefunden werden. Dies ist das Gleiche wie das Iterieren mit einer for...in Schleife, mit dem Unterschied, dass eine for...in Schleife auch Eigenschaften in der Prototyp-Kette aufzählt. Die Reihenfolge des von Object.keys() zurückgegebenen Arrays ist die gleiche wie die, die von einer for...in Schleife bereitgestellt wird.

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

Beispiele

Verwendung von Object.keys()

js
// Basic array
const arr = ["a", "b", "c"];
console.log(Object.keys(arr)); // ['0', '1', '2']

// Array-like object
const obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.keys(obj)); // ['0', '1', '2']

// Array-like object with random key ordering
const anObj = { 100: "a", 2: "b", 7: "c" };
console.log(Object.keys(anObj)); // ['2', '7', '100']

// getFoo is a non-enumerable property
const myObj = Object.create(
  {},
  {
    getFoo: {
      value() {
        return this.foo;
      },
    },
  },
);
myObj.foo = 1;
console.log(Object.keys(myObj)); // ['foo']

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

Verwendung von Object.keys() mit Primitiven

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

js
// Strings have indices as enumerable own properties
console.log(Object.keys("foo")); // ['0', '1', '2']

// Other primitives except undefined and null have no own properties
console.log(Object.keys(100)); // []

Hinweis: In ES5 führte das Übergeben eines Nicht-Objekts an Object.keys() zu einem TypeError.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Object
Konstruktor
1. Object()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor

Object.keys()

In diesem Artikel

Probieren Sie es aus

Syntax

Parameter

Rückgabewert

Beschreibung

Beispiele

Verwendung von Object.keys()

Verwendung von Object.keys() mit Primitiven

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN