JavaScript | Atomics.notify() 方法

Atomics.notify() 方法用于在SharedArrayBuffer 对象的指定索引上通知正在等待的线程。当该索引处的值被修改并且等待的线程中的某个线程由于调用了Atomics.wait() 方法而陷入等待时，该线程将被唤醒。

语法

Atomics.notify(typedArray, index, count);

参数

• typedArray ：一个含有所有线程都支持的数组类型的对象，在本方法中必须为SharedArrayBuffer对象。
• index (必须)：用于唤醒等待线程的索引（整数）。
• count (可选)：可以表示等待被唤醒的线程数。默认为1，即唤醒一个线程。

返回值

返回唤醒的线程数。

示例

const buffer = new SharedArrayBuffer(16);
const int32View = new Int32Array(buffer);

// 启动一个工作线程并等待唤醒
const worker = new Worker('worker.js');
Atomics.wait(int32View, 0, 0);

// 更改值并唤醒工作线程
Atomics.store(int32View, 0, 42);
const wokenUpCount = Atomics.notify(int32View, 0);

console.log(wokenUpCount); // 1，因为只唤醒了一个线程

注意

1. Atomics.notify()方法只应在SharedArrayBuffer上使用。如果在其它类型的数组上使用该方法，将会抛出TypeError异常。

2. 如果没有等待的线程在等待时调用Atomics.notify()，则该方法不会产生任何效果，返回值为0。

3. Atomics.notify() 方法不会保证哪些线程被唤醒，也不能保证在所有平台上的可预测性（即不能保证上下文切换的顺序或方式）。

4. Atomics.notify() 方法只能唤醒调用Atomics.wait() 方法并因等待句柄参数引用的值未偏离参数中给定的值而陷入等待的线程，对于通过任何其他方式处于阻塞状态的线程不会产生任何效果。

5. 如果在调用Atomics.notify() 方法返回之前发生了对指定值的更改，唤醒的线程可能仍然在等待。