此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

TypedArray.prototype.with()

基线 广泛可用

自 2023年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

TypedArray 实例的 with() 方法是使用方括号表示法修改指定索引值的复制方法版本。它会返回一个新的类型化数组,其指定索引处的元素值会被新值替换。该方法的算法与 Array.prototype.with() 相同。

语法

js
arrayInstance.with(index, value)

参数

index

要修改的数组索引(从 0 开始),会被转换为整数

value

要分配给指定索引的任何值。

返回值

一个新的类型化数组,其中位于 index 处的元素已被 value 替换。

异常

RangeError

index >= array.lengthindex < -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]

规范

规范
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.with

浏览器兼容性

参见