← 返回首页
TypedArray.prototype.subarray() - 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.subarray()
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.subarray()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015년 7월.

subarray() 메서드는 이 TypedArray 객체와 동일한 ArrayBuffer 저장소에 동일한 요소의 타입을 가진 새로운 TypedArray를 반환합니다. 시작 오프셋은 포함하고 마지막 오프셋은 제외합니다. TypedArray는 타입이 지정된 배열 유형 중 하나입니다.

In this article

시도해 보기

const uint8 = new Uint8Array([10, 20, 30, 40, 50]); console.log(uint8.subarray(1, 3)); // Expected output: Uint8Array [20, 30] console.log(uint8.subarray(1)); // Expected output: Uint8Array [20, 30, 40, 50]

구문

js
subarray() subarray(begin) subarray(begin, end)

매개변수

begin Optional

시작할 요소입니다. 오프셋 값은 포함되어 있습니다. 이 값을 명시하지 않으면 배열 전체가 새로운 뷰에 포함됩니다.

end Optional

마지막 요소입니다. 오프셋 값은 제외합니다. 이 값을 명시하지 않으면 begin에 지정된 요소부터 배열 끝까지 모든 요소가 새로운 뷰에 포함됩니다.

반환 값

새로운 TypedArray 객체.

설명

begin과 end으로 명시된 범위는 현재 배열의 유효한 인덱스 범위로 고정됩니다. 새 배열의 계산된 길이가 음수인 경우 0으로 고정됩니다. begin 또는 end가 음수인 경우 배열의 시작이 아닌 끝의 인덱스를 참조합니다.

또한 명심하셔야 할 점은 기존 버퍼에 새로운 뷰(view)를 생성하는 것뿐입니다. 새 객체의 내용을 변경하면 원래 객체에 영향을 미치며 그 반대의 경우도 마찬가지입니다.

예제

subarray() 메서드 사용하기

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 ] const sub = uint8.subarray(0, 4); console.log(sub); // Uint8Array [ 1, 2, 3, 0 ]

명세서

Specification
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.subarray

브라우저 호환성

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.