Object.fromEntries()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The Object.fromEntries()
static method transforms a list of key-value pairs into an object.
Try it
Syntax
Object.fromEntries(iterable)
Parameters
Return value
A new object whose properties are given by the entries of the iterable.
Description
The Object.fromEntries()
method takes a list of key-value pairs and returns a new object whose properties are given by those entries. The iterable
argument is expected to be an object that implements an [Symbol.iterator]()
method. The method returns an iterator object that produces two-element array-like objects. The first element is a value that will be used as a property key, and the second element is the value to associate with that property key.
Object.fromEntries()
performs the reverse of Object.entries()
, except that Object.entries()
only returns string-keyed properties, while Object.fromEntries()
can also create symbol-keyed properties.
Note:
Unlike Array.from()
, Object.fromEntries()
does not use the value of this
, so calling it on another constructor does not create objects of that type.
Examples
Converting a Map to an Object
Converting an Array to an Object
Object transformations
With Object.fromEntries
, its reverse method Object.entries()
, and array manipulation methods, you are able to transform objects like this:
const object1 = { a: 1, b: 2, c: 3 };
const object2 = Object.fromEntries(
Object.entries(object1).map(([key, val]) => [key, val * 2]),
);
console.log(object2);
// { a: 2, b: 4, c: 6 }
Specifications
Specification |
---|
ECMAScript Language Specification # sec-object.fromentries |
Browser compatibility
BCD tables only load in the browser