The static Atomics
.store()
method stores a given value at the given position in the array and returns that value.
Syntax
Atomics.store(typedArray, index, value)
Parameters
typedArray
- A shared integer typed array. One of
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
, orUint32Array
. index
- The position in the
typedArray
to store avalue
in. value
- The number to store.
Return value
The value that has been stored.
Exceptions
- Throws a
TypeError
, iftypedArray
is not one of the allowed integer types. - Throws a
TypeError
, iftypedArray
is not a shared typed array type. - Throws a
RangeError
, ifindex
is out of bounds in thetypedArray
.
Examples
var sab = new SharedArrayBuffer(1024); var ta = new Uint8Array(sab); Atomics.store(ta, 0, 12); // 12
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript Latest Draft (ECMA-262) The definition of 'Atomics.store' in that specification. |
Living Standard | Initial definition in ES2017. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 60 | 16 | 55 46 — 541 | No | No | 10.1 |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | 60 | 60 | ? | 55 46 — 541 | No | No | No |
1. From version 46 until version 54 (exclusive): this feature is behind the javascript.options.shared_memory
preference (needs to be set to true
). To change preferences in Firefox, visit about:config.