path: root/files/uk/web/javascript/enumerability_and_ownership_of_properties/index.html

---
title: Перелічуваність та належність властивостей
slug: Web/JavaScript/Enumerability_and_ownership_of_properties
tags:
  - JavaScript
  - Посібник
translation_of: Web/JavaScript/Enumerability_and_ownership_of_properties
---
<div>{{JsSidebar("More")}}</div>

<p>Перелічуваними називаються властивості, чий внутрішній прапор перелічуваності має значення true, що є значенням за замовчуванням для властивостей, створених простим присвоєнням або за допомогою ініціалізатора властивості (властивості, визначені за допомогою <a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">Object.defineProperty</a> та подібного, за замовчуванням мають значення перелічуваності false). Перелічувані властивості з'являються у циклах <a href="/uk/docs/Web/JavaScript/Reference/Statements/for...in">for...in</a>, якщо тільки ключ властивості не є <a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Symbol">символом</a>. Належність властивостей визначається тим, чи належить властивість безпосередньо до об'єкта, а не до його ланцюга прототипів. Властивості об'єкта також можна отримати всі загалом. Існують численні вбудовані засоби виявлення, перебору/переліку та отримання властивостей об'єкта, а у таблиці нижче наведено, які з них є доступними. Далі наведено зразок коду, який демонструє, як отримати відсутні категорії.</p>

<div style="overflow: auto; width: 100%;">
<table>
 <caption>Перелічуваність та належність властивостей - вбудовані методи виявлення, отримання та перебору</caption>
 <tbody>
  <tr>
   <th>Функціональність</th>
   <th>Власний об'єкт</th>
   <th>Власний об'єкт та його ланцюг прототипів</th>
   <th>Лише ланцюг прототипів</th>
  </tr>
  <tr>
   <td>Виявлення</td>
   <td>
    <table>
     <thead>
      <tr>
       <th scope="col">Перелічувані</th>
       <th scope="col">Неперелічувані</th>
       <th scope="col">Перелічувані та неперелічувані</th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code></p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty">hasOwnProperty</a></code></p>
       </td>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty">hasOwnProperty</a></code> – відфільтровані для виключення перелічуваних властивостей за допомогою <code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code></p>
       </td>
       <td><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty">hasOwnProperty</a></code></td>
      </tr>
     </tbody>
    </table>
   </td>
   <td>
    <table>
     <thead>
      <tr>
       <th scope="col">Перелічувані</th>
       <th scope="col">Неперелічувані</th>
       <th scope="col">Перелічувані та неперелічувані</th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>Недоступні без додаткового коду</td>
       <td>Недоступні без додаткового коду</td>
       <td><code><a href="/uk/docs/Web/JavaScript/Reference/Operators/in">in</a></code></td>
      </tr>
     </tbody>
    </table>
   </td>
   <td>Недоступні без додаткового коду</td>
  </tr>
  <tr>
   <td>Отримання</td>
   <td>
    <table>
     <thead>
      <tr>
       <th scope="col">Перелічувані</th>
       <th scope="col">Неперелічувані</th>
       <th scope="col">Перелічувані та неперелічувані</th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/keys">Object.keys</a></code></p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code> </p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code></p>
       </td>
       <td><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code>, <code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code> – відфільтровані для виключення перелічуваних властивостей за допомогою <code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code></td>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code></p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code></p>
       </td>
      </tr>
     </tbody>
    </table>
   </td>
   <td>Недоступні без додаткового коду</td>
   <td>Недоступні без додаткового коду</td>
  </tr>
  <tr>
   <td>Перебір</td>
   <td>
    <table>
     <thead>
      <tr>
       <th scope="col">Перелічувані</th>
       <th scope="col">Неперелічувані</th>
       <th scope="col">Перелічувані та неперелічувані</th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/keys">Object.keys</a></code></p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code> </p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code></p>
       </td>
       <td><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code>, <code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code> – відфільтровані для виключення перелічуваних властивостей за допомогою <code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code></td>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code></p>

        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code></p>
       </td>
      </tr>
     </tbody>
    </table>
   </td>
   <td>
    <table>
     <thead>
      <tr>
       <th scope="col">Перелічувані</th>
       <th scope="col">Неперелічувані</th>
       <th scope="col">Перелічувані та неперелічувані</th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>
        <p><code><a href="/uk/docs/Web/JavaScript/Reference/Statements/for...in">for..in</a></code></p>

        <p>(за винятком символів)</p>
       </td>
       <td>Недоступні без додаткового коду</td>
       <td>Недоступні без додаткового коду</td>
      </tr>
     </tbody>
    </table>
   </td>
   <td>Недоступні без додаткового коду</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Отримання_властивостей_за_перелічуваністюналежністю">Отримання властивостей за перелічуваністю/належністю</h2>

<p>Зауважте, що це не найефективніший алгоритм для усіх випадків, але він корисний для швидкої демонстрації.</p>

<ul>
 <li>Виявлення може відбуватись через <code>SimplePropertyRetriever.методЯкийВамПотрібен(obj).indexOf(prop) &gt; -1</code></li>
 <li>Перебір може відбуватись через <code>SimplePropertyRetriever.методЯкийВамПотрібен(obj).forEach(function (value, prop) {});</code> (або скористайтесь <code>filter()</code>, <code>map()</code> і т. д.)</li>
</ul>

<pre class="brush: js notranslate">var SimplePropertyRetriever = {
    getOwnEnumerables: function(obj) {
        return this._getPropertyNames(obj, true, false, this._enumerable);
         // Або скористайтесь for..in, відфільтрувавши методом hasOwnProperty, або просто цим: return Object.keys(obj);
    },
    getOwnNonenumerables: function(obj) {
        return this._getPropertyNames(obj, true, false, this._notEnumerable);
    },
    getOwnEnumerablesAndNonenumerables: function(obj) {
        return this._getPropertyNames(obj, true, false, this._enumerableAndNotEnumerable);
        // Або просто скористайтесь: return Object.getOwnPropertyNames(obj);
    },
    getPrototypeEnumerables: function(obj) {
        return this._getPropertyNames(obj, false, true, this._enumerable);
    },
    getPrototypeNonenumerables: function(obj) {
        return this._getPropertyNames(obj, false, true, this._notEnumerable);
    },
    getPrototypeEnumerablesAndNonenumerables: function(obj) {
        return this._getPropertyNames(obj, false, true, this._enumerableAndNotEnumerable);
    },
    getOwnAndPrototypeEnumerables: function(obj) {
        return this._getPropertyNames(obj, true, true, this._enumerable);
        // Або можна використати невідфільтрований результат for..in
    },
    getOwnAndPrototypeNonenumerables: function(obj) {
        return this._getPropertyNames(obj, true, true, this._notEnumerable);
    },
    getOwnAndPrototypeEnumerablesAndNonenumerables: function(obj) {
        return this._getPropertyNames(obj, true, true, this._enumerableAndNotEnumerable);
    },
    // Приватні статичні фукнції зворотного виклику для перевірки властивостей
    _enumerable: function(obj, prop) {
        return obj.propertyIsEnumerable(prop);
    },
    _notEnumerable: function(obj, prop) {
        return !obj.propertyIsEnumerable(prop);
    },
    _enumerableAndNotEnumerable: function(obj, prop) {
        return true;
    },
    // Натхненний http://stackoverflow.com/a/8024294/271577
    _getPropertyNames: function getAllPropertyNames(obj, iterateSelfBool, iteratePrototypeBool, includePropCb) {
        var props = [];

        do {
            if (iterateSelfBool) {
                Object.getOwnPropertyNames(obj).forEach(function(prop) {
                    if (props.indexOf(prop) === -1 &amp;&amp; includePropCb(obj, prop)) {
                        props.push(prop);
                    }
                });
            }
            if (!iteratePrototypeBool) {
                break;
            }
            iterateSelfBool = true;
        } while (obj = Object.getPrototypeOf(obj));

        return props;
    }
};</pre>

<h2 id="Таблиця_виявлення">Таблиця виявлення</h2>

<div style="overflow: auto; width: 100%;">
<table>
 <thead>
  <tr>
   <th scope="row"></th>
   <th scope="col"><code>in</code></th>
   <th scope="col"><code>for..in</code></th>
   <th scope="col"><code>obj.hasOwnProperty</code></th>
   <th scope="col"><code>obj.propertyIsEnumerable</code></th>
   <th scope="col"><code>Object.keys</code></th>
   <th scope="col"><code>Object.getOwnPropertyNames</code></th>
   <th scope="col"><code>Object.getOwnPropertyDescriptors</code></th>
   <th scope="col"><code>Reflect.ownKeys()</code></th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <th scope="row">Перелічувані</th>
   <td>true</td>
   <td>true</td>
   <td>true</td>
   <td>true</td>
   <td>true</td>
   <td>true</td>
   <td>true</td>
   <td>true</td>
  </tr>
  <tr>
   <th scope="row">Неперелічувані</th>
   <td>true</td>
   <td>false</td>
   <td>true</td>
   <td>false</td>
   <td>false</td>
   <td>true</td>
   <td>true</td>
   <td>true</td>
  </tr>
  <tr>
   <th scope="row">Символи</th>
   <td>true</td>
   <td>false</td>
   <td>true</td>
   <td>true</td>
   <td>false</td>
   <td>false</td>
   <td>true</td>
   <td>true</td>
  </tr>
  <tr>
   <th scope="row">Успадковані перелічувані</th>
   <td>true</td>
   <td>true</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
  </tr>
  <tr>
   <th scope="row">Успадковані неперелічувані</th>
   <td>true</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
  </tr>
  <tr>
   <th scope="row">Успадковані символи</th>
   <td>true</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
   <td>false</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Див._також">Див. також</h2>

<ul>
 <li><code><a href="/uk/docs/Web/JavaScript/Reference/Operators/in">in</a></code></li>
 <li><code><a href="/uk/docs/Web/JavaScript/Reference/Statements/for...in">for..in</a></code></li>
 <li>{{jsxref("Object.hasOwnProperty()")}}</li>
 <li>{{jsxref("Object.propertyIsEnumerable()")}}</li>
 <li>{{jsxref("Object.getOwnPropertyNames()")}}</li>
 <li>{{jsxref("Object.keys()")}}</li>
 <li>{{jsxref("Object.getOwnPropertyDescriptors()")}}</li>
</ul>