Object.getOwnPropertyDescriptors()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
O Object.getOwnPropertyDescriptors()
método retorna todas as descrições próprias da propriedade de um dado objeto.
Experimente
Sintaxe
Object.getOwnPropertyDescriptors(obj)
Parâmetro
obj
-
O objeto pelo o qual deseja obter todos os descritores de propriedade próprios.
Valor retornado
Um objeto contendo todas as propriedades descritivas de um objeto. Pode ser um objeto vazio, se não existir propriedade.
Descrição
Esse método permite examinar a descrição precisa de todas as propriedades de um objeto. Uma propriedade em JavaScript consiste de um nome com valor string ou um Symbol
e uma propriedade descritora. Outras informações sobre propriedade de tipo descritoras e seus atributos podem ser encontradas em Object.defineProperty()
.
Uma propriedade descritora é um registro com alguns dos seguintes atributos:
value
-
O valor associdado com à propriedade (somente descritores de dados).
writable
-
true
se somente o valor associado com a propriedade pode ser alterada (somente descritores de dados). get
-
Uma função que serve como um capturador para a propriedade ou
undefined
se não existir um capturador (somente descritores de acesso). set
-
Uma função que serve como um configurador para a propriedade, ou
undefined
se não existir um configurador (somente descritores de acesso). configurable
-
true
se e somente se o tipo da propriedade descritora pode ser alterada e se a propriedade pode ser deletada do objeto correspondente. enumerable
-
true
se e somente se essa propriedade se mostrar durante a enumeração da propriedade no objeto correspondente.
Exemplos
Criando um clone superficial
Enquanto o Object.assign()
método vai copiar somente o enumerável e as próprias propriedades da origem de um objeto para o objeto alvo, você é capaz de usar esse método e Object.create()
para uma cópia superficial entre dois objetos desconhecidos:
Object.create(
Object.getPrototypeOf(obj),
Object.getOwnPropertyDescriptors(obj),
);
Criando uma subclasse
Um modo típico de criar uma subclasse é definir a subclasse, configurar um protótipo para uma instância da superclasse e depois difinir as propriedades daquela instância. Isso pode ficar estranho especialmente para os capturadores e configuradores. Ao invés disso, você pode usar esse código para configurar o protótipo :
function superclass() {}
superclass.prototype = {
// Define seu método e propriedades aqui
};
function subclass() {}
subclass.prototype = Object.create(superclass.prototype, {
// Define seu método e propriedades aqui
});
Especificações
Specification |
---|
ECMAScript Language Specification # sec-object.getownpropertydescriptors |
Compatibilidade com navegadores
BCD tables only load in the browser