Atomics.load()

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.load() メソッドは、配列内の指定された位置の値を返します。

試してみましょう

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

// 5 + 2 = 7
console.log(Atomics.add(uint8, 0, 2));
// 予想される結果: 5

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

構文

Atomics.load(typedArray, index)

引数

typedArray

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

index

typedArray の中で値を読み込む位置。

返値

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

例外

TypeError

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

RangeError

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

例

load の使用

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

Atomics.add(ta, 0, 12);
Atomics.load(ta, 0); // 12

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-atomics.load

ブラウザーの互換性

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.load()

In this article

試してみましょう

構文

引数

返値

例外

例

load の使用

仕様書

ブラウザーの互換性

関連情報

Help improve MDN