Widely available すべての主要ブラウザで対応済み。安心して使用可能。

概要

TypedArray はバイナリデータを効率的に操作するための配列です。Int8Array, Uint8Array, Float32Array, Float64Array など複数の型があり、ArrayBuffer を基盤とします。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
7
12
4
5.1
18
4.2

ArrayBuffer[Symbol.species] は静的アクセサープロパティで、配列バッファーメソッドから返値を作成するために使用されるコンストラクターを返します。

51
13
48
10
51
10

ArrayBuffer() コンストラクターは ArrayBuffer オブジェクトを生成するために使用されます。

7
12
4
5.1
18
4.2

byteLength は、ArrayBuffer のアクセサープロパティで、この配列バッファーの長さをバイト単位で表します。

7
12
4
5.1
18
4.2

ArrayBuffer.isView() メソッドは、渡された値が ArrayBuffer のビューのうちの一つ、例えば型付き配列オブジェクトや DataView であるかどうかを判断します。

32
12
29
7
32
7

slice() は ArrayBuffer インスタンスのメソッドで、新しい ArrayBuffer を返し、その内容はこの ArrayBuffer の start から end の手前までをコピーします。start または end のいずれかが負の場合、配列の先頭からではなく、末尾からのインデックスを指します。

17
12
12
5.1
18
6
その他

DataView ビューは、バイナリーの ArrayBuffer 内の複数の数値型を、プラットフォームのエンディアンを意識することなく読み書きするための低水準インターフェイスを提供します。

9
12
15
5.1
18
5
ビルトインオブジェクト

DataView() コンストラクターは、 DataView オブジェクトを生成します。

9
12
15
5.1
18
5

buffer は DataView インスタンスのアクセサープロパティで、このビューの構築時に参照された ArrayBuffer または SharedArrayBuffer を表します。

9
12
15
5.1
18
5

byteLength は DataView インスタンスのアクセサープロパティで、このビューの長さを(バイト単位で)返します。

9
12
15
5.1
18
5

byteOffset は DataView インスタンスのアクセサープロパティで、このビューの ArrayBuffer または SharedArrayBuffer の先頭からオフセットを表します。

9
12
15
5.1
18
5

getFloat32() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 4 バイトを読み取り、 32 ビット浮動小数点数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。

9
12
15
5.1
18
5

getFloat64() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 8 バイトを読み取り、 64 ビット浮動小数点数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。

9
12
15
5.1
18
5

getInt16() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 2 バイトを読み取り、符号付き 16 ビット整数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。

9
12
15
5.1
18
5

getInt32() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 4 バイトを読み取り、符号付き 32 ビット整数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。

9
12
15
5.1
18
5

getInt8() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 1 バイトを読み取り、符号付き 8 ビット整数として解釈します。

9
12
15
5.1
18
5

getUint16() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 2 バイトを読み取り、符号なし 16 ビット整数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。

9
12
15
5.1
18
5

getUint32() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 4 バイトを読み取り、符号なし 32 ビット整数として解釈します。アラインメント制約はありません。境界内の任意のオフセットからマルチバイト値を取得できます。

9
12
15
5.1
18
5

getUint8() は DataView インスタンスのメソッドで、この DataView の指定されたバイトオフセットから 1 バイトを読み取り、符号なし 8 ビット整数として解釈します。

9
12
15
5.1
18
5

setFloat32() は DataView インスタンスのメソッドで、数値を受け取り、32 ビット浮動小数点数として、この DataView の指定されたバイトオフセットから始まる 4 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。

9
12
15
5.1
18
5

setFloat64() は DataView インスタンスのメソッドで、数値を受け取り、64 ビット浮動小数点数として、この DataView の指定されたバイトオフセットから始まる 8 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。

9
12
15
5.1
18
5

setInt16() は DataView インスタンスのメソッドで、数値を受け取り、符号付き 16 ビット整数として、この DataView の指定されたバイトオフセットから始まる 2 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。

9
12
15
5.1
18
5

setInt32() は DataView インスタンスのメソッドで、数値を受け取り、符号付き 32 ビット整数として、この DataView の指定されたバイトオフセットから始まる 4 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。

9
12
15
5.1
18
5

