WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.fromEntries — ein Objekt aus Schlüssel-Wert-Paaren

Object.fromEntries erstellt aus einer iterierbaren Sammlung von Schlüssel-Wert-Einträgen ein neues Objekt. Es unterstützt Zeichenfolgen- und Symbolschlüssel; bei doppelten Schlüsseln bleibt der letzte Wert erhalten. Nützlich zum Umformen von Einträgen und zum Konvertieren einer Map in ein Objekt.

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.fromEntries(iterable)

Object.fromEntries(iterable) ist eine in ECMAScript 2019 eingeführte statische Methode und keine Web-API. Sie akzeptiert ein iterierbares Objekt, etwa ein Array aus Paaren oder eine Map, und gibt ein neues gewöhnliches Objekt mit Object.prototype als Prototyp zurück. Prüfe die Verfügbarkeit in der Zielumgebung mit typeof Object.fromEntries === "function"; die in einem Repository verwendete Node-Version belegt nicht die Unterstützung im Browser.

Jeder Eintrag muss ein Objekt sein: Die Methode liest dessen Eigenschaften 0 und 1 als Schlüssel und Wert aus. Die Einträge selbst müssen nicht iterierbar sein. Fehlt die Eigenschaft 1, ist der Wert undefined; zusätzliche Elemente werden ignoriert. Nicht iterierbare Eingaben oder primitive Einträge führen zu einem TypeError.

Um einen Eigenschaftsschlüssel zu erhalten, wandelt die Methode einen Schlüssel, der ein Objekt ist, zunächst in einen primitiven Wert um. Ist der primitive Wert ein Symbol, wird er unverändert verwendet; andernfalls wird er in eine Zeichenfolge umgewandelt. Wiederholen sich Schlüssel nach der Umwandlung, gilt der letzte Wert. Das Ergebnis enthält eigene Dateneigenschaften, die beschreibbar, aufzählbar und konfigurierbar sind. Ein Eintrag mit "__proto__" erstellt eine eigene Eigenschaft, statt den Prototyp zu ändern.

Ein typischer Ablauf ist Object.entries(obj), gefolgt von map oder filter und anschließend Object.fromEntries(...). Das ist jedoch keine vollständige Umkehrung: Object.entries lässt Symbole und nicht aufzählbare Eigenschaften aus, und Eigenschaftsdeskriptoren bleiben nicht erhalten. Objektwerte bleiben Referenzen – es entsteht keine tiefe Kopie.

Beispiele

const token = Symbol("token");
const entries = [["score", 10], ["score", 20], [token, "ok"]];
const result = Object.fromEntries(entries);

console.log(result.score);
console.log(result[token]);
console.log(Object.entries(result).length);

Ergebnis

20
ok
1

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