MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

Atomics.add() 静态方法会添加给定的值到数组里的某个特定位置,且返回该位置的旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。

语法

Atomics.add(typedArray, index, value)

参数

typedArray
一个共享的整型 typed array。例如 Int8ArrayUint8ArrayInt16ArrayUint16ArrayInt32Array,或者 Uint32Array
index
将要添加值的 typedArray 中的位置。
value
添加的数字。

返回值

给定位置的旧值(typedArray[index])

错误

  • 假如 typedArray 不是允许的整型之一,则抛出 TypeError
  • 假如 typedArray 不是一个贡献的 typed array,则抛出 TypeError
  • 如果 index 超出了 typedArray 的边界,则抛出 RangeError

示例

var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);

Atomics.add(ta, 0, 12); // returns 0, the old value
Atomics.load(ta, 0); // 12

规范

Specification Status Comment
ECMAScript Shared Memory and Atomics
Atomics.add
Draft Initial definition.

浏览器支持

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 未实现 [2] 未实现 46 (46) [1] 未实现 未实现 未实现
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 未实现 未实现 46.0 (46) [1] 未实现 未实现 未实现

[1] 该功能被首选项设置禁用了。在 about:config,设置 javascript.options.shared_memory 为 true 来启用。

[2] 实现在开发之中,需要 flags: --js-flags=--harmony-sharedarraybuffer --enable-blink-feature=SharedArrayBuffer

相关

文档标签和贡献者

 此页面的贡献者: Ende93
 最后编辑者: Ende93,