From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../webassembly/memory/buffer/index.html | 62 ++++++++++++++ .../webassembly/memory/grow/index.html | 80 ++++++++++++++++++ .../global_objects/webassembly/memory/index.html | 91 +++++++++++++++++++++ .../webassembly/memory/memory/index.html | 94 ++++++++++++++++++++++ .../webassembly/memory/prototype/index.html | 70 ++++++++++++++++ 5 files changed, 397 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/webassembly/memory/buffer/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/webassembly/memory/grow/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/webassembly/memory/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/webassembly/memory/memory/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/webassembly/memory/prototype/index.html (limited to 'files/ja/web/javascript/reference/global_objects/webassembly/memory') diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/memory/buffer/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/memory/buffer/index.html new file mode 100644 index 0000000000..edf93b9c7b --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/memory/buffer/index.html @@ -0,0 +1,62 @@ +--- +title: WebAssembly.Memory.prototype.buffer +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/buffer +tags: + - API + - Buffer + - JavaScript + - Property + - Reference + - WebAssembly + - memory + - プロパティ +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/buffer +--- +
{{JSRef}}
+ +

buffer は {{jsxref("WebAssembly.Memory")}} オブジェクトのプロトタイププロパティで、メモリに含まれるバッファーを返します。

+ +

例

+ +

