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

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

语法

Atomics.add(typedArray, index, value)

参数

typedArray
一个共享的整型 typed array。例如 Int8ArrayUint8ArrayInt16ArrayUint16ArrayInt32Array,或者 Uint32Array
index
typedArray 中的位置,该位置数值会被加总并更新。
value
增加的数字。

返回值

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

错误

  • 假如 typedArray 不是允许的整型之一,则抛出 TypeError
  • 假如 typedArray 不是一个shared 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
Unknown
Atomics.add
Unknown Initial definition.

浏览器支持

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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

相关

文档标签和贡献者

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