このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

DataView.prototype.setInt8()

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月.

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

試してみましょう

// ArrayBuffer をバイト単位のサイズで作成
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer);
view.setInt8(1, 127); // 符号付き 8 ビット整数の最大値

console.log(view.getInt8(1));
// 予想される結果: 127

構文

js
setInt8(byteOffset, value)

引数

byteOffset

データを格納するビューの先頭からのバイト単位のオフセットです。

value

設定する値。値がどのようにバイト列にエンコードされるかについては、値のエンコード方式と正規化を参照してください。

返値

undefined です。

発生するエラー

RangeError

byteOffset がビューの末尾を越えて格納するように設定されたときに発生します。

setInt8() の使用

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setInt8(0, 3);
dataview.getInt8(0); // 3

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-dataview.prototype.setint8

ブラウザーの互換性

関連情報