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

View in English Always switch to English

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.

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]

规范

Specification
ECMAScript® 2026 Language Specification
# sec-%typedarray%.prototype.with

浏览器兼容性

参见