TypedArray.prototype.with()
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
js
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.length
orindex < -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()
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]
Specifications
Specification |
---|
ECMAScript Language Specification # sec-%typedarray%.prototype.with |
Browser compatibility
BCD tables only load in the browser