次の例では (GitHub 上の memory.html およびライブデモ版 もご覧ください)、 memory.wasm バイトコードを {{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用して読み込みんでインスタンス化し、その上の行で生成されたメモリにインポートします。それから、メモリにいくつかの値を格納し、関数をエクスポートして使用し、いくつかの値を合計します。

+ +
WebAssembly.instantiateStreaming(fetch('memory.wasm'), { js: { mem: memory } })
+.then(obj => {
+  var i32 = new Uint32Array(memory.buffer);
+  for (var i = 0; i < 10; i++) {
+    i32[i] = i;
+  }
+  var sum = obj.instance.exports.accumulate(0, 10);
+  console.log(sum);
+});
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('WebAssembly JS', '#dom-memory-buffer', 'buffer')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.WebAssembly.Memory.buffer")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/memory/grow/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/memory/grow/index.html new file mode 100644 index 0000000000..28df2da77d --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/memory/grow/index.html @@ -0,0 +1,80 @@ +--- +title: WebAssembly.Memory.prototype.grow() +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/grow +tags: + - API + - JavaScript + - Method + - Reference + - WebAssembly + - grow + - memory + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/grow +--- +
{{JSRef}}
+ +

grow() は {{jsxref("WebAssembly.Memory")}} オブジェクトのプロトタイプメソッドで、指定した WebAssembly ページの数だけメモリインスタンスの大きさを拡張します。

+ +

構文

+ +
memory.grow(number);
+
+ +

引数

+ +
+
number
+
メモリを拡大する WebAssembly ページ数 (それぞれは 64KiB の大きさ)。
+
+ +

返値

+ +

以前のメモリの大きさを、 WebAssembly ページ単位で返します。

+ +

例

+ +

以下の例では、新しい WebAssembly メモリインスタンスを初期サイズ1ページ (64KiB)、最大サイズ10ページ (640KiB) で作成します。

+ +
var memory = new WebAssembly.Memory({initial:1, maximum:10});
+ +

それから、インスタンスを1ページ分拡張することができます。

+ +
const bytesPerPage = 64 * 1024;
+console.log(memory.buffer.byteLength / bytesPerPage);  // "1"
+console.log(memory.grow(1));                           // "1"
+console.log(memory.buffer.byteLength / bytesPerPage);  // "2"
+
+ +

なお、ここでの grow() の返値は直前の WebAssembly ページ数です。

+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('WebAssembly JS', '#dom-memory-grow', 'grow()')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.WebAssembly.Memory.grow")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/memory/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/memory/index.html new file mode 100644 index 0000000000..39a3a1ddea --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/memory/index.html @@ -0,0 +1,91 @@ +--- +title: WebAssembly.Memory() +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory +tags: + - Class + - JavaScript + - Reference + - WebAssembly + - クラス +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory +--- +
{{JSRef}}
+ +

WebAssembly.Memory オブジェクトは {{jsxref("WebAssembly/Memory/buffer","buffer")}} プロパティを持ち、これはサイズ変更可能な {{jsxref("ArrayBuffer")}} で、 WebAssembly Instance からアクセスする生のバイト列のメモリを持ちます。

+ +

JavaScript または WebAssembly コードから生成されたメモリは JavaScript と WebAssembly のどちらからもアクセス、変更が可能になります。

+ +

コンストラクター

+ +
+
{{jsxref("WebAssembly.Memory()")}}
+
新しい Memory オブジェクトを生成します。
+
+ +

Memory インスタンス

+ +

全ての Memory インスタンスは Memory() コンストラクターのプロトタイプオブジェクトを継承しています。これは全ての Memory インスタンスに影響するように変更可能です。

+ +

インスタンスプロパティ

+ +
+
Memory.prototype.constructor
+
このオブジェクトのインスタンスを生成した関数を返します。既定では {{jsxref("WebAssembly.Memory()")}} コンストラクターです。
+
{{jsxref("WebAssembly/Memory/buffer","Memory.prototype.buffer")}}
+
メモリに格納されているバッファーを返すアクセサープロパティです。/dd>
+
+ +

インスタンスメソッド

+ +
+
{{jsxref("WebAssembly/Memory/grow","Memory.prototype.grow()")}}
+
指定した WebAssembly ページの数 (64KBを1単位とする) で Memory インスタンスのサイズを増やします。
+
+ +

例

+ +

WebAssembly.Memory オブジェクトを取得する方法は2つあります。1つ目は JavaScript から生成する方法です。以下の例では、初期サイズが10ページ (640KiB) 、最大サイズが100ページ (6.4MiB) で新しい WebAssembly Memory インスタンスを生成しています。

+ +
var memory = new WebAssembly.Memory({initial:10, maximum:100});
+ +

2つ目は WebAssembly モジュールからエクスポートされた WebAssembly.Memory オブジェクトを使用する方法です。次の例では (GitHub 上の memory.html およびライブデモ版 もご覧ください)、 memory.wasm バイトコードを {{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用して読み込みんでインスタンス化し、その上の行で生成されたメモリにインポートします。それから、メモリにいくつかの値を格納し、関数をエクスポートして使用し、いくつかの値を合計します。

+ +
fetchAndInstantiate('memory.wasm').then(function(instance) {
+  var i32 = new Uint32Array(instance.exports.mem.buffer);
+  for (var i = 0; i < 10; i++) {
+    i32[i] = i;
+  }
+  var sum = instance.exports.accumulate(0, 10);
+  console.log(sum);
+});
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('WebAssembly JS', '#memories', 'Memory')}}
+ +

ブラウザーの互換性

+ +
+ + +

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

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/memory/memory/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/memory/memory/index.html new file mode 100644 index 0000000000..ff8180c361 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/memory/memory/index.html @@ -0,0 +1,94 @@ +--- +title: WebAssembly.Memory() コンストラクター +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/Memory +tags: + - Constructor + - JavaScript + - Reference + - WebAssembly + - コンストラクター +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/Memory +--- +
{{JSRef}}
+ +

The WebAssembly.Memory() コンストラクターは新しい Memory オブジェクトを生成します。これは {{jsxref("WebAssembly/Memory/buffer","buffer")}} プロパティでサイズ変更可能な {{jsxref("ArrayBuffer")}} により、 WebAssembly Instance からアクセスする生のバイト列のメモリを持ちます。

+ +

JavaScript または WebAssembly コードから生成されたメモリは JavaScript と WebAssembly のどちらからもアクセス、変更が可能になります。

+ +

構文

+ +
new WebAssembly.Memory(memoryDescriptor);
+ +

引数

+ +
+
memoryDescriptor
+
以下のメンバーを含むことができるオブジェクトです。 +
+
initial
+
WebAssembly メモリの初期サイズで、単位は WebAssembly ページ数です。
+
maximum {{optional_inline}}
+
WebAssembly メモリを拡張できる最大サイズで、単位は WebAssembly ページ数です。存在する場合、 maximum 引数はエンジンがメモリを予約するヒントとして使用されます。ただし、エンジンはこの予約リクエストを無視したり固定したりすることがあります。一般的に、ほとんどの WebAssembly モジュールは maximum を設定する必要はありません。
+
+
+
+ +
+

メモ: WebAssembly ページは 65,536 バイト、すなわち 64KiB の固定長です。

+
+ +

例外

+ + + +

例

+ +

WebAssembly.Memory オブジェクトを取得する方法は2つあります。1つ目は JavaScript から生成する方法です。以下の例では、初期サイズが10ページ (640KiB) 、最大サイズが100ページ (6.4MiB) で新しい WebAssembly Memory インスタンスを生成しています。

+ +
var memory = new WebAssembly.Memory({initial:10, maximum:100});
+ +

2つ目は WebAssembly モジュールからエクスポートされた WebAssembly.Memory オブジェクトを使用する方法です。次の例では (GitHub 上の memory.html およびライブデモ版 もご覧ください)、 memory.wasm バイトコードを {{jsxref("WebAssembly.instantiateStreaming()")}} メソッドを使用して読み込みんでインスタンス化し、その上の行で生成されたメモリにインポートします。それから、メモリにいくつかの値を格納し、関数をエクスポートして使用し、いくつかの値を合計します。

+ +
WebAssembly.instantiateStreaming(fetch('memory.wasm'), { js: { mem: memory } })
+.then(obj => {
+  var i32 = new Uint32Array(memory.buffer);
+  for (var i = 0; i < 10; i++) {
+    i32[i] = i;
+  }
+  var sum = obj.instance.exports.accumulate(0, 10);
+  console.log(sum);
+});
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('WebAssembly JS', '#dom-memory-memory', 'Memory')}}
+ +

