WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.values — Werte der eigenen Eigenschaften eines Objekts

Object.values(obj) gibt ein neues Array mit den Werten eigener, aufzählbarer Eigenschaften mit Zeichenfolgen als Schlüsseln zurück. Geerbte und nicht aufzählbare Eigenschaften sowie Symbol-Schlüssel werden ausgeschlossen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Object.values(obj)

Object.values(obj) ist eine statische Methode: Rufe sie auf Object auf, nicht auf dem untersuchten Objekt. Sie gibt ein neues Array zurück, das ausschließlich die Werte eigener, aufzählbarer Eigenschaften mit Zeichenfolgen als Schlüsseln enthält. Schlüssel oder Schlüssel-Wert-Paare gibt sie nicht zurück. Geerbte Eigenschaften, nicht aufzählbare Eigenschaften und Eigenschaften mit Symbol-Schlüsseln werden ausgeschlossen.

Bei gewöhnlichen Objekten werden Schlüssel, die Array-Indizes sind, zuerst in aufsteigender numerischer Reihenfolge verarbeitet; die übrigen Zeichenfolgenschlüssel folgen in der Reihenfolge, in der die Eigenschaften erstellt wurden. Das ist weder eine Sortierung der Werte noch eine alphabetische Sortierung der Schlüssel. Im Beispiel steht der Schlüssel 2 vor 10, und beide stehen vor label.

Das Argument wird in ein Objekt umgewandelt. null und undefined lösen einen TypeError aus; eine Zeichenfolge stellt aufzählbare indexierte Eigenschaften bereit, sodass Object.values("abc") zu ["a","b","c"] führt. Gewöhnliche Zahlen- und boolesche Primitive haben keine eigenen aufzählbaren Eigenschaften und ergeben daher [].

Ein neues Array bedeutet keine tiefe Kopie: Einträge mit Objektwerten bleiben Verweise auf dieselben Objekte. Beim Lesen der Werte werden Getter aufgerufen, die Nebenwirkungen haben oder Ausnahmen auslösen können. Die Methode selbst schreibt keine Eigenschaften des Quellobjekts, aber während des Lesens aufgerufener Code kann sie ändern.

Beispiele

const record = Object.create({ inherited: "ignored" });
record.label = "item";
record[10] = "ten";
record[2] = "two";
Object.defineProperty(record, "hidden", { value: "ignored" });
record[Symbol("secret")] = "ignored";

console.log(JSON.stringify(Object.values(record)));

Ergebnis

["two","ten","item"]

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen