From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../object/getownpropertydescriptors/index.html | 104 +++++++++++++++++++++ 1 file changed, 104 insertions(+) create mode 100644 files/pt-br/web/javascript/reference/global_objects/object/getownpropertydescriptors/index.html (limited to 'files/pt-br/web/javascript/reference/global_objects/object/getownpropertydescriptors') diff --git a/files/pt-br/web/javascript/reference/global_objects/object/getownpropertydescriptors/index.html b/files/pt-br/web/javascript/reference/global_objects/object/getownpropertydescriptors/index.html new file mode 100644 index 0000000000..b12a764811 --- /dev/null +++ b/files/pt-br/web/javascript/reference/global_objects/object/getownpropertydescriptors/index.html @@ -0,0 +1,104 @@ +--- +title: Object.getOwnPropertyDescriptors() +slug: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors +translation_of: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors +--- +
{{JSRef}}
+ +

O Object.getOwnPropertyDescriptors() método retorna todas as descrições próprias da propriedade de um dado objeto.

+ +
{{EmbedInteractiveExample("pages/js/object-getownpropertydescriptors.html")}}
+ +

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 {{jsxref("Symbol")}} e uma propriedade descritora. Outras informações sobre propriedade de tipo descritoras e seus atributos podem ser encontradas em {{jsxref("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 {{jsxref("undefined")}} se não existir um capturador (somente descritores de acesso).
+
set
+
Uma função que serve como um configurador para a propriedade, ou {{jsxref("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 {{jsxref("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 {{jsxref("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

+ + + + + + + + + + +
Especificações
{{SpecName('ESDraft', '#sec-object.getownpropertydescriptors', 'Object.getOwnPropertyDescriptors')}}
+ +

Compatibiliadde de navegadores

+ +
+ + +

{{Compat("javascript.builtins.Object.getOwnPropertyDescriptors")}}

+
+ +

Veja também

+ + -- cgit v1.2.3-54-g00ecf