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 基本指南.