Atomics.exchange()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021年12月.

Atomics.exchange() は静的メソッドで、指定された値を配列内の指定した位置と交換し、その値を返します。これは不可分操作で、古い値を読み取ってから新しい値を書き込むまでの間に他の物が書き込まないことを保証します。

試してみましょう

// バイト単位でサイズを指定して SharedArrayBuffer を作成
const buffer = new SharedArrayBuffer(16);
const uint8 = new Uint8Array(buffer);
uint8[0] = 5;

console.log(Atomics.load(uint8, 0));
// 予想される結果: 5

Atomics.exchange(uint8, 0, 2); // Returns 5
console.log(Atomics.load(uint8, 0));
// 予想される結果: 2

構文

Atomics.exchange(typedArray, index, value)

引数

typedArray

共有整数の型付き配列です。 Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array, BigUint64Array の何れかです。

index

typedArray で value と交換する位置です。

value

交換する数値です。

返値

指定された位置 (typedArray[index]) にあった古い値です。

例外

TypeError

typedArray が許可された整数型のいずれでもない場合に発生します。

RangeError

index が typedArray の範囲を超えている場合に発生します。

例

exchange() の使用

js
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);

Atomics.exchange(ta, 0, 12); // 古い値である 0 を返す
Atomics.load(ta, 0); // 12

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-atomics.exchange

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年7月25日 by MDN contributors.

View this page on GitHub • Report a problem with this content

Atomics.exchange()

In this article

試してみましょう

構文

引数

返値

例外

例

exchange() の使用

仕様書

ブラウザーの互換性

関連情報

Help improve MDN