W3cubDocs

/JavaScript

WebAssembly.memory.grow

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The grow() protoype property of the Memory object increases the size of the memory instance by a specified number of WebAssembly pages.

Syntax

memory.grow(number);

Parameters

number
The number of WebAssembly pages you want to grow the memory by (each one is 64KB in size).

Return value

Void.

Examples

The following example creates a new WebAssembly Memory instance with an initial size of 10 pages (640KB), and a maximum size of 100 pages (6.4MB).

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

We can then grow the instance by one page like so:

memory.grow(1);

Specifications

Specification Status Comment
Web Assembly JavaScript API
The definition of 'grow()' in that specification.
Draft Initial draft definition.

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support[1] No support No support[2] No support No support[1] No support
Feature Android Android Webview Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support No support No support[1] No support No support[2] No support No support No support No support[1]

[1] Experimental support can be enabled in Chrome 51+ and Opera 38+ by going to chrome://flags and enabling the Experimental WebAssembly flag.

[2] Experimental support can be enabled in Firefox 47+ by enabling the javascript.options.wasm flag in about:config.

See also

  • WebAssembly landing page.
  • WebAssembly concepts
  • Using the WebAssembly JavaScript API

© 2005–2017 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory/grow