← 返回首页
TypedArray.prototype.copyWithin() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. 개발자를 위한 웹 기술
  2. JavaScript
  3. JavaScript 참고서
  4. 표준 내장 객체
  5. TypedArray
  6. TypedArray.prototype.copyWithin()
Theme
  • OS default
  • Light
  • Dark
한국어
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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()와 같은 알고리즘을 가집니다.

In this article

시도해 보기

const uint8 = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]); // Insert position, start position, end position uint8.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)

매개변수

target

시퀀스를 복사할 0 기반 인덱스로, 정수로 변환. 이는 start에 있는 요소가 복사될 위치에 해당하며, start과 end 사이의 모든 요소는 후속 인덱스에 복사됩니다.

start

요소 복사를 시작할 0 기반 인덱스로, 정수로 변환됩니다.

end Optional

요소 복사를 끝낼 0 기반 인덱스로, 정수로 변환됩니다. copyWithin()은 end를 포함하지 않고 end전 까지 복사합니다. copyWithin()는 여기까지 복사하지만 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® 2027 Language Specification
# sec-%typedarray%.prototype.copywithin

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 2025년 2월 11일 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. 표준 내장 객체
  2. TypedArray
  3. 정적 메서드
    1. TypedArray.from()
    2. TypedArray.of()
  4. 정적 속성
    1. TypedArray.BYTES_PER_ELEMENT
    2. get TypedArray[@@species]
  5. 인스턴스 메서드
    1. TypedArray.prototype.at()
    2. TypedArray.prototype.copyWithin()
    3. TypedArray.prototype.entries()
    4. TypedArray.prototype.every()
    5. TypedArray.prototype.fill()
    6. TypedArray.prototype.filter()
    7. TypedArray.prototype.find()
    8. TypedArray.prototype.findIndex()
    9. TypedArray.prototype.findLast()
    10. TypedArray.prototype.findLastIndex()
    11. TypedArray.prototype.forEach()
    12. includes()
    13. TypedArray.prototype.indexOf()
    14. TypedArray.prototype.join()
    15. TypedArray.prototype.keys()
    16. lastIndexOf()
    17. TypedArray.prototype.map()
    18. TypedArray.prototype.reduce()
    19. reduceRight()
    20. TypedArray.prototype.reverse()
    21. TypedArray.prototype.set()
    22. TypedArray.prototype.slice()
    23. TypedArray.prototype.some()
    24. TypedArray.prototype.sort()
    25. TypedArray.prototype.subarray()
    26. toLocaleString()
    27. TypedArray.prototype.toReversed()
    28. TypedArray.prototype.toSorted()
    29. TypedArray.prototype.toString()
    30. TypedArray.prototype.values()
    31. TypedArray.prototype.with()
    32. TypedArray.prototype[@@iterator]()
  6. 인스턴스 속성
    1. TypedArray.prototype.buffer
    2. TypedArray.prototype.byteLength
    3. TypedArray.prototype.byteOffset
    4. TypedArray.prototype.length
  7. 상속
  8. Object/Function
  9. 정적 메서드
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toSource()
    5. Function.prototype[@@hasInstance]()
  10. 정적 속성
    1. Function: displayName
    2. Function.prototype.length
    3. Function: name
    4. Function
    5. Function.arguments
    6. Function.prototype.caller
  11. 인스턴스 메서드
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  12. 인스턴스 속성
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
  13. 관련 페이지
  14. BigInt64Array
  15. BigUint64Array
  16. Float16Array
  17. Float32Array
  18. Float64Array
  19. Int8Array
  20. Int16Array
  21. Int32Array
  22. Uint8Array
  23. Uint8ClampedArray
  24. Uint16Array
  25. Uint32Array

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.