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

CKTIS / JavaScript

Object.keys — claves propias enumerables de un objeto

Object.keys(obj) devuelve un nuevo array con las claves propias enumerables de un objeto, en forma de cadenas. Excluye las propiedades heredadas, las no enumerables y las claves Symbol. En los objetos ordinarios, las claves que son índices de array aparecen antes que las demás claves de cadena.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

Object.keys(obj)

Object.keys(obj) es un método estático de Object que devuelve un nuevo array de nombres de propiedades. Solo incluye propiedades propias, es decir, que no se heredan de un prototipo, cuyo atributo enumerable es true y cuya clave es una cadena. El resultado contiene cadenas incluso cuando las claves se escribieron como números. Las claves Symbol quedan excluidas.

En los objetos ordinarios, las claves que son índices de array aparecen en orden numérico ascendente, seguidas de las demás claves de cadena en el orden en que se crearon las propiedades. Esto no es una ordenación alfabética ni una regla aplicable a cualquier cadena que parezca un número: "02" no es un índice de array. Los objetos Proxy pueden influir en el orden y ejecutar código durante la enumeración.

A diferencia de for...in, este método excluye las propiedades enumerables heredadas. En cambio, Reflect.ownKeys(obj) también incluye las propiedades propias no enumerables y las claves Symbol. Object.keys no lee los valores de las propiedades ni invoca sus getters; el array devuelto no se actualiza cuando cambia el objeto.

null y undefined provocan un TypeError. Los demás valores primitivos se convierten en objetos: Object.keys("ab") produce ["0","1"], mientras que Object.keys(42) produce []. Esta es una API del lenguaje ECMAScript, no una API del navegador; ejecutar el ejemplo en Node.js no demuestra la compatibilidad con un navegador concreto.

Ejemplos

const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;

console.log(JSON.stringify(Object.keys(item)));

Resultado

["2","10","name"]

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes