Object.entries()
Experimental: Esta é uma tecnologia experimental
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.
O método Object.entries()
retorna uma array dos próprios pares [key, value]
enumeráveis de um dado objeto, na mesma ordem dos objetos providos através do loop for...in
(sendo a diferença que o for-in loop enumera também propriedades dispostas na cadeia de prototipagem - prototype chain).
Sintaxe
Object.entries(obj)
Parâmetros
obj
-
O objeto cujos próprios pares
[key, value]
de propriedades enumeráveis deverão ser retornados.
Valor de retorno
Uma array de pares [key, value]
enumeráveis de propriedades de um dado objeto.
Descrição
Object.entries()
retorna um array cujos elementos são também arrays correspondentes aos pares de propriedades [key, value]
enumeráveis encontrados diretamente sobre o objeto. A ordem das propriedades é a mesma que seria se fossem iteradas as propriedades do objeto manualmente.
Exemplos
var obj = { foo: "bar", baz: 42 };
console.log(Object.entries(obj)); // [ ['foo', 'bar'], ['baz', 42] ]
// objeto array-like
var obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.entries(obj)); // [ ['0', 'a'], ['1', 'b'], ['2', 'c'] ]
// objeto array-like com ordenação aleatória de chave (key)
var an_obj = { 100: "a", 2: "b", 7: "c" };
console.log(Object.entries(an_obj)); // [ ['2', 'b'], ['7', 'c'], ['100', 'a'] ]
// getFoo é uma propriedade que não é enumerável
var my_obj = Object.create(
{},
{
getFoo: {
value: function () {
return this.foo;
},
},
},
);
my_obj.foo = "bar";
console.log(Object.entries(my_obj)); // [ ['foo', 'bar'] ]
// argumento não-objeto será convertido (conversão implícita) para um objeto
console.log(Object.entries("foo")); // [ ['0', 'f'], ['1', 'o'], ['2', 'o'] ]
// itera graciosamente através de chave-valor (key-value)
var obj = { a: 5, b: 7, c: 9 };
for (var [key, value] of Object.entries(obj)) {
console.log(key + " " + value); // "a 5", "b 7", "c 9"
}
// Ou, usando array extras
Object.entries(obj).forEach(([key, value]) => {
console.log(key + " " + value); // "a 5", "b 7", "c 9"
});
Convertendo um Object
em um Map
Polyfill
Para incluir suporte ao Object.entries
em ambientes mais antigos, você pode achar um Polyfill nos repositórios: tc39/proposal-object-values-entries e es-shims/Object.entries.
Especificações
Specification |
---|
ECMAScript Language Specification # sec-object.entries |
Compatibilidade com navegadores
BCD tables only load in the browser