setInt8() は DataView インスタンスのメソッドで、数値を受け取り、符号付き 8 ビット整数として、この DataView の指定されたバイトオフセットにあるバイトに格納します。

9
12
15
5.1
18
5

setUint16() は DataView インスタンスのメソッドで、数値を受け取り、符号なし 16 ビット整数として、この DataView の指定されたバイトオフセットから始まる 2 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。

9
12
15
5.1
18
5

setUint32() は DataView インスタンスのメソッドで、数値を受け取り、符号なし 32 ビット整数として、この DataView の指定されたバイトオフセットから始まる 2 バイトに格納します。アラインメント制約はなく、マルチバイトの値は範囲内の任意のオフセットに格納できます。

9
12
15
5.1
18
5

setUint8() は DataView インスタンスのメソッドで、数値を受け取り、符号なし 8 ビット整数として、この DataView の指定されたバイトオフセットにあるバイトに格納します。

9
12
15
5.1
18
5
その他

Float32Array は型付き配列で、プラットフォームのバイト順による 32 ビット浮動小数点数 (C 言語の float データ型に相当) の配列を表します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Float32Array() は型付き配列のコンストラクターで、新しい Float32Array オブジェクト、すなわち 32 ビット浮動小数点数 (C 言語の float データ型に相当) の配列をプラットフォームのバイトオーダーで生成します。バイトオーダーを制御する必要がある場合は、代わりに DataView を使用してください。生成後は、オブジェクトのメソッドや、標準の配列の添字構文 (すなわち角括弧表記) を用いて配列の要素を参照することができます。

7
12
4
5.1
18
4.2
Float32Array.Float32Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Float32Array.Float32Array.iterable allowed

`新しい Float32Array(反復可能)`

39
14
52
10
39
10
その他

Float64Array は型付き配列で、プラットフォームのバイト順による 64 ビット浮動小数点数 (C 言語の double データ型に相当) の配列を表します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Float64Array() は型付き配列のコンストラクターで、新しい Float64Array オブジェクト、すなわち 64 ビット浮動小数点数 (C 言語の double データ型に相当) の配列をプラットフォームのバイトオーダーで生成します。バイトオーダーを制御する必要がある場合は、代わりに DataView を使用してください。生成後は、オブジェクトのメソッドや、標準の配列の添字構文 (すなわち角括弧表記) を用いて配列の要素を参照することができます。

7
12
4
5.1
18
4.2
Float64Array.Float64Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Float64Array.Float64Array.iterable allowed

`新しい Float64Array(反復可能)`

39
14
52
10
39
10
その他

Int16Array は型付き配列で、プラットフォームのバイト順による 2 の補数形式の 16 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Int16Array() は型付き配列のコンストラクターで、プラットフォームのバイト順による 2 の補数形式の 16 ビット符号付き整数値の配列を生成します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。

7
12
4
5.1
18
4.2
Int16Array.Int16Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Int16Array.Int16Array.iterable allowed

`新しい Int16Array(反復可能)`

39
14
52
10
39
10
その他

Int32Array は型付き配列で、プラットフォームのバイト順による 2 の補数形式の 32 ビット符号付き整数値の配列を表します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Int32Array() は型付き配列のコンストラクターで、プラットフォームのバイト順による 2 の補数形式の 32 ビット符号付き整数値の配列を生成します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。

7
12
4
5.1
18
4.2
Int32Array.Int32Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Int32Array.Int32Array.iterable allowed

`新しい Int32Array(反復可能)`

39
14
52
10
39
10
その他

Int8Array は型付き配列で、 2 の補数形式の 8 ビット符号付き整数値の配列を表します。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Int8Array() は型付き配列のコンストラクターで、 2 の補数形式の 8 ビット符号付き整数値の型付き配列を生成します。中身は 0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。

7
12
4
5.1
18
4.2
Int8Array.Int8Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Int8Array.Int8Array.iterable allowed

`新しい Int8Array(反復可能)`

39
14
52
10
39
10
その他

