CKTIS / JavaScript
Object.getOwnPropertyNames — nomes das propriedades próprias
Object.getOwnPropertyNames(obj) devolve um novo array de chaves que são cadeias de caracteres. Nos objetos comuns, inclui as chaves de todas as propriedades próprias com esse tipo de chave, mesmo as não enumeráveis. As chaves Symbol são excluídas, e a armadilha ownKeys de um Proxy pode influenciar a lista.
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.getOwnPropertyNames(obj)Object.getOwnPropertyNames(obj) é um método estático: chame-o em Object, não no objeto analisado. Devolve um novo array apenas com as chaves do tipo cadeia de caracteres presentes no resultado da operação interna [[OwnPropertyKeys]], sem verificar os descritores de propriedades. Nos objetos comuns, inclui todas as chaves desse tipo das propriedades próprias, independentemente do atributo enumerable, mas não as das propriedades herdadas. O método devolve chaves, não valores de propriedades.
Nos objetos comuns, Object.keys(obj) inclui apenas propriedades próprias enumeráveis cujas chaves são cadeias de caracteres. Object.getOwnPropertySymbols(obj) devolve as chaves Symbol das propriedades próprias, enquanto Reflect.ownKeys(obj) devolve tanto as chaves do tipo cadeia de caracteres como as do tipo Symbol das propriedades próprias, incluindo as não enumeráveis. «Própria» e «enumerável» descrevem características diferentes.
Nos objetos comuns, os nomes que são índices de array aparecem primeiro, por ordem numérica crescente; as restantes chaves do tipo cadeia de caracteres seguem a ordem de criação das propriedades. Não se trata de uma ordenação alfabética. Os objetos Proxy podem personalizar a lista e a ordem através da armadilha ownKeys, dentro dos limites impostos pela especificação. Se o objeto-alvo for extensível, a armadilha pode indicar uma chave do tipo cadeia de caracteres sem um descritor de propriedade própria correspondente ou omitir uma chave desse tipo de uma propriedade própria configurável do objeto-alvo.
null e undefined causam um TypeError; os restantes valores primitivos são convertidos em objetos. O exemplo demonstra a ordenação dos índices e a inclusão de hidden, que, com esta utilização de Object.defineProperty, não é enumerável por predefinição. A propriedade inherited e a chave Symbol são excluídas.
Exemplos
const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';
console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));Resultado
["2","10","label","hidden"] ["2","10","label"]
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.