TypedArray.prototype.with()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2023年7月.
with() は TypedArray インスタンスのメソッドで、ブラケット記法を使用して指定された位置の値を変更することのコピーメソッド版です。これは指定されたインデックスの要素を指定された値で置き換えた新しい配列の添字を返します。このメソッドのアルゴリズムは Array.prototype.with() と同じです。
構文
js
arrayInstance.with(index, value)
引数
返値
index の要素を value に置き換えた新しい型付き配列。
例外
RangeError-
index >= array.lengthまたはindex < -array.lengthの場合に発生します。
解説
詳細については、 Array.prototype.with() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。
例
>with() の使用
js
const arr = new Uint8Array([1, 2, 3, 4, 5]);
console.log(arr.with(2, 6)); // Uint8Array [1, 2, 6, 4, 5]
console.log(arr); // Uint8Array [1, 2, 3, 4, 5]
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-%typedarray%.prototype.with> |