Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Reflect.ownKeys — todas as chaves próprias

Reflect.ownKeys(target) exige um objeto. Para um objeto comum, devolve um array com todas as chaves próprias: cadeias de caracteres e símbolos, incluindo as chaves de propriedades não enumeráveis. Exclui as propriedades herdadas. A armadilha ownKeys de um Proxy pode alterar as chaves devolvidas.

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

Reflect.ownKeys(target)

Reflect.ownKeys(target) cria um novo array de chaves. Se target for um objeto comum, o array contém as chaves de todas as suas propriedades próprias, enumeráveis e não enumeráveis. Os elementos são cadeias de caracteres ou símbolos, não os valores das propriedades. Não percorre a cadeia de protótipos. Um argumento que não seja um objeto, incluindo null ou uma cadeia de caracteres, provoca um TypeError; não é convertido automaticamente num objeto.

Nos objetos comuns, surgem primeiro as chaves que são índices de array, por ordem numérica crescente; depois, as outras cadeias de caracteres, pela ordem de criação das propriedades; e, por fim, os símbolos, pela ordem de criação das propriedades correspondentes. Assim, "2" precede "10", mesmo que tenham sido adicionadas pela ordem inversa; as próprias chaves continuam a ser cadeias de caracteres.

Em contrapartida, Object.keys devolve apenas chaves enumeráveis do tipo cadeia de caracteres. Object.getOwnPropertyNames inclui as chaves próprias do tipo cadeia de caracteres, enquanto Object.getOwnPropertySymbols inclui os símbolos próprios. Usa Reflect.ownKeys quando precisares dos dois tipos de chaves sem filtrar pela enumerabilidade.

O método invoca a operação interna [[OwnPropertyKeys]]. Num Proxy, isso pode ativar a armadilha ownKeys, pelo que pode executar código do utilizador, lançar uma exceção ou devolver as chaves numa ordem permitida diferente da de um objeto comum. A armadilha também pode alterar o conjunto de chaves devolvidas: se o objeto-alvo do proxy for extensível, pode omitir chaves de propriedades próprias configuráveis ou devolver chaves adicionais para as quais o objeto-alvo não tem um descritor de propriedade própria. Tem de incluir as chaves das propriedades próprias não configuráveis. Se o objeto-alvo não for extensível, o conjunto devolvido tem de corresponder exatamente ao das suas chaves próprias. Não pressuponhas que todos os objetos exóticos seguem a ordem comum. Esta é uma API da linguagem ECMAScript; a simples presença de Node 24 num repositório não comprova o suporte no navegador de destino.

Exemplos

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

const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);

Resultado

2 | 10 | name | hidden | Symbol(tag)
true

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.

Fontes