Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Object.fromEntries — criar um objeto a partir de pares chave-valor

Object.fromEntries cria um novo objeto a partir de uma coleção iterável de entradas chave-valor. Suporta chaves de texto e símbolos; quando uma chave se repete, mantém o último valor. É útil para transformar entradas ou converter uma Map num objeto.

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

Sintaxe

Object.fromEntries(iterable)

Object.fromEntries(iterable) é um método estático introduzido no ECMAScript 2019, não uma API Web. Aceita um objeto iterável, como um array de pares ou uma Map, e devolve um novo objeto comum cujo protótipo é Object.prototype. Verifique a disponibilidade no ambiente de destino com typeof Object.fromEntries === "function"; a versão de Node utilizada num repositório não comprova o suporte nos browsers.

Cada entrada tem de ser um objeto: o método lê as propriedades 0 e 1 como chave e valor. As entradas não têm de ser iteráveis. Se faltar a propriedade 1, o valor resultante é undefined; os elementos adicionais são ignorados. Um argumento não iterável ou uma entrada que seja um valor primitivo causa um TypeError.

Para obter uma chave de propriedade, o método começa por converter a chave num valor primitivo se esta for um objeto. Se o valor primitivo for um símbolo, é usado sem alterações; caso contrário, é convertido numa cadeia de texto. Se as chaves se repetirem depois da conversão, prevalece o último valor. O resultado tem propriedades de dados próprias, graváveis, enumeráveis e configuráveis. Uma entrada "__proto__" cria uma propriedade própria em vez de alterar o protótipo.

Um fluxo de trabalho comum é Object.entries(obj), seguido de map ou filter e, por fim, Object.fromEntries(...). No entanto, não é uma inversão completa: Object.entries omite símbolos e propriedades não enumeráveis, e os descritores não são preservados. Os valores que são objetos continuam a ser referências — não é criada uma cópia profunda.

Exemplos

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);

Resultado

20
ok
1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes