CKTIS / JavaScript
Object.keys — chaves próprias enumeráveis de um objeto
Object.keys(obj) devolve um novo array com as chaves próprias enumeráveis de um objeto, sob a forma de cadeias de caracteres. Exclui propriedades herdadas, propriedades não enumeráveis e chaves Symbol. Em objetos comuns, as chaves que são índices de array surgem antes das restantes chaves de cadeia.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Object.keys(obj)Object.keys(obj) é um método estático de Object que devolve um novo array de nomes de propriedades. Inclui apenas propriedades próprias, ou seja, que não são herdadas de um protótipo, cujo atributo enumerable é true e cuja chave é uma cadeia de caracteres. O resultado contém cadeias de caracteres, mesmo quando as chaves foram escritas como números. As chaves Symbol são excluídas.
Em objetos comuns, as chaves que são índices de array surgem por ordem numérica crescente, seguidas das restantes chaves de cadeia pela ordem de criação das propriedades. Isto não é uma ordenação alfabética nem uma regra aplicável a todas as cadeias que se assemelham a números: "02" não é um índice de array. Os objetos Proxy podem influenciar a ordem e executar código durante a enumeração.
Ao contrário de for...in, o método exclui as propriedades enumeráveis herdadas. Já Reflect.ownKeys(obj) também inclui propriedades próprias não enumeráveis e chaves Symbol. Object.keys não lê os valores das propriedades nem invoca os respetivos getters; o array devolvido não é atualizado quando o objeto muda.
null e undefined causam um TypeError. Os outros valores primitivos são convertidos em objetos: Object.keys("ab") produz ["0","1"], enquanto Object.keys(42) produz []. Esta é uma API da linguagem ECMAScript, não uma API de navegador; executar o exemplo em Node.js não comprova a compatibilidade com um navegador específico.
Exemplos
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"]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.