← 返回首页

TypedArray.prototype.byteOffset - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

TypedArray.prototype.byteOffset

Baseline Widely available

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

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

In this article

解説

byteOffset プロパティは設定アクセサープロパティが undefined であるアクセサープロパティです。これは、このプロパティが読み取り専用であることを意味します。値は型付き配列が構築された時点で確定し、変更できません。ただし、基盤となるバッファーのサイズ変更により表示範囲が有効できなくなった場合、byteOffset は 0 になります。

例

byteOffset プロパティの使用

js
const buffer = new ArrayBuffer(8);

const uint8array1 = new Uint8Array(buffer);
uint8array1.byteOffset; // 0 （オフセットを指定していない）

const uint8array2 = new Uint8Array(buffer, 3);
uint8array2.byteOffset; // 3 （Uint8Array の構築時に指定したとおり）

const buffer2 = new ArrayBuffer(16, { maxByteLength: 32 });
const uint8lengthTracking = new Uint8Array(buffer2, 4);
uint8lengthTracking.byteOffset; // 4
buffer2.resize(3);
uint8lengthTracking.byteOffset; // 0 （ビュー範囲が有効ではなくなった）

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-get-%typedarray%.prototype.byteoffset

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

JavaScript 型付き配列ガイド
TypedArray

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2026年1月22日 by MDN contributors.

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

標準組み込みオブジェクト
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
Int8Array
Int16Array
Int32Array
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array