TypedArray.prototype.with()
Baseline 2023
Newly available
Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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 Language Specification # sec-%typedarray%.prototype.with |
ブラウザーの互換性
BCD tables only load in the browser