diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2021-09-07 00:43:07 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-09-07 00:43:07 +0900 |
commit | c01e8779a5fed876331e3933e8e19e1daecab11c (patch) | |
tree | be0fe33e2fd3a86e6b4d77197a0954e9b88456ab /files/ja | |
parent | f07b200c812378523739b7e1e75b7e6cf72fe673 (diff) | |
download | translated-content-c01e8779a5fed876331e3933e8e19e1daecab11c.tar.gz translated-content-c01e8779a5fed876331e3933e8e19e1daecab11c.tar.bz2 translated-content-c01e8779a5fed876331e3933e8e19e1daecab11c.zip |
Global_Objects/WebAssembly/Table 以下の文書を更新 (#2265)
- Markdownに変換
- 2021/08/28 時点の英語版に同期
Diffstat (limited to 'files/ja')
8 files changed, 312 insertions, 378 deletions
diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.html deleted file mode 100644 index ebcbd78d9f..0000000000 --- a/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: WebAssembly.Table.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/get -tags: - - API - - JavaScript - - Method - - Reference - - WebAssembly - - get - - table - - メソッド -translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/get ---- -<div>{{JSRef}}</div> - -<p><code><strong>get()</strong></code> は {{jsxref("WebAssembly.Table")}} オブジェクトのプロトタイプメソッドで、指定されたインデックスに格納された関数参照を取得します。</p> - -<h2 id="Syntax" name="Syntax">構文</h2> - -<pre class="syntaxbox">table.get(<em>index</em>); -</pre> - -<h3 id="Parameters" name="Parameters">引数</h3> - -<dl> - <dt><em>index</em></dt> - <dd>取得する関数参照のインデックス。</dd> -</dl> - -<h3 id="Return_value" name="Return_value">返値</h3> - -<p>関数参照を返します。これは <a href="/ja/docs/WebAssembly/Exported_functions">エクスポートされた WebAssembly 関数</a> 、wasm 関数を内在する JavaScript ラッパーです。</p> - -<h3 id="Exceptions" name="Exceptions">例外</h3> - -<p>もし <em>index</em> が {{jsxref("WebAssembly/Table/length","Table.prototype.length")}} 以上だった場合、{{jsxref("RangeError")}} をスローします。</p> - -<h2 id="Examples" name="Examples">例</h2> - -<p>次の例では (Github の <a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table.html">table.html</a> と <a href="https://mdn.github.io/webassembly-examples/js-api-examples/table.html">動作例</a> も確認してください)、<code><a href="https://github.com/mdn/webassembly-examples/blob/master/wasm-utils.js">fetchAndInstantiate()</a></code> ユーティリティ関数を使用して table.wasm バイトコードをロード、コンパイルして、インスタンス化しています。その後、エクスポートされたテーブルに格納された参照を取得します。</p> - -<pre class="brush: js">WebAssembly.instantiateStreaming(fetch('table.wasm')) -.then(function(obj) { - var tbl = obj.instance.exports.tbl; - console.log(tbl.get(0)()); // 13 - console.log(tbl.get(1)()); // 42 -});</pre> - -<p>参照内に格納されている値を実際に取得するためには、アクセサの最後に2つ目の関数呼び出し演算子を含める必要があります(<code>get(0)</code> ではなく <code>get(0)()</code>) 。これは単純な値ではなく、関数です。</p> - -<h2 id="Specifications" name="Specifications">仕様書</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様書</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('WebAssembly JS', '#dom-table-get', 'get()')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.WebAssembly.Table.get")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/WebAssembly">WebAssembly</a> 概要ページ</li> - <li><a href="/ja/docs/WebAssembly/Concepts">WebAssembly の概念</a></li> - <li><a href="/ja/docs/WebAssembly/Using_the_JavaScript_API">WebAssembly JavaScript API の使用</a></li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.md b/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.md new file mode 100644 index 0000000000..826de450ca --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.md @@ -0,0 +1,68 @@ +--- +title: WebAssembly.Table.prototype.get() +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/get +tags: + - API + - JavaScript + - メソッド + - Reference + - WebAssembly + - get + - table +browser-compat: javascript.builtins.WebAssembly.Table.get +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/get +--- +{{JSRef}} + +**`get()`** は {{jsxref("WebAssembly.Table")}} オブジェクトのプロトタイプメソッドで、指定された位置に格納されている関数参照を取得します。 + +## 構文 + +```js +get(index) +``` + +### 引数 + +- _index_ + - : 取得する関数参照の位置です。 + +### 返値 + +関数参照を返します。これは[エクスポートされた WebAssembly 関数](/ja/docs/WebAssembly/Exported_functions)、wasm 関数を内在する JavaScript ラッパーです。</p> + +### 例外 + +_index_ が {{jsxref("WebAssembly/Table/length","Table.prototype.length")}} 以上であった場合、{{jsxref("RangeError")}} が発生します。 + +## 例 + +### get の使用 + +次の例では (Github の [table.html](https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table.html) と[動作例](https://mdn.github.io/webassembly-examples/js-api-examples/table.html)も確認してください)、 table.wasm バイトコードを +{{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用して読み取り、コンパイルしてインスタンス化しています。その後、エクスポートされたテーブルに格納された参照を取得します。 + +```js +WebAssembly.instantiateStreaming(fetch('table.wasm')) +.then(function(obj) { + var tbl = obj.instance.exports.tbl; + console.log(tbl.get(0)()); // 13 + console.log(tbl.get(1)()); // 42 +}); +``` + +参照に格納されている値を実際に取得するためには、アクセサーの最後に 2 つ目の関数呼び出し演算子を含める必要があります (`get(0)` ではなく `get(0)()`)。これは単純な値ではなく、関数です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebAssembly](/ja/docs/WebAssembly) 概要ページ +- [WebAssembly の概念](/ja/docs/WebAssembly/Concepts) +- [WebAssembly JavaScript API の使用](/ja/docs/WebAssembly/Using_the_JavaScript_API) diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.html deleted file mode 100644 index 3c645810aa..0000000000 --- a/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: WebAssembly.Table.prototype.grow() -slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/grow -tags: - - API - - JavaScript - - Method - - Reference - - WebAssembly - - grow - - table - - メソッド -translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/grow ---- -<div>{{JSRef}}</div> - -<p><code><strong>grow()</strong></code> は {{jsxref("WebAssembly.Table")}} オブジェクトのプロトタイプメソッドで、指定された要素数でテーブルを拡張します。</p> - -<h2 id="Syntax" name="Syntax">構文</h2> - -<pre class="syntaxbox">table.grow(<em>number</em>); -</pre> - -<h3 id="Parameters" name="Parameters">引数</h3> - -<dl> - <dt><em>number</em></dt> - <dd>テーブルを拡張する要素数。</dd> -</dl> - -<h3 id="Return_value" name="Return_value">返値</h3> - -<p>以前のテーブルの長さ。</p> - -<h3 id="Exceptions" name="Exceptions">例外</h3> - -<p>もし <code>grow()</code> 操作が何かしらの理由で失敗した場合、{{jsxref("RangeError")}} をスローします。</p> - -<h2 id="Examples" name="Examples">例</h2> - -<p>次の例では、初期サイズが2で最大サイズが10の WebAssembly Table を作成しています。</p> - -<pre class="brush: js">var table = new WebAssembly.Table({ element: "anyfunc", initial: 2, maximum: 10 });</pre> - -<p>次のようにすることで、テーブルのサイズを1拡張することができます:</p> - -<pre class="brush: js">console.log(table.length); // "2" -console.log(table.grow(1)); // "2" -console.log(table.length); // "3" -</pre> - -<h2 id="Specifications" name="Specifications">仕様書</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様書</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('WebAssembly JS', '#dom-table-grow', 'grow()')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.WebAssembly.Table.set")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/WebAssembly">WebAssembly</a> 概要ページ</li> - <li><a href="/ja/docs/WebAssembly/Concepts">WebAssembly の概念</a></li> - <li><a href="/ja/docs/WebAssembly/Using_the_JavaScript_API">WebAssembly JavaScript API の使用</a></li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.md b/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.md new file mode 100644 index 0000000000..3622d9dcaf --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.md @@ -0,0 +1,68 @@ +--- +title: WebAssembly.Table.prototype.grow() +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/grow +tags: + - API + - JavaScript + - メソッド + - Reference + - WebAssembly + - grow + - table +browser-compat: javascript.builtins.WebAssembly.Table.grow +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/grow +--- +{{JSRef}} + +**`grow()`** は {{jsxref("WebAssembly.Table")}} オブジェクトのプロトタイプメソッドで、 Table インスタンスの大きさを指定された要素数だけ拡張します。 + +## 構文 + +```js +grow(number) +``` + +### 引数 + +- _number_ + - : テーブルを拡張する要素数です。 + +### 返値 + +直前のテーブルの長さです。 + +### 例外 + +`grow()` の操作が何らかの理由で失敗した場合、 {{jsxref("RangeError")}} が発生します。 + +## 例 + +### grow の使用 + +以下の例では、新しい WebAssembly Table のインスタンスを初期サイズ 2、最大サイズ 10 で生成しています。 + +```js +var table = new WebAssembly.Table({ element: "anyfunc", initial: 2, maximum: 10 }); +``` + +以下のようにして、テーブルを 1 だけ拡張することができます。 + +```js +console.log(table.length); // "2" +console.log(table.grow(1)); // "2" +console.log(table.length); // "3" +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebAssembly](/ja/docs/WebAssembly) 概要ページ +- [WebAssembly の概念](/ja/docs/WebAssembly/Concepts) +- [WebAssembly JavaScript API の使用](/ja/docs/WebAssembly/Using_the_JavaScript_API) diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/index.html deleted file mode 100644 index 963a942b65..0000000000 --- a/files/ja/web/javascript/reference/global_objects/webassembly/table/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: WebAssembly.Table() -slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table -translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table ---- -<div>{{JSRef}}</div> - -<p><code><strong>WebAssembly.Table()</strong></code> コンストラクタは与えられたサイズと要素の型から <code>Table</code> オブジェクトを生成します。</p> - -<p>これは、配列ライクな構造で表現された WebAssembly テーブルの JavaScript ラッパーオブジェクトです。JavaScript か WebAssembly コード上で生成されたテーブルは JavaScript、WebAssembly の両方からアクセス、変更可能です。</p> - -<div class="note"> -<p><strong>注</strong>: 現在、テーブルには関数の参照のみ格納できます。しかし、将来的に拡張される予定です。</p> -</div> - -<h2 id="構文">構文</h2> - -<pre class="syntaxbox">var myTable = new WebAssembly.Table(tableDescriptor);</pre> - -<h3 id="パラメータ">パラメータ</h3> - -<dl> - <dt><em>tableDescriptor</em></dt> - <dd>以下のメンバーを含むことができるオブジェクト: - <dl> - <dt><em>element</em></dt> - <dd>テーブルに格納する値の型の文字列表現。現在は、<code>"anyfunc"</code> (関数) のみ設定できます。</dd> - <dt><em>initial</em></dt> - <dd>WebAssembly テーブルの初期要素数。</dd> - <dt><em>maximum {{optional_inline}}</em></dt> - <dd>WebAssembly テーブルが拡張できる要素の最大数。</dd> - </dl> - </dd> -</dl> - -<h3 id="例外">例外</h3> - -<ul> - <li>もし <code>tableDescriptor</code> がオブジェクト型でない場合、{{jsxref("TypeError")}} がスローされます。</li> - <li>もし <code>maximum</code> 定義されていて <code>initial</code> よりも小さい場合、{{jsxref("RangeError")}} がスローされます。</li> -</ul> - -<h2 id="Table_インスタンス"><code>Table</code> インスタンス</h2> - -<p>全ての <code>Table</code> インスタンスは <code>Table()</code>コンストラクタの <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/prototype">プロトタイプオブジェクト</a> を継承します。これは全ての <code>Table</code> インスタンスに影響するように変更可能です。</p> - -<h3 id="インスタンスプロパティ">インスタンスプロパティ</h3> - -<dl> - <dt><code>Table.prototype.constructor</code></dt> - <dd>このオブジェクトのインスタンスを生成した関数を返します。デフォルトでは {{jsxref("WebAssembly.Table()")}} コンストラクタです。</dd> - <dt>{{jsxref("Global_Objects/WebAssembly/Table/length","Table.prototype.length")}}</dt> - <dd>テーブルの長さを返します。すなわち、要素数です。</dd> -</dl> - -<h3 id="インスタンスメソッド">インスタンスメソッド</h3> - -<dl> - <dt>{{jsxref("Global_Objects/WebAssembly/Table/get","Table.prototype.get()")}}</dt> - <dd>アクセサ関数。インデックスから格納された要素を取得します。</dd> - <dt>{{jsxref("Global_Objects/WebAssembly/Table/grow","Table.prototype.grow()")}}</dt> - <dd>指定した要素数で Table インスタンスを拡張します。</dd> - <dt>{{jsxref("Global_Objects/WebAssembly/Table/set","Table.prototype.set()")}}</dt> - <dd>指定したインデックスに要素を格納します。</dd> -</dl> - -<h2 id="例">例</h2> - -<p>以下の例 (table2.htmlの <a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.html">ソースコード</a> と <a href="https://mdn.github.io/webassembly-examples/js-api-examples/table2.html">動作例</a> を参照) では初期サイズが2の WebAssembly Table インスタンスを生成しています。次に、テーブルの長さと2つのインデックスの内容を表示しています (長さが2で両方の要素が {{jsxref("null")}} であることを確認するために、{{jsxref("WebAssembly/Table/get", "Table.prototype.get()")}} を使って読み込んでいます) 。</p> - -<pre class="brush: js">var tbl = new WebAssembly.Table({initial:2, element:"anyfunc"}); -console.log(tbl.length); // "2" -console.log(tbl.get(0)); // "null" -console.log(tbl.get(1)); // "null"</pre> - -<p>次に、テーブルを含むインポートオブジェクトを作ります:</p> - -<pre class="brush: js">var importObj = { - js: { - tbl:tbl - } -};</pre> - -<p>最後に {{jsxref("WebAssembly.instantiateStreaming()")}} を使用して wasm モジュール (table2.wasm) をロード し、インスタンス化します。table2.wasm モジュールは2の関数を持っていて (1つは42を、もう1つは83を返す) 、インポートされたテーブルの0、1番目に両方の要素が格納されます (<a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.wat">text representation</a>を参照) 。そして、インスタンス化された後、テーブルの長さは2のままです。しかし、今はJSから呼び出し可能な <a href="/en-US/docs/WebAssembly/Exported_functions">エクスポートされたWebAssembly関数</a> が含まれています。</p> - -<pre class="brush: js">WebAssembly.instantiateStreaming(fetch('table2.wasm'), importObject) -.then(function(obj) { - console.log(tbl.length); - console.log(tbl.get(0)()); - console.log(tbl.get(1)()); -});</pre> - -<p>内部の値を表示するためには、参照された関数のアクセサの呼び出しの後に、2つ目の関数呼び出しを含める必要があることに注意して下さい (<code>get(0)</code> ではなく <code>get(0)()</code>)。</p> - -<p>この例では、JavaScript からテーブルを作成してアクセスしていますが、wasm インスタンス内で同じテーブルを参照して呼び出すこともできます。</p> - -<h2 id="仕様">仕様</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様</th> - <th scope="col">策定状況</th> - <th scope="col">コメント</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('WebAssembly JS', '#webassemblytable-objects', 'Table')}}</td> - <td>{{Spec2('WebAssembly JS')}}</td> - <td>初回ドラフト定義。</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2> - -<div>{{Compat("javascript.builtins.WebAssembly.Table")}}</div> - -<h2 id="関連情報">関連情報</h2> - -<ul> - <li><a href="/ja/docs/WebAssembly">WebAssembly</a> overview page</li> - <li><a href="https://developer.mozilla.org/ja/docs/WebAssembly/Concepts">WebAssembly のコンセプト</a></li> - <li><a href="https://developer.mozilla.org/ja/docs/WebAssembly/Using_the_JavaScript_API">WebAssembly JavaScript API を使用する</a></li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/index.md b/files/ja/web/javascript/reference/global_objects/webassembly/table/index.md new file mode 100644 index 0000000000..049d2bec2d --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/index.md @@ -0,0 +1,86 @@ +--- +title: WebAssembly.Table +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table +tags: + - Class + - JavaScript + - Reference + - WebAssembly + - table +browser-compat: javascript.builtins.WebAssembly.Table +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table +--- +{{JSRef}} + +**`WebAssembly.Table()`** オブジェクトは JavaScript のラッパーオブジェクトであり、関数の参照を格納する WebAssembly Table を表す配列風の構造を持っています。 JavaScript や WebAssembly のコードで作成されたテーブルは、 JavaScript と WebAssembly の両方からアクセスでき、変更もできます。 + +> **Note:** 現在、テーブルには関数の参照のみが格納できますが、将来的に拡張される予定です。 + +## コンストラクター + +- [`WebAssembly.Table()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/Table) + - : 新しい `Table` オブジェクトを生成します。 + +## インスタンスプロパティ + +- {{jsxref("WebAssembly/Table/length","Table.prototype.length")}} + - : テーブルの長さを返します。すなわち、要素数です。 + +## インスタンスメソッド + +- {{jsxref("WebAssembly/Table/get","Table.prototype.get()")}} + - : アクセサー関数です。指定した位置に格納された要素を取得します。 +- {{jsxref("WebAssembly/Table/grow","Table.prototype.grow()")}} + - : Table インスタンスを指定した要素数だけ拡張します。 +- {{jsxref("WebAssembly/Table/set","Table.prototype.set()")}} + - : 指定した位置に要素を格納します。 + +## 例 + +### 新しい WebAssembly Table インスタンスの生成 + +次の例では ([table2.html](https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.html) と[動作例](https://mdn.github.io/webassembly-examples/js-api-examples/table2.html)を確認してください)、新しい WebAssembly Table メソッドを初期サイズ 2 要素で生成します。それからそのテーブルの長さと 2 つの位置の内容を ({{jsxref("WebAssembly/Table/get", "Table.prototype.get()")}} を使用して受け取って) 表示し、長さが 2 で両方の要素が {{jsxref("null")}} であることを示します。 + +```js +var tbl = new WebAssembly.Table({initial:2, element:"anyfunc"}); +console.log(tbl.length); // "2" +console.log(tbl.get(0)); // "null" +console.log(tbl.get(1)); // "null" +``` + +次に、テーブルを含むインポートオブジェクトを生成します。 + +```js +var importObj = { + js: { + tbl:tbl + } +}; +``` + +<p>最後に {{jsxref("WebAssembly.instantiateStreaming()")}} を使用して wasm モジュール (table2.wasm) をロード し、インスタンス化します。table2.wasm モジュールは2の関数を持っていて (1つは42を、もう1つは83を返す) 、インポートされたテーブルの0、1番目に両方の要素が格納されます (<a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.wat">text representation</a>を参照) 。そして、インスタンス化された後、テーブルの長さは2のままです。しかし、今はJSから呼び出し可能な <a href="/en-US/docs/WebAssembly/Exported_functions">エクスポートされたWebAssembly関数</a> が含まれています。</p> + +<pre class="brush: js">WebAssembly.instantiateStreaming(fetch('table2.wasm'), importObject) +.then(function(obj) { + console.log(tbl.length); + console.log(tbl.get(0)()); + console.log(tbl.get(1)()); +});</pre> + +<p>内部の値を表示するためには、参照された関数のアクセサの呼び出しの後に、2つ目の関数呼び出しを含める必要があることに注意して下さい (<code>get(0)</code> ではなく <code>get(0)()</code>)。</p> + +<p>この例では、JavaScript からテーブルを作成してアクセスしていますが、wasm インスタンス内で同じテーブルを参照して呼び出すこともできます。</p> + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebAssembly](/ja/docs/WebAssembly) 概要ページ +- [WebAssembly の概念](/ja/docs/WebAssembly/Concepts) +- [WebAssembly JavaScript API の使用](/ja/docs/WebAssembly/Using_the_JavaScript_API) diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.html deleted file mode 100644 index e17643ba50..0000000000 --- a/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: WebAssembly.Table() コンストラクター -slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/Table -tags: - - Constructor - - JavaScript - - Reference - - WebAssembly - - コンストラクター -translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/Table ---- -<div>{{JSRef}}</div> - -<p><code><strong>WebAssembly.Table()</strong></code> コンストラクターは、大きさと要素の型を指定して新しい <code>Table</code> オブジェクトを生成します。</p> - -<h2 id="Syntax" name="Syntax">構文</h2> - -<pre class="syntaxbox">new WebAssembly.Table(tableDescriptor);</pre> - -<h3 id="Parameters" name="Parameters">引数</h3> - -<dl> - <dt><em>tableDescriptor</em></dt> - <dd>以下のメンバーを含むことができるオブジェクトです。 - <dl> - <dt><em>element</em></dt> - <dd>文字列で、テーブルに格納される値の型を表します。現時点では、 "<code>anyfunc</code>" (関数) の値のみを取ることができます。</dd> - <dt><em>initial</em></dt> - <dd>WebAssembly テーブルの初期の要素数です。</dd> - <dt><em>maximum {{optional_inline}}</em></dt> - <dd>WebAssembly テーブルが拡張する最大の要素数です。</dd> - </dl> - </dd> -</dl> - -<h3 id="Exceptions" name="Exceptions">例外</h3> - -<ul> - <li><code>tableDescriptor</code> がオブジェクトでない場合は、 {{jsxref("TypeError")}} が発生します。</li> - <li><code>maximum</code> が設定されており、かつ <code>initial</code> よりも小さい場合は、 {{jsxref("RangeError")}} が発生します。</li> -</ul> - -<h2 id="Examples" name="Examples">例</h2> - -<p>次の例では (table2.html の <a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.html">ソースコード</a> と <a href="https://mdn.github.io/webassembly-examples/js-api-examples/table2.html">デモ版</a>) 新しく WebAssembly テーブルのインスタンスを、2要素を初期の大きさとして生成します。それからテーブルの長さと2つの要素の中身を ({{jsxref("WebAssembly/Table/get", "Table.prototype.get()")}} で取得して) 表示し、長さは2で2つの要素は共に {{jsxref("null")}} となります。</p> - -<pre class="brush: js">var tbl = new WebAssembly.Table({initial:2, element:"anyfunc"}); -console.log(tbl.length); // "2" -console.log(tbl.get(0)); // "null" -console.log(tbl.get(1)); // "null"</pre> - -<p>それからテーブルを含むインポートオブジェクトを作成します。</p> - -<pre class="brush: js">var importObj = { - js: { - tbl:tbl - } -};</pre> - -<p>最終的に、 wasm モジュール (table2.wasm) を {{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用して読み込みインスタンス化します。 table2.wasm モジュールには2つの関数 (1つは 42 を返し、もう1つは 83 を返す) が入っており、それぞれをインポートされたテーブルの要素 0 と 1 に格納します。 (<a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.wat">テキスト表示</a> をご覧ください)。インスタンス化した後で、テーブルは長さが2のままですが、要素には呼び出し可能な<a href="/ja/docs/WebAssembly/Exported_functions">エクスポートされた WebAssembly 関数</a>が入り、 JS から呼び出せるようになりました。</p> - -<pre class="brush: js">WebAssembly.instantiateStreaming(fetch('table2.wasm'), importObject) -.then(function(obj) { - console.log(tbl.length); - console.log(tbl.get(0)()); - console.log(tbl.get(1)()); -});</pre> - -<p>なお、関数呼び出し演算子がアクセサーの後に二重についており、実際に参照している関数を呼び出して、その中に格納された値をログ出力しています (例えば <code>get(0)()</code> を <code>get(0)</code> の代わりに使用)。</p> - -<p>この例は JavaScript からテーブルを生成してアクセスする方法を示していますが、同じテーブルを wasm インスタンスの中から見ることができ、呼び出すこともできます。</p> - -<h2 id="Specifications" name="Specifications">仕様書</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様書</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('WebAssembly JS', '#dom-table-table', 'Table')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("javascript.builtins.WebAssembly.Table.Table")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/WebAssembly">WebAssembly</a> 概要ページ</li> - <li><a href="/ja/docs/WebAssembly/Concepts">WebAssembly の概念</a></li> - <li><a href="/ja/docs/WebAssembly/Using_the_JavaScript_API">WebAssembly JavaScript API の使用</a></li> -</ul> diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.md b/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.md new file mode 100644 index 0000000000..ff30415f27 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.md @@ -0,0 +1,90 @@ +--- +title: WebAssembly.Table() コンストラクター +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/Table +tags: + - コンストラクター + - JavaScript + - Reference + - WebAssembly +browser-compat: javascript.builtins.WebAssembly.Table.Table +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/Table +--- +{{JSRef}} + +**`WebAssembly.Table()`** コンストラクターは、大きさと要素の型を指定して新しい `Table` オブジェクトを生成します。 + +## 構文 + +```js +new WebAssembly.Table(tableDescriptor) +``` + +### 引数 + +- _tableDescriptor_ + + - : 以下のメンバーを含むことができるオブジェクトです。 + + - _element_ + - : 文字列で、テーブルに格納される値の型を表します。現時点では、 `"anyfunc"` (関数) の値のみを取ることができます。 + - _initial_ + - : WebAssembly テーブルの初期の要素数です。 + - _maximum {{optional_inline}}_ + - : WebAssembly テーブルが拡張することができる最大の要素数です。 + +### 例外 + +- `tableDescriptor` がオブジェクトでない場合は、 {{jsxref("TypeError")}} が発生します。 +- `maximum` が設定されており、かつ `initial` よりも小さい場合は、 {{jsxref("RangeError")}} が発生します。 + +## 例 + +### 新しい WebAssembly Table インスタンスの生成 + +次の例では (table2.html の[ソースコード](https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.html)と[実行例](https://mdn.github.io/webassembly-examples/js-api-examples/table2.html)はこちら) 新しく WebAssembly テーブルのインスタンスを、初期の大きさを 2 要素して生成します。それからテーブルの長さと 2 つの要素の中身を ({{jsxref("WebAssembly/Table/get", "Table.prototype.get()")}} で取得して) 表示し、長さは 2 で 2 つの要素は共に {{jsxref("null")}} となります。 + +```js +var tbl = new WebAssembly.Table({initial:2, element:"anyfunc"}); +console.log(tbl.length); // "2" +console.log(tbl.get(0)); // "null" +console.log(tbl.get(1)); // "null" +``` + +それからテーブルを含むインポートオブジェクトを作成します。 + +```js +var importObj = { + js: { + tbl:tbl + } +}; +``` + +最終的に、 wasm モジュール (table2.wasm) を {{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用して読み込みインスタンス化します。 table2.wasm モジュールには 2 つの関数 (1 つは 42 を返し、もう 1 つは 83 を返す) が入っており、それぞれをインポートされたテーブルの要素 0 と 1 に格納します。 ([テキスト表現](https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/table2.wat)をご覧ください)。インスタンス化した後で、テーブルは長さは 2 のままですが、要素には呼び出し可能な<a href="/ja/docs/WebAssembly/Exported_functions">エクスポートされた WebAssembly 関数</a>が入り、 JS から呼び出せるようになりました。 + +```js +WebAssembly.instantiateStreaming(fetch('table2.wasm'), importObject) +.then(function(obj) { + console.log(tbl.length); + console.log(tbl.get(0)()); + console.log(tbl.get(1)()); +}); +``` + +なお、関数呼び出し演算子がアクセサーの後に二重についており (例えば `get(0)()` を `get(0)` の代わりに使用)、実際に参照している関数を呼び出して、その中に格納された値をログ出力しています。 + +この例は JavaScript からテーブルを生成してアクセスする方法を示していますが、同じテーブルを wasm インスタンスの中から見ることができ、呼び出すこともできます。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [WebAssembly](/ja/docs/WebAssembly) 概要ページ +- [WebAssembly の概念](/ja/docs/WebAssembly/Concepts) +- [WebAssembly JavaScript API の使用](/ja/docs/WebAssembly/Using_the_JavaScript_API) |