CKTIS / JavaScript
Object.getOwnPropertyDescriptors — descritores das propriedades próprias
Para um objeto comum, Object.getOwnPropertyDescriptors devolve os descritores de todas as suas propriedades próprias, incluindo as não enumeráveis e as que têm chaves Symbol. Permite inspecionar atributos ou copiar propriedades sem converter acessores em valores.
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.getOwnPropertyDescriptors(obj)Object.getOwnPropertyDescriptors(obj) devolve um novo objeto comum. O método obtém de obj a lista de chaves das propriedades próprias e inclui, para cada chave da lista, o respetivo descritor se obj indicar que existe. Aceita chaves de tipo cadeia de caracteres e Symbol, incluindo as de propriedades não enumeráveis; exclui propriedades herdadas.
O descritor de uma propriedade de dados contém value, writable, enumerable e configurable. Um descritor de acessor contém get e set em vez de value e writable; uma função em falta é representada por undefined. A leitura dos descritores de um objeto comum não invoca os respetivos getters. No entanto, com um Proxy, podem ser executadas armadilhas e ocorrer exceções. O resultado também pode ficar incompleto sem que seja lançada uma exceção: a armadilha ownKeys pode omitir a chave de uma propriedade própria configurável de um objeto-alvo extensível, mesmo que o proxy continue a indicar um descritor de propriedade própria para essa chave. Nesse caso, o método deixa esse descritor de fora do resultado.
Para um objeto comum, o padrão Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) cria uma cópia superficial com o mesmo protótipo e os mesmos atributos das propriedades próprias. Ao contrário de Object.assign, preserva os acessores e as propriedades não enumeráveis. Os objetos aninhados continuam partilhados; não é uma técnica geral para clonar objetos que dependem de slots internos, como Map.
null e undefined provocam um TypeError; os restantes valores primitivos são convertidos em objetos de encapsulamento. O método pertence ao ECMAScript 2017, não às Web APIs. O suporte no navegador de destino tem de ser verificado separadamente — a disponibilidade no Node 24 não o comprova.
Exemplos
let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
hidden: { value: 7, enumerable: false },
doubled: {
get() { reads += 1; return this.hidden * 2; },
enumerable: true
}
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);Resultado
0 7 false function 14 1 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.