Atomics.and() In JavaScript

What is Atomics? 

• Atomics is an object in JavaScript that provides the ability to perform atomic operations as static methods.
• Just like the Math object in JavaScript all the properties and methods of Atomics are also static.
• Atomics are used with SharedArrayBuffer(generic fixed-length binary data buffer) objects.
• Atomics are not constructors like other global objects.
• Atomics cannot be used with a new operator or can be invoked as a function.

Atomics Operations in JavaScript: Multiple threads can read and write the same data in memory when their shared memory is. To ensure that predicted values are written and read accurately, another operation cannot start until and unless the current one finishes. Atomic operations also cannot be interrupted.

Atomics.and() Method:

• Among the Atomic Operations, there is an inbuilt operation Atomics.and() in JavaScript that is used to compute a bitwise AND with a given value at a given position in the array.
• Atomics.and() operation returns the old value at that position.
• The integer typedarray, index, and the value are passed as an argument to the function and it returns the value that has been stored in the respective array.

Syntax: 

Atomics.and(typedArray, index, value)

Parameters Used: This method accepts three parameters which are described below: 

• typedarray: This parameter specifies a shared integer typed array Int8Array, Uint8Array, Int16Array etc.
• index: This parameter specifies the position in the array, typedArray to compute bitwise AND.
• value: This parameter specifies the number to compute bitwise AND with.

Return value: The Atomics.and() method returns the old value at the given position(typedArray[index]).

Examples:  

Input : arr[0] = 5
        Atomics.and(arr, 0, 3)
Output : 1

Input : arr[0] = 4
        Atomics.and(arr, 0, 6)
Output : 4

The below programs illustrate the Atomics.and() method:

Example 1: 

// creating a SharedArrayBuffer
let buf = new SharedArrayBuffer(16);
let arr = new Uint8Array(buf);

// Initialising element at zeroth
// position of array with 5
arr[0] = 5;

// Displaying the SharedArrayBuffer
console.log(Atomics.load(arr, 0));

// Displaying the return value of the 
// Atomics.and() method
console.log(Atomics.and(arr, 0, 9));

// Displaying the updated SharedArrayBuffer
console.log(Atomics.load(arr, 0));

Output: 

5
1
1

Example 2: 

// creating a SharedArrayBuffer
let buf = new SharedArrayBuffer(25);
let arr = new Uint8Array(buf);

// Initialising element at zeroth 
// position of array with 7
arr[0] = 7

// Displaying the SharedArrayBuffer
console.log(Atomics.load(arr, 0));

// Displaying the return value of the
// Atomics.and() method
console.log(Atomics.and(arr, 0, 2));

// Displaying the updated SharedArrayBuffer
console.log(Atomics.load(arr, 0));

Output: 

7
2
2

Application: Whenever we want to compute bitwise AND with any value and want to return the computed value, we use Atomics.and() operation in JavaScript.

Let’s see a JavaScript Program : 

// creating a SharedArrayBuffer
let mybuffer = new SharedArrayBuffer(25);
let myarray = new Uint8Array(mybuffer);

// Initialising the element at zeroth
// position of array with 11
myarray[0] = 11;

// Displaying the return value of the
// Atomics.and() method
console.log(Atomics.and(myarray, 0, 13));

// Displaying the updated SharedArrayBuffer
console.log(Atomics.load(myarray, 0));

Output: 

9
9

Exceptions: 

• If the typedArray is not one of the allowed integer types then the Atomics.and( ) operation throws a TypeError.
• If the typedArray is not a shared typed array then the Atomics.and( ) operation throws a TypeError.
• If the index used as an argument to the Atomics.and( ) operation is out of the bound in the typedArray then the Atomics.store( ) operation throws a RangeError.

Supported Browser:

• Google Chrome
• Microsoft Edge
• Firefox