This page was translated from English by the community.Learn more and join the MDN Web Docs community.
TypedArray.prototype.copyWithin()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016년 9월.
TypedArray 인스턴스의copyWithin() 메서드는 이 형식화 배열의 일부를 같은 형식화 배열의 다른 장소에 얕은 복사를 수행하며 배열의 길이를 수정하지 않고 해당 배열을 반환합니다. 이 메서드는Array.prototype.copyWithin()와 같은 알고리즘을 가집니다.
시도해 보기
const uint8 = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);// Insert position, start position, end positionuint8.copyWithin(3, 1, 3);console.log(uint8);// Expected output: Uint8Array [1, 2, 3, 2, 3, 6, 7, 8]구문
js
copyWithin(target, start)copyWithin(target, start, end)매개변수
반환 값
수정된 형식화 배열
설명
보다 자세한 설명은Array.prototype.copyWithin()을 참고하시기 바랍니다. 이 메서드는 범용 메서드가 아니며 오직 형식화 배열 인스턴스에서만 호출할 수 있습니다.
예제
copyWithin() 사용하기
js
const buffer = new ArrayBuffer(8);const uint8 = new Uint8Array(buffer);uint8.set([1, 2, 3]);console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]uint8.copyWithin(3, 0, 3);console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.copywithin |