2 files changed, 71 insertions, 87 deletions
diff --git a/files/ja/web/javascript/reference/global_objects/arraybuffer/index.html b/files/ja/web/javascript/reference/global_objects/arraybuffer/index.html
deleted file mode 100644
index 790ccb2694..0000000000
--- a/files/ja/web/javascript/reference/global_objects/arraybuffer/index.html
+++ /dev/null
@@ -1,87 +0,0 @@
----
-title: ArrayBuffer
-slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer
-tags:
-  - ArrayBuffer
-  - Constructor
-  - JavaScript
-  - TypedArrays
-translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer
----
-<div>{{JSRef}}</div>
-
-<p><strong><code>ArrayBuffer</code></strong> オブジェクトは、一般的な固定長の生のバイナリデータバッファを表現するために使用されます。</p>
-
-<p><code>ArrayBuffer</code> はバイトの配列で、他の言語では「バイト配列」と呼ばれることが多いです。ArrayBuffer の内容を直接操作することはできません。代わりに、型付きの配列オブジェクトか {{jsxref("DataView")}} オブジェクトのいずれかを作成して、バッファを特定の形式で表現し、バッファの内容を読み書きするためにそれを使用します。</p>
-
-<p><code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/ArrayBuffer">ArrayBuffer()</a></code> コンストラクタは、指定した長さの <code>ArrayBuffer</code> をバイト単位で作成します。<a href="/ja/docs/Web/API/WindowBase64/Base64_encoding_and_decoding#Appendix_to_Solution_1_Decode_a_Base64_string_to_Uint8Array_or_ArrayBuffer">Base64 文字列</a>や<a href="/ja/docs/Web/API/FileReader/readAsArrayBuffer">ローカルファイル</a>などの既存のデータから配列バッファを取得することもできます。</p>
-
-<h2 id="コンストラクタ">コンストラクタ</h2>
-
-<dl>
- <dt>{{jsxref("ArrayBuffer.ArrayBuffer", "ArrayBuffer()")}}</dt>
- <dd>新しい <code>ArrayBuffer</code> オブジェクトを作成します。</dd>
-</dl>
-
-<h2 id="静的プロパティ">静的プロパティ</h2>
-
-<dl>
- <dt>{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}</dt>
- <dd>派生オブジェクトを作成する際に使用するコンストラクタ関数です。</dd>
-</dl>
-
-<h2 id="静的メソッド">静的メソッド</h2>
-
-<dl>
- <dt>{{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(<var>arg</var>)")}}</dt>
- <dd><code><var>arg</var></code> が<a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">型付き配列オブジェクト</a>や {{jsxref("DataView")}} のような ArrayBuffer ビューのいずれかである場合に <code>true</code> を返します。それ以外の場合は <code>false</code> を返します。</dd>
-</dl>
-
-<h2 id="インスタンスプロパティ">インスタンスプロパティ</h2>
-
-<dl>
- <dt>{{jsxref("ArrayBuffer.prototype.byteLength")}}</dt>
- <dd><code>ArrayBuffer</code> の読み取り専用サイズ (バイト単位)。これは配列が構築されたときに設定され、変更することはできません。</dd>
-</dl>
-
-<h2 id="インスタンスメソッド">インスタンスメソッド</h2>
-
-<dl>
- <dt>{{jsxref("ArrayBuffer.prototype.slice()")}}</dt>
- <dd><code>ArrayBuffer</code> のバイト数のコピーであり、その内容は、<code><var>begin</var></code> (含む) から <code><var>end</var></code> (排他的) までのバイト数である。<code><var>begin</var></code> または <code><var>end</var></code> のどちらかが負の値の場合は、配列の先頭からではなく、配列の末尾からのインデックスを指します。</dd>
-</dl>
-
-<h2 id="Example" name="Example">例</h2>
-
-<h3 id="ArrayBuffer_の作成">ArrayBuffer の作成</h3>
-
-<p>この例では、バッファを参照する {{jsxref("Int32Array")}} ビューを持つ 8 バイトバッファを作成します。</p>
-
-<pre class="brush: js notranslate">const buffer = new ArrayBuffer(8);
-const view = new Int32Array(buffer);</pre>
-
-<h2 id="仕様">仕様</h2>
-
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('ESDraft', '#sec-arraybuffer-objects', 'ArrayBuffer')}}</td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザー実装状況</h2>
-
-<p>{{Compat("javascript.builtins.ArrayBuffer")}}</p>
-
-<h2 id="あわせて参照">あわせて参照</h2>
-
-<ul>
- <li><a href="/ja/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></li>
- <li>{{jsxref("SharedArrayBuffer")}}</li>
-</ul>
diff --git a/files/ja/web/javascript/reference/global_objects/arraybuffer/index.md b/files/ja/web/javascript/reference/global_objects/arraybuffer/index.md
new file mode 100644
index 0000000000..0841ce8811
--- /dev/null
+++ b/files/ja/web/javascript/reference/global_objects/arraybuffer/index.md
@@ -0,0 +1,71 @@
+---
+title: ArrayBuffer
+slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer
+tags:
+  - ArrayBuffer
+  - クラス
+  - JavaScript
+  - リファレンス
+  - TypedArrays
+  - Polyfill
+browser-compat: javascript.builtins.ArrayBuffer
+translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer
+---
+{{JSRef}}
+
+**`ArrayBuffer`** オブジェクトは、一般的な固定長の生のバイナリーデータバッファーを表現するために使用します。
+
+`ArrayBuffer` はバイトの配列で、他の言語ではよく「バイト配列」と呼ばれます。`ArrayBuffer` の内容を直接操作することはできません。代わりに、バッファーを特定の形式で表現する[型付き配列オブジェクト](/ja/docs/Web/JavaScript/Reference/Global_Objects/TypedArray)または {{jsxref("DataView")}} オブジェクトのいずれか作成して、バッファーの内容を読み書きします。
+
+[`ArrayBuffer()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/ArrayBuffer) コンストラクターは、指定した長さの `ArrayBuffer` をバイト単位で作成します。既存のデータから、たとえば、[Base64](/ja/docs/Glossary/Base64) 文字列や[ローカルファイルから](/ja/docs/Web/API/FileReader/readAsArrayBuffer)から配列バッファーを取得することもできます。
+
+## コンストラクター
+
+- {{jsxref("ArrayBuffer.ArrayBuffer", "ArrayBuffer()")}}
+  - : 新しい `ArrayBuffer` オブジェクトを作成します。
+
+## 静的プロパティ
+
+- {{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}
+  - : 派生オブジェクトを作成する際に使用するコンストラクター関数です。
+
+## 静的メソッド
+
+- {{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}}
+  - : `arg` が<a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">型付き配列オブジェクト</a>や {{jsxref("DataView")}} のような ArrayBuffer ビューのいずれかである場合は `true` を返します。それ以外の場合は `false` を返します。
+
+## インスタンスプロパティ
+
+- {{jsxref("ArrayBuffer.prototype.byteLength")}}
+  - : `ArrayBuffer` の長さ (バイト単位) で、読み取り専用です。これは配列が構築されたときに設定され、変更することはできません。
+
+## インスタンスメソッド
+
+- {{jsxref("ArrayBuffer.prototype.slice()")}}
+  - : 新しい `ArrayBuffer` に、`begin` (の位置) から `end` (の手前) までのバイトのコピーを入れて返します。`begin` または `end` のどちらかが負の値の場合は、配列の先頭からではなく、配列の末尾からの位置を指します。
+
+## 例
+
+### ArrayBuffer の作成
+
+この例では、バッファーを参照する {{jsxref("Int32Array")}} ビューを持つ 8 バイトバッファーを作成します。
+
+```js
+const buffer = new ArrayBuffer(8);
+const view = new Int32Array(buffer);
+```
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- `ArrayBuffer` のポリフィルが [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) で利用できます
+- [JavaScript 型付き配列](/ja/docs/Web/JavaScript/Typed_arrays)
+- {{jsxref("SharedArrayBuffer")}}
+- [RangeError: invalid array length](/ja/docs/Web/JavaScript/Reference/Errors/Invalid_array_length)