TypedArray.prototype.with()
Baseline 2023Newly available
Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
The with() method of TypedArray instances is the copying version of using the bracket notation to change the value of a given index. It returns a new typed array with the element at the given index replaced with the given value. This method has the same algorithm as Array.prototype.with().
Syntax
arrayInstance.with(index, value)
Parameters
index-
Zero-based index at which to change the typed array, converted to an integer.
value-
Any value to be assigned to the given index.
Return value
A new typed array with the element at index replaced with value.
Exceptions
RangeError-
Thrown if
index >= array.lengthorindex < -array.length.
Description
See Array.prototype.with() for more details. This method is not generic and can only be called on typed array instances.
Examples
Using with()
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]
Specifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.with |