JavaScript Atomics load()用法及代碼示例

在 Atomic Operations 中，有一個內置操作 Atomics.load() 用於返回駐留在數組中給定位置的值。整數類型數組和值的索引作為參數傳遞給函數。 Atomics.load() 返回數組給定位置的值。

注意：Atomics.load() 可以與任何可與共享內存一起使用的類型化數組一起使用，包括整型8數組,Uint8Array,Int16數組,Uint16數組,Int32數組,Uint32Array,浮點32數組， 和Float64數組。另外，原子.load()方法返回類型化數組中指定索引處的值。

用法:

Atomics.load(typedArray, index)

參數：

• typedarray：它是您要修改的共享整數類型數組。
• index：它是 typedArray 中要加載值的位置。

返回值：Atomics.load() 返回給定位置 (typedArray[index]) 的值。

下麵提供了上述函數的示例。

例子：

Input : arr[0] = 9;
        Atomics.load(arr, 0);
Output : 9

Input : arr[0] = 3; 
        Atomics.add(arr, 0, 2)
        Atomics.load(arr, 0);
Output : 5

下麵提供上述方法的示例。

示例 1：假設我們有一個SharedArrayBuffer，用於在兩個網絡工作者之間共享內存。我們可以使用 Atomics.load() 方法加載共享數組緩衝區中特定索引處的值：

// create a shared array buffer 
const sharedBuffer = new SharedArrayBuffer(4); 
  
// create a view of the shared buffer as a 32-bit integer array 
const sharedArray = new Int32Array(sharedBuffer); 
  
// set the value at index 0 to 42 
sharedArray[0] = 42; 
  
// load the value at index 0 atomically 
const loadedValue = Atomics.load(sharedArray, 0); 
  
console.log(loadedValue); // output: 42

輸出：

9

在上麵的示例 1 中，我們創建了一個 SharedArrayBuffer 和一個 32 位整數數組形式的緩衝區視圖。我們將索引0處的值設置為42，然後使用Atomics.load()將索引0處的值加載到loadedValue變量中。因為我們使用的是 Atomics.load()，所以加載操作相對於有權訪問同一共享內存的任何其他代理來說保證是原子的。

示例 2：

// creating a SharedArrayBuffer  
let buf = new SharedArrayBuffer(25); 
let arr = new Uint8Array(buf); 
  
// Initialising element at zeroth position of array with 3 
arr[0] = 3; 
  
// Displaying the SharedArrayBuffer  
console.log(Atomics.load(arr, 0)); 
  
// Displaying the return value of the Atomics.add() method  
console.log(Atomics.add(arr, 0, 2)); 
  
// Displaying the updated SharedArrayBuffer  
console.log(Atomics.load(arr, 0));

輸出：

3
3
5

應用：每當我們想要從數組的指定位置返回一個值時，我們都會在 JavaScript 中使用 Atomics.load() 操作。

例子：

// creating a SharedArrayBuffer  
let mybuffer = new SharedArrayBuffer(25); 
let myarray = new Uint8Array(mybuffer); 
  
// Initialising the element at zeroth position of array 
myarray[0] = 40; 
  
// Displaying the SharedArrayBuffer  
console.log(Atomics.load(myarray, 0));

輸出：

40

異常：

• 如果 typedArray 不是允許的整數類型之一，則 Atomics.load() 操作會拋出 TypeError。
• 如果 typedArray 不是共享類型數組，則 Atomics.load() 操作會拋出 TypeError。
• 如果用作 Atomics.load() 操作參數的索引超出了 typedArray 的範圍，則 Atomics.load() 操作將拋出 RangeError。

支持的瀏覽器：

• 穀歌瀏覽器
• 微軟邊
• Firefox
• Opera
• Safari

我們有 Javascript 原子方法的完整列表，要檢查這些方法，請閱讀這篇JavaScript Atomics Complete Reference 文章。

我們有一份關於 Javascript 的備忘單，其中涵蓋了 Javascript 的所有重要主題，請查看這些主題Javascript Cheat Sheet-A JavaScript 基本指南.