NATIVE

settings_applicationsObject  >   settings_applicationsArray  >   settings_applications[[Prototype]]

NATIVE

Editing
  • account_tree
  • bug_report

ArraynewArraytoSpliced(IntstartIndex, IntdeleteLength, AnyTypeitem[, ...[AnyTypeitemN]]]])

배열의 특정 위치의 원소를 제거하거나 제거후 새 원소를 추가한다. splice() 메소드와 동일하나 원본이 아닌 복사본을 반환한다.

구문

형식
array.toSpliced(startIndex[, deleteLength[, ...[, item]]])

매개 변수

IntstartIndex필수

배경을 원소를 삭제하거나 변경을 시작할 0부터 시작하는 인덱스를 설정한다. 배열의 길이보다 크면 인덱스는 배열의 길이로 설정된다. 음수로 설정하는 경우에는 배열의 끝에서 부터의 길이로 처리되며 절대값이 배열의 길이보다 큰 경우는 0으로 처리된다.

  • startIndex0보다 작은 경우에 startIndex + array.length 값으로 사용한다.
  • startIndex-array.length보다 작은 경우에 0이 사용된다.
  • startIndexarray.length보다 크거나 같은 경우에 원소는 삭제되지 않지만 추가되는 원소가 있을 경우 추가가 된다.
  • startIndex를 생략하고 인수없이 실행하면 아무것도 삭제되지 않는다.
IntdeleteLength선택

제거(변경)을 시작할 startIndex로부터의 길이를 설정한다. 0의 경우 아무것도 제거되지 않는다. 이 경우는 삭제가 아닌 추가할 새 요소를 정의해 주어야 한다. 만일 startIndex에서부터 배열의 길이보다 크면 배열의 끝까지 원소를 모두 제거(변경) 한다.

AnyTypeitem[, ...[, itemN]]선택적 열거

startIndex부터 시작하여 추가할 원소들이며 생략된 경우에는 삭제만 된다.

반환

ArraynewArray

변경이 반영된 새로운 배열을 반환한다.

버전 명세

ECMAScript 2024(15th Edition)
#sec-array.prototype.tospliced

지원 웹브라우저