aboutsummaryrefslogtreecommitdiff
path: root/files/ru/web/javascript/reference/global_objects/object/getownpropertydescriptors/index.html
blob: f394c5a9e3516b4511d771efa1998bc616e2a319 (plain)
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
---
title: Object.getOwnPropertyDescriptors()
slug: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors
translation_of: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors
---
<div>{{JSRef}}</div>

<p>Метод <code><strong>Object.getOwnPropertyDescriptors()</strong></code> возвращает все собственные дескрипторы свойств данного объекта.</p>

<div>{{EmbedInteractiveExample("pages/js/object-getownpropertydescriptors.html")}}</div>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox">Object.getOwnPropertyDescriptors(<var>obj</var>)</pre>

<h3 id="Параметры">Параметры</h3>

<dl>
 <dt><code>obj</code></dt>
 <dd>Объект, для которого нужно получить все собственные дескрипторы свойств.</dd>
</dl>

<h3 id="Возвращаемое_значение">Возвращаемое значение</h3>

<p>Объект, содержащий все собственные дескрипторы свойств объекта. Может быть пустой объект, если нет свойств.</p>

<h2 id="Описание">Описание</h2>

<p>Этот метод позволяет изучить точное описание всех собственных свойств объекта. Свойство в JavaScript состоит из строкового имени или {{jsxref("Symbol")}}  и свойства дескриптора. Дополнительную информацию о типах свойств дескрипторов и их атрибутах можно найти в {{jsxref("Object.defineProperty()")}}.</p>

<p>Свойство дескриптора это запись с некоторыми из следующих атрибутов:</p>

<dl>
 <dt><code>value</code></dt>
 <dd>Значение, связанное со свойством (только дескрипторы данных).</dd>
 <dt><code><strong>writable</strong></code></dt>
 <dd><code>true</code>  тогда и только тогда когда значение, связанное со свойством, может быть изменено (только дескрипторы данных).</dd>
 <dt><code>get</code></dt>
 <dd>Функция, которая служит в качестве получателя для свойства, или {{jsxref("undefined")}} если нет получателя (только дескрипторы доступа).</dd>
 <dt><code>set</code></dt>
 <dd>Функция, которая служит установщиком для свойства, или {{jsxref("undefined")}} если установщика нет (только дескрипторы доступа).</dd>
 <dt><code>configurable</code></dt>
 <dd><code>true</code> тогда и только тогда, когда тип этого свойства дескриптора может быть изменён, и если свойство может быть удалено из соответствующего объекта.</dd>
 <dt><code>enumerable</code></dt>
 <dd><code>true</code> тогда и только тогда, когда это свойство отображается при перечислении свойств соответствующего объекта.
 <p> </p>
 </dd>
</dl>

<h2 id="Примеры">Примеры</h2>

<h3 id="Создание_поверхностного_клона">Создание поверхностного клона</h3>

<p>В то время как метод {{jsxref("Object.assign()")}} будет только копировать перечисляемые и собственные свойства из исходного объекта в целевой объект, вы можете использовать этот метод и {{jsxref("Object.create()")}} для поверхностного копирования между двумя неизвестными объектами:</p>

<pre class="brush: js">Object.create(
  Object.getPrototypeOf(obj),
  Object.getOwnPropertyDescriptors(obj)
);
</pre>

<h3 id="Создание_подкласса">Создание подкласса</h3>

<p>Типичный способ создания подкласса это определить подкласс, определить свойства этого экземпляра. Это может быть неудобно особенно для получателей и установщиков. Вместо этого, вы можете использовать этот код для установки прототипа:</p>

<pre class="brush: js">function superclass() {}
superclass.prototype = {
  // Определите ваши методы и свойства здесь
};
function subclass() {}
subclass.prototype = Object.create(
  superclass.prototype,
  {
    // Определите ваши методы и свойства здесь
  }
);
</pre>

<h2 id="Спецификации">Спецификации</h2>

{{Specifications}}

<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2>

<div>
<p>{{Compat}}</p>
</div>

<h2 id="Смотрите_также">Смотрите также</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>