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.