1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
---
title: Object.getOwnPropertyDescriptors()
slug: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors
tags:
- JavaScript
- Objeto
- metodo
translation_of: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors
original_slug: Web/JavaScript/Referencia/Objetos_globales/Object/getOwnPropertyDescriptors
---
<div>{{JSRef}}</div>
<p>El método<code><strong>Object.getOwnPropertyDescriptors()</strong></code><strong> </strong>regresa todos los descriptores de propiedad propios de un objeto dado.</p>
<div>{{EmbedInteractiveExample("pages/js/object-getownpropertydescriptors.html")}}</div>
<h2 id="Sintáxis">Sintáxis</h2>
<pre class="syntaxbox">Object.getOwnPropertyDescriptors(<var>obj</var>)</pre>
<h3 id="Parámetros">Parámetros</h3>
<dl>
<dt><code>obj</code></dt>
<dd>El objeto para el cual obtener todos los descriptores de propiedad.</dd>
</dl>
<h3 id="Valores_devueltos">Valores devueltos</h3>
<p>Un objeto que contiene todos los descriptores de propiedad propios de un objeto.</p>
<h2 id="Descripción">Descripción</h2>
<p>Este método permite la examinación de la descripción precisa de todas las propiedades de un objeto. Una propiedad en JavaScript consiste en un valor-cadena nombre y un descriptor de propiedad. Más información acerca de los tipos de descriptores de propiedad y sus atributos pueden ser encontrados en {{jsxref("Object.defineProperty()")}}.</p>
<p>Un descriptor de propiedad es un registro con algunos de los siguientes atributos:</p>
<dl>
<dt><code>value</code></dt>
<dd>El valor asociado con la propiedad (solo descriptores de datos).</dd>
<dt><code><strong>writable</strong></code></dt>
<dd><code>true</code> si y solo si el valor asociado con la propiedad puede ser cambiado (solo descriptores de datos).</dd>
<dt><code>get</code></dt>
<dd>Un función que sirve como un getter para la propiedad, o {{jsxref("undefined")}} si no hay getter (solo descriptores de acceso).</dd>
<dt><code>set</code></dt>
<dd>Una función que sirve como un setter para la propiedad, o {{jsxref("undefined")}} si no hay setter (solo descriptores de acceso).</dd>
<dt><code>configurable</code></dt>
<dd><code>true</code> si y solo si el tipo de este descriptor de propiedad puede ser cambiado y si la propiedad puede ser borrada de el objeto correspondiente.</dd>
<dt><code>enumerable</code></dt>
<dd><code>true</code> si y solo si esta propiedad aparece durante la enumeración de las propiedad en el objeto correspondiente.</dd>
</dl>
<h2 id="Ejemplos">Ejemplos</h2>
<h3 id="Creando_un_clon_superficial">Creando un clon superficial</h3>
<p>Mientras el método {{jsxref("Object.assign()")}} solo copiará las propiedades enumerables y propias de un objeto fuente a un objeto destino, puedes usar este método y {{jsxref("Object.create()")}} para una copia superficial entre dos objetos desconocidos:</p>
<pre class="brush: js">Object.create(
Object.getPrototypeOf(obj),
Object.getOwnPropertyDescriptors(obj)
);
</pre>
<h3 id="Creando_una_subclase">Creando una subclase</h3>
<p>Una manera típica de crear una subclase es definir la subclase, establecer su prototipo a una instancia de la superclase, y después definir propiedades en esa instancia. Esto puede ponerse incómodo especialmente por los getters y setters. En cambio, tú puedes usar este código para establecer el prototipo:</p>
<pre class="brush: js">function superclass() {}
superclass.prototype = {
// Define tus métodos y propiedades aquí
};
function subclass() {}
subclass.prototype = Object.create(
superclass.prototype,
{
// Define tus métodos y propiedades aquí
}
);
</pre>
<h2 id="Especificaciones">Especificaciones</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-object.getownpropertydescriptors', 'Object.getOwnPropertyDescriptors')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td>Definición inicial en ECMAScript 2017.</td>
</tr>
<tr>
<td>{{SpecName('ES2017', '#sec-object.getownpropertydescriptors', 'Object.getOwnPropertyDescriptors')}}</td>
<td>{{Spec2('ES2017')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<div>
<p>{{Compat("javascript.builtins.Object.getOwnPropertyDescriptors")}}</p>
</div>
<h2 id="Ver_también">Ver también:</h2>
<ul>
<li>{{jsxref("Object.getOwnPropertyDescriptor()")}}</li>
<li>{{jsxref("Object.defineProperty()")}}</li>
<li><a href="https://github.com/tc39/proposal-object-getownpropertydescriptors">Polyfill</a></li>
</ul>
|
