TypedArray.prototype.with()

Метод with() экземпляров TypedArray является копирующей версией использования синтаксиса с квадратными скобками для изменения значения указанного индекса. Он возвращает новый типизированный массив с элементом по указанному индексу, замененным указанным значением. Этот метод имеет тот же алгоритм, что и Array.prototype.with().

Синтаксис

arrayInstance.with(index, value)

Параметры

index

Индекс, начинающийся с нуля, по которому следует изменить типизированный массив, преобразованный в целое число.

value

Любое значение, которое должно быть присвоено указанному индексу.

Возвращаемое значение

Новый типизированный массив с элементом по index, замененным на value.

Исключения

RangeError

Выбрасывается, если index >= array.length или index < -array.length.

Описание

См. Array.prototype.with() для более подробной информации. Этот метод не является общим и может быть вызван только для экземпляров типизированных массивов.

Примеры

Использование 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]

Спецификации

Совместимость с браузерами

См. также

• Polyfill of TypedArray.prototype.with in core-js
• Руководство по типизированным массивам JavaScript
• TypedArray.prototype.toReversed()
• TypedArray.prototype.toSorted()
• TypedArray.prototype.at()
• Array.prototype.with()