Atomics.exchange
Atomics.exchange
Atomics.exchange()
静态方法会用给定的值替换掉数组上的值,然后返回数组的旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。
语法
Atomics.exchange(typedArray, index, value)
参数
typedArray
一个共享的整型 typed array。例如 Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
,或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.exchange(ta, 0, 12 // returns 0, the old value
Atomics.load(ta, 0 // 12
规范
Specification | Status | Comment |
---|---|---|
ECMAScript Latest Draft (ECMA-262)The definition of 'Atomics.exchange' in that specification. | Living Standard | Initial definition in ES2017. |
浏览器兼容性
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | No support 2 | No support | 55 (55) 1 | No support | No support | No support |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | No support | 55.0 (55) 1 | No support | No support | No support |