TypedArray.prototype.with()

The with() method of {{jsxref("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 {{jsxref("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#

• {{jsxref("RangeError")}}
• : Thrown if index >= array.length or index < -array.length.

Description#

See {{jsxref("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#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• Polyfill of TypedArray.prototype.with in core-js
• JavaScript typed arrays guide
• {{jsxref("TypedArray.prototype.toReversed()")}}
• {{jsxref("TypedArray.prototype.toSorted()")}}
• {{jsxref("TypedArray.prototype.at()")}}
• {{jsxref("Array.prototype.with()")}}