From cd886fbabe78a862f1df68f5591fe2e23221532d Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Thu, 23 Sep 2021 10:09:01 +0900 Subject: Global_Objects/WebAssembly/Instance/Instance を更新 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Markdownに変換 - 2021/07/21 時点の英語版に同期 --- .../webassembly/instance/instance/index.md | 100 ++++++++++++--------- 1 file changed, 60 insertions(+), 40 deletions(-) (limited to 'files/ja/web/javascript') diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/instance/instance/index.md b/files/ja/web/javascript/reference/global_objects/webassembly/instance/instance/index.md index 68ac6cb80a..0b8326c9d3 100644 --- a/files/ja/web/javascript/reference/global_objects/webassembly/instance/instance/index.md +++ b/files/ja/web/javascript/reference/global_objects/webassembly/instance/instance/index.md @@ -2,61 +2,81 @@ title: WebAssembly.Instance() コンストラクター slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Instance/Instance tags: - - Constructor + - コンストラクター - JavaScript - Reference - WebAssembly - - コンストラクター +browser-compat: javascript.builtins.WebAssembly.Instance.Instance translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Instance/Instance --- -
{{JSRef}}
+{{JSRef}} + +**`WebAssembly.Instance()`** コンストラクターは、新しい `Instance` オブジェクトを生成します。これはステートフルで実行可能な {{jsxref("WebAssembly.Module")}} のインスタンスです。 + +## 構文 + +> **Warning:** 巨大なモジュールのインスタンス化は高コストになる可能性があるので、開発者が同期的な `Instance()` コンストラクターを使用するのは、絶対に必要な場合のみにするべきです。それ以外の場合はすべて、{{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用してください。 + +```js +new WebAssembly.Instance(module, importObject) +``` + +### 引数 + +- _module_ + - : インスタンス化する {{jsxref("WebAssembly.Module")}} オブジェクト。 +- _importObject_ {{optional_inline}} + - : 新しく生成される `Instance` にインポートされる値を持つオブジェクトで、例えば関数や {{jsxref("WebAssembly.Memory")}} オブジェクトなどです。モジュール内で宣言されたインポートそれぞれに対応するプロパティが存在する必要があります。そうでない場合、 {{jsxref("WebAssembly.LinkError")}} が発生します。 + +## 例 -

WebAssembly.Instance() コンストラクターは、新しい Instance オブジェクトを生成し、これはステートフルで実行可能な {{jsxref("WebAssembly.Module")}} のインスタンスです。

+### WebAssembly モジュールの同期的なインスタンス化 -

WebAssembly.Instance() コンストラクター関数は同期的に {{jsxref("WebAssembly.Module")}} オブジェクトをインスタンス化することができます。しかし、主な Instance の取得方法は非同期の {{jsxref("WebAssembly.instantiateStreaming()")}} 関数を使用する方法です。

+次のように `WebAssembly.Instance()` コンストラクター関数を呼び出して、渡した {{jsxref("WebAssembly.Module")}} オブジェクトを同期的にインスタンス化することができます。 -

構文

+```js +const importObject = { + imports: { + imported_func: function(arg) { + console.log(arg); + } + } +}; -
-

重要: 巨大なモジュールのインスタンス化は高コストになる可能性があります。開発者が同期的な Instance() コンストラクターを使用するのは、絶対に必要な場合のみにするべきです。他のすべての場合で非同期の {{jsxref("WebAssembly.instantiateStreaming()")}} メソッドの使用が推奨されます。

-
+fetch('simple.wasm').then(response => + response.arrayBuffer() +).then(bytes => { + let mod = new WebAssembly.Module(bytes); + let instance = new WebAssembly.Instance(mod, importObject); + instance.exports.exported_func(); +}) +``` -
new WebAssembly.Instance(module, importObject);
+ただし、`Instance` を取得する方法としては、次のように、非同期の {{jsxref("WebAssembly.instantiateStreaming()")}} 関数を使用することをお勧めします。 -

引数

+```js +const importObject = { + imports: { + imported_func: function(arg) { + console.log(arg); + } + } +}; -
-
module
-
インスタンス化する {{jsxref("WebAssembly.Module")}} オブジェクト。
-
importObject {{optional_inline}}
-
関数や {{jsxref("WebAssembly.Memory")}} オブジェクトなどの新しく生成される Instance にインポートされる値を持つオブジェクト。モジュール内で宣言されたインポートそれぞれに対応するプロパティが存在する必要があります。そうでない場合、 {{jsxref("WebAssembly.LinkError")}} が発生します。
-
+WebAssembly.instantiateStreaming(fetch('simple.wasm'), importObject) +.then(obj => obj.instance.exports.exported_func()); +``` -

仕様書

+## 仕様書 - - - - - - - - - - - -
仕様書
{{SpecName('WebAssembly JS', '#dom-instance-instance', 'Instance')}}
+{{Specifications}} -

ブラウザーの互換性

+## ブラウザーの互換性 -
-

{{Compat("javascript.builtins.WebAssembly.Instance.Instance")}}

-
+{{Compat}} -

関連情報

+## 関連情報 - +- [WebAssembly](/ja/docs/WebAssembly) 概要ページ +- [WebAssembly の概念](/ja/docs/WebAssembly/Concepts) +- [WebAssembly JavaScript API の使用](/ja/docs/WebAssembly/Using_the_JavaScript_API) -- cgit v1.2.3-54-g00ecf