Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】Atomics::Atomics.load静的メソッドの使い方

Atomics.load()静的メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Atomics.load()メソッドは、共有メモリ上に格納されたTypedArrayから、指定されたインデックスの値をアトミックに読み取ることを実行するメソッドです。このメソッドは、JavaScriptのWeb Workers間で共有されるメモリ(SharedArrayBuffer)のデータを安全に扱うために不可欠な機能として設計されています。

「アトミックに」とは、その操作が不可分であり、他のスレッドによる操作と同時に行われたとしても、常に完全な状態のデータが読み取られることを保証することを意味します。具体的には、あるスレッドが値を書き込んでいる最中に、別のスレッドがその値を読み取ろうとしても、読み取られる値は常に書き込みが完了した値か、書き込み前の値のいずれかであり、部分的に書き換えられた不完全な値が読み込まれることはありません。これにより、データの整合性が保たれ、並行処理における競合状態による予期せぬバグを防ぎます。

このメソッドは、SharedArrayBufferを基盤とするInt32ArrayBigInt64ArrayなどのTypedArrayオブジェクトを対象とし、引数として対象のTypedArrayと読み取りたい要素のインデックスを受け取ります。そして、そのインデックス位置からアトミックに読み取られた値を返します。複数のWeb Workerが同じ共有メモリにアクセスし、データの読み書きを行うようなシステムを構築する際には、データの破損を防ぎ、予測可能な挙動を実現するためにAtomics.load()のようなアトミック操作の利用が非常に重要となります。

公式リファレンス: Atomics.load()

構文(syntax)

1Atomics.load(typedArray, index);

引数(parameters)

typedArray, index

  • typedArray: number[]: 操作対象のTypedArray(Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array, BigUint64Array)
  • index: number: 読み込む要素のインデックス

戻り値(return)

number | bigint

指定された添え字にある共有メモリ上の値を返します。値は数値(number)またはBigInt(bigint)のいずれかです。

関連コンテンツ