Atomics.wait()

Cú pháp

Atomics.wait(typedArray, index, value)
Atomics.wait(typedArray, index, value, timeout)

Tham số

typedArray

Một Int32Array hoặc BigInt64Array xem một SharedArrayBuffer.

index

Vị trí trong typedArray để chờ.

value

Giá trị kỳ vọng cần kiểm tra.

timeout Optional

Thời gian chờ tính bằng mili giây. NaN (và các giá trị được chuyển đổi thành NaN, chẳng hạn như undefined) trở thành Infinity. Các giá trị âm trở thành 0.

Giá trị trả về

Một chuỗi là "not-equal", "ok", hoặc "timed-out".

• "not-equal" được trả về ngay lập tức nếu value ban đầu không bằng với những gì được lưu tại index.
• "ok" được trả về nếu được đánh thức bởi lời gọi Atomics.notify(), bất kể liệu giá trị kỳ vọng có thay đổi hay không.
• "timed-out" được trả về nếu một lần chờ ngủ vượt quá timeout được chỉ định mà không được đánh thức bởi Atomics.notify().

Ngoại lệ

TypeError

Được ném ra trong một trong các trường hợp sau:

• Nếu typedArray không phải là Int32Array hoặc BigInt64Array xem một SharedArrayBuffer.
• Nếu luồng hiện tại không thể bị chặn (ví dụ, vì nó là luồng chính).

RangeError

Được ném ra nếu index nằm ngoài giới hạn trong typedArray.

Ví dụ

Lưu ý rằng các ví dụ này không thể chạy trực tiếp từ console hoặc một trang web tùy ý, vì SharedArrayBuffer không được định nghĩa trừ khi các yêu cầu bảo mật của nó được đáp ứng.

Sử dụng Atomics.wait()

Cho một Int32Array được chia sẻ:

// Create a SharedArrayBuffer with a size in bytes
const sab = new SharedArrayBuffer(1024);
const int32 = new Int32Array(sab);

Luồng đọc đang ngủ và chờ tại vị trí 0 vì value được cung cấp khớp với những gì được lưu tại index được cung cấp. Luồng đọc sẽ không tiến lên cho đến khi luồng ghi đã gọi Atomics.notify() tại vị trí 0 của typedArray được cung cấp. Lưu ý rằng nếu, sau khi được đánh thức, giá trị tại vị trí 0 không được thay đổi bởi luồng ghi, luồng đọc sẽ không quay lại ngủ, mà sẽ tiếp tục.

Atomics.wait(int32, 0, 0);
console.log(int32[0]); // 123

Luồng ghi lưu một giá trị mới và thông báo cho luồng đang chờ một khi đã ghi:

console.log(int32[0]); // 0;
Atomics.store(int32, 0, 123);
Atomics.notify(int32, 0, 1);

Đặc tả kỹ thuật

Tương thích trình duyệt

Xem thêm

• Atomics
• Atomics.waitAsync()
• Atomics.notify()