ブラウザーの互換性

+ +
+ + +

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

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/memory/prototype/index.html b/files/ja/web/javascript/reference/global_objects/webassembly/memory/prototype/index.html new file mode 100644 index 0000000000..e9e48b5bec --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/webassembly/memory/prototype/index.html @@ -0,0 +1,70 @@ +--- +title: WebAssembly.Memory.prototype +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/prototype +tags: + - JavaScript + - Property + - Prototype + - WebAssembly + - memory +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory +--- +
{{JSRef}} {{SeeCompatTable}}
+ +

WebAssembly.Memory.prototype プロパティは {{jsxref("WebAssembly.Memory()")}} コンストラクタのプロトタイプを表します。

+ +
{{js_property_attributes(0, 0, 0)}}
+ +

説明

+ +

全ての {{jsxref("WebAssembly.Memory")}} インスタンスは Memory.prototype を継承します。 {{jsxref("WebAssembly.Memory()")}} コンストラクタのプロトタイプオブジェクトは全ての {{jsxref( "WebAssembly.Memory")}} インスタンスに影響するように変更可能です。

+ +

プロパティ

+ +
+
Memory.prototype.constructor
+
このオブジェクトのインスタンスを生成した関数を返します。デフォルトでは {{jsxref("WebAssembly.Memory()")}} コンストラクタです。
+
{{jsxref("WebAssembly/Memory/buffer","Memory.prototype.buffer")}}
+
メモリーに格納されているバッファを返すアクセサプロパティ。
+
+

メソッド

+
+
{{jsxref("WebAssembly/Memory/grow","Memory.prototype.grow()")}}
+
指定した WebAssembly ページの数 (64KBを1単位とする) で Memory インスタンスのサイズを増やします。
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様策定状況コメント
{{SpecName('WebAssembly JS', '#webassemblymemory-objects', 'Memory')}}{{Spec2('WebAssembly JS')}}初回ドラフト定義
+ +

ブラウザ実装状況

+ +
+ + +

{{Compat("javascript.builtins.WebAssembly.Memory.prototype")}}

+
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf