initial commit

1 files changed, 332 insertions, 0 deletions

diff --git a/files/ja/web/javascript/enumerability_and_ownership_of_properties/index.html b/files/ja/web/javascript/enumerability_and_ownership_of_properties/index.html
new file mode 100644
index 0000000000..500527c489
--- /dev/null
+++ b/files/ja/web/javascript/enumerability_and_ownership_of_properties/index.html
@@ -0,0 +1,332 @@
+---
+title: プロパティの列挙可能性と所有権
+slug: Web/JavaScript/Enumerability_and_ownership_of_properties
+tags:
+  - Guide
+  - JavaScript
+translation_of: Web/JavaScript/Enumerability_and_ownership_of_properties
+---
+<div>{{JsSidebar("More")}}</div>
+
+<p>列挙可能プロパティは、内部の<ruby>列挙可能<rp>（</rp><rt>enumerable</rt><rp>）</rp></ruby>フラグが true に設定されているプロパティです。これは、単純な代入や初期化で作成されたプロパティのデフォルトです (<a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">Object.defineProperty</a> で追加したプロパティはデフォルトで列挙可能性が false になります）。プロパティのキーが <a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol">Symbol</a> でない限り、列挙可能なプロパティは <a href="/ja/docs/Web/JavaScript/Reference/Statements/for...in">for...in</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="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code></p>
+
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty">hasOwnProperty</a></code></p>
+       </td>
+       <td>
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty">hasOwnProperty</a></code> – <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code> を使用して列挙可能なものを除外するようにフィルターリング</p>
+       </td>
+       <td><code><a href="/ja/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="/ja/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="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/keys">Object.keys</a></code></p>
+
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code></p>
+
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code></p>
+       </td>
+       <td><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code>, <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code> – <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code> を使用して列挙可能なものを除外するようにフィルターリング</td>
+       <td>
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code></p>
+
+        <p><code><a href="/ja/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="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/keys">Object.keys</a></code></p>
+
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code> </p>
+
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code></p>
+       </td>
+       <td><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code>, <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols">getOwnPropertySymbols</a></code> – <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable">propertyIsEnumerable</a></code> を使用して列挙可能なものを除外するようにフィルターリング</td>
+       <td>
+        <p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames">getOwnPropertyNames</a></code></p>
+
+        <p><code><a href="/ja/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="/ja/docs/Web/JavaScript/Reference/Statements/for...in">for..in</a></code></p>
+
+        <p>(symbol を除く)</p>
+       </td>
+       <td>追加のコードが必要</td>
+       <td>追加のコードが必要</td>
+      </tr>
+     </tbody>
+    </table>
+   </td>
+   <td>追加のコードが必要</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="Obtaining_properties_by_enumerabilityownership" name="Obtaining_properties_by_enumerabilityownership">列挙可能性/所有権によるプロパティの取得</h2>
+
+<p>以下に示すのは全てのケースで最も効率的なアルゴリズムではなく、簡潔なデモであることに注意してください。</p>
+
+<ul>
+ <li>検出は以下の方法で行うことができます。<br>
+<code>SimplePropertyRetriever.使いたい get メソッド(obj).indexOf(prop) &gt; -1</code></li>
+ <li>反復は以下の方法で行うことができます。<br>
+<code>SimplePropertyRetriever.使いたい get メソッド(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);
+         // Or could use for..in filtered with hasOwnProperty or just this: 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);
+        // Or just use: 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);
+        // Or could use unfiltered for..in
+    },
+    getOwnAndPrototypeNonenumerables: function(obj) {
+        return this._getPropertyNames(obj, true, true, this._notEnumerable);
+    },
+    getOwnAndPrototypeEnumerablesAndNonenumerables: function(obj) {
+        return this._getPropertyNames(obj, true, true, this._enumerableAndNotEnumerable);
+    },
+    // Private static property checker callbacks
+    _enumerable: function(obj, prop) {
+        return obj.propertyIsEnumerable(prop);
+    },
+    _notEnumerable: function(obj, prop) {
+        return !obj.propertyIsEnumerable(prop);
+    },
+    _enumerableAndNotEnumerable: function(obj, prop) {
+        return true;
+    },
+    // Inspired by 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="Detection_Table" name="Detection_Table">検出テーブル</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">Symbols キー</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">継承された Symbols キー</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="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li><code><a href="/ja/docs/Web/JavaScript/Reference/Operators/in">in</a></code></li>
+ <li><code><a href="/ja/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>