Int8Array() コンストラクター

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

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

構文

new Int8Array(); // new in ES2017 new Int8Array(length); new Int8Array(typedArray); new Int8Array(object); new Int8Array(buffer [, byteOffset [, length]]);

引数

length

length 引数付きで呼び出されると、メモリ内に内部的な配列バッファーを作成し、大きさは length を BYTES_PER_ELEMENT で乗じたバイト数になり、ゼロになることもあります。

typedArray

typedArray 引数付きで呼び出されると、これはあらゆる型付き配列型 (例えば Int32Array) にすることができますが、 typedArray を新しい型付き配列にコピーします。 typedArray の中のそれぞれの値は、新しい配列にコピーされる前にコンストラクターの対応する型に変換されます。新しい型付き配列の長さは typedArray 引数の長さと同じになります。

object

object 引数付きで呼び出されると、あたかも TypedArray.from() メソッドであるかのように新しい型付き配列が生成されます。

buffer, byteOffset, length

buffer と、オプションで byteOffset と length 引数を指定して呼び出されると、指定された ArrayBuffer を表示する型付き配列ビューが生成されます。 byteOffset および length 引数は、型付き配列ビューが表示するメモリ範囲を指定する。両方を省略した場合は buffer の全てを表示し、 length のみを省略した場合は buffer の残りを表示します。

例

様々な方法による Int8Array の生成

js
// 長さの指定
var int8 = new Int8Array(2);
int8[0] = 42;
console.log(int8[0]); // 42
console.log(int8.length); // 2
console.log(int8.BYTES_PER_ELEMENT); // 1

// 配列から
var arr = new Int8Array([21, 31]);
console.log(arr[1]); // 31

// 他の型付き配列から
var x = new Int8Array([21, 31]);
var y = new Int8Array(x);
console.log(y[0]); // 21

// ArrayBuffer から
var buffer = new ArrayBuffer(8);
var z = new Int8Array(buffer, 1, 4);

// 反復可能オブジェクトから
var iterable = (function* () {
  yield* [1, 2, 3];
})();
var int8 = new Int8Array(iterable);
// Int8Array[1, 2, 3]

js
var dv = Int8Array([1, 2, 3]);
// TypeError: calling a builtin Int8Array constructor
// without new is forbidden

var dv = new Int8Array([1, 2, 3]);

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2026年5月23日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

標準組み込みオブジェクト
Int8Array
コンストラクター
1. Int8Array() コンストラクター
継承
TypedArray
静的メソッド
1. from()
2. of()
静的プロパティ
1. BYTES_PER_ELEMENT
2. [Symbol.species]
インスタンスメソッド
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
インスタンスプロパティ
1. buffer
2. byteLength
3. byteOffset
4. length
Object/Function
静的メソッド
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
静的プロパティ
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
インスタンスメソッド
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
インスタンスプロパティ
1. __proto__
2. constructor
関連するページ
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int16Array
Int32Array
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array

Int8Array() コンストラクター

目次

構文

引数

例

様々な方法による Int8Array の生成

仕様書

ブラウザーの互換性

互換性メモ

関連情報

MDN の改良に協力