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

CKTIS / JavaScript

Object.entries: pares próprios chave–valor

Object.entries devolve um novo array de pares para propriedades próprias enumeráveis cujas chaves são texto.

Versão: ECMAScript 2017 onward; example target: Node.js 24.22.2

Sintaxe

Object.entries(value)

Object.entries(value) começa por executar ToObject: null e undefined lançam TypeError, enquanto as restantes primitivas são encapsuladas. Assim, um texto produz pares para os índices enumeráveis dos caracteres. O resultado é um novo array de arrays [key, value], com chaves de texto.

Inclui apenas propriedades próprias enumeráveis com chaves de texto. Chaves symbol, propriedades herdadas e não enumeráveis são omitidas. A ordem segue OwnPropertyKeys: índices de array sobem numericamente e as restantes chaves de texto preservam a ordem de criação.

O método existe desde ECMAScript 2017. A lista de chaves é primeiro capturada, mas para cada chave o método volta a verificar o seu descritor próprio atual e depois obtém o valor. Getters e traps Proxy podem alterar o objeto, apagar chaves posteriores ou lançar; o resultado não é uma fotografia atómica dos valores.

Exemplos

const symbol = Symbol("skip");
const proto = { inherited: "skip" };
const record = Object.create(proto);
Object.defineProperty(record, "first", {
  enumerable: true,
  configurable: true,
  get() { delete record.later; return "A"; }
});
record.later = "B";
record[2] = "two";
record[1] = "one";
Object.defineProperty(record, "hidden", { value: 0 });
record[symbol] = "symbol";
console.log(JSON.stringify(Object.entries(record)));
console.log(JSON.stringify(Object.entries("hi")));
try { Object.entries(null); } catch (error) { console.log(error.name); }

Resultado

[["1","one"],["2","two"],["first","A"]]
[["0","h"],["1","i"]]
TypeError

O exemplo mostra ordem, omissão de símbolos e herança e um getter que apaga uma chave posterior.

Fontes