TypedArray オブジェクトは、背後にあるバイナリーデータバッファーの、配列風のビューを表します。 TypedArray という名称のグローバルプロパティがあるわけではなく、また直接 TypedArray コンストラクターが見えるわけではありません。代わりに、さまざまなグローバルプロパティがあり、それらの値は後述するように特定の要素の型における型付き配列のコンストラクターになります。下記のページで、それぞれの要素を持つ片引き配列で使用できる共通のプロパティやメソッドを確認できます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

TypedArray[Symbol.species] は静的アクセサープロパティで、型付き配列のメソッドの返値を構築するのに使われるコンストラクターを返します。

51
13
48
10
51
10

TypedArray.BYTESPERELEMENT プロパティは、型付き配列内の各要素の大きさをバイト単位で表します。

7
12
4
5.1
18
4.2

buffer は TypedArray インスタンスのアクセサープロパティで、構築時点にこの型付き配列が参照する ArrayBuffer または SharedArrayBuffer を返します。

7
12
4
5.1
18
4.2

byteLength は TypedArray のアクセサープロパティで、この型付き配列の長さを(バイト単位で)返します。

7
12
4
5.1
18
4.2

byteOffset は TypedArray インスタンスのアクセサープロパティで、この型付き配列の ArrayBuffer または SharedArrayBuffer の開始位置からの(バイト単位の)オフセットを返します。

7
12
4
5.1
18
4.2
TypedArray.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
TypedArray.index properties not consulting prototype

プロトタイプを参照しないインデックス付きプロパティ

7
12
25
5.1
18
5
TypedArray.iterable in constructor

コンストラクター内で反復可能

39
14
52
10
39
10

join() は TypedArray インスタンスのメソッドで、この型付き配列のすべての要素を、カンマまたは指定する区切り文字で連結して新しい文字列を作成して返します。型付き配列に 1 つの項目しかない場合、その項目は区切り文字を使用せずに返します。このメソッドのアルゴリズムは Array.prototype.join() と同じです。

45
12
37
10
45
10

length は TypedArray インスタンスのアクセサープロパティで、型付き配列の長さを(要素数で)返します。

7
12
4
5.1
18
4.2

name は Function オブジェクトの読み取り専用プロパティで、作成時に付けられた関数の名前、もしくは無名関数の場合は anonymous または '' (空文字列)を返します。

7
12
4
5.1
18
4.2
TypedArray.named properties

名前付きプロパティ

7
12
30
5.1
18
5

reverse() は TypedArray インスタンスのメソッドで、型付き配列をその場 (in-place) で反転し、同じ型付き配列への参照を返します。型付き配列の最初の要素は最後になり、型付き配列の最後の要素は最初になります。言い換えれば,型付き配列の他の要素の順序は,以前とは逆の順序になります。このメソッドは Array.prototype.reverse() と同じアルゴリズムです。

45
12
37
10
45
10

set() は TypedArray インスタンスのメソッドで、複数の値を指定した配列から入力値を読み込み、型付き配列に格納します。

7
12
4
5.1
18
4.2

slice() は TypedArray インスタンスのメソッドで、型付き配列の一部を start から end (end は含まれない)まで選択された新しい型付き配列オブジェクトにコピーして返します。元の型付き配列は変更されません。このメソッドは Array.prototype.slice() と同じアルゴリズムです。

45
12
38
10
45
10

sort() は TypedArray インスタンスのメソッドで、型付き配列の要素をその場 (in-place) でソートし、その型付き配列を返します。このメソッドは Array.prototype.sort() と同じアルゴリズムですが、既定で文字列としてではなく数値として値をソートする点が異なります。

45
12
46
10
45
10

subarray() は TypedArray インスタンスのメソッドで、同じ ArrayBuffer ストアにおいて、この型付き配列オブジェクトと同じ要素の型をもつ新しい型付き配列を返します。先頭のオフセットは含み、末尾のオフセットは含みません。

7
12
4
5.1
18
4.2

toString() は TypedArray インスタンスのメソッドで、指定された配列とその要素を表す文字列を返します。このメソッドは Array.prototype.toString() と同じアルゴリズムです。

7
12
51
5.1
18
5
その他

Uint16Array は型付き配列で、プラットフォームのバイト順による 16 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Uint16Array() は型付き配列のコンストラクターで、プラットフォームのバイト順による 16 ビット符号なし整数値の配列を生成します。

