JS Atomics.compareExchange()
这是一个实验中的功能
此功能某些浏览器尚在开发中。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
**Atomics**
.compareExchange()
静态方法会在数组的值与期望值相等的时候,将给定的替换值替换掉数组上的值,然后返回旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。
The source for this interactive example is stored in a GitHub repository. If you’d like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
语法
Atomics.compareExchange(typedArray, index, expectedValue, replacementValue)
参数
typedArray
一个共享的整型 typed array。例如 [Int8Array
](/api/js-es/ob-typed-array/int8-array.html"Int8Array 类型数组表示二进制补码8位有符号整数的数组。内容初始化为0。 一旦建立,你可以使用对象的方法引用数组中的元素,或使用标准数组索引语法( 即,使用括号注释)。"),Uint8Array
,Int16Array
,Uint16Array
,Int32Array
,或 Uint32Array
。
index
typedArray
的索引。
expectedValue
用于比较的值。
replacementValue
将要替换上的值。
返回值
给定位置的旧值(typedArray[index]
).
错误
- 假如
typedArray
不是允许的整型之一,则抛出TypeError
。 假如 typedArray
不是一个贡献的 typed array,则抛出TypeError
。- 如果
index
超出了typedArray 的边界,则抛出
RangeError
。
示例
var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);
ta[0] = 7;
Atomics.compareExchange(ta, 0, 7, 12); // returns 7, the old value
Atomics.load(ta, 0); // 12
规范
Specification | Status | Comment |
---|---|---|
Unknown Atomics.compareExchange | Unknown | Initial definition. |