diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
|---|---|---|
| committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
| commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
| tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/javascript/reference/global_objects/webassembly/table | |
| parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
| download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip | |
initial commit
Diffstat (limited to 'files/ja/web/javascript/reference/global_objects/webassembly/table')
7 files changed, 622 insertions, 0 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 new file mode 100644 index 0000000000..fa797cb7a6 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/get/index.html @@ -0,0 +1,79 @@ +--- +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> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<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/grow/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.html new file mode 100644 index 0000000000..4819f33086 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/grow/index.html @@ -0,0 +1,79 @@ +--- +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> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<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/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/index.html new file mode 100644 index 0000000000..963a942b65 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/index.html @@ -0,0 +1,126 @@ +--- +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/length/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/length/index.html new file mode 100644 index 0000000000..8d6c3ae6c9 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/length/index.html @@ -0,0 +1,63 @@ +--- +title: WebAssembly.Table.prototype.length +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/length +tags: + - API + - JavaScript + - Property + - Reference + - length + - table + - プロパティ +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/length +--- +<div>{{JSRef}}</div> + +<p>{{jsxref("WebAssembly.Table")}} オブジェクトの <code><strong>length</strong></code> プロトタイププロパティはテーブルの長さを返します。すなわち、テーブルの要素数です。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">table.length; +</pre> + +<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-length', 'length')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.WebAssembly.Table.length")}}</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/prototype/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/prototype/index.html new file mode 100644 index 0000000000..8a178f1ce3 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/prototype/index.html @@ -0,0 +1,74 @@ +--- +title: WebAssembly.Table.prototype +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/prototype +tags: + - JavaScript + - Property + - Prototype + - WebAssembly + - table +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table +--- +<div>{{JSRef}} {{SeeCompatTable}}</div> + +<p><code><strong>WebAssembly.Table</strong></code><strong><code>.prototype</code></strong> プロパティは {{jsxref("WebAssembly.Table()")}} コンストラクタのプロトタイプを表します。</p> + +<div>{{js_property_attributes(0, 0, 0)}}</div> + +<h2 id="説明">説明</h2> + +<p>全ての {{jsxref("WebAssembly.Table")}} インスタンスは <code>Table.prototype</code> を継承します。{{jsxref("WebAssembly.Table()")}} コンストラクタのプロトタイプオブジェクトは全ての {{jsxref( "WebAssembly.Table")}} インスタンスに影響するように変更可能です。</p> + +<h2 id="プロパティ">プロパティ</h2> + +<dl> + <dt><code>Table.prototype.constructor</code></dt> + <dd>このオブジェクトのインスタンスを生成した関数を返します。デフォルトでは {{jsxref("WebAssembly.Table()")}} コンストラクタです。</dd> + <dt>{{jsxref("WebAssembly/Table/length","Table.prototype.length")}}</dt> + <dd>テーブルの長さを返します。すなわち、要素数です。</dd> + <dt> + <h2 id="メソッド">メソッド</h2> + </dt> + <dt>{{jsxref("WebAssembly/Table/get","Table.prototype.get()")}}</dt> + <dd>アクセサ関数。インデックスから格納された要素を取得します。</dd> + <dt>{{jsxref("WebAssembly/Table/grow","Table.prototype.grow()")}}</dt> + <dd>指定した要素数で Table インスタンスを拡張します。</dd> + <dt>{{jsxref("WebAssembly/Table/set","Table.prototype.set()")}}</dt> + <dd>指定したインデックスに要素を格納します。</dd> +</dl> + +<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="ブラウザ実装状況">ブラウザ実装状況</h2> + +<div> + + +<p>{{Compat("javascript.builtins.WebAssembly.Table.prototype")}}</p> +</div> + +<h2 id="関連情報">関連情報</h2> + +<ul> + <li>{{jsxref("WebAssembly.Table")}}</li> + <li><a href="/ja/docs/WebAssembly">WebAssembly</a> overview page</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/set/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/set/index.html new file mode 100644 index 0000000000..681c1b6ed7 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/set/index.html @@ -0,0 +1,101 @@ +--- +title: WebAssembly.Table.prototype.set() +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/set +tags: + - API + - JavaScript + - Method + - Reference + - WebAssembly + - set + - table + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Table/set +--- +<div>{{JSRef}}</div> + +<p>{{jsxref("WebAssembly.Table")}} オブジェクトの <code><strong>set()</strong></code> プロトタイプメソッドは指定されたインデックスに格納されている参照を違う値に変更します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">table.set(<em>index</em>, <em>value</em>); +</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><em>index</em></dt> + <dd>変更する関数参照のインデックス。</dd> + <dt><em>value</em></dt> + <dd>変更する参照。これは <a href="/ja/docs/WebAssembly/Exported_functions">エクスポートされた WebAssembly 関数</a> 、 wasm 関数を内在する JavaScript ラッパーである必要があります。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>なし。</p> + +<h3 id="Exception" name="Exception">例外</h3> + +<ul> + <li><em>index</em> が {{jsxref("Global_Objects/WebAssembly/Table/length","Table.prototype.length")}} の場合、 {{jsxref("RangeError")}} がスローされます。</li> + <li><em>value</em> がエクスポートされた WebAssembly 関数でも <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/null">null</a></code> でもない場合、{{jsxref("TypeError")}} をスローします。</li> +</ul> + +<h2 id="Examples" name="Examples">例</h2> + +<p>次の例では、2つ参照を持つ WebAssembly Table インスタンスを生成しています (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で、関数参照が含まれないこと ({{jsxref("null")}} を返します) を確認するために、テーブルの長さと2つのインデックス ({{jsxref("Global_Objects/WebAssembly/Table/get","Table.prototype.get()")}} を通して読み出して) のコンテンツを表示します。</p> + +<pre class="brush: js">var tbl = new WebAssembly.Table({initial:2, element:"anyfunc"}); +console.log(tbl.length); +console.log(tbl.get(0)); +console.log(tbl.get(1));</pre> + +<p>次にテーブルの参照を含むインポートオブジェクトを作成します:</p> + +<pre class="brush: js">var importObj = { + js: { + tbl:tbl + } +};</pre> + +<p>最後に、<code><a href="https://github.com/mdn/webassembly-examples/blob/master/wasm-utils.js">fetchAndInstantiate()</a></code> ユーティリティ関数を使用して wasm モジュール (table2.wasm) をロードしてインスタンス化します。テーブルの長さを表示して、いまテーブルに格納された(table2.wasm モジュール (<a href="https://github.com/mdn/webassembly-examples/blob/master/text-format-examples/table2.was">テキスト表現</a> を参照) はテーブルに2つの関数参照を追加し、両方とも、簡単な数値を表示します)2つの関数参照を実行します:</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="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('WebAssembly JS', '#dom-table-set', 'set()')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<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/table/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.html new file mode 100644 index 0000000000..e293ab5bd1 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/table/table/index.html @@ -0,0 +1,100 @@ +--- +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> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<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> |
