mirror of
https://github.com/ruanyf/es6tutorial.git
synced 2025-05-24 18:32:22 +00:00
docs(Atomics): Atomics.wake() rename to Atomics.notify()
This commit is contained in:
parent
2e082a3343
commit
8f852c0425
@ -1215,9 +1215,11 @@ self.addEventListener('message', (event) => {
|
|||||||
|
|
||||||
上面代码将共享内存的偶数位置的值改成`1`,奇数位置的值改成`2`。
|
上面代码将共享内存的偶数位置的值改成`1`,奇数位置的值改成`2`。
|
||||||
|
|
||||||
**(3)Atomics.wait(),Atomics.wake()**
|
**(3)Atomics.wait(),Atomics.notify()**
|
||||||
|
|
||||||
使用`while`循环等待主线程的通知,不是很高效,如果用在主线程,就会造成卡顿,`Atomics`对象提供了`wait()`和`wake()`两个方法用于等待通知。这两个方法相当于锁内存,即在一个线程进行操作时,让其他线程休眠(建立锁),等到操作结束,再唤醒那些休眠的线程(解除锁)。
|
使用`while`循环等待主线程的通知,不是很高效,如果用在主线程,就会造成卡顿,`Atomics`对象提供了`wait()`和`notify()`两个方法用于等待通知。这两个方法相当于锁内存,即在一个线程进行操作时,让其他线程休眠(建立锁),等到操作结束,再唤醒那些休眠的线程(解除锁)。
|
||||||
|
|
||||||
|
`Atomics.notify()`方法以前叫做`Atomics.wake()`,后来进行了改名。
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
// Worker 线程
|
// Worker 线程
|
||||||
@ -1240,10 +1242,10 @@ const newArrayValue = 100;
|
|||||||
Atomics.store(sharedArray, 0, newArrayValue);
|
Atomics.store(sharedArray, 0, newArrayValue);
|
||||||
const arrayIndex = 0;
|
const arrayIndex = 0;
|
||||||
const queuePos = 1;
|
const queuePos = 1;
|
||||||
Atomics.wake(sharedArray, arrayIndex, queuePos);
|
Atomics.notify(sharedArray, arrayIndex, queuePos);
|
||||||
```
|
```
|
||||||
|
|
||||||
上面代码中,`sharedArray`的`0`号位置改为`100`,然后就执行`Atomics.wake()`方法,唤醒在`sharedArray`的`0`号位置休眠队列里的一个线程。
|
上面代码中,`sharedArray`的`0`号位置改为`100`,然后就执行`Atomics.notify()`方法,唤醒在`sharedArray`的`0`号位置休眠队列里的一个线程。
|
||||||
|
|
||||||
`Atomics.wait()`方法的使用格式如下。
|
`Atomics.wait()`方法的使用格式如下。
|
||||||
|
|
||||||
@ -1256,14 +1258,14 @@ Atomics.wait(sharedArray, index, value, timeout)
|
|||||||
- sharedArray:共享内存的视图数组。
|
- sharedArray:共享内存的视图数组。
|
||||||
- index:视图数据的位置(从0开始)。
|
- index:视图数据的位置(从0开始)。
|
||||||
- value:该位置的预期值。一旦实际值等于预期值,就进入休眠。
|
- value:该位置的预期值。一旦实际值等于预期值,就进入休眠。
|
||||||
- timeout:整数,表示过了这个时间以后,就自动唤醒,单位毫秒。该参数可选,默认值是`Infinity`,即无限期的休眠,只有通过`Atomics.wake()`方法才能唤醒。
|
- timeout:整数,表示过了这个时间以后,就自动唤醒,单位毫秒。该参数可选,默认值是`Infinity`,即无限期的休眠,只有通过`Atomics.notify()`方法才能唤醒。
|
||||||
|
|
||||||
`Atomics.wait()`的返回值是一个字符串,共有三种可能的值。如果`sharedArray[index]`不等于`value`,就返回字符串`not-equal`,否则就进入休眠。如果`Atomics.wake()`方法唤醒,就返回字符串`ok`;如果因为超时唤醒,就返回字符串`timed-out`。
|
`Atomics.wait()`的返回值是一个字符串,共有三种可能的值。如果`sharedArray[index]`不等于`value`,就返回字符串`not-equal`,否则就进入休眠。如果`Atomics.notify()`方法唤醒,就返回字符串`ok`;如果因为超时唤醒,就返回字符串`timed-out`。
|
||||||
|
|
||||||
`Atomics.wake()`方法的使用格式如下。
|
`Atomics.notify()`方法的使用格式如下。
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
Atomics.wake(sharedArray, index, count)
|
Atomics.notify(sharedArray, index, count)
|
||||||
```
|
```
|
||||||
|
|
||||||
它的三个参数含义如下。
|
它的三个参数含义如下。
|
||||||
@ -1272,7 +1274,7 @@ Atomics.wake(sharedArray, index, count)
|
|||||||
- index:视图数据的位置(从0开始)。
|
- index:视图数据的位置(从0开始)。
|
||||||
- count:需要唤醒的 Worker 线程的数量,默认为`Infinity`。
|
- count:需要唤醒的 Worker 线程的数量,默认为`Infinity`。
|
||||||
|
|
||||||
`Atomics.wake()`方法一旦唤醒休眠的 Worker 线程,就会让它继续往下运行。
|
`Atomics.notify()`方法一旦唤醒休眠的 Worker 线程,就会让它继续往下运行。
|
||||||
|
|
||||||
请看一个例子。
|
请看一个例子。
|
||||||
|
|
||||||
@ -1280,16 +1282,16 @@ Atomics.wake(sharedArray, index, count)
|
|||||||
// 主线程
|
// 主线程
|
||||||
console.log(ia[37]); // 163
|
console.log(ia[37]); // 163
|
||||||
Atomics.store(ia, 37, 123456);
|
Atomics.store(ia, 37, 123456);
|
||||||
Atomics.wake(ia, 37, 1);
|
Atomics.notify(ia, 37, 1);
|
||||||
|
|
||||||
// Worker 线程
|
// Worker 线程
|
||||||
Atomics.wait(ia, 37, 163);
|
Atomics.wait(ia, 37, 163);
|
||||||
console.log(ia[37]); // 123456
|
console.log(ia[37]); // 123456
|
||||||
```
|
```
|
||||||
|
|
||||||
上面代码中,视图数组`ia`的第 37 号位置,原来的值是`163`。Worker 线程使用`Atomics.wait()`方法,指定只要`ia[37]`等于`163`,就进入休眠状态。主线程使用`Atomics.store()`方法,将`123456`写入`ia[37]`,然后使用`Atomics.wake()`方法唤醒 Worker 线程。
|
上面代码中,视图数组`ia`的第 37 号位置,原来的值是`163`。Worker 线程使用`Atomics.wait()`方法,指定只要`ia[37]`等于`163`,就进入休眠状态。主线程使用`Atomics.store()`方法,将`123456`写入`ia[37]`,然后使用`Atomics.notify()`方法唤醒 Worker 线程。
|
||||||
|
|
||||||
另外,基于`wait`和`wake`这两个方法的锁内存实现,可以看 Lars T Hansen 的 [js-lock-and-condition](https://github.com/lars-t-hansen/js-lock-and-condition) 这个库。
|
另外,基于`wait`和`notify`这两个方法的锁内存实现,可以看 Lars T Hansen 的 [js-lock-and-condition](https://github.com/lars-t-hansen/js-lock-and-condition) 这个库。
|
||||||
|
|
||||||
注意,浏览器的主线程不宜设置休眠,这会导致用户失去响应。而且,主线程实际上会拒绝进入休眠。
|
注意,浏览器的主线程不宜设置休眠,这会导致用户失去响应。而且,主线程实际上会拒绝进入休眠。
|
||||||
|
|
||||||
@ -1335,3 +1337,4 @@ Atomics.xor(sharedArray, index, value)
|
|||||||
- `Atomics.isLockFree(size)`:返回一个布尔值,表示`Atomics`对象是否可以处理某个`size`的内存锁定。如果返回`false`,应用程序就需要自己来实现锁定。
|
- `Atomics.isLockFree(size)`:返回一个布尔值,表示`Atomics`对象是否可以处理某个`size`的内存锁定。如果返回`false`,应用程序就需要自己来实现锁定。
|
||||||
|
|
||||||
`Atomics.compareExchange`的一个用途是,从 SharedArrayBuffer 读取一个值,然后对该值进行某个操作,操作结束以后,检查一下 SharedArrayBuffer 里面原来那个值是否发生变化(即被其他线程改写过)。如果没有改写过,就将它写回原来的位置,否则读取新的值,再重头进行一次操作。
|
`Atomics.compareExchange`的一个用途是,从 SharedArrayBuffer 读取一个值,然后对该值进行某个操作,操作结束以后,检查一下 SharedArrayBuffer 里面原来那个值是否发生变化(即被其他线程改写过)。如果没有改写过,就将它写回原来的位置,否则读取新的值,再重头进行一次操作。
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user