CKTIS / JavaScript
Object.getOwnPropertyDescriptor — inspecionar uma propriedade própria
Object.getOwnPropertyDescriptor devolve uma descrição de uma propriedade própria do objeto: o seu valor ou os seus acessores, juntamente com as marcas dos seus atributos. Não percorre a cadeia de protótipos e devolve undefined se o objeto não tiver essa propriedade própria.
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.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) lê o descritor de uma única propriedade própria, incluindo uma que não seja enumerável. Não procura nos protótipos. O resultado é um novo objeto descritor ou undefined se a propriedade não estiver diretamente em obj. Uma propriedade existente cujo valor seja undefined continua a ter um descritor.
Um descritor de propriedade de dados contém value, writable, enumerable e configurable. Um descritor de propriedade acessora contém get e set em vez de value e writable; um acessor em falta tem o valor undefined. Num objeto comum, ler o descritor não invoca o getter. writable determina se uma atribuição pode alterar o valor, enumerable se a propriedade é incluída numa enumeração e configurable se pode ser eliminada ou reconfigurada.
Alterar os campos do objeto devolvido não altera a propriedade original. Para aplicar um descritor, use Object.defineProperty, tendo em conta as restrições da propriedade existente. O descritor não é uma cópia profunda: um objeto guardado em value continua a ser a mesma referência.
key é convertido numa chave de propriedade: uma string ou um símbolo. Passar null ou undefined como obj provoca um TypeError; os outros valores primitivos são convertidos em objetos wrapper. Num Proxy, a operação pode invocar a trap getOwnPropertyDescriptor, pelo que pode ter efeitos secundários ou lançar uma exceção.
Exemplos
const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));Resultado
42 false true true 42 undefined
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.