7
12
4
5.1
18
4.2
Uint16Array.Uint16Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Uint16Array.Uint16Array.iterable allowed

`新しい Uint16Array(反復可能)`

39
14
52
10
39
10
その他

Uint32Array は型付き配列で、プラットフォームのバイト順による 32 ビット符号なし整数値の配列を表します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Uint32Array() は型付き配列のコンストラクターで、プラットフォームのバイト順による 32 ビット符号なし整数値の配列を生成します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。

7
12
4
5.1
18
4.2
Uint32Array.Uint32Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Uint32Array.Uint32Array.iterable allowed

`新しい Uint32Array(反復可能)`

39
14
52
10
39
10
その他

Uint8Array は型付き配列で、 8 ビット符号なし整数値の配列を表します。初期化データが明示的に与えられなかった場合、中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文(すなわち、ブラケット記法)を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Uint8Array() コンストラクターは、 Uint8Array オブジェクトを作成します。初期化データが明示的に指定されていない場合、コンテンツは 0 に初期化されます。

7
12
4
5.1
18
4.2
Uint8Array.Uint8Array.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Uint8Array.Uint8Array.iterable allowed

`新しい Uint8Array(反復可能)`

39
14
52
10
39
10
その他

Uint8ClampedArray は型付き配列で、 0-255 に制約される 8 ビット符号なし整数値の配列を表します。指定された値が \[0,255] の範囲を超えた場合、 0 または 255 が代わりに設定されます。整数以外を指定しようとすると、最も近い整数が設定されます。中身は 0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

7
12
4
5.1
18
4.2
ビルトインオブジェクト

Uint8ClampedArray() は型付き配列のコンストラクターで、 0-255 に制約される 8 ビット符号なし整数値の配列を生成します。指定された値が \[0,255] の範囲を超えた場合、 0 または 255 が代わりに設定されます。整数以外を指定しようとすると、最も近い整数が設定されます。中身は 0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。

7
12
4
5.1
18
4.2
Uint8ClampedArray.Uint8ClampedArray.constructor without parameters

パラメータのないコンストラクタ

7
12
55
5.1
18
5
Uint8ClampedArray.Uint8ClampedArray.iterable allowed

`新しい Uint8ClampedArray(反復可能)`

39
14
52
10
39
10
1+対応 (バージョン) 未対応 注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 1件
削除済み
  • Firefox 53では、非標準の`ArrayBuffer.slice()`メソッドは削除されました(標準版の`ArrayBuffer.prototype.slice()`は残されています)。
注釈 1件
実装メモ
  • 負の整数はインデックス付きプロパティとはみなされないため、プロトタイプ・プロパティの値を返す。
注釈 1件
実装メモ
  • 負の整数はインデックス付きプロパティとはみなされないため、プロトタイプ・プロパティの値を返す。
注釈 1件
実装メモ
  • 負の整数はインデックス付きプロパティとはみなされないため、プロトタイプ・プロパティの値を返す。
注釈 1件
実装メモ
  • 負の整数はインデックス付きプロパティとはみなされないため、プロトタイプ・プロパティの値を返す。
注釈 1件
実装メモ
  • 負の整数はインデックス付きプロパティとはみなされないため、プロトタイプ・プロパティの値を返す。

基本構文

JAVASCRIPT
const buffer = new ArrayBuffer(16);
const int32 = new Int32Array(buffer);
int32[0] = 42;

const float64 = new Float64Array([1.5, 2.5, 3.5]);
float64.map(x => x * 2); // Float64Array [3, 5, 7]

ライブデモ

bainaride-ta. Directlyoperation

ArrayBuffer middle, different type(Int8 and Int32) in display..

プレビュー全画面表示

Notesrisize. Difference with type.

baitnumber that different and inspect it.. with sameelementnumber in also, Int8 and Float64.

プレビュー全画面表示

col-de-ta. operation

Uint8ClampedArray Use, RGBA value that 0~255 to automaticallylimit variantchild inspect it..

プレビュー全画面表示

実務での使いどころ

  • Typed arrays (initial support) の活用

    バイナリデータを効率的に扱う型付き配列。Int8Array, Float32Array 等の固定型配列を提供。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

Powered by web-features