Thewith() method ofTypedArray instances is thecopying version of using thebracket 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 asArray.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 atindex replaced withvalue.

Exceptions

RangeError

Thrown ifindex >= array.length orindex < -array.length.

Description

SeeArray.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

Browser compatibility

See also

• Polyfill ofTypedArray.prototype.with incore-js
• JavaScript typed arrays guide
• TypedArray.prototype.toReversed()
• TypedArray.prototype.toSorted()
• TypedArray.prototype.at()
• Array.prototype.with()