Skip to content
Related Articles

Related Articles

Atomics.and( ) In JavaScript

Improve Article
Save Article
  • Last Updated : 27 Oct, 2022
Improve Article
Save Article

What is Atomics? 
The Atomics is an object in JavaScript which provides atomic operations to be performed 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 a method Atomics.and() that is used to compute a bitwise AND operation with a given value at a given position in an array. The old value at that position is returned by Atomics.and() function. No other write operation can happen until the modified value is written back.

Syntax:  

Atomics.and(typedArray, index, value)

Parameters Used:  

  1. typedarray: It is the shared integer typed array you want to modify.
  2. index: It is the position in the typedArray where you want to compute bitwise AND.
  3. value: It is the number you want to compute the bitwise AND with.

Return Value: Atomics.and() returns the old value at the given position (typedArray[index]).
Examples of the above function are provided below.

Examples: 

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

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

Codes for the above function are provided below. 

Code 1:  

Javascript




<script>
    // creating a SharedArrayBuffer
    var buf = new SharedArrayBuffer(25);
    var arr = new Uint8Array(buf);
     
    // Initialising element at zeroth position of array with 9
    arr[0] = 9;
     
    // 9 (1001) AND 3 (0011) =  1 (0001)
    // Displaying the return value of the Atomics.and() method
    console.log(Atomics.and(arr, 0, 3));
     
    // Displaying the updated SharedArrayBuffer
    console.log(Atomics.load(arr, 0));
</script>

Output: 

9
1

Code 2: 

Javascript




<script>
    // creating a SharedArrayBuffer
    var buf = new SharedArrayBuffer(25);
    var arr = new Uint8Array(buf);
     
    // Initialising element at zeroth position of array with 3
    arr[0] = 3;
     
    // 3 (0011) AND 2 (0010) =  2 (0010)
    // 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));
</script>

Output: 

3
2

Exceptions : 

  • Throws a TypeError, if typedArray is not one of the allowed integer types.
  • Throws a TypeError, if typedArray is not a shared typed array type.
  • Throws a RangeError, if the index is out of bounds in the typedArray.

Supported Browser:

  • Google Chrome
  • Microsoft Edge
  • Firefox

My Personal Notes arrow_drop_up
Related Articles

Start Your Coding Journey Now!