Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Object.entries: pares propios de clave y valor

Object.entries devuelve un array nuevo de pares para propiedades propias enumerables cuyas claves son texto.

Versión: ECMAScript 2017 onward; example target: Node.js 24.22.2

Sintaxis

Object.entries(value)

Object.entries(value) primero ejecuta ToObject: null y undefined lanzan TypeError, mientras las demás primitivas se envuelven. Por eso un texto produce pares para sus índices de caracteres enumerables. El resultado es un array nuevo de arrays [key, value], con claves de texto.

Solo incluye propiedades propias enumerables con claves de texto. Omite símbolos, propiedades heredadas y no enumerables. El orden sigue OwnPropertyKeys: los índices de array ascienden numéricamente y las demás claves de texto conservan su orden de creación.

El método existe desde ECMAScript 2017. Primero obtiene una instantánea de las claves, pero para cada una vuelve a comprobar su descriptor propio actual y luego obtiene su valor. Getters y trampas Proxy pueden modificar el objeto, borrar claves posteriores o lanzar; el resultado no es una instantánea atómica de valores.

Ejemplos

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

El ejemplo muestra el orden, la omisión de símbolos y herencia, y un getter que borra una clave posterior.

Fuentes