초안 ECMA-262 / 2026년 10월 24일

ECMAScript® 2027 언어 명세

이 명세에 대하여

https://tc39.es/ecma262/의 문서는 가장 정확한 최신 ECMAScript 명세입니다. 이 문서에는 가장 최근의 연간 스냅샷 내용과 모든 완료된 제안 — 제안 절차에서 단계 4에 도달하여 여러 구현체에 구현되었으며 다음 연간 스냅샷에 포함될 제안 — 이 들어 있습니다. 이전 스냅샷은 https://ecma-international.org/publications-and-standards/standards/ecma-262/에서 확인할 수 있습니다.

이 문서는 단일 페이지와 여러 페이지로 제공됩니다.

이 명세에 기여하기

이 명세는 ECMAScript 커뮤니티의 도움을 받아 GitHub에서 개발됩니다. 이 명세의 개발에 기여하는 방법에는 여러 가지가 있습니다:

GitHub 저장소: https://github.com/tc39/ecma262
이슈: 모든 이슈, 새 이슈 등록
풀 리퀘스트: 모든 풀 리퀘스트, 새 풀 리퀘스트 생성
테스트 모음: Test262
편집자:
커뮤니티:
- Discourse: https://es.discourse.group/
- 채팅: Matrix
- 메일링 리스트 보관소: https://esdiscuss.org/

이 문서의 제작 방법에 관한 자세한 내용은 제작 정보를 참조하시기 바랍니다.

소개

이 Ecma 표준은 ECMAScript 2027 언어를 정의합니다. 이 문서는 ECMAScript 언어 명세의 제18판입니다. ECMAScript는 여러 초기 기술을 기반으로 하며, 그중 가장 잘 알려진 기술은 JavaScript(Netscape)와 JScript(Microsoft)입니다. 이 언어는 Netscape의 Brendan Eich가 만들었으며, 해당 회사의 Navigator 2.0 브라우저에서 처음 등장했습니다. 웹 브라우저에 내장된 언어로 가장 잘 알려져 있지만, 서버 및 임베디드 애플리케이션을 포함하여 브라우저 외부에서도 널리 채택되었으며, 세계에서 가장 널리 사용되는 범용 프로그래밍 언어 중 하나로 성장했습니다.

ECMAScript 언어 명세의 개발은 1996년 11월에 시작되었습니다. 이 Ecma 표준의 초판은 1997년 6월 Ecma 총회에서 채택되었습니다.

이 Ecma 표준은 신속 처리 절차에 따라 채택되도록 ISO/IEC JTC 1에 제출되었으며, 1998년 4월에 국제 표준 ISO/IEC 16262로 승인되었습니다. 1998년 6월 Ecma 총회는 ISO/IEC 16262와 완전히 일치하도록 ECMA-262 제2판을 승인했습니다. 초판과 제2판 사이의 변경 사항은 편집상의 변경입니다.

이 표준의 제3판에는 강력한 정규 표현식, 향상된 문자열 처리, 새로운 제어문, try/catch 예외 처리, 더욱 엄밀한 오류 정의, 숫자 출력 형식 지정 및 향후 언어의 발전을 고려한 사소한 변경 사항이 도입되었습니다. ECMAScript 표준 제3판은 1999년 12월 Ecma 총회에서 채택되었으며, 2002년 6월에 ISO/IEC 16262:2002로 발행되었습니다.

제3판이 발행된 후 ECMAScript는 월드 와이드 웹과 함께 광범위하게 채택되어 사실상 모든 웹 브라우저에서 지원하는 프로그래밍 언어가 되었습니다. ECMAScript 제4판을 개발하기 위해 상당한 작업이 이루어졌습니다. 그러나 해당 작업은 완료되지 않았고 ECMAScript 제4판으로 발행되지도 않았으며, 그 일부가 제6판의 개발에 반영되었습니다.

ECMAScript 제5판(ECMA-262 제5^판으로 발행)은 브라우저 구현체 사이에서 보편화된 언어 명세의 사실상 해석을 명문화하고, 제3판 발행 이후 등장한 새로운 기능에 대한 지원을 추가했습니다. 이러한 기능에는 접근자 프로퍼티, 리플렉션을 통한 객체 생성 및 검사, 프로퍼티 속성에 대한 프로그램 제어, 추가 배열 조작 함수, JSON 객체 인코딩 형식 지원 및 향상된 오류 검사와 프로그램 보안을 제공하는 엄격 모드가 포함됩니다. 제5판은 2009년 12월 Ecma 총회에서 채택되었습니다.

제5판은 신속 처리 절차에 따라 채택되도록 ISO/IEC JTC 1에 제출되었으며, 국제 표준 ISO/IEC 16262:2011로 승인되었습니다. ECMAScript 표준 제5.1판에는 사소한 수정 사항이 반영되었으며, ISO/IEC 16262:2011과 동일한 내용을 담고 있습니다. 제5.1판은 2011년 6월 Ecma 총회에서 채택되었습니다.

제6판에 대한 본격적인 개발은 제5판의 발행을 준비하던 2009년에 시작되었습니다. 그러나 이에 앞서 1999년 제3판의 발행 시점부터 상당한 실험과 언어 개선 설계 작업이 이루어졌습니다. 실질적으로 제6판의 완성은 15년에 걸친 노력의 결실입니다. 이 판의 목표에는 대규모 애플리케이션과 라이브러리 제작에 대한 지원을 개선하고, ECMAScript를 다른 언어의 컴파일 대상으로 사용하는 데 대한 지원을 개선하는 것이 포함되었습니다. 주요 개선 사항에는 모듈, 클래스 선언, 렉시컬 블록 스코프, 이터레이터와 제너레이터, 비동기 프로그래밍을 위한 프로미스, 구조 분해 패턴 및 적절한 꼬리 호출이 포함되었습니다. ECMAScript 내장 라이브러리는 맵, 집합, 이진 숫자 값의 배열을 포함한 추가 데이터 추상화를 지원하도록 확장되었으며, 문자열과 정규 표현식에서 유니코드 보충 문자에 대한 지원도 추가되었습니다. 내장 기능은 서브클래싱을 통해 확장할 수 있게 되었습니다. 제6판은 언어와 라이브러리를 정기적으로 점진적으로 개선하기 위한 토대를 제공합니다. 제6판은 2015년 6월 총회에서 채택되었습니다.

ECMAScript 2016은 Ecma TC39의 새로운 연간 릴리스 주기와 공개 개발 절차에 따라 출시된 최초의 ECMAScript 판입니다. 이후의 모든 개발을 GitHub에서 진행하기 위한 기반으로 삼기 위해 ECMAScript 2015 소스 문서로부터 일반 텍스트 소스 문서를 만들었습니다. 이 표준이 개발된 1년 동안 수천 건의 버그 수정, 편집 수정 및 기타 개선 사항에 해당하는 수백 건의 풀 리퀘스트와 이슈가 등록되었습니다. 또한 이러한 작업을 지원하기 위해 Ecmarkup, Ecmarkdown, Grammarkdown을 비롯한 다양한 소프트웨어 도구가 개발되었습니다. ES2016에는 새로운 거듭제곱 연산자에 대한 지원도 포함되었으며, Array.prototype에 includes라는 새로운 메서드가 추가되었습니다.

ECMAScript 2017에는 소규모 언어 및 라이브러리 개선, 버그 수정, 편집상의 갱신과 함께 비동기 함수, 공유 메모리 및 원자적 연산이 도입되었습니다. 비동기 함수는 프로미스를 반환하는 함수를 위한 구문을 제공하여 비동기 프로그래밍 경험을 개선합니다. 공유 메모리와 원자적 연산은 병렬 CPU에서도 명확히 정의된 실행 순서를 보장하는 원자적 연산을 사용하여 여러 에이전트로 구성된 프로그램이 통신할 수 있도록 하는 새로운 메모리 모델을 도입합니다. Object에 새로운 정적 메서드인 Object.values, Object.entries, Object.getOwnPropertyDescriptors도 추가되었습니다.

ECMAScript 2018에는 비동기 이터레이터 프로토콜과 비동기 제너레이터를 통한 비동기 반복 지원이 도입되었습니다. 또한 네 가지 새로운 정규 표현식 기능인 dotAll 플래그, 이름 있는 캡처 그룹, 유니코드 프로퍼티 이스케이프 및 후방 탐색 단언이 포함되었습니다. 마지막으로 객체의 나머지 프로퍼티와 전개 프로퍼티가 포함되었습니다.

ECMAScript 2019에는 몇 가지 새로운 내장 함수가 도입되었습니다. 배열을 평탄화하기 위한 Array.prototype의 flat과 flatMap, Object.entries의 반환값을 새 Object로 직접 변환하기 위한 Object.fromEntries, 널리 구현되어 있지만 비표준인 내장 함수 String.prototype.trimLeft와 trimRight를 더 적절한 이름으로 대체하는 String.prototype의 trimStart와 trimEnd가 포함되었습니다. 또한 구문과 의미에 대한 몇 가지 사소한 갱신이 포함되었습니다. 구문 갱신에는 선택적인 catch 바인딩 매개변수와 JSON에 맞추기 위한 문자열 리터럴 내 U+2028(줄 구분자) 및 U+2029(문단 구분자)의 허용이 포함되었습니다. 다른 갱신 사항에는 Array.prototype.sort가 안정 정렬을 수행하도록 하는 요구 사항, JSON.stringify가 입력과 관계없이 올바른 형식의 UTF-8을 반환하도록 하는 요구 사항, Function.prototype.toString이 해당하는 원래 소스 텍스트 또는 표준 자리표시자 중 하나를 반환하도록 하여 그 동작을 명확히 하는 사항이 포함되었습니다.

ECMAScript 2020은 제11^판으로, 전역 정규 표현식에서 생성된 모든 일치 객체에 대한 이터레이터를 생성하는 String의 matchAll 메서드; 동적 지정자를 사용하여 모듈을 비동기적으로 가져오는 구문인 import(); 임의 정밀도 정수를 다루기 위한 새로운 숫자 원시형인 BigInt; 단락 평가하지 않는 새로운 Promise 조합자인 Promise.allSettled; 전역 this 값에 접근하는 범용적인 방법인 globalThis; 모듈 내부에서 사용하는 전용 export * as ns from 'module' 구문; for-in 열거 순서의 표준화 확대; 모듈에서 사용할 수 있으며 호스트가 내용을 채우고 모듈에 관한 문맥 정보를 포함할 수 있는 객체인 import.meta를 도입했습니다. 또한 “nullish” 값(undefined 또는 null)을 더 편리하게 다루기 위한 두 가지 새로운 구문 기능인 값 선택 연산자 nullish 병합과, 접근하거나 호출할 값이 nullish이면 단락 평가하는 프로퍼티 접근 및 함수 호출 연산자 옵셔널 체이닝이 추가되었습니다.

ECMAScript 2021은 제12^판으로, String의 replaceAll 메서드; 입력값이 이행되면 단락 평가하는 Promise 조합자인 Promise.any; 여러 오류를 한 번에 나타내는 새로운 Error 유형인 AggregateError; 논리 할당 연산자(??=, &&=, ||=); 대상 객체가 가비지 컬렉션으로부터 유지되도록 하지 않으면서 해당 객체를 참조하는 WeakRef와, 대상 객체가 가비지 컬렉션될 때 수행되는 정리 작업의 등록 및 등록 해제를 관리하는 FinalizationRegistry; 숫자 리터럴의 구분자(1_000)를 도입했습니다. 또한 Array.prototype.sort가 더 정밀하게 정의되어 구현체 정의 정렬 순서가 발생하는 경우의 수가 줄었습니다.

ECMAScript 2022는 제13^판으로, 모듈의 최상위 수준에서 해당 키워드를 사용할 수 있게 하는 최상위 await; 새로운 클래스 요소인 공개 및 비공개 인스턴스 필드, 공개 및 비공개 정적 필드, 비공개 인스턴스 메서드와 접근자, 비공개 정적 메서드와 접근자; 클래스별 평가 초기화를 수행하는 클래스 내부의 정적 블록; 객체에 비공개 필드가 있는지 검사하는 #x in obj 구문; 일치한 부분 문자열의 시작 및 끝 인덱스를 제공하는 /d 플래그를 통한 정규 표현식 일치 인덱스; 오류의 원인 연결 관계를 기록하는 데 사용할 수 있는 Error 객체의 cause 프로퍼티; 상대 인덱싱을 허용하는 String, Array 및 TypedArray의 at 메서드; Object.prototype.hasOwnProperty를 편리하게 대체하는 Object.hasOwn을 도입했습니다.

ECMAScript 2023은 제14^판으로, Array.prototype과 TypedArray.prototype의 toSorted, toReversed, with, findLast, findLastIndex 메서드 및 Array.prototype의 toSpliced 메서드를 도입했습니다. 실행 가능한 ECMAScript 파일을 더 편리하게 만들 수 있도록 파일 시작 부분의 #! 주석에 대한 지원을 추가했으며, 대부분의 Symbol을 약한 컬렉션의 키로 사용할 수 있도록 허용했습니다.

ECMAScript 2024는 제15^판으로, ArrayBuffer와 SharedArrayBuffer의 크기를 조정하고 전송하는 기능을 추가했습니다. 문자열 집합을 다루는 고급 기능을 갖춘 RegExp를 생성하기 위한 새로운 RegExp /v 플래그를 추가했습니다. 또한 Promise를 구성하기 위한 편의 메서드 Promise.withResolvers, 데이터를 집계하기 위한 Object.groupBy와 Map.groupBy 메서드, 공유 메모리의 변경을 비동기적으로 기다리기 위한 Atomics.waitAsync 메서드, 문자열에 올바른 형식의 유니코드만 포함되는지 검사하고 이를 보장하기 위한 String.prototype.isWellFormed와 String.prototype.toWellFormed 메서드를 도입했습니다.

ECMAScript 2025는 제16^판으로, 이터레이터를 다루기 위한 관련 정적 메서드와 프로토타입 메서드를 갖춘 새로운 전역 Iterator를 추가했습니다. Set에 대한 일반적인 연산을 수행하기 위한 메서드를 Set.prototype에 추가했습니다. JSON 모듈 가져오기에 대한 지원과 가져오는 모듈의 속성을 선언하기 위한 구문을 추가했습니다. 문자열을 정규 표현식에서 안전하게 사용할 수 있도록 이스케이프하는 RegExp.escape 메서드를 추가했습니다. 정규 표현식 내부에서 수정자 플래그를 인라인으로 활성화하거나 비활성화하는 구문을 추가했습니다. Promise를 반환할 수도 있고 반환하지 않을 수도 있는 함수를 호출하면서 결과가 항상 Promise가 되도록 보장하는 Promise.try 메서드를 추가했습니다. 또한 새로운 TypedArray 종류인 Float16Array와 관련 메서드 DataView.prototype.getFloat16, DataView.prototype.setFloat16, Math.f16round를 추가했습니다.

ECMAScript 2026은 제17^판으로, 정밀도 손실을 최소화하면서 크기가 서로 다른 Number의 이터러블을 합산하는 Math.sumPrecise; 이터레이터를 순서대로 연결하는 Iterator.concat; 비동기 이터러블 및 기타 비동기 소스로부터 Array를 구성하는 Array.fromAsync; 오류 객체를 식별하는 Error.isError; 키가 아직 존재하지 않을 때 조회 시 사용할 기본값을 제공하기 위한 Map.prototype과 WeakMap.prototype의 메서드; 16진수 및 base64로 인코딩된 이진 데이터의 String으로 변환하거나 그로부터 변환하기 위한 Uint8Array의 메서드; 일치하는 JSON 소스 구간에 접근하기 위한 JSON.parse reviver의 매개변수; 원시값에 대한 JSON.stringify 출력을 세밀하게 제어하기 위한 JSON.rawJSON을 추가했습니다.

여러 조직을 대표하는 수십 명의 개인이 Ecma TC39에서 이 판과 이전 판의 개발에 매우 중요한 기여를 했습니다. 또한 TC39의 ECMAScript 관련 활동을 지원하는 활발한 커뮤니티가 형성되었습니다. 이 커뮤니티는 수많은 초안을 검토하고, 수천 건의 버그 보고서를 제출하고, 구현 실험을 수행하고, 테스트 모음을 기여하고, 전 세계 개발자 커뮤니티에 ECMAScript를 교육했습니다. 안타깝게도 이 작업에 기여한 모든 개인과 조직을 확인하여 감사를 표하는 것은 불가능합니다.

Allen Wirfs-Brock
ECMA-262, 프로젝트 편집자, 제6^판

Brian Terlson
ECMA-262, 프로젝트 편집자, 제7^판부터 제10^판까지

Jordan Harband
ECMA-262, 프로젝트 편집자, 제10^판부터 제12^판까지

Kevin Gibbons
ECMA-262, 프로젝트 편집자, 제12^판부터 제17^판까지

Shu-yu Guo
ECMA-262, 프로젝트 편집자, 제12^판부터 제18^판까지

Michael Ficarra
ECMA-262, 프로젝트 편집자, 제12^판부터 제18^판까지

Richard Gibson
ECMA-262, 프로젝트 편집자, 제18^판

Ron Buckton
ECMA-262, 프로젝트 편집자, 제18^판

Nicolò Ribaudo
ECMA-262, 프로젝트 편집자, 제18^판

Linus Groh
ECMA-262, 프로젝트 편집자, 제18^판

1 범위

이 표준은 범용 프로그래밍 언어인 ECMAScript 2027을 정의합니다.

2 적합성

ECMAScript의 적합한 구현체는 이 명세에 기술된 모든 타입, 값, 객체, 프로퍼티, 함수 및 프로그램의 구문과 의미를 제공하고 지원해야 합니다.

ECMAScript의 적합한 구현체는 최신 버전의 유니코드 표준과 ISO/IEC 10646에 따라 소스 텍스트 입력을 해석해야 합니다.

서로 다른 자연어와 국가에서 사용하는 언어적·문화적 관례에 맞춰야 하는 프로그램을 지원하는 애플리케이션 프로그래밍 인터페이스(API)를 제공하는 ECMAScript의 적합한 구현체는 이 명세와 호환되는 최신 ECMA-402 판에 정의된 인터페이스를 구현해야 합니다.

ECMAScript의 적합한 구현체는 이 명세에 기술된 것 외에 추가적인 타입, 값, 객체, 프로퍼티 및 함수를 제공할 수 있습니다. 특히 ECMAScript의 적합한 구현체는 이 명세에 기술된 객체에 대해 이 명세에 기술되지 않은 프로퍼티와 해당 프로퍼티의 값을 제공할 수 있습니다.

ECMAScript의 적합한 구현체는 이 명세에 기술되지 않은 프로그램 구문과 정규 표현식 구문을 지원할 수 있습니다. 특히 ECMAScript의 적합한 구현체는 이 명세의 하위 절 12.7.2에 명시된 “미래 예약어”를 사용하는 프로그램 구문을 지원할 수 있습니다.

ECMAScript의 적합한 구현체는 하위 절 17.1에서 금지된 확장으로 나열된 확장을 구현해서는 안 됩니다.

ECMAScript의 적합한 구현체는 구현체 정의, 구현체 근사 또는 호스트 정의가 아닌 기능을 재정의해서는 안 됩니다.

ECMAScript의 적합한 구현체는 달리 명시되지 않는 한 규범적 선택 사항인 하위 절의 구현 여부를 선택할 수 있습니다. 웹 브라우저는 일반적으로 모든 규범적 선택 사항 하위 절을 구현해야 합니다. (부속서 B를 참조하시기 바랍니다.) 규범적 선택 사항인 동작을 하나라도 구현하는 경우, 해당 동작을 포함하는 규범적 선택 사항 절의 모든 동작을 구현해야 합니다. 이 명세에서는 아래와 같이 색상이 있는 상자 안에 “규범적 선택 사항”이라는 문구를 표시하여 규범적 선택 사항 절을 나타냅니다.

규정 선택 사항

2.1 규범적 선택 사항 절 제목 예시

절 내용 예시입니다.

ECMAScript의 적합한 구현체는 규범적 선택 사항으로도 표시된 경우가 아니라면 레거시 하위 절을 구현해야 합니다. 레거시 하위 절에 명시된 모든 언어 기능과 동작에는 바람직하지 않은 특성이 하나 이상 있습니다. 그러나 기존 애플리케이션에서 계속 사용되고 있으므로 이 명세에서 제거할 수 없습니다. 이러한 기능은 ECMAScript 핵심 언어의 일부로 간주되지 않습니다. 프로그래머는 새로운 ECMAScript 코드를 작성할 때 이러한 기능과 동작을 사용하거나 그 존재를 가정하지 않는 것이 좋습니다.

레거시

2.2 레거시 절 제목 예시

절 내용 예시입니다.

규정 선택 사항, 레거시

2.3 레거시 규범적 선택 사항 절 제목 예시

절 내용 예시입니다.

3 규범적 참고 문헌

다음의 참조 문서는 이 문서를 적용하는 데 필수적입니다. 날짜가 명시된 참조의 경우 인용된 판만 적용됩니다. 날짜가 명시되지 않은 참조의 경우 참조 문서의 최신판(모든 개정 사항 포함)이 적용됩니다.

IEEE 754-2019, 부동소수점 산술에 관한 IEEE 표준.

유니코드 표준.
https://unicode.org/versions/latest

ISO/IEC 10646, 정보 기술 — 범용 다중 옥텟 부호화 문자 집합(UCS) 및 개정 1:2005, 개정 2:2006, 개정 3:2008, 개정 4:2008과 추가 개정 사항 및 정오표, 또는 후속 표준.

ECMA-402, ECMAScript 국제화 API 명세, 구체적으로는 이 명세의 해당 판에 대응하는 연간 판.
https://www.ecma-international.org/publications-and-standards/standards/ecma-402/

ECMA-404, JSON 데이터 교환 형식.
https://www.ecma-international.org/publications-and-standards/standards/ecma-404/

4 개요

이 절에는 ECMAScript 언어에 대한 비규범적 개요가 포함되어 있습니다.

ECMAScript는 호스트 환경 내에서 계산을 수행하고 계산 객체를 조작하기 위한 객체 지향 프로그래밍 언어입니다. 여기에서 정의하는 ECMAScript는 계산에 필요한 모든 기능을 자체적으로 제공하도록 설계되지 않았습니다. 실제로 이 명세에는 외부 데이터의 입력이나 계산 결과의 출력을 위한 규정이 없습니다. 대신 ECMAScript 프로그램의 계산 환경은 이 명세에 기술된 객체와 기타 기능뿐 아니라 특정 환경에 고유한 객체도 제공할 것으로 기대됩니다. 이러한 객체의 설명과 동작은 ECMAScript 프로그램에서 접근할 수 있는 특정 프로퍼티와 호출할 수 있는 특정 함수를 제공할 수 있다는 점을 명시하는 것 외에는 이 명세의 범위를 벗어납니다.

ECMAScript는 원래 스크립팅 언어로 사용하도록 설계되었으나, 현재는 범용 프로그래밍 언어로 널리 사용됩니다. 스크립팅 언어는 기존 시스템의 기능을 조작하고, 사용자 정의하고, 자동화하는 데 사용하는 프로그래밍 언어입니다. 이러한 시스템에서는 유용한 기능이 사용자 인터페이스를 통해 이미 제공되며, 스크립팅 언어는 해당 기능을 프로그램으로 제어할 수 있도록 노출하는 수단입니다. 이러한 방식으로 기존 시스템은 객체와 기능으로 구성된 호스트 환경을 제공하여 스크립팅 언어의 기능을 완성한다고 할 수 있습니다. 스크립팅 언어는 전문 프로그래머와 비전문 프로그래머 모두가 사용하도록 설계됩니다.

ECMAScript는 원래 웹 스크립팅 언어로 설계되었으며, 브라우저의 웹 페이지를 동적으로 만들고 웹 기반 클라이언트-서버 아키텍처의 일부로 서버 계산을 수행하는 수단을 제공했습니다. 현재 ECMAScript는 다양한 호스트 환경에 핵심 스크립팅 기능을 제공하는 데 사용됩니다. 따라서 이 문서에서는 특정 호스트 환경과 독립적으로 핵심 언어를 명시합니다.

ECMAScript의 사용은 단순한 스크립팅을 넘어섰으며, 현재는 다양한 환경과 규모에서 모든 범위의 프로그래밍 작업에 사용됩니다. ECMAScript의 사용이 확대됨에 따라 제공하는 기능도 함께 확장되었습니다. ECMAScript는 이제 완전한 기능을 갖춘 범용 프로그래밍 언어입니다.

4.1 웹 스크립팅

웹 브라우저는 클라이언트 측 계산을 위한 ECMAScript 호스트 환경을 제공하며, 여기에는 창, 메뉴, 팝업, 대화 상자, 텍스트 영역, 앵커, 프레임, 방문 기록, 쿠키 및 입출력을 나타내는 객체 등이 포함됩니다. 또한 호스트 환경은 포커스 변경, 페이지와 이미지의 로드, 언로드, 오류와 중단, 선택, 폼 제출 및 마우스 동작과 같은 이벤트에 스크립팅 코드를 연결하는 수단을 제공합니다. 스크립팅 코드는 HTML 내부에 나타나며, 표시되는 페이지는 사용자 인터페이스 요소와 고정되거나 계산된 텍스트 및 이미지의 조합입니다. 스크립팅 코드는 사용자 상호 작용에 반응하며, 주 프로그램이 필요하지 않습니다.

웹 서버는 서버 측 계산을 위한 별도의 호스트 환경을 제공하며, 여기에는 요청, 클라이언트 및 파일을 나타내는 객체와 데이터를 잠그고 공유하는 수단이 포함됩니다. 브라우저 측 스크립팅과 서버 측 스크립팅을 함께 사용하면 웹 기반 애플리케이션에 맞춤형 사용자 인터페이스를 제공하면서 클라이언트와 서버 사이에 계산을 분산할 수 있습니다.

ECMAScript를 지원하는 각 웹 브라우저와 서버는 자체 호스트 환경을 제공하여 ECMAScript 실행 환경을 완성합니다.

4.2 호스트와 구현체

ECMAScript를 호스트 환경에 통합하는 데 도움이 되도록 이 명세는 특정 기능(예: 추상 연산)의 정의 전체 또는 일부를 이 명세 외부의 주체에 위임합니다. 편집상 이 명세는 다음과 같은 종류의 위임을 구분합니다.

구현체는 부속서 D에 열거된 기능 또는 구현체 정의나 구현체 근사로 표시된 기능을 추가로 정의하는 외부 주체입니다. 비공식적인 용법에서 구현체는 특정 웹 브라우저와 같은 구체적인 결과물을 가리킵니다.

구현체 정의 기능은 추가적인 제한 없이 그 정의를 외부 주체에 위임하는 기능입니다. 이 명세는 특정 동작을 권장하지 않으며, 적합한 구현체는 이 명세에서 제시한 제약 내에서 자유롭게 동작을 선택할 수 있습니다.

구현체 근사 기능은 이상적인 동작을 권장하면서 그 정의를 외부 주체에 위임하는 기능입니다. 적합한 구현체는 이 명세에서 제시한 제약 내에서 자유롭게 동작을 선택할 수 있지만, 이상적인 동작에 근접하도록 노력하는 것이 권장됩니다. Math.exp와 같은 일부 수학 연산은 구현체 근사입니다.

호스트는 부속서 D에 나열된 기능을 추가로 정의하지만, 그 밖의 구현체 정의 또는 구현체 근사 기능은 추가로 정의하지 않는 외부 주체입니다. 비공식적인 용법에서 호스트는 모든 웹 브라우저의 집합과 같이 부속서 D를 통해 이 명세와 동일한 방식으로 연동하는 모든 구현체의 집합을 가리킵니다. 호스트는 WHATWG HTML(https://html.spec.whatwg.org/)과 같은 외부 명세인 경우가 많습니다. 다시 말해, 호스트 정의 기능은 외부 명세에서 추가로 정의되는 경우가 많습니다.

호스트 훅은 외부 주체가 전체 또는 일부를 정의하는 추상 연산입니다. 모든 호스트 훅은 부속서 D에 나열되어야 합니다. 호스트 훅은 적어도 다음 요구 사항을 준수해야 합니다:

정상 완료 또는 예외 완료 중 하나를 반환해야 합니다.

호스트 정의 기능은 추가적인 제한 없이 그 정의를 외부 주체에 위임하며 부속서 D에 나열된 기능입니다. 호스트가 아닌 구현체도 호스트 정의 기능에 대한 정의를 제공할 수 있습니다.

호스트 환경은 모든 호스트 정의 기능에 대해 선택한 구체적인 정의의 조합입니다. 호스트 환경에는 일반적으로 입력을 얻고 출력을 제공할 수 있는 객체 또는 함수가 전역 객체의 호스트 정의 프로퍼티로 포함됩니다.

이 명세는 항상 가장 구체적인 용어를 사용하는 편집 관례를 따릅니다. 예를 들어 어떤 기능이 호스트 정의라면 이를 구현체 정의라고 지칭하지 않는 것이 좋습니다.

호스트와 구현체 모두 이 명세에 정의된 언어 타입, 명세 타입, 추상 연산, 문법 생성 규칙, 내재 객체 및 내재 심볼을 통해 이 명세와 연동할 수 있습니다.

4.3 ECMAScript 개요

다음은 ECMAScript에 대한 비공식적인 개요이며, 언어의 모든 부분을 설명하지는 않습니다. 이 개요는 표준 본문의 일부가 아닙니다.

ECMAScript는 객체 기반입니다. 기본적인 언어 기능과 호스트 기능은 객체를 통해 제공되며, ECMAScript 프로그램은 서로 통신하는 객체들의 집합입니다. ECMAScript에서 객체는 0개 이상의 프로퍼티로 구성되며, 각 프로퍼티에는 사용 방법을 결정하는 속성이 있습니다. 예를 들어 프로퍼티의 Writable 속성이 false로 설정되면 실행 중인 ECMAScript 코드가 해당 프로퍼티에 다른 값을 할당하려는 모든 시도는 실패합니다. 프로퍼티는 다른 객체, 원시값 또는 함수를 담는 컨테이너입니다. 원시값은 다음 내장 타입 중 하나의 구성원입니다: Undefined, Null, Boolean, Number, BigInt, String, Symbol; 객체는 내장 타입 Object의 구성원이며, 함수는 호출 가능한 객체입니다. 프로퍼티를 통해 객체와 연결된 함수는 메서드라고 합니다.

ECMAScript는 ECMAScript 개체의 정의를 완성하는 내장 객체의 집합을 정의합니다. 이러한 내장 객체에는 전역 객체; Object, Function, Boolean, Symbol 및 다양한 Error 객체를 포함하여 언어의 런타임 의미론에 기본이 되는 객체; Math, Number, Date를 포함하여 숫자 값을 나타내고 조작하는 객체; 텍스트 처리 객체인 String과 RegExp; Array 및 요소가 각각 특정 숫자 데이터 표현을 갖는 9가지 종류의 TypedArray를 포함하여 인덱스가 있는 값의 컬렉션인 객체; Map과 Set 객체를 포함하는 키 기반 컬렉션; JSON 객체, ArrayBuffer, SharedArrayBuffer, DataView를 포함하여 구조화된 데이터를 지원하는 객체; 제너레이터 함수와 Promise 객체를 포함하여 제어 추상화를 지원하는 객체; Proxy와 Reflect를 포함하는 리플렉션 객체가 있습니다.

ECMAScript는 내장 연산자의 집합도 정의합니다. ECMAScript 연산자에는 다양한 단항 연산, 곱셈 연산자, 덧셈 연산자, 비트 이동 연산자, 관계 연산자, 동등 연산자, 이항 비트 연산자, 이항 논리 연산자, 할당 연산자 및 쉼표 연산자가 포함됩니다.

대규모 ECMAScript 프로그램은 프로그램을 여러 개의 문 및 선언 시퀀스로 나눌 수 있게 하는 모듈을 통해 지원됩니다. 각 모듈은 자신이 사용하며 다른 모듈에서 제공해야 하는 선언과, 자신의 선언 중 다른 모듈이 사용할 수 있는 선언을 명시적으로 식별합니다.

ECMAScript 구문은 의도적으로 Java 구문과 유사하게 설계되었습니다. ECMAScript 구문은 사용하기 쉬운 스크립팅 언어로 활용할 수 있도록 제약이 완화되어 있습니다. 예를 들어 변수의 타입을 선언할 필요가 없으며, 프로퍼티에도 타입이 연결되지 않습니다. 또한 정의된 함수의 선언이 해당 함수를 호출하는 부분보다 소스 텍스트상 앞에 나타날 필요가 없습니다.

4.3.1 객체

ECMAScript에는 클래스 정의를 위한 구문이 포함되어 있지만, ECMAScript 객체는 C++, Smalltalk 또는 Java의 객체처럼 근본적으로 클래스 기반인 것은 아닙니다. 대신 객체는 리터럴 표기법이나 생성자 등 다양한 방법으로 생성할 수 있습니다. 생성자는 객체를 생성한 다음, 프로퍼티에 초기값을 할당하여 객체 전체 또는 일부를 초기화하는 코드를 실행합니다. 각 생성자는 프로토타입 기반 상속과 공유 프로퍼티를 구현하는 데 사용되는 "prototype"이라는 프로퍼티를 갖는 함수입니다. 객체는 new 표현식에서 생성자를 사용하여 생성합니다. 예를 들어 new Date(2009, 11)은 새 Date 객체를 생성합니다. new를 사용하지 않고 생성자를 호출했을 때의 결과는 생성자에 따라 달라집니다. 예를 들어 Date()는 객체 대신 현재 날짜와 시간의 문자열 표현을 생성합니다.

생성자로 생성한 모든 객체는 생성자의 "prototype" 프로퍼티 값에 대한 암묵적인 참조를 가지며, 이를 객체의 프로토타입이라고 합니다. 또한 프로토타입은 자신의 프로토타입에 대한 null이 아닌 암묵적인 참조를 가질 수 있으며, 이러한 참조가 계속 이어질 수 있습니다. 이를 프로토타입 체인이라고 합니다. 객체의 프로퍼티를 참조하면 프로토타입 체인에서 해당 이름의 프로퍼티를 포함하는 첫 번째 객체의 그 프로퍼티를 참조하게 됩니다. 다시 말해, 먼저 직접 언급된 객체에 해당 프로퍼티가 있는지 검사합니다. 그 객체에 해당 이름의 프로퍼티가 있으면 참조는 그 프로퍼티를 가리킵니다. 해당 이름의 프로퍼티가 없으면 다음으로 그 객체의 프로토타입을 검사하며, 이러한 과정이 계속됩니다.

여러 상자와 화살표로 이루어진 이미지. — 그림 1: 객체/프로토타입 관계

클래스 기반 객체 지향 언어에서는 일반적으로 인스턴스가 상태를 갖고, 클래스가 메서드를 가지며, 구조와 동작만 상속됩니다. ECMAScript에서는 객체가 상태와 메서드를 가지며, 구조, 동작 및 상태가 모두 상속됩니다.

프로토타입에 있는 특정 프로퍼티를 직접 포함하지 않는 모든 객체는 해당 프로퍼티와 그 값을 공유합니다. 그림 1은 이를 보여 줍니다:

CF는 생성자이며 객체이기도 합니다. new 표현식을 사용하여 다섯 개의 객체 cf₁, cf₂, cf₃, cf₄, cf₅를 생성했습니다. 각 객체에는 "q1"과 "q2"라는 프로퍼티가 있습니다. 점선은 암묵적인 프로토타입 관계를 나타냅니다. 예를 들어 cf₃의 프로토타입은 CF_p입니다. 생성자 CF 자체에는 "P1"과 "P2"라는 두 개의 프로퍼티가 있으며, 이 프로퍼티는 CF_p, cf₁, cf₂, cf₃, cf₄ 또는 cf₅에서 보이지 않습니다. CF_p에 있는 "CFP1"이라는 프로퍼티는 cf₁, cf₂, cf₃, cf₄, cf₅가 공유하지만 CF는 공유하지 않습니다. CF_p의 암묵적인 프로토타입 체인에 있는 프로퍼티 중 이름이 "q1", "q2" 또는 "CFP1"이 아닌 프로퍼티도 마찬가지로 공유됩니다. CF와 CF_p 사이에는 암묵적인 프로토타입 연결이 없다는 점에 유의하시기 바랍니다.

대부분의 클래스 기반 객체 언어와 달리, 프로퍼티에 값을 할당하여 객체에 프로퍼티를 동적으로 추가할 수 있습니다. 즉, 생성자가 생성된 객체의 모든 프로퍼티 또는 일부 프로퍼티의 이름을 지정하거나 값을 할당할 필요는 없습니다. 위 그림에서는 cf₁, cf₂, cf₃, cf₄, cf₅를 위한 새로운 공유 프로퍼티를 CF_p의 프로퍼티에 새 값을 할당하여 추가할 수 있습니다.

ECMAScript 객체는 본질적으로 클래스 기반이 아니지만, 생성자 함수, 프로토타입 객체 및 메서드의 공통 패턴을 바탕으로 클래스와 유사한 추상화를 정의하는 것이 편리한 경우가 많습니다. ECMAScript 내장 객체 자체도 이러한 클래스와 유사한 패턴을 따릅니다. ECMAScript 2015부터 ECMAScript 언어에는 프로그래머가 내장 객체에서 사용하는 것과 동일한 클래스 유사 추상화 패턴을 따르는 객체를 간결하게 정의할 수 있도록 하는 클래스 정의 구문이 포함됩니다.

4.3.2 ECMAScript의 엄격 변형

ECMAScript 언어는 일부 사용자가 언어에서 사용할 수 있는 특정 기능의 사용을 제한하기를 원할 수 있음을 인정합니다. 사용자는 보안을 위해, 오류를 유발하기 쉽다고 생각하는 기능을 피하기 위해, 강화된 오류 검사를 얻기 위해 또는 자신이 선택한 다른 이유로 이러한 제한을 원할 수 있습니다. 이를 지원하기 위해 ECMAScript는 언어의 엄격 변형을 정의합니다. 언어의 엄격 변형은 일반 ECMAScript 언어의 특정 구문적·의미적 기능을 제외하고 일부 기능의 세부 의미를 수정합니다. 또한 엄격 변형은 비엄격 형태의 언어에서 오류로 명시되지 않은 상황에 대해 오류 예외를 던져 보고해야 하는 추가 오류 조건을 명시합니다.

ECMAScript의 엄격 변형은 일반적으로 언어의 엄격 모드라고 합니다. 엄격 모드의 선택과 ECMAScript 엄격 모드 구문 및 의미의 사용은 11.2.2에 설명된 대로 개별 ECMAScript 소스 텍스트 단위 수준에서 명시적으로 이루어집니다. 엄격 모드는 구문적인 소스 텍스트 단위 수준에서 선택되므로, 해당 소스 텍스트 단위 내에서 국소적으로 영향을 미치는 제한만 부과합니다. 엄격 모드는 여러 소스 텍스트 단위에 걸쳐 일관되게 동작해야 하는 ECMAScript 의미론의 어떠한 측면도 제한하거나 수정하지 않습니다. 하나의 완전한 ECMAScript 프로그램은 엄격 모드와 비엄격 모드의 ECMAScript 소스 텍스트 단위로 함께 구성될 수 있습니다. 이 경우 엄격 모드는 엄격 모드 소스 텍스트 단위 내에 정의된 코드를 실제로 실행할 때만 적용됩니다.

이 명세에 적합하려면 ECMAScript 구현체는 이 명세에 정의된 제한 없는 전체 ECMAScript 언어와 ECMAScript 언어의 엄격 변형을 모두 구현해야 합니다. 또한 구현체는 제한 없는 소스 텍스트 단위와 엄격 모드 소스 텍스트 단위를 하나의 복합 프로그램으로 결합하는 것을 지원해야 합니다.

4.4 용어 및 정의

이 문서에서는 다음 용어와 정의를 적용합니다.

4.4.1 구현체 근사

구현체 근사 기능은 외부 주체가 전체 또는 일부를 정의하지만, 이 명세에서 이상적인 동작을 권장하는 기능입니다

4.4.2 구현체 정의

구현체 정의 기능은 이 명세 외부의 주체가 전체 또는 일부를 정의하는 기능입니다

4.4.3 호스트 정의

구현체 정의와 같습니다

참고

편집상의 구분에 대해서는 절 4.2를 참조하시기 바랍니다.

4.4.4 타입

절 6에 정의된 데이터 값의 집합입니다

4.4.5 원시값

절 6에 정의된 Undefined, Null, Boolean, Number, BigInt, Symbol 또는 String 타입 중 하나의 구성원입니다

참고

원시값은 언어 구현의 가장 낮은 수준에서 직접 표현되는 데이터입니다.

4.4.6 객체

Object 타입의 구성원입니다

참고

객체는 프로퍼티의 집합이며, 하나의 프로토타입 객체를 갖습니다. 프로토타입은 null일 수 있습니다.

4.4.7 생성자

객체를 생성하고 초기화하는 함수 객체입니다

참고

생성자의 "prototype" 프로퍼티 값은 상속과 공유 프로퍼티를 구현하는 데 사용되는 프로토타입 객체입니다.

4.4.8 프로토타입

다른 객체에 공유 프로퍼티를 제공하는 객체입니다

참고

생성자가 객체를 생성하면 해당 객체는 프로퍼티 참조를 해석하기 위해 생성자의 "prototype" 프로퍼티를 암묵적으로 참조합니다. 생성자의 "prototype" 프로퍼티는 프로그램 표현식 constructor.prototype으로 참조할 수 있으며, 객체의 프로토타입에 추가된 프로퍼티는 상속을 통해 해당 프로토타입을 공유하는 모든 객체가 공유합니다. 또는 내장 함수 Object.create를 사용하여 명시적으로 지정한 프로토타입을 갖는 새 객체를 생성할 수 있습니다.

4.4.9 일반 객체

모든 객체가 지원해야 하는 필수 내부 메서드에 대해 기본 동작을 갖는 객체입니다

4.4.10 특수 객체

하나 이상의 필수 내부 메서드에 대해 기본 동작을 갖지 않는 객체입니다

참고

일반 객체가 아닌 모든 객체는 특수 객체입니다.

4.4.11 표준 객체

이 명세에서 의미를 정의하는 객체입니다

4.4.12 내장 객체

ECMAScript 구현체가 명시하고 제공하는 객체입니다

참고

표준 내장 객체는 이 명세에 정의되어 있습니다. ECMAScript 구현체는 추가 종류의 내장 객체를 명시하고 제공할 수 있습니다.

4.4.13 undefined 값

변수에 값이 할당되지 않았을 때 사용하는 원시값입니다

4.4.14 Undefined 타입

undefined 값만을 유일한 값으로 갖는 타입입니다

4.4.15 null 값

어떠한 객체 값도 의도적으로 존재하지 않음을 나타내는 원시값입니다

4.4.16 Null 타입

null 값만을 유일한 값으로 갖는 타입입니다

4.4.17 Boolean 값

Boolean 타입의 구성원입니다

참고

Boolean 값은 true와 false 두 개뿐입니다.

4.4.18 Boolean 타입

원시값 true와 false로 구성된 타입입니다

4.4.19 Boolean 객체

표준 내장 Boolean 생성자의 인스턴스인 Object 타입의 구성원입니다

참고

Boolean 객체는 new 표현식에서 Boolean 생성자를 사용하고 Boolean 값을 인수로 전달하여 생성합니다. 생성된 객체에는 해당 Boolean 값을 값으로 갖는 내부 슬롯이 있습니다. Boolean 객체는 Boolean 값으로 강제 변환할 수 있습니다.

4.4.20 String 값

0개 이상의 16비트 부호 없는 정숫값으로 이루어진 유한한 순서 있는 시퀀스인 원시값입니다

참고

String 값은 String 타입의 구성원입니다. 시퀀스의 각 정숫값은 일반적으로 UTF-16 텍스트의 단일 16비트 단위를 나타냅니다. 그러나 ECMAScript는 이러한 값이 16비트 부호 없는 정수여야 한다는 것 외에는 값에 어떠한 제한이나 요구 사항도 부과하지 않습니다.

4.4.21 String 타입

가능한 모든 String 값의 집합입니다

4.4.22 String 객체

표준 내장 String 생성자의 인스턴스인 Object 타입의 구성원입니다

참고

String 객체는 new 표현식에서 String 생성자를 사용하고 String 값을 인수로 전달하여 생성합니다. 생성된 객체에는 해당 String 값을 값으로 갖는 내부 슬롯이 있습니다. String 생성자를 함수로 호출하여 String 객체를 String 값으로 강제 변환할 수 있습니다(22.1.1.1).

4.4.23 Number 값

배정밀도 64비트 이진 형식의 IEEE 754-2019 값에 대응하는 원시값입니다

참고

Number 값은 Number 타입의 구성원이며, 수를 직접 표현합니다.

4.4.24 Number 타입

NaN(“숫자가 아님”), +∞_𝔽(양의 무한대), -∞_𝔽(음의 무한대)를 포함한 가능한 모든 Number 값의 집합입니다

4.4.25 Number 객체

표준 내장 Number 생성자의 인스턴스인 Object 타입의 구성원입니다

참고

Number 객체는 new 표현식에서 Number 생성자를 사용하고 Number 값을 인수로 전달하여 생성합니다. 생성된 객체에는 해당 Number 값을 값으로 갖는 내부 슬롯이 있습니다. Number 생성자를 함수로 호출하여 Number 객체를 Number 값으로 강제 변환할 수 있습니다(21.1.1.1).

4.4.26 Infinity

양의 무한대를 나타내는 Number 값입니다

4.4.27 NaN

IEEE 754-2019의 NaN(“숫자가 아님”) 값인 Number 값입니다

4.4.28 BigInt 값

임의 정밀도 정숫값에 대응하는 원시값입니다

4.4.29 BigInt 타입

가능한 모든 BigInt 값의 집합입니다

4.4.30 BigInt 객체

표준 내장 BigInt 생성자의 인스턴스인 Object 타입의 구성원입니다

4.4.31 Symbol 값

고유하며 String이 아닌 Object 프로퍼티 키를 나타내는 원시값입니다

4.4.32 Symbol 타입

가능한 모든 Symbol 값의 집합입니다

4.4.33 Symbol 객체

표준 내장 Symbol 생성자의 인스턴스인 Object 타입의 구성원입니다

4.4.34 함수

서브루틴으로 호출할 수 있는 Object 타입의 구성원입니다

참고

함수에는 프로퍼티 외에도 호출 시 동작을 결정하는 실행 가능한 코드와 상태가 포함됩니다. 함수의 코드는 ECMAScript로 작성되었을 수도 있고 그렇지 않을 수도 있습니다.

4.4.35 내장 함수

함수인 내장 객체입니다

참고

내장 함수의 예로는 parseInt와 Math.exp가 있습니다. 호스트 또는 구현체는 이 명세에 기술되지 않은 추가 내장 함수를 제공할 수 있습니다.

4.4.36 내장 생성자

생성자인 내장 함수입니다

참고

내장 생성자의 예로는 Object와 Function이 있습니다. 호스트 또는 구현체는 이 명세에 기술되지 않은 추가 내장 생성자를 제공할 수 있습니다.

4.4.37 프로퍼티

키(String 값 또는 Symbol 값)와 값을 연결하는 객체의 일부입니다

참고

프로퍼티의 형태에 따라 값은 데이터 값(원시값, 객체 또는 함수 객체)으로 직접 표현되거나 접근자 함수 쌍에 의해 간접적으로 표현될 수 있습니다.

4.4.38 메서드

프로퍼티의 값인 함수입니다

참고

함수를 객체의 메서드로 호출하면 해당 객체가 함수의 this 값으로 전달됩니다.

4.4.39 내장 메서드

내장 함수인 메서드입니다

참고

표준 내장 메서드는 이 명세에 정의되어 있습니다. 호스트 또는 구현체는 이 명세에 기술되지 않은 추가 내장 메서드를 제공할 수 있습니다.

4.4.40 속성

프로퍼티의 특정 특성을 정의하는 내부 값입니다

4.4.41 자체 프로퍼티

해당 객체에 직접 포함된 프로퍼티입니다

4.4.42 상속된 프로퍼티

객체의 자체 프로퍼티가 아니면서 해당 객체의 프로토타입에 있는 프로퍼티(자체 프로퍼티 또는 상속된 프로퍼티)인 객체의 프로퍼티입니다

4.5 이 명세의 구성

이 명세의 나머지 부분은 다음과 같이 구성됩니다:

절 5에서는 명세 전반에 걸쳐 사용하는 표기 관례를 정의합니다.

절 6부터 10까지는 ECMAScript 프로그램이 동작하는 실행 환경을 정의합니다.

절 11부터 17까지는 구문적 인코딩과 모든 언어 기능의 실행 의미를 포함하여 실제 ECMAScript 프로그래밍 언어를 정의합니다.

절 18부터 28까지는 ECMAScript 표준 라이브러리를 정의합니다. 여기에는 ECMAScript 프로그램이 실행 중에 사용할 수 있는 모든 표준 객체의 정의가 포함됩니다.

절 29에서는 SharedArrayBuffer를 기반으로 하는 메모리에 대한 접근의 메모리 일관성 모델과 Atomics 객체의 메서드를 설명합니다.

5 표기 관례

5.1 구문 문법과 어휘 문법

5.1.1 문맥 자유 문법

문맥 자유 문법은 여러 생성 규칙으로 구성됩니다. 각 생성 규칙은 비단말 기호라고 하는 추상 기호를 좌변으로 가지며, 0개 이상의 비단말 기호와 단말 기호의 시퀀스를 우변으로 갖습니다. 각 문법의 단말 기호는 지정된 알파벳에서 선택됩니다.

연쇄 생성 규칙은 우변에 0개 이상의 단말 기호와 함께 정확히 하나의 비단말 기호를 갖는 생성 규칙입니다.

주어진 문맥 자유 문법은 목표 기호라고 하는 하나의 특별한 비단말 기호로 구성된 문장에서 시작하여 언어를 지정합니다. 이 언어는 시퀀스의 임의의 비단말 기호를 해당 비단말 기호가 좌변인 생성 규칙의 우변으로 반복해서 대체하여 얻을 수 있는 단말 기호 시퀀스들의 집합이며, 이 집합은 무한할 수도 있습니다.

5.1.2 어휘 문법과 RegExp 문법

ECMAScript의 어휘 문법은 절 12에 제시되어 있습니다. 이 문법은 11.1에 정의된 SourceCharacter 규칙을 따르는 유니코드 코드 포인트를 단말 기호로 갖습니다. 이 문법은 목표 기호 InputElementDiv, InputElementTemplateTail, InputElementRegExp, InputElementRegExpOrTemplateTail 또는 InputElementHashbangOrRegExp에서 시작하는 생성 규칙의 집합을 정의하며, 이러한 코드 포인트의 시퀀스가 입력 요소의 시퀀스로 변환되는 방법을 설명합니다.

공백과 주석을 제외한 입력 요소는 ECMAScript 구문 문법의 단말 기호를 구성하며, ECMAScript 토큰이라고 합니다. 이러한 토큰은 ECMAScript 언어의 예약어, 식별자, 리터럴 및 구두점 기호입니다. 또한 줄 종결자는 토큰으로 간주되지는 않지만 입력 요소 스트림의 일부가 되어 자동 세미콜론 삽입 과정(12.10)을 안내합니다. 단순 공백과 한 줄 주석은 버려지며 구문 문법의 입력 요소 스트림에 나타나지 않습니다. MultiLineComment(즉, 여러 줄에 걸쳐 있는지와 관계없이 /*…*/ 형식의 주석)도 줄 종결자를 포함하지 않으면 단순히 버려집니다. 그러나 MultiLineComment가 하나 이상의 줄 종결자를 포함하면 단일 줄 종결자로 대체되며, 이 줄 종결자는 구문 문법의 입력 요소 스트림의 일부가 됩니다.

ECMAScript의 RegExp 문법은 22.2.1에 제시되어 있습니다. 이 문법 역시 SourceCharacter로 정의되는 코드 포인트를 단말 기호로 갖습니다. 이 문법은 목표 기호 Pattern에서 시작하는 생성 규칙의 집합을 정의하며, 코드 포인트의 시퀀스가 정규 표현식 패턴으로 변환되는 방법을 설명합니다.

어휘 문법과 RegExp 문법의 생성 규칙은 구분 기호로 두 개의 콜론 “::”을 사용하여 구별합니다. 어휘 문법과 RegExp 문법은 일부 생성 규칙을 공유합니다.

5.1.3 숫자 문자열 문법

숫자 문자열 문법은 7.1.4.1에 제시되어 있습니다. 이 문법은 SourceCharacter를 단말 기호로 가지며, 목표 기호 StringNumericLiteral에서 시작하여 String을 숫자 값으로 변환하는 데 사용됩니다. 이는 숫자 리터럴의 어휘 문법과 유사하지만 서로 다릅니다.

숫자 문자열 문법의 생성 규칙은 구분 기호로 세 개의 콜론 “:::”을 사용하여 구별하며, 소스 텍스트를 파싱하는 데는 사용하지 않습니다.

5.1.4 구문 문법

ECMAScript의 구문 문법은 절 13부터 16까지에 제시되어 있습니다. 이 문법은 어휘 문법에서 정의한 ECMAScript 토큰을 단말 기호로 갖습니다(5.1.2). 이 문법은 두 가지 대안적인 목표 기호 Script와 Module에서 시작하는 생성 규칙의 집합을 정의하며, 토큰 시퀀스가 ECMAScript 프로그램의 구문적으로 올바른 독립 구성 요소를 형성하는 방법을 설명합니다.

코드 포인트 스트림을 ECMAScript Script 또는 Module로 파싱할 때는 먼저 어휘 문법을 반복 적용하여 입력 요소 스트림으로 변환합니다. 그런 다음 구문 문법을 한 번 적용하여 이 입력 요소 스트림을 파싱합니다. 입력 요소 스트림의 토큰을 남는 토큰 없이 목표 비단말 기호(Script 또는 Module)의 단일 인스턴스로 파싱할 수 없다면 입력 스트림에는 구문 오류가 있습니다.

파싱에 성공하면 각 노드가 파스 노드인 루트가 있는 트리 구조인 파스 트리를 구성합니다. 각 파스 노드는 문법 기호의 인스턴스이며, 해당 기호로부터 유도할 수 있는 소스 텍스트 구간을 나타냅니다. 전체 소스 텍스트를 나타내는 파스 트리의 루트 노드는 파싱 목표 기호의 인스턴스입니다. 파스 노드가 비단말 기호의 인스턴스이면, 해당 비단말 기호를 좌변으로 갖는 어떤 생성 규칙의 인스턴스이기도 합니다. 또한 이 노드는 생성 규칙 우변의 각 기호에 하나씩 대응하는 0개 이상의 자식을 갖습니다. 각 자식은 해당 기호의 인스턴스인 파스 노드입니다.

파서를 호출할 때마다 새로운 파스 노드를 생성하며, 동일한 소스 텍스트를 파싱하더라도 서로 다른 파싱 사이에서 재사용하지 않습니다. 파스 노드가 동일한 소스 텍스트 구간을 나타내고, 동일한 문법 기호의 인스턴스이며, 동일한 파서 호출에서 생성된 경우에만 동일한 파스 노드로 간주합니다.

참고 1

동일한 String을 여러 번 파싱하면 서로 다른 파스 노드가 생성됩니다. 예를 들어 다음을 고려하시기 바랍니다:

let str = "1 + 1;";
eval(str);
eval(str);

각 eval 호출은 str의 값을 ECMAScript 소스 텍스트로 변환하고 독립적으로 파싱하여 별도의 파스 노드 트리를 생성합니다. 각 파싱이 동일한 String 값에서 유래한 소스 텍스트에 대해 수행되더라도 트리는 서로 다릅니다.

참고 2

파스 노드는 명세상의 구성 요소이며, 구현체가 유사한 데이터 구조를 사용할 필요는 없습니다.

구문 문법의 생성 규칙은 구분 기호로 하나의 콜론 “:”만 사용하여 구별합니다.

절 13부터 16까지에 제시된 구문 문법은 어떤 토큰 시퀀스가 올바른 ECMAScript Script 또는 Module로 허용되는지를 완전히 설명하지는 않습니다. 특정 추가 토큰 시퀀스도 허용됩니다. 즉, 시퀀스의 특정 위치(예: 줄 종결자 문자 앞)에 세미콜론을 추가하기만 하면 문법으로 설명할 수 있는 시퀀스도 허용됩니다. 또한 문법으로 설명되는 특정 토큰 시퀀스라도 줄 종결자 문자가 특정 “부적절한” 위치에 나타나면 허용되지 않는 것으로 간주됩니다.

특정 경우에는 모호성을 피하기 위해 구문 문법이 유효한 ECMAScript Script 또는 Module을 형성하지 않는 토큰 시퀀스도 허용하는 일반화된 생성 규칙을 사용합니다. 예를 들어 객체 리터럴과 객체 구조 분해 패턴에 이 기법을 사용합니다. 이러한 경우에는 허용되는 토큰 시퀀스를 추가로 제한하는 더 엄격한 보충 문법을 제공합니다. 일반적으로 조기 오류 규칙은 특정 문맥에서 “p는 n을 포괄해야 합니다”라고 명시합니다. 여기에서 p는 파스 노드(일반화된 생성 규칙의 인스턴스)이며, n은 보충 문법의 비단말 기호입니다. 이는 다음을 의미합니다:

p 또는 그 하위 노드에는 어떠한 조기 오류 규칙도 적용하지 않습니다.
원래 p에 일치했던 토큰 시퀀스를 n을 목표 기호로 사용하여 다시 파싱합니다. n이 문법 매개변수를 받으면, 해당 매개변수는 p를 처음 파싱할 때 사용한 값과 동일하게 설정합니다.
남는 토큰 없이 토큰 시퀀스를 n의 단일 인스턴스로 파싱할 수 있으면:
1. 해당 n의 인스턴스(주어진 p에 대해 고유한 파스 노드)를 “p에 의해 포괄되는 n”이라고 합니다.
2. 추가적인 “포괄해야 합니다”의 경우에 따라 수정된 조기 오류 규칙을 p에 의해 포괄되는 n과 그 하위 노드에 적용합니다.
그렇지 않으면(파싱에 실패하면) 조기 구문 오류입니다.

5.1.5 문법 표기법

5.1.5.1 단말 기호

ECMAScript 문법에서 일부 단말 기호는 고정폭 글꼴로 표시됩니다. 이러한 기호는 소스 텍스트에 작성된 그대로 나타나야 합니다. 이 방식으로 명시된 모든 단말 기호의 코드 포인트는 다른 유니코드 범위의 비슷하게 생긴 코드 포인트가 아니라 기본 라틴 블록의 해당 유니코드 코드 포인트로 이해해야 합니다. 단말 기호의 코드 포인트는 \ UnicodeEscapeSequence로 표현할 수 없습니다.

단말 기호가 개별 유니코드 코드 포인트인 문법(즉, 어휘 문법, RegExp 문법 및 숫자 문자열 문법)에서 생성 규칙에 연속해서 나타나는 여러 고정폭 코드 포인트는 동일한 코드 포인트 시퀀스를 각각 독립된 단말 기호로 작성한 것의 간단한 축약 표현입니다.

예를 들어 다음 생성 규칙은:

다음의 축약 표현입니다:

반면 구문 문법에서는 연속된 고정폭 코드 포인트가 하나의 단말 기호입니다.

단말 기호에는 다음과 같은 두 가지 다른 형식도 있습니다:

어휘 문법과 RegExp 문법에서는 관례적인 인쇄 표현이 없는 유니코드 코드 포인트를 “<ABBREV>” 형식으로 표시합니다. 여기에서 “ABBREV”는 해당 코드 포인트 또는 코드 포인트 집합을 기억하기 위한 약어입니다. 이러한 형식은 유니코드 형식 제어 문자, 공백 및 줄 종결자에 정의되어 있습니다.
구문 문법에서 특정 단말 기호(예: IdentifierName과 RegularExpressionLiteral)는 어휘 문법에서 같은 이름을 갖는 비단말 기호를 참조하므로 기울임꼴로 표시됩니다.

5.1.5.2 비단말 기호와 생성 규칙

비단말 기호는 기울임꼴로 표시됩니다. 비단말 기호의 정의(“생성 규칙”이라고도 함)는 정의할 비단말 기호의 이름과 그 뒤에 오는 하나 이상의 콜론으로 시작합니다. (콜론의 개수는 생성 규칙이 속하는 문법을 나타냅니다.) 그다음 줄에는 해당 비단말 기호의 대안적인 우변이 하나 이상 이어집니다. 예를 들어 다음 구문 정의는:

WhileStatement

while

(

Expression

)

Statement

비단말 기호 WhileStatement가 while 토큰, 여는 괄호 토큰, Expression, 닫는 괄호 토큰, Statement가 차례로 이어지는 것을 나타낸다고 명시합니다. 여기에 나타나는 Expression과 Statement 자체도 비단말 기호입니다. 다른 예로, 다음 구문 정의는:

ArgumentList가 단일 AssignmentExpression 또는 ArgumentList 뒤에 쉼표와 AssignmentExpression이 차례로 이어지는 것을 나타낼 수 있다고 명시합니다. 이러한 ArgumentList의 정의는 재귀적입니다. 즉, 자기 자신을 사용하여 정의됩니다. 그 결과 ArgumentList는 쉼표로 구분된 임의의 양수 개의 인수를 포함할 수 있으며, 각 인수 표현식은 AssignmentExpression입니다. 이러한 비단말 기호의 재귀적 정의는 흔히 사용됩니다.

5.1.5.3 선택적 기호

단말 기호 또는 비단말 기호 뒤에 나타날 수 있는 아래첨자 접미사 “_opt”는 선택적 기호를 나타냅니다. 선택적 기호를 포함하는 대안은 실제로 두 개의 우변을 지정합니다. 하나는 선택적 요소를 생략하고, 다른 하나는 이를 포함합니다. 즉, 다음은:

VariableDeclaration

BindingIdentifier

Initializer

opt

다음을 편리하게 축약한 표현입니다:

또한 다음은:

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

다음을 편리하게 축약한 표현입니다:

ForStatement

for

(

LexicalDeclaration

;

Expression

opt

)

Statement

for

(

LexicalDeclaration

Expression

;

Expression

opt

)

Statement

이 표현은 다시 다음의 축약 표현입니다:

ForStatement

for

(

LexicalDeclaration

;

)

Statement

for

(

LexicalDeclaration

;

Expression

)

Statement

for

(

LexicalDeclaration

Expression

;

)

Statement

for

(

;

)

따라서 이 예에서 비단말 기호 ForStatement에는 실제로 네 개의 대안적인 우변이 있습니다.

5.1.5.4 문법 매개변수

생성 규칙은 “_[parameters]” 형식의 아래첨자 주석으로 매개변수화할 수 있으며, 이 주석은 해당 생성 규칙에서 정의하는 비단말 기호의 접미사로 나타날 수 있습니다. “_parameters”는 단일 이름 또는 쉼표로 구분된 이름 목록일 수 있습니다. 매개변수화된 생성 규칙은 매개변수 이름 앞에 밑줄을 붙여 매개변수화된 비단말 기호에 추가한 모든 조합을 정의하는 생성 규칙 집합의 축약 표현입니다. 즉, 다음은:

[Return]

다음을 편리하게 축약한 표현입니다:

또한 다음은:

[Return, In]

다음의 축약 표현입니다:

StatementList_Return_In

ReturnStatement

ExpressionStatement

여러 매개변수는 조합에 따른 수의 생성 규칙을 만들어 내며, 완전한 문법에서 이러한 생성 규칙이 모두 참조되는 것은 아닙니다.

생성 규칙 우변의 비단말 기호에 대한 참조도 매개변수화할 수 있습니다. 예를 들어:

StatementList

ReturnStatement

ExpressionStatement

[+In]

다음과 같이 표현하는 것과 같습니다:

StatementList

ReturnStatement

ExpressionStatement_In

또한:

StatementList

ReturnStatement

ExpressionStatement

[~In]

다음과 같습니다:

StatementList

ReturnStatement

ExpressionStatement

비단말 기호 참조에는 매개변수 목록과 “_opt” 접미사가 모두 있을 수 있습니다. 예를 들어:

VariableDeclaration

BindingIdentifier

Initializer

[+In]

opt

다음의 축약 표현입니다:

VariableDeclaration

BindingIdentifier

Initializer_In

우변의 비단말 기호 참조에서 매개변수 이름 앞에 “_?”를 붙이면 해당 매개변수 값은 현재 생성 규칙의 좌변 기호에 대한 참조에 그 매개변수 이름이 나타나는지에 따라 달라집니다. 예를 들어:

VariableDeclaration

[In]

BindingIdentifier

Initializer

[?In]

다음의 축약 표현입니다:

VariableDeclaration

BindingIdentifier

Initializer

VariableDeclaration_In

BindingIdentifier

Initializer_In

대안적인 우변 앞에 “[+parameter]”가 붙으면, 생성 규칙의 비단말 기호를 참조할 때 해당 이름의 매개변수를 사용한 경우에만 그 대안을 사용할 수 있습니다. 대안적인 우변 앞에 “[~parameter]”가 붙으면, 생성 규칙의 비단말 기호를 참조할 때 해당 이름의 매개변수를 사용하지 않은 경우에만 그 대안을 사용할 수 있습니다. 즉, 다음은:

StatementList

[Return]

[+Return]

다음의 축약 표현입니다:

또한 다음은:

[Return]

[~Return]

다음의 축약 표현입니다:

5.1.5.5 one of

문법 정의의 콜론 뒤에 “one of”라는 문구가 오면, 다음 한 줄 또는 여러 줄에 있는 각 단말 기호가 대안적인 정의임을 나타냅니다. 예를 들어 ECMAScript의 어휘 문법에는 다음 생성 규칙이 포함됩니다:

BinaryDigit

one of

이는 단지 다음을 편리하게 축약한 표현입니다:

BinaryDigit

5.1.5.6 [empty]

생성 규칙의 우변에 “[empty]”라는 문구가 나타나면, 해당 생성 규칙의 우변에 단말 기호나 비단말 기호가 없음을 나타냅니다.

5.1.5.7 미리 보기 제한

생성 규칙의 우변에 “[lookahead = seq]”라는 문구가 나타나면, 토큰 시퀀스 seq가 바로 뒤에 오는 입력 토큰 시퀀스의 접두 시퀀스인 경우에만 해당 생성 규칙을 사용할 수 있음을 나타냅니다. 마찬가지로 “[lookahead ∈ set]”는 set이 토큰 시퀀스의 비어 있지 않은 유한 집합일 때, set의 어떤 요소가 바로 뒤에 오는 토큰 시퀀스의 접두 시퀀스인 경우에만 해당 생성 규칙을 사용할 수 있음을 나타냅니다. 편의를 위해 집합을 비단말 기호로 작성할 수도 있으며, 이 경우에는 해당 비단말 기호가 전개될 수 있는 모든 토큰 시퀀스의 집합을 나타냅니다. 해당 비단말 기호가 무한히 많은 서로 다른 토큰 시퀀스로 전개될 수 있다면 편집 오류로 간주합니다.

이러한 조건은 부정할 수 있습니다. “[lookahead ≠ seq]”는 seq가 바로 뒤에 오는 입력 토큰 시퀀스의 접두 시퀀스가 아닌 경우에만 이를 포함하는 생성 규칙을 사용할 수 있음을 나타냅니다. “[lookahead ∉ set]”는 set의 어떤 요소도 바로 뒤에 오는 토큰 시퀀스의 접두 시퀀스가 아닌 경우에만 해당 생성 규칙을 사용할 수 있음을 나타냅니다.

예를 들어 다음 정의가 주어지면:

one of

다음 정의는:

[lookahead ∉ { 1, 3, 5, 7, 9 }]

DecimalDigits

DecimalDigit

[lookahead ∉ DecimalDigit]

문자 n 뒤에 첫 번째 숫자가 짝수인 하나 이상의 십진 숫자가 이어지는 경우 또는 뒤에 다른 십진 숫자가 이어지지 않는 하나의 십진 숫자와 일치합니다.

이러한 문구를 구문 문법에서 사용하는 경우, 이후 토큰을 결정하려면 이후 위치에서 어떤 어휘 목표 기호를 사용할지 알아야 하므로 바로 뒤에 오는 토큰 시퀀스를 모호함 없이 식별할 수 없을 수 있습니다. 따라서 구문 문법에서 이를 사용할 때, 사용할 어휘 목표 기호의 선택에 따라 토큰 시퀀스 seq가 결과 토큰 시퀀스의 접두 시퀀스인지 여부가 달라질 수 있다면 seq를 미리 보기 제한에 사용하는 것은 편집 오류로 간주합니다. 여기에는 시퀀스 집합의 일부로 사용하는 경우도 포함됩니다.

5.1.5.8 [no LineTerminator here]

구문 문법의 생성 규칙 우변에 “[no LineTerminator here]”라는 문구가 나타나면, 해당 생성 규칙이 제한된 생성 규칙임을 나타냅니다. 표시된 위치의 입력 스트림에 LineTerminator가 있으면 해당 생성 규칙을 사용할 수 없습니다. 예를 들어 다음 생성 규칙은:

ThrowStatement

throw

[no LineTerminator here]

Expression

;

스크립트의 throw 토큰과 Expression 사이에 LineTerminator가 있으면 해당 생성 규칙을 사용할 수 없음을 나타냅니다.

제한된 생성 규칙에서 LineTerminator의 존재를 금지하지 않는 한, 입력 요소 스트림에서 연속된 두 토큰 사이에는 임의의 개수의 LineTerminator가 나타날 수 있으며, 이는 스크립트의 구문적 허용 여부에 영향을 주지 않습니다.

5.1.5.9 but not

생성 규칙의 우변에서는 “but not”이라는 문구를 사용한 다음 제외할 전개를 표시하여 특정 전개가 허용되지 않음을 명시할 수 있습니다. 예를 들어 다음 생성 규칙은:

Identifier

IdentifierName

but not ReservedWord

비단말 기호 Identifier를 IdentifierName을 대체할 수 있는 임의의 코드 포인트 시퀀스로 대체할 수 있음을 의미합니다. 단, 동일한 코드 포인트 시퀀스로 ReservedWord를 대체할 수 없어야 합니다.

5.1.5.10 설명 문구

마지막으로, 모든 대안을 나열하기 어려운 경우에는 일부 비단말 기호를 산세리프 글꼴의 설명 문구로 기술합니다:

SourceCharacter

any Unicode code point

5.2 알고리즘 관례

이 명세는 알고리즘의 단계를 명시하기 위해 번호가 매겨진 목록을 자주 사용합니다. 이러한 알고리즘은 ECMAScript 언어 구문 요소에 요구되는 의미를 정확하게 명시하는 데 사용됩니다. 알고리즘은 특정 구현 기법의 사용을 암시하려는 것이 아닙니다. 실제로는 주어진 기능을 구현하는 데 더 효율적인 알고리즘이 있을 수 있습니다.

알고리즘은 쉼표로 구분된 순서 있는 별칭 이름의 시퀀스를 사용하여 명시적으로 매개변수화할 수 있습니다. 이러한 이름은 알고리즘 단계 내에서 해당 위치로 전달된 인수를 참조하는 데 사용할 수 있습니다. 선택적 매개변수는 대괄호로 둘러싸서 표시하며([ , name ]), 알고리즘 단계 내에서는 필수 매개변수와 다르지 않습니다. 나머지 매개변수는 매개변수 목록의 끝에 나타날 수 있으며, 앞에 줄임표를 붙여 표시합니다(, ...name). 나머지 매개변수는 필수 매개변수와 선택적 매개변수 뒤에 제공된 모든 인수를 List로 수집합니다. 이러한 추가 인수가 없으면 해당 List는 비어 있습니다.

알고리즘 단계는 순차적인 하위 단계로 세분할 수 있습니다. 하위 단계는 들여쓰며, 하위 단계 자체도 들여쓴 하위 단계로 더 세분할 수 있습니다. 하위 단계는 개요 번호 매기기 관례로 식별하며, 첫 번째 수준의 하위 단계에는 소문자 알파벳을, 두 번째 수준의 하위 단계에는 소문자 로마 숫자를 붙입니다. 세 수준보다 더 많은 수준이 필요하면 네 번째 수준에서 숫자를 사용하면서 이 규칙을 반복합니다. 예를 들어:

최상위 단계
1. 하위 단계.
2. 하위 단계.
  1. 하위 단계의 하위 단계.
    1. 하위 단계의 하위 단계의 하위 단계
      1. 하위 단계의 하위 단계의 하위 단계의 하위 단계
        하위 단계의 하위 단계의 하위 단계의 하위 단계의 하위 단계

단계 또는 하위 단계는 그 하위 단계의 적용 조건을 지정하는 “만약” 술어로 작성할 수 있습니다. 이 경우 하위 단계는 해당 술어가 참일 때만 적용됩니다. 단계 또는 하위 단계가 “그렇지 않으면”이라는 말로 시작하면, 같은 수준에서 앞선 “만약” 술어 단계의 부정에 해당하는 술어입니다.

단계는 하위 단계의 반복 적용을 명시하기 위해 “각각에 대해” 또는 “반복”으로 시작할 수 있습니다.

“단언:”으로 시작하는 단계는 해당 알고리즘의 불변 조건을 단언합니다. 이러한 단언은 그렇지 않으면 암묵적일 알고리즘의 불변 조건을 명시적으로 드러내는 데 사용됩니다. 마찬가지로 “참고:”로 시작하는 단계는 인접한 단계와 관련된 문맥을 제공합니다. 단언 단계와 참고 단계는 순전히 정보 제공용입니다. 추가적인 의미적 요구 사항을 부과하지 않으므로 구현체가 검사할 필요가 없습니다.

알고리즘 단계는 “x를 someValue로 둡니다”라는 형식을 사용하여 임의의 값에 대해 이름 있는 별칭을 선언할 수 있습니다. 이러한 별칭은 x와 someValue가 동일한 기반 데이터를 참조하고 어느 쪽을 수정하든 양쪽 모두에서 보인다는 점에서 참조와 유사합니다. 이러한 참조 유사 동작을 피하려는 알고리즘 단계는 우변의 복사본을 명시적으로 만들어야 합니다. “x를 someValue의 복사본으로 둡니다”는 someValue의 얕은 복사본을 생성합니다.

별칭은 선언된 이후의 모든 단계에서 참조할 수 있으며, 선언 이전의 단계에서는 참조해서는 안 됩니다. 별칭은 “x를 someOtherValue로 설정합니다”라는 형식으로 수정할 수 있습니다.

5.2.1 평가 순서

알고리즘 단계에 복합 표현식이 나타나면, 왼쪽에서 오른쪽으로, 안쪽에서 바깥쪽으로 평가되는 것으로 이해해야 합니다. 예를 들어 다음 단계는

A(B(), C.[[D]]) + E(F())를 반환합니다.

다음과 같습니다

tmp1을 B()로 둡니다.
tmp2를 C.[[D]]로 둡니다.
tmp3을 A(tmp1, tmp2)로 둡니다.
tmp4를 F()로 둡니다.
tmp5를 E(tmp4)로 둡니다.
tmp6을 tmp3 + tmp5로 둡니다.
tmp6을 반환합니다.

여기에서 각 tmpN 별칭은 일시적이며 이 단계들에서만 보입니다.

5.2.2 추상 연산

이 명세의 여러 부분에서 쉽게 사용할 수 있도록 일부 알고리즘에는 이름을 붙이고 매개변수화된 함수 형식으로 작성하여 다른 알고리즘 내에서 이름으로 참조할 수 있게 합니다. 이러한 알고리즘을 추상 연산이라고 합니다. 추상 연산은 일반적으로 OperationName(arg1, arg2)과 같은 함수 적용 형식으로 참조합니다. 일부 추상 연산은 클래스와 유사한 명세 추상화의 다형적으로 디스패치되는 메서드로 취급됩니다. 이러한 메서드 유사 추상 연산은 일반적으로 someValue.OperationName(arg1, arg2)과 같은 메서드 적용 형식으로 참조합니다.

5.2.3 구문 지향 연산

구문 지향 연산은 이름이 있는 연산으로, 그 정의는 각각 ECMAScript 문법 중 하나의 생성 규칙 하나 이상과 연결된 알고리즘으로 구성됩니다. 여러 대안적인 정의를 갖는 생성 규칙에는 일반적으로 각 대안에 대해 별도의 알고리즘이 있습니다. 알고리즘이 문법 생성 규칙과 연결되면 해당 생성 규칙 대안의 단말 기호와 비단말 기호를 알고리즘의 매개변수처럼 참조할 수 있습니다. 이 방식으로 사용하는 비단말 기호는 소스 텍스트를 파싱할 때 일치하는 실제 대안 정의를 가리킵니다. 문법 생성 규칙 또는 그로부터 파생된 파스 노드에 일치하는 소스 텍스트는 일치에 참여한 첫 번째 단말 기호의 시작에서 일치에 참여한 마지막 단말 기호의 끝까지에 해당하는 소스 텍스트 부분입니다.

알고리즘이 생성 규칙의 대안과 연결되면 해당 대안은 일반적으로 “[ ]” 문법 주석 없이 표시됩니다. 이러한 주석은 대안의 구문적 인식에만 영향을 미쳐야 하며, 해당 대안에 연결된 의미에는 영향을 주지 않아야 합니다.

구문 지향 연산은 다음 알고리즘의 단계 1, 3 및 4에 있는 관례를 사용하여 파스 노드와 선택적인 추가 매개변수로 호출합니다:

status를 SomeNonTerminal의 SyntaxDirectedOperation으로 둡니다.
someParseNode를 어떤 소스 텍스트의 파싱 결과로 둡니다.
someParseNode의 SyntaxDirectedOperation을 수행합니다.
someParseNode의 SyntaxDirectedOperation을 인수 "value"로 수행합니다.

명시적으로 달리 지정하지 않는 한, 모든 연쇄 생성 규칙에는 해당 생성 규칙의 좌변 비단말 기호에 적용할 수 있는 모든 연산에 대한 암묵적인 정의가 있습니다. 이 암묵적인 정의는 동일한 연산을 동일한 매개변수(있는 경우)와 함께 연쇄 생성 규칙의 유일한 우변 비단말 기호에 다시 적용한 다음 결과를 반환합니다. 예를 들어 어떤 알고리즘에 “Block의 Evaluation을 반환합니다”라는 형식의 단계가 있고 다음 생성 규칙이 있다고 가정합니다:

Block

{

StatementList

}

그러나 Evaluation 연산이 해당 생성 규칙에 알고리즘을 연결하지 않았다고 가정합니다. 이 경우 Evaluation 연산에는 다음 형식의 연결이 암묵적으로 포함됩니다:

Runtime Semantics: Evaluation

Block

{

StatementList

}

StatementList의 Evaluation을 반환합니다.

5.2.4 런타임 의미론

런타임에 호출해야 하는 의미를 명시하는 알고리즘을 런타임 의미론이라고 합니다. 런타임 의미론은 추상 연산 또는 구문 지향 연산으로 정의됩니다.

5.2.4.1 Completion ( `completionRecord` )

추상 연산 Completion. 인수 completionRecord (완료 레코드). 반환값: 완료 레코드. Completion Record가 반환된다는 점을 강조하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

단언: completionRecord는 Completion Record입니다.
completionRecord를 반환합니다.

5.2.4.2 예외 던지기

알고리즘 단계에서 “던집니다”라는 말은 ThrowCompletion을 호출한 결과를 반환하는 것의 축약 표현입니다. 예를 들어,

만약 result.[[Error]]가 none이 아니면, result.[[Error]]를 던집니다.

다음과 같습니다

만약 result.[[Error]]가 none이 아니면, ThrowCompletion(result.[[Error]])을 반환합니다.

특정 타입의 예외를 던지도록 명시하는 알고리즘 단계는 던질 해당 타입의 예외를 구성합니다. 예를 들어,

TypeError 예외를 던집니다.

다음과 같습니다

ThrowCompletion(새로 생성한 TypeError 객체)을 반환합니다.

5.2.4.3 Completion Record의 래핑을 해제하는 축약 표현

접두사 “?”와 “!”는 Completion Record의 래핑을 해제하는 축약 표현으로 사용됩니다. “?”는 비정상 완료를 호출자에게 전파하거나, 그렇지 않으면 정상 완료의 래핑을 해제하는 데 사용됩니다. “!”는 Completion Record가 정상임을 단언하고 래핑을 해제하는 데 사용됩니다. 형식적으로 다음 단계는

result를 ? record로 둡니다.

다음과 같습니다

단언: record는 Completion Record입니다.
만약 record가 비정상 완료이면, record를 반환합니다.
result를 record.[[Value]]로 둡니다.

마찬가지로 다음 단계는

result를 ! record로 둡니다.

다음과 같습니다

단언: record는 정상 완료입니다.
result를 record.[[Value]]로 둡니다.

“?” 또는 “!”가 다른 문맥에서 사용되면 먼저 이 규칙을 적용할 수 있을 때까지 평가 순서에 제시된 재작성 방식을 적용한 다음 이 규칙을 적용합니다. 예를 들어 다음 단계는

AO(? Other())를 수행합니다.

다음과 같이 재작성할 수 있습니다

tmp1을 Other()로 둡니다.
tmp2를 ? tmp1으로 둡니다.
AO(tmp2)를 수행합니다.

이를 다시 전개하면 다음과 같습니다

tmp1을 Other()로 둡니다.
단언: tmp1은 Completion Record입니다.
만약 tmp1이 비정상 완료이면, tmp1을 반환합니다.
tmp2를 tmp1.[[Value]]로 둡니다.
AO(tmp2)를 수행합니다.

5.2.4.4 암묵적인 정상 완료

Completion Record를 반환하도록 선언된 추상 연산 내의 알고리즘과 모든 내장 함수에서는 반환값을 먼저 NormalCompletion에 전달하고 그 결과를 대신 사용합니다. 이 규칙은 Completion 알고리즘 내부나 해당 단계에서 반환값이 Completion Record임을 명확히 표시한 경우에는 적용되지 않습니다. 이러한 경우는 다음과 같습니다:

Completion, NormalCompletion, ThrowCompletion 또는 ReturnCompletion을 적용한 결과를 직접 반환하는 경우
Completion Record를 구성한 결과를 직접 반환하는 경우

이러한 추상 연산에서 다른 방법으로 Completion Record를 반환하면 편집 오류입니다. 예를 들어 이러한 추상 연산 내에서,

true를 반환합니다.

다음 중 어느 것과도 같은 의미입니다

NormalCompletion(true)를 반환합니다.

또는

completion을 NormalCompletion(true)로 둡니다.
Completion(completion)을 반환합니다.

또는

Completion Record { [[Type]]: normal, [[Value]]: true, [[Target]]: empty }를 반환합니다.

? 축약 표현의 전개를 통해 다음 예가 허용된다는 점에 유의하시기 바랍니다. 전개된 단계에서 비정상인 경우에는 Completion을 적용한 결과를 직접 반환하고, 정상인 경우에는 래핑을 해제한 후 암묵적인 NormalCompletion 적용이 이루어지기 때문입니다.

? completion을 반환합니다.

다음 예는 해당 단계에 표시하지 않은 채 Completion Record를 반환하므로 편집 오류입니다.

completion을 NormalCompletion(true)로 둡니다.
completion을 반환합니다.

5.2.5 정적 의미론

문맥 자유 문법은 입력 요소 스트림이 평가할 수 있는 유효한 ECMAScript Script 또는 Module을 형성하는지 여부를 정의하는 모든 규칙을 표현할 만큼 강력하지 않습니다. 일부 상황에서는 ECMAScript 알고리즘 관례 또는 산문 형태의 요구 사항으로 표현할 수 있는 추가 규칙이 필요합니다. 이러한 규칙은 항상 문법의 생성 규칙과 연결되며, 해당 생성 규칙의 정적 의미론이라고 합니다.

정적 의미 규칙에는 이름이 있으며 일반적으로 알고리즘으로 정의됩니다. 이름 있는 정적 의미 규칙은 문법 생성 규칙과 연결됩니다. 여러 대안적인 정의를 갖는 생성 규칙에는 일반적으로 각 대안에 대해 적용 가능한 이름 있는 정적 의미 규칙마다 별도의 알고리즘이 있습니다.

정적 의미 규칙의 특별한 종류로 조기 오류 규칙이 있습니다. 조기 오류 규칙은 특정 문법 생성 규칙과 연결된 조기 오류 조건(절 17 참조)을 정의합니다. 대부분의 조기 오류 규칙 평가는 이 명세의 알고리즘 내에서 명시적으로 호출되지 않습니다. 적합한 구현체는 Script 또는 Module을 처음 평가하기 전에 해당 Script 또는 Module을 파싱하는 데 사용된 생성 규칙의 모든 조기 오류 규칙을 검증해야 합니다. 조기 오류 규칙 중 하나라도 위반하면 해당 Script 또는 Module은 유효하지 않으며 평가할 수 없습니다.

5.2.6 수학 연산

이 명세에서는 다음 종류의 숫자 값을 참조합니다:

수학적 값: 기본 숫자 타입으로 사용하는 임의의 실수입니다.
확장된 수학적 값: 수학적 값에 +∞와 -∞를 함께 포함합니다.
Number: IEEE 754-2019 binary64(배정밀도 부동소수점) 값입니다.
BigInt: 임의의 정수를 일대일로 대응하여 나타내는 ECMAScript 언어 값입니다.

이 명세의 표현에서는 서로 다른 숫자 종류를 아래 첨자 접미사를 사용하여 구별합니다. 아래 첨자 _𝔽는 Number를 나타내고, 아래 첨자 _ℤ는 BigInt를 나타냅니다. 아래 첨자 접미사가 없는 숫자 값은 수학적 값을 나타냅니다. 이 명세에서는 대부분의 숫자 값을 10진수로 나타내며, 0x 뒤에 숫자 0-9 또는 A-F가 오는 형식의 숫자 값은 16진수 값으로도 사용합니다.

일반적으로 이 명세에서 “y의 길이” 또는 “네 개의 16진수 숫자가 나타내는 정수 ...”와 같이 숫자 종류를 명시적으로 지정하지 않고 숫자 값을 언급하는 경우, 해당 표현은 수학적 값을 나타냅니다. Number 또는 BigInt 값을 나타내는 표현에는 이를 명시적으로 표시합니다. 예를 들어 “...의 코드 포인트 수에 대한 Number 값” 또는 “...에 대한 BigInt 값”과 같습니다.

이 명세에서 정수라는 용어를 사용할 때는 달리 명시되지 않는 한 정수 집합에 속하는 수학적 값을 나타냅니다. 이 명세에서 정수인 Number라는 용어를 사용할 때는 그 수학적 값이 정수 집합에 속하는 유한한 Number 값을 나타냅니다.

+, ×, =, ≥와 같은 숫자 연산자는 피연산자의 타입에 따라 결정되는 해당 연산을 나타냅니다. 수학적 값에 적용되는 경우 연산자는 일반적인 수학 연산을 나타냅니다. 확장 수학적 값에 적용되는 경우 연산자는 확장 실수에 대한 일반적인 수학 연산을 나타냅니다. 부정형은 정의되지 않으며 이 명세에서 이를 사용하는 것은 편집상의 오류로 간주해야 합니다. Number에 적용되는 경우 연산자는 IEEE 754-2019의 관련 연산을 나타냅니다. BigInt에 적용되는 경우 연산자는 BigInt의 수학적 값에 적용되는 일반적인 수학 연산을 나타냅니다. 서로 다른 타입의 피연산자(예: Number와 수학적 값)에 적용되는 숫자 연산자는 정의되지 않으며 이 명세의 편집상의 오류로 간주해야 합니다.

이 문서에서는 수학적 값과 Number 또는 BigInt 사이의 변환을 항상 명시적으로 나타냅니다. 수학적 값 또는 확장 수학적 값 x를 Number로 변환하는 것은 “x에 대한 Number 값” 또는 𝔽(x)로 나타내며, 6.1.6.1에 정의되어 있습니다. 정수 x를 BigInt로 변환하는 것은 “x에 대한 BigInt 값” 또는 ℤ(x)로 나타냅니다. Number 또는 BigInt x를 수학적 값으로 변환하는 것은 “x의 수학적 값” 또는 ℝ(x)로 나타냅니다. +0_𝔽 및 -0_𝔽의 수학적 값은 수학적 값 0입니다. 유한하지 않은 값의 수학적 값은 정의되지 않습니다. x의 확장 수학적 값은 유한한 값의 경우 x의 수학적 값이고, +∞_𝔽 및 -∞_𝔽의 경우 각각 +∞ 및 -∞입니다. NaN에 대해서는 정의되지 않습니다.

수학 함수 abs(x)는 x의 절댓값을 산출하며, x < 0이면 -x이고 그렇지 않으면 x 자체입니다.

수학 함수 ln(x)는 x의 자연로그를 산출합니다. 수학 함수 log10(x)는 x의 밑이 10인 로그를 산출합니다. 수학 함수 log2(x)는 x의 밑이 2인 로그를 산출합니다.

수학 함수 min(x1, x2, … , xN)는 x1부터 xN까지 중 수학적으로 가장 작은 값을 산출합니다. 수학 함수 max(x1, x2, ..., xN)는 x1부터 xN까지 중 수학적으로 가장 큰 값을 산출합니다. 이러한 수학 함수의 정의역과 치역은 확장 수학적 값입니다.

표기 “x modulo y”(y는 유한하고 0이 아니어야 합니다)는 어떤 정수 q에 대해 abs(k) < abs(y) and x - k = q × y를 만족하고 y와 같은 부호(또는 0)를 갖는 값 k를 계산합니다.

“x를 lower와 upper 사이로 클램핑한 결과”라는 표현(x는 확장 수학적 값이고 lower 및 upper는 lower ≤ upper를 만족하는 수학적 값)은 x < lower이면 lower를 산출하고, x > upper이면 upper를 산출하며, 그렇지 않으면 x를 산출합니다.

수학 함수 floor(x)는 x보다 크지 않은 가장 큰 정수(+∞에 가장 가까운 정수)를 산출합니다.

참고

floor(x) = x - (x modulo 1).

수학 함수 truncate(x)는 0 방향으로 반올림하여 x의 소수 부분을 제거합니다. x < 0이면 -floor(-x)를 생성하고, 그렇지 않으면 floor(x)를 생성합니다.

수학 함수 min, max, abs, floor 및 truncate는 Number와 BigInt에 대해 정의되지 않으며, 이러한 메서드에 수학적 값이 아닌 인수를 사용하는 것은 이 명세의 편집 오류입니다.

하한 a에서 상한 b까지의 구간은 동일한 숫자 타입의 숫자 값으로 구성된 집합이며, 무한하거나 비어 있을 수 있습니다. 각 경계는 포함 또는 제외 중 하나로 기술되며, 둘 다일 수는 없습니다. 구간에는 다음과 같은 네 가지 종류가 있습니다:

a(포함)에서 b(포함)까지의 구간은 a에서 b까지의 닫힌 구간이라고도 하며, a ≤ x ≤ b를 만족하는 동일한 숫자 타입의 모든 값 x를 포함하고 그 밖의 값은 포함하지 않습니다.
a(포함)에서 b(제외)까지의 구간은 a ≤ x < b를 만족하는 동일한 숫자 타입의 모든 값 x를 포함하고 그 밖의 값은 포함하지 않습니다.
a(제외)에서 b(포함)까지의 구간은 a < x ≤ b를 만족하는 동일한 숫자 타입의 모든 값 x를 포함하고 그 밖의 값은 포함하지 않습니다.
a(제외)에서 b(제외)까지의 구간은 a < x < b를 만족하는 동일한 숫자 타입의 모든 값 x를 포함하고 그 밖의 값은 포함하지 않습니다.

예를 들어 1(포함)에서 2(제외)까지의 구간은 1을 포함하고 2는 포함하지 않는, 1과 2 사이의 모든 수학적 값으로 구성됩니다. 구간을 정의할 때는 -0_𝔽 < +0_𝔽이므로, 예를 들어 하한이 +0_𝔽인 닫힌 구간은 +0_𝔽를 포함하지만 -0_𝔽는 포함하지 않습니다. NaN은 어떤 구간에도 포함되지 않습니다.

5.2.7 값 표기법

이 명세에서 ECMAScript 언어 값은 굵은 글씨로 표시됩니다. 예로는 null, true 또는 "hello"가 있습니다. 이러한 값은 Function.prototype.apply 또는 let n = 42;와 같은 ECMAScript 소스 텍스트와 구별됩니다.

5.2.8 동일성

이 명세에서는 명세 값과 ECMAScript 언어 값 모두에 대해 동등성을 비교합니다. 동등성을 비교할 때 값은 두 범주 중 하나에 속합니다. 동일성이 없는 값은 정수의 크기나 시퀀스의 길이와 같은 모든 고유 특성이 같으면 다른 동일성이 없는 값과 동등합니다. 동일성이 없는 값은 그 특성을 완전히 기술함으로써 사전 참조 없이 나타낼 수 있습니다. 반면 각 동일성이 있는 값은 고유하므로 자기 자신과만 동등합니다. 동일성이 있는 값은 동일성이 없는 값과 유사하지만, 동일성이라는 추측할 수 없고 변경할 수 없으며 전역적으로 고유한 특성이 추가로 있습니다. 동일성 자체는 기술할 수 없으므로 기존의 동일성이 있는 값에 대한 참조는 단순히 해당 값을 기술하는 것만으로 나타낼 수 없습니다. 대신 이러한 값에 대한 참조를 한 곳에서 다른 곳으로 명시적으로 전달해야 합니다. 동일성이 있는 값 중 일부는 변경 가능하므로 동일성을 제외한 특성을 그 자리에서 변경할 수 있으며, 그 값을 보유한 모든 곳에서 새로운 특성을 관찰하게 됩니다. 동일성이 없는 값은 동일성이 있는 값과 결코 동등하지 않습니다.

이 명세의 관점에서 “이다”라는 말은 “만약 bool이 true이면, ...”와 같이 두 값의 동등성을 비교하는 데 사용되며, “포함한다”라는 말은 “만약 list가 r.[[Foo]]가 true인 Record r을 포함하면, ...”와 같이 동등성 비교를 사용하여 리스트 안에서 값을 찾는 데 사용됩니다. 값의 명세 동일성은 이러한 비교의 결과를 결정하며, 이 명세에서 공리적으로 주어집니다.

ECMAScript 언어의 관점에서 언어 값의 동등성은 SameValue 추상 연산과 이 연산이 전이적으로 호출하는 추상 연산을 사용하여 비교합니다. 이러한 비교 추상 연산의 알고리즘은 ECMAScript 언어 값의 언어 동일성을 결정합니다.

명세 값 중 명세 동일성이 없는 값의 예에는 수학적 값과 확장된 수학적 값; ECMAScript 소스 텍스트, 서로게이트 쌍, 지시문 프롤로그 등; UTF-16 코드 단위; 유니코드 코드 포인트; 열거 값; 구문 지향 연산과 호스트 훅 등을 포함하는 추상 연산; 순서쌍이 있으며, 이에 한정되지 않습니다. 명세 동일성이 있는 명세 값의 예에는 Property Descriptor, PrivateElement 등을 포함하는 모든 종류의 Record; 파스 노드; List; Set과 Relation; Abstract Closure; Data Block; Private Name; 실행 컨텍스트와 실행 컨텍스트 스택; 에이전트 식별자; WaiterList Record가 있으며, 이에 한정되지 않습니다.

Symbol.for로 생성한 Symbol 값을 제외한 모든 ECMAScript 언어 값에서 명세 동일성과 언어 동일성은 일치합니다. 명세 동일성과 언어 동일성이 모두 없는 ECMAScript 언어 값은 undefined, null, Boolean, String, Number 및 BigInt입니다. 명세 동일성과 언어 동일성이 모두 있는 ECMAScript 언어 값은 Symbol 중 Symbol.for로 생성하지 않은 값과 Object입니다. Symbol.for로 생성한 Symbol 값에는 명세 동일성이 있지만 언어 동일성은 없습니다.

6 ECMAScript 데이터 타입과 값

이 명세의 알고리즘은 각각 연관된 타입이 있는 값을 조작합니다. 가능한 값 타입은 정확히 이 절에 정의된 타입입니다. 타입은 다시 ECMAScript 언어 타입과 명세 타입으로 분류됩니다.

6.1 ECMAScript 언어 타입

ECMAScript 언어 타입은 ECMAScript 프로그래머가 ECMAScript 언어를 사용하여 직접 조작하는 값에 대응합니다. ECMAScript 언어 타입은 Undefined, Null, Boolean, String, Symbol, Number, BigInt 및 Object입니다. ECMAScript 언어 값은 ECMAScript 언어 타입으로 특징지어지는 값입니다.

6.1.1 Undefined 타입

Undefined 타입에는 undefined라고 하는 값이 정확히 하나 있습니다. 값이 할당되지 않은 모든 변수는 undefined 값을 갖습니다.

6.1.2 Null 타입

Null 타입에는 null이라고 하는 값이 정확히 하나 있습니다.

6.1.3 Boolean 타입

Boolean 타입은 true와 false라고 하는 두 값을 갖는 논리적 개체를 나타냅니다.

6.1.4 String 타입

String 타입은 0개 이상의 16비트 부호 없는 정숫값(“요소”)으로 이루어진 모든 순서 있는 시퀀스의 집합이며, 최대 길이는 2⁵³ - 1개 요소입니다. String 타입은 일반적으로 실행 중인 ECMAScript 프로그램의 텍스트 데이터를 나타내는 데 사용되며, 이 경우 String의 각 요소는 UTF-16 코드 단위 값으로 취급됩니다. 각 요소는 시퀀스 내의 한 위치를 차지하는 것으로 간주됩니다. 이러한 위치는 음이 아닌 정수로 인덱싱됩니다. 첫 번째 요소가 있으면 인덱스 0에 있고, 다음 요소가 있으면 인덱스 1에 있으며, 이후에도 같은 방식으로 이어집니다. String의 길이는 그 안에 포함된 요소(즉, 16비트 값)의 개수입니다. 빈 String의 길이는 0이므로 요소를 포함하지 않습니다.

String 내용을 해석하지 않는 ECMAScript 연산은 추가적인 의미론을 적용하지 않습니다. String 값을 해석하는 연산은 각 요소를 하나의 UTF-16 코드 단위로 취급합니다. 그러나 ECMAScript는 이러한 코드 단위의 값이나 코드 단위 사이의 관계를 제한하지 않으므로, String 내용을 UTF-16으로 인코딩된 유니코드 코드 포인트 시퀀스로 추가 해석하는 연산은 올바르지 않은 부분 시퀀스를 고려해야 합니다. 이러한 연산은 숫자 값이 0xD800부터 0xDBFF까지의 닫힌 구간에 있는 모든 코드 단위(유니코드 표준에서 선행 서로게이트, 더 공식적으로는 상위 서로게이트 코드 단위로 정의됨)와 숫자 값이 0xDC00부터 0xDFFF까지의 닫힌 구간에 있는 모든 코드 단위(후행 서로게이트, 더 공식적으로는 하위 서로게이트 코드 단위로 정의됨)를 다음 규칙에 따라 특별하게 취급합니다:

선행 서로게이트도 후행 서로게이트도 아닌 코드 단위는 동일한 값을 갖는 코드 포인트로 해석됩니다.
두 코드 단위의 시퀀스에서 첫 번째 코드 단위 c1이 선행 서로게이트이고 두 번째 코드 단위 c2가 후행 서로게이트이면, 이는 서로게이트 쌍이며 값 (c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000인 코드 포인트로 해석됩니다. (11.1.3 참조)
선행 서로게이트 또는 후행 서로게이트이지만 서로게이트 쌍의 일부가 아닌 코드 단위는 동일한 값을 갖는 코드 포인트로 해석됩니다.

String.prototype.normalize 함수(22.1.3.15 참조)를 사용하여 String 값을 명시적으로 정규화할 수 있습니다. String.prototype.localeCompare(22.1.3.12 참조)는 내부적으로 String 값을 정규화하지만, 다른 어떤 연산도 자신이 처리하는 String을 암묵적으로 정규화하지 않습니다. 달리 명시되지 않는 한 연산 결과는 언어 및/또는 로케일에 민감하지 않습니다.

참고

이 설계의 근거는 String의 구현을 가능한 한 단순하고 고성능으로 유지하기 위한 것입니다. ECMAScript 소스 텍스트가 정규화 형식 C인 경우, 문자열 리터럴에 유니코드 이스케이프 시퀀스가 포함되지 않는 한 문자열 리터럴도 정규화되어 있음이 보장됩니다.

이 명세에서 “A, B, ...의 문자열 연결”이라는 문구(각 인수는 String 값, 코드 단위 또는 코드 단위 시퀀스입니다)는 각 인수의 코드 단위를 인수 순서대로 연결한 코드 단위 시퀀스를 갖는 String 값을 나타냅니다.

“string의 inclusiveStart부터 exclusiveEnd까지의 부분 문자열”이라는 문구(string은 String 값 또는 코드 단위 시퀀스이고 inclusiveStart와 exclusiveEnd는 정수입니다)는 string에서 인덱스 inclusiveStart로 시작하여 인덱스 exclusiveEnd 바로 앞에서 끝나는 연속 코드 단위로 구성된 String 값을 나타냅니다(inclusiveStart = exclusiveEnd이면 빈 String입니다). “to” 접미사가 생략되면 string의 길이가 exclusiveEnd 값으로 사용됩니다.

“ASCII 단어 문자”라는 문구는 유니코드 기본 라틴 블록의 모든 문자와 숫자 및 U+005F (LOW LINE)만으로 구성된 다음 String 값을 나타냅니다:
"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_".
역사적인 이유로 이는 여러 알고리즘에서 중요한 의미를 갖습니다.

6.1.4.1 StringIndexOf ( `string`, `searchValue`, `fromIndex` )

추상 연산 StringIndexOf. 인수 string (String), searchValue (String) 및 fromIndex (음이 아닌 정수). 반환값: 음이 아닌 정수 또는 not-found. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
searchValue가 빈 String이고 fromIndex ≤ length이면, fromIndex를 반환합니다.
searchLength를 searchValue의 길이로 둡니다.
fromIndex ≤ i ≤ length - searchLength를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
1. candidate를 string의 i부터 i + searchLength까지의 부분 문자열로 둡니다.
2. candidate가 searchValue이면, i를 반환합니다.
not-found를 반환합니다.

참고 1

searchValue가 빈 String이고 fromIndex ≤ string의 길이이면, 이 알고리즘은 fromIndex를 반환합니다. 빈 String은 마지막 코드 단위 뒤를 포함하여 문자열 내의 모든 위치에서 사실상 발견됩니다.

참고 2

fromIndex + searchValue의 길이 > string의 길이이면 이 알고리즘은 항상 not-found를 반환합니다.

6.1.4.2 StringLastIndexOf ( `string`, `searchValue`, `fromIndex` )

추상 연산 StringLastIndexOf. 인수 string (String), searchValue (String) 및 fromIndex (음이 아닌 정수). 반환값: 음이 아닌 정수 또는 not-found. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
searchLength를 searchValue의 길이로 둡니다.
단언: fromIndex + searchLength ≤ length입니다.
0 ≤ i ≤ fromIndex를 만족하는 각 정수 i에 대해 내림차순으로 다음을 수행합니다.
1. candidate를 string의 i부터 i + searchLength까지의 부분 문자열로 둡니다.
2. candidate가 searchValue이면, i를 반환합니다.
not-found를 반환합니다.

참고

searchValue가 빈 String이면 이 알고리즘은 fromIndex를 반환합니다. 빈 String은 마지막 코드 단위 뒤를 포함하여 문자열 내의 모든 위치에서 사실상 발견됩니다.

6.1.5 Symbol 타입

Symbol 타입은 Object 프로퍼티의 키로 사용할 수 있는 모든 String이 아닌 값의 집합입니다(6.1.7).

각 Symbol은 고유하며 변경할 수 없습니다.

각 Symbol에는 값이 String 또는 undefined인 변경 불가능한 [[Description]] 내부 슬롯이 있습니다.

6.1.5.1 잘 알려진 Symbol

잘 알려진 Symbol은 이 명세의 알고리즘에서 명시적으로 참조하는 내장 Symbol 값입니다. 일반적으로 명세 알고리즘의 확장 지점 역할을 하는 값을 가진 프로퍼티의 키로 사용됩니다. 달리 명시되지 않는 한 잘 알려진 Symbol 값은 모든 realm에서 공유됩니다(9.3).

이 명세에서 잘 알려진 Symbol은 표준 내재 표기법을 사용하여 참조하며, 여기에서 내재 객체는 표 1에 나열된 값 중 하나입니다.

참고

이 명세의 이전 판에서는 현재 판에서 %Symbol.name%을 사용하는 곳에 @@name 형식의 표기법을 사용했습니다. 구체적으로 다음 이름이 사용되었습니다: @@asyncIterator, @@hasInstance, @@isConcatSpreadable, @@iterator, @@match, @@matchAll, @@replace, @@search, @@species, @@split, @@toPrimitive, @@toStringTag 및 @@unscopables.

표 1: 잘 알려진 Symbol

명세 이름	`[[Description]]`	값과 목적
%Symbol.asyncDispose%	"Symbol.asyncDispose"	객체에서 리소스 정리를 비동기적으로 수행하는 메서드입니다. 포함하는 스코프의 평가가 완료될 때 AsyncDisposableStack 객체와 `await using` 선언에서 호출됩니다.
%Symbol.asyncIterator%	"Symbol.asyncIterator"	객체의 기본 비동기 이터레이터를 반환하는 메서드입니다. `for`-`await`-`of` 문의 의미론에서 호출됩니다.
%Symbol.dispose%	"Symbol.dispose"	객체에서 명시적인 리소스 정리를 수행하는 메서드입니다. 포함하는 스코프의 평가가 완료될 때 DisposableStack 객체, AsyncDisposableStack 객체 및 `using` 선언에서 호출됩니다.
%Symbol.hasInstance%	"Symbol.hasInstance"	생성자 객체가 어떤 객체를 해당 생성자의 인스턴스 중 하나로 인식하는지 결정하는 메서드입니다. `instanceof` 연산자의 의미론에서 호출됩니다.
%Symbol.isConcatSpreadable%	"Symbol.isConcatSpreadable"	값이 true이면 `Array.prototype.concat`에 의해 객체가 배열 요소로 평탄화되어야 함을 나타내는 Boolean 값 프로퍼티입니다.
%Symbol.iterator%	"Symbol.iterator"	객체의 기본 이터레이터를 반환하는 메서드입니다. for-of 문의 의미론에서 호출됩니다.
%Symbol.match%	"Symbol.match"	정규 표현식을 문자열과 일치시키는 정규 표현식 메서드입니다. `String.prototype.match` 메서드에서 호출됩니다.
%Symbol.matchAll%	"Symbol.matchAll"	문자열에 대한 정규 표현식의 일치 결과를 생성하는 이터레이터를 반환하는 정규 표현식 메서드입니다. `String.prototype.matchAll` 메서드에서 호출됩니다.
%Symbol.replace%	"Symbol.replace"	문자열에서 일치한 부분 문자열을 치환하는 정규 표현식 메서드입니다. `String.prototype.replace` 메서드에서 호출됩니다.
%Symbol.search%	"Symbol.search"	문자열에서 정규 표현식과 일치하는 인덱스를 반환하는 정규 표현식 메서드입니다. `String.prototype.search` 메서드에서 호출됩니다.
%Symbol.species%	"Symbol.species"	파생 객체를 생성하는 데 사용되는 생성자 함수인 함수 값 프로퍼티입니다.
%Symbol.split%	"Symbol.split"	정규 표현식과 일치하는 인덱스에서 문자열을 분할하는 정규 표현식 메서드입니다. `String.prototype.split` 메서드에서 호출됩니다.
%Symbol.toPrimitive%	"Symbol.toPrimitive"	객체를 대응하는 원시값으로 변환하는 메서드입니다. ToPrimitive 추상 연산에서 호출됩니다.
%Symbol.toStringTag%	"Symbol.toStringTag"	객체의 기본 문자열 설명을 생성하는 데 사용되는 String 값 프로퍼티입니다. 내장 메서드 `Object.prototype.toString`에서 접근합니다.
%Symbol.unscopables%	"Symbol.unscopables"	자체 프로퍼티 이름과 상속된 프로퍼티 이름이 연결된 객체의 `with` 환경 바인딩에서 제외되는 프로퍼티 이름인 객체 값 프로퍼티입니다.

6.1.6 숫자 타입

ECMAScript에는 Number와 BigInt라는 두 개의 내장 숫자 타입이 있습니다. 다음 추상 연산은 이러한 숫자 타입에 대해 정의됩니다. “결과” 열에는 반환 타입과 함께 연산의 일부 호출이 비정상 완료를 반환할 가능성이 있는지를 표시합니다.

표 2: 숫자 타입 연산

연산	예제 소스	...의 Evaluation 의미론에서 호출	결과
Number::unaryMinus	`-x`	단항 `-` 연산자	Number
BigInt::unaryMinus	`-x`	단항 `-` 연산자	BigInt
Number::bitwiseNOT	`~x`	비트 NOT 연산자 ( `~` )	Number
BigInt::bitwiseNOT	`~x`	비트 NOT 연산자 ( `~` )	BigInt
Number::exponentiate	`x ** y`	지수 연산자 및 Math.pow ( `base`, `exponent` )	Number
BigInt::exponentiate	`x ** y`	지수 연산자 및 Math.pow ( `base`, `exponent` )	BigInt를 포함하는 정상 완료 또는 던지기 완료
Number::multiply	`x * y`	곱셈 연산자	Number
BigInt::multiply	`x * y`	곱셈 연산자	BigInt
Number::divide	`x / y`	곱셈 연산자	Number
BigInt::divide	`x / y`	곱셈 연산자	BigInt를 포함하는 정상 완료 또는 던지기 완료
Number::remainder	`x % y`	곱셈 연산자	Number
BigInt::remainder	`x % y`	곱셈 연산자	BigInt를 포함하는 정상 완료 또는 던지기 완료
Number::add	`x ++` `++ x` `x + y`	후위 증가 연산자, 전위 증가 연산자, 및 덧셈 연산자 ( `+` )	Number
BigInt::add	`x ++` `++ x` `x + y`	후위 증가 연산자, 전위 증가 연산자, 및 덧셈 연산자 ( `+` )	BigInt
Number::subtract	`x --` `-- x` `x - y`	후위 감소 연산자, 전위 감소 연산자, 및 뺄셈 연산자 ( `-` )	Number
BigInt::subtract	`x --` `-- x` `x - y`	후위 감소 연산자, 전위 감소 연산자, 및 뺄셈 연산자 ( `-` )	BigInt
Number::leftShift	`x << y`	왼쪽 시프트 연산자 ( `<<` )	Number
BigInt::leftShift	`x << y`	왼쪽 시프트 연산자 ( `<<` )	BigInt
Number::signedRightShift	`x >> y`	부호 있는 오른쪽 시프트 연산자 ( `>>` )	Number
BigInt::signedRightShift	`x >> y`	부호 있는 오른쪽 시프트 연산자 ( `>>` )	BigInt
Number::unsignedRightShift	`x >>> y`	부호 없는 오른쪽 시프트 연산자 ( `>>>` )	Number
BigInt::unsignedRightShift	`x >>> y`	부호 없는 오른쪽 시프트 연산자 ( `>>>` )	던지기 완료
Number::lessThan	`x < y` `x > y` `x <= y` `x >= y`	관계 연산자, IsLessThan ( `x`, `y`, `leftFirst` )를 통해	Boolean 또는 undefined (순서가 없는 입력의 경우)
BigInt::lessThan	`x < y` `x > y` `x <= y` `x >= y`	관계 연산자, IsLessThan ( `x`, `y`, `leftFirst` )를 통해	Boolean
Number::equal	`x == y` `x != y` `x === y` `x !== y`	동등 연산자, IsStrictlyEqual ( `x`, `y` )를 통해	Boolean
BigInt::equal	`x == y` `x != y` `x === y` `x !== y`	동등 연산자, IsStrictlyEqual ( `x`, `y` )를 통해	Boolean
Number::sameValue	`Object.is(x, y)`	Object 내부 메서드에서, SameValue ( `x`, `y` )를 통해, 정확한 값 동등성을 검사하기 위해 사용	Boolean
Number::sameValueZero	`[x].includes(y)`	SameValueZero ( `x`, `y` )를 통해, Array, Map 및 Set 메서드에서처럼 +0_𝔽과 -0_𝔽의 차이를 무시하여 값 동등성을 검사하기 위해 사용	Boolean
Number::bitwiseAND	`x & y`	이항 비트 연산자	Number
BigInt::bitwiseAND	`x & y`		BigInt
Number::bitwiseXOR	`x ^ y`		Number
BigInt::bitwiseXOR	`x ^ y`		BigInt
Number::bitwiseOR	`x \| y`		Number
BigInt::bitwiseOR	`x \| y`		BigInt
Number::toString	`String(x)`	많은 표현식과 내장 함수에서 ToString ( `arg` )를 통해 호출	String
BigInt::toString	`String(x)`	많은 표현식과 내장 함수에서 ToString ( `arg` )를 통해 호출	String

숫자 타입은 일반적으로 정밀도 손실이나 잘림 없이 서로 변환할 수 없으므로 ECMAScript 언어는 이러한 타입 사이에 암묵적 변환을 제공하지 않습니다. 다른 타입을 요구하는 함수를 호출할 때 타입을 변환하려면 프로그래머가 Number 및 BigInt 함수를 명시적으로 호출해야 합니다.

참고

ECMAScript 초판과 이후 판에서는 특정 연산자에 대해 정밀도 손실이나 잘림이 발생할 수 있는 암묵적 숫자 변환을 제공해 왔습니다. 이러한 레거시 암묵적 변환은 하위 호환성을 위해 유지되지만, 프로그래머 오류의 가능성을 최소화하고 향후 판에서 일반화된 값 타입을 도입할 가능성을 열어 두기 위해 BigInt에는 제공되지 않습니다.

6.1.6.1 Number 타입

Number 타입은 정확히 18,437,736,874,454,810,627개(즉, 2⁶⁴ - 2⁵³ + 3)의 값을 가지며, IEEE 부동 소수점 산술 표준에 명시된 배정밀도 부동 소수점 IEEE 754-2019 binary64 값을 나타냅니다. 단, IEEE 표준의 서로 구별되는 9,007,199,254,740,990개(즉, 2⁵³ - 2)의 NaN 값은 ECMAScript에서 하나의 특수한 NaN 값으로 나타냅니다. (NaN 값은 프로그램 표현식 NaN에 의해 생성된다는 점에 유의하십시오.) 일부 구현에서는 외부 코드가 다양한 NaN 값 간의 차이를 감지할 수 있지만, 이러한 동작은 구현 정의입니다. ECMAScript 코드에서는 모든 NaN 값을 서로 구별할 수 없습니다.

참고

Number 값이 ArrayBuffer(25.1 참조) 또는 SharedArrayBuffer(25.2 참조)에 저장된 후 관찰될 수 있는 비트 패턴은 ECMAScript 구현에서 사용하는 해당 Number 값의 내부 표현과 반드시 동일하지는 않습니다.

양의 무한대와 음의 무한대라고 하는 두 개의 다른 특수 값이 있습니다. 간결하게 설명하기 위해 이러한 값은 각각 기호 +∞_𝔽와 -∞_𝔽로도 지칭합니다. (이 두 무한 Number 값은 프로그램 표현식 +Infinity(또는 단순히 Infinity)와 -Infinity에 의해 생성된다는 점에 유의하십시오.)

나머지 18,437,736,874,454,810,624개(즉, 2⁶⁴ - 2⁵³)의 각 값은 유한 Number입니다. 이 중 절반은 양수이고 절반은 음수입니다. 모든 양의 유한 Number에는 크기가 같은 대응하는 음의 Number가 있습니다.

양의 0과 음의 0이 모두 존재한다는 점에 유의하십시오. 간결하게 설명하기 위해 이러한 값은 각각 기호 +0_𝔽와 -0_𝔽로도 지칭합니다. (이 두 개의 서로 다른 0 Number 값은 프로그램 표현식 +0(또는 단순히 0)과 -0에 의해 생성된다는 점에 유의하십시오.)

18,437,736,874,454,810,622개(즉, 2⁶⁴ - 2⁵³ - 2)의 유한한 0이 아닌 값은 두 종류입니다.

그중 18,428,729,675,200,069,632개(즉, 2⁶⁴ - 2⁵⁴)는 정규화된 값이며, 다음 형식을 가집니다.

s \times m \times 2 e

여기서 s는 1 또는 -1이고, m은 2⁵²(포함)부터 2⁵³(제외)까지의 구간에 있는 정수이며, e는 -1074부터 971까지의 양 끝을 포함하는 구간에 있는 정수입니다.

나머지 9,007,199,254,740,990개(즉, 2⁵³ - 2)의 값은 비정규화된 값이며, 다음 형식을 가집니다.

s \times m \times 2 e

여기서 s는 1 또는 -1이고, m은 0(제외)부터 2⁵²(제외)까지의 구간에 있는 정수이며, e는 -1074입니다.

크기가 2⁵³ 이하인 모든 양의 정수와 음의 정수는 Number 타입으로 표현할 수 있다는 점에 유의하십시오. 정수 0은 Number 타입에서 두 가지 표현, 즉 +0_𝔽와 -0_𝔽를 가집니다.

유한 Number가 0이 아니고 이를 표현하는 데 사용되는 정수 m(위에 표시된 두 형식 중 하나에서)가 홀수이면 홀수 유효숫자를 가집니다. 그렇지 않으면 짝수 유효숫자를 가집니다.

이 명세에서 x가 정확한 실수의 수학적 양(π와 같은 무리수일 수도 있음)을 나타낼 때 “x에 대한 Number 값”이라는 구문은 다음 방식으로 선택된 Number 값을 의미합니다. -0_𝔽를 제외한 모든 유한 Number의 합집합에 Number 타입으로 표현할 수 없는 두 개의 추가 값, 즉 2¹⁰²⁴(이는 +1 × 2⁵³ × 2⁹⁷¹)와 -2¹⁰²⁴(이는 -1 × 2⁵³ × 2⁹⁷¹)를 더한 집합을 고려합니다. 이 집합에서 값이 x에 가장 가까운 원소를 선택합니다. 집합의 두 값이 동일하게 가깝다면 짝수 유효숫자를 가진 값을 선택합니다. 이를 위해 두 추가 값 2¹⁰²⁴와 -2¹⁰²⁴는 짝수 유효숫자를 가진 것으로 간주합니다. 마지막으로 2¹⁰²⁴가 선택된 경우 이를 +∞_𝔽로 바꾸고, -2¹⁰²⁴가 선택된 경우 이를 -∞_𝔽로 바꾸며, +0_𝔽가 선택된 경우 x < 0인 경우에만 이를 -0_𝔽로 바꿉니다. 그 밖의 선택된 값은 변경하지 않고 사용합니다. 그 결과가 x에 대한 Number 값입니다. (이 절차는 IEEE 754-2019 roundTiesToEven 모드의 동작과 정확히 일치합니다.)

+∞에 대한 Number 값은 +∞_𝔽이고, -∞에 대한 Number 값은 -∞_𝔽입니다.

일부 ECMAScript 연산자는 -2³¹부터 2³¹ - 1까지의 양 끝을 포함하는 구간이나 0부터 2¹⁶ - 1까지의 양 끝을 포함하는 구간과 같은 특정 범위의 정수만 처리합니다. 이러한 연산자는 Number 타입의 모든 값을 허용하지만, 먼저 각 값을 예상 범위의 정수 값으로 변환합니다. 7.1의 숫자 변환 연산에 대한 설명을 참조하십시오.

6.1.6.1.1 Number::unaryMinus ( `number` )

추상 연산 Number::unaryMinus. 인수 number (Number). 반환값: Number. 호출되면 다음 단계를 수행한다.

number가 NaN이면, NaN을 반환합니다.
number의 부정값, 즉 크기는 같지만 부호가 반대인 Number를 계산하여 반환합니다.

6.1.6.1.2 Number::bitwiseNOT ( `number` )

추상 연산 Number::bitwiseNOT. 인수 number (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

oldValue를 ! ToInt32(number)로 둡니다.
oldValue의 비트 보수를 반환합니다. 결과의 수학적 값은 32비트 2의 보수 비트 문자열로 정확하게 표현할 수 있습니다.

6.1.6.1.3 Number::exponentiate ( `base`, `exponent` )

추상 연산 Number::exponentiate. 인수 base (Number) 및 exponent (Number). 반환값: Number. base를 exponent 제곱한 결과를 나타내는 구현체 근사 값을 반환합니다. 호출되면 다음 단계를 수행한다.

exponent가 NaN이면 NaN을 반환합니다.
exponent가 +0_𝔽 또는 -0_𝔽 중 하나이면 1_𝔽을 반환합니다.
base가 NaN이면 NaN을 반환합니다.
base가 +∞_𝔽이면 다음을 수행합니다.
1. exponent > +0_𝔽이면 +∞_𝔽을 반환합니다.
2. +0_𝔽을 반환합니다.
base가 -∞_𝔽이면 다음을 수행합니다.
1. exponent > +0_𝔽이면 다음을 수행합니다.
  1. exponent가 홀수인 정수 Number이면 -∞_𝔽을 반환합니다.
  2. +∞_𝔽을 반환합니다.
2. exponent가 홀수인 정수 Number이면 -0_𝔽을 반환합니다.
3. +0_𝔽을 반환합니다.
base가 +0_𝔽이면 다음을 수행합니다.
1. exponent > +0_𝔽이면 +0_𝔽을 반환합니다.
2. +∞_𝔽을 반환합니다.
base가 -0_𝔽이면 다음을 수행합니다.
1. exponent > +0_𝔽이면 다음을 수행합니다.
  1. exponent가 홀수인 정수 Number이면 -0_𝔽을 반환합니다.
  2. +0_𝔽을 반환합니다.
2. exponent가 홀수인 정수 Number이면 -∞_𝔽을 반환합니다.
3. +∞_𝔽을 반환합니다.
단언: base는 유한 Number이며 +0_𝔽도 -0_𝔽도 아닙니다.
exponent가 +∞_𝔽이면 다음을 수행합니다.
1. abs(ℝ(base)) > 1이면 +∞_𝔽을 반환합니다.
2. abs(ℝ(base)) = 1이면 NaN을 반환합니다.
3. +0_𝔽을 반환합니다.
exponent가 -∞_𝔽이면 다음을 수행합니다.
1. abs(ℝ(base)) > 1이면 +0_𝔽을 반환합니다.
2. abs(ℝ(base)) = 1이면 NaN을 반환합니다.
3. +∞_𝔽을 반환합니다.
단언: exponent는 유한 Number이며 +0_𝔽도 -0_𝔽도 아닙니다.
base < -0_𝔽이고 exponent가 정수 Number가 아니면 NaN을 반환합니다.
ℝ(base)를 ℝ(exponent) 제곱한 결과를 나타내는 구현에서 근사한 Number 값을 반환합니다.

참고

base가 1_𝔽 또는 -1_𝔽이고 exponent가 +∞_𝔽 또는 -∞_𝔽인 경우, 또는 base가 1_𝔽이고 exponent가 NaN인 경우의 base ** exponent 결과는 IEEE 754-2019와 다릅니다. ECMAScript 초판은 이 연산의 결과를 NaN으로 명시했지만, 이후 IEEE 754 개정판은 1_𝔽을 명시했습니다. 호환성을 위해 역사적인 ECMAScript 동작을 유지합니다.

6.1.6.1.4 Number::multiply ( `x`, `y` )

추상 연산 Number::multiply. 인수 x (Number) 및 y (Number). 반환값: Number. IEEE 754-2019 이진 배정밀도 산술 규칙에 따라 곱셈을 수행하여 x와 y의 곱을 생성합니다. 호출되면 다음 단계를 수행한다.

x가 NaN이거나 y가 NaN이면, NaN을 반환합니다.
x가 +∞_𝔽 또는 -∞_𝔽이면, 다음을 수행합니다.
1. y가 +0_𝔽 또는 -0_𝔽이면, NaN을 반환합니다.
2. y > +0_𝔽이면, x를 반환합니다.
3. -x를 반환합니다.
y가 +∞_𝔽 또는 -∞_𝔽이면, 다음을 수행합니다.
1. x가 +0_𝔽 또는 -0_𝔽이면, NaN을 반환합니다.
2. x > +0_𝔽이면, y를 반환합니다.
3. -y를 반환합니다.
x가 -0_𝔽이면, 다음을 수행합니다.
1. y가 -0_𝔽이거나 y < -0_𝔽이면, +0_𝔽을 반환합니다.
2. -0_𝔽을 반환합니다.
y가 -0_𝔽이면, 다음을 수행합니다.
1. x < -0_𝔽이면, +0_𝔽을 반환합니다.
2. -0_𝔽을 반환합니다.
𝔽(ℝ(x) × ℝ(y))를 반환합니다.

참고

유한 정밀도 곱셈은 교환법칙을 만족하지만 항상 결합법칙을 만족하는 것은 아닙니다.

6.1.6.1.5 Number::divide ( `x`, `y` )

추상 연산 Number::divide. 인수 x (Number) 및 y (Number). 반환값: Number. IEEE 754-2019 이진 배정밀도 산술 규칙에 따라 나눗셈을 수행하며, x가 피제수이고 y가 제수인 x와 y의 몫을 생성합니다. 호출되면 다음 단계를 수행한다.

x가 NaN이거나 y가 NaN이면, NaN을 반환합니다.
x가 +∞_𝔽 또는 -∞_𝔽이면, 다음을 수행합니다.
1. y가 +∞_𝔽 또는 -∞_𝔽이면, NaN을 반환합니다.
2. y가 +0_𝔽이거나 y > +0_𝔽이면, x를 반환합니다.
3. -x를 반환합니다.
y가 +∞_𝔽이면, 다음을 수행합니다.
1. x가 +0_𝔽이거나 x > +0_𝔽이면, +0_𝔽을 반환합니다.
2. -0_𝔽을 반환합니다.
y가 -∞_𝔽이면, 다음을 수행합니다.
1. x가 +0_𝔽이거나 x > +0_𝔽이면, -0_𝔽을 반환합니다.
2. +0_𝔽을 반환합니다.
x가 +0_𝔽 또는 -0_𝔽이면, 다음을 수행합니다.
1. y가 +0_𝔽 또는 -0_𝔽이면, NaN을 반환합니다.
2. y > +0_𝔽이면, x를 반환합니다.
3. -x를 반환합니다.
y가 +0_𝔽이면, 다음을 수행합니다.
1. x > +0_𝔽이면, +∞_𝔽을 반환합니다.
2. -∞_𝔽을 반환합니다.
y가 -0_𝔽이면, 다음을 수행합니다.
1. x > +0_𝔽이면, -∞_𝔽을 반환합니다.
2. +∞_𝔽을 반환합니다.
𝔽(ℝ(x) / ℝ(y))를 반환합니다.

6.1.6.1.6 Number::remainder ( `numerator`, `denominator` )

추상 연산 Number::remainder. 인수 numerator (Number) 및 denominator (Number). 반환값: Number. 피연산자의 암묵적인 나눗셈에서 나머지를 생성하며, 여기에서 numerator는 피제수이고 denominator는 제수입니다. 호출되면 다음 단계를 수행한다.

numerator가 NaN이거나 denominator가 NaN이면 NaN을 반환합니다.
numerator가 +∞_𝔽 또는 -∞_𝔽 중 하나이면 NaN을 반환합니다.
denominator가 +∞_𝔽 또는 -∞_𝔽 중 하나이면 numerator를 반환합니다.
denominator가 +0_𝔽 또는 -0_𝔽 중 하나이면 NaN을 반환합니다.
numerator가 +0_𝔽 또는 -0_𝔽 중 하나이면 numerator를 반환합니다.
단언: numerator는 유한 Number이며 +0_𝔽도 -0_𝔽도 아닙니다.
단언: denominator는 유한 Number이며 +0_𝔽도 -0_𝔽도 아닙니다.
quotient를 ℝ(numerator) / ℝ(denominator)로 둡니다.
truncatedQuotient를 truncate(quotient)로 둡니다.
remainder를 ℝ(numerator) - (ℝ(denominator) × truncatedQuotient)로 둡니다.
remainder = 0이고 numerator < -0_𝔽이면 -0_𝔽을 반환합니다.
𝔽(remainder)를 반환합니다.

참고 1

C와 C++에서 나머지 연산자는 정수 피연산자만 허용하지만, ECMAScript에서는 부동소수점 피연산자도 허용합니다.

참고 2

% 연산자가 계산하는 부동소수점 나머지 연산의 결과는 IEEE 754-2019에서 정의한 “나머지” 연산과 같지 않습니다. IEEE 754-2019의 “나머지” 연산은 절삭 나눗셈이 아니라 반올림 나눗셈에서 나머지를 계산하므로 일반적인 정수 나머지 연산자의 동작과 유사하지 않습니다. 대신 ECMAScript 언어는 부동소수점 연산에 대한 %가 Java의 정수 나머지 연산자와 유사하게 동작하도록 정의합니다. 이는 C 라이브러리 함수 fmod와 비교할 수 있습니다.

6.1.6.1.7 Number::add ( `x`, `y` )

추상 연산 Number::add. 인수 x (Number) 및 y (Number). 반환값: Number. IEEE 754-2019 이진 배정밀도 산술 규칙에 따라 덧셈을 수행하여 인수의 합을 생성합니다. 호출되면 다음 단계를 수행한다.

x가 NaN이거나 y가 NaN이면 NaN을 반환합니다.
x가 +∞_𝔽이고 y가 -∞_𝔽이면 NaN을 반환합니다.
x가 -∞_𝔽이고 y가 +∞_𝔽이면 NaN을 반환합니다.
x가 +∞_𝔽 또는 -∞_𝔽 중 하나이면 x를 반환합니다.
y가 +∞_𝔽 또는 -∞_𝔽 중 하나이면 y를 반환합니다.
단언: x와 y는 유한 Number입니다.
x가 -0_𝔽이고 y가 -0_𝔽이면 -0_𝔽을 반환합니다.
𝔽(ℝ(x) + ℝ(y))를 반환합니다.

참고

유한 정밀도 덧셈은 교환법칙을 만족하지만 항상 결합법칙을 만족하는 것은 아닙니다.

6.1.6.1.8 Number::subtract ( `x`, `y` )

추상 연산 Number::subtract. 인수 x (Number) 및 y (Number). 반환값: Number. 뺄셈을 수행하여 피연산자의 차를 생성합니다. x는 피감수이고 y는 감수입니다. 호출되면 다음 단계를 수행한다.

Number::add(x, Number::unaryMinus(y))를 반환합니다.

참고

x - y는 항상 x + (-y)와 같은 결과를 생성합니다.

6.1.6.1.9 Number::leftShift ( `x`, `y` )

추상 연산 Number::leftShift. 인수 x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

leftNumber를 ! ToInt32(x)로 둡니다.
rightNumber를 ! ToUint32(y)로 둡니다.
shiftCount를 ℝ(rightNumber) modulo 32로 둡니다.
leftNumber를 shiftCount비트만큼 왼쪽으로 시프트한 결과를 반환합니다. 결과의 수학적 값은 32비트 2의 보수 비트 문자열로 정확하게 표현할 수 있습니다.

6.1.6.1.10 Number::signedRightShift ( `x`, `y` )

추상 연산 Number::signedRightShift. 인수 x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

leftNumber를 ! ToInt32(x)로 둡니다.
rightNumber를 ! ToUint32(y)로 둡니다.
shiftCount를 ℝ(rightNumber) modulo 32로 둡니다.
leftNumber를 shiftCount비트만큼 부호 확장 오른쪽 시프트한 결과를 반환합니다. 최상위 비트가 전파됩니다. 결과의 수학적 값은 32비트 2의 보수 비트 문자열로 정확하게 표현할 수 있습니다.

6.1.6.1.11 Number::unsignedRightShift ( `x`, `y` )

추상 연산 Number::unsignedRightShift. 인수 x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

leftNumber를 ! ToUint32(x)로 둡니다.
rightNumber를 ! ToUint32(y)로 둡니다.
shiftCount를 ℝ(rightNumber) modulo 32로 둡니다.
leftNumber를 shiftCount비트만큼 0 채움 오른쪽 시프트한 결과를 반환합니다. 비워진 비트는 0으로 채워집니다. 결과의 수학적 값은 32비트 부호 없는 비트 문자열로 정확하게 표현할 수 있습니다.

6.1.6.1.12 Number::lessThan ( `x`, `y` )

추상 연산 Number::lessThan. 인수 x (Number) 및 y (Number). 반환값: Boolean 또는 undefined. 호출되면 다음 단계를 수행한다.

x가 NaN이면 undefined를 반환합니다.
y가 NaN이면 undefined를 반환합니다.
x가 y이면 false를 반환합니다.
x가 +0_𝔽이고 y가 -0_𝔽이면 false를 반환합니다.
x가 -0_𝔽이고 y가 +0_𝔽이면 false를 반환합니다.
x가 +∞_𝔽이면 false를 반환합니다.
y가 +∞_𝔽이면 true를 반환합니다.
y가 -∞_𝔽이면 false를 반환합니다.
x가 -∞_𝔽이면 true를 반환합니다.
단언: x와 y는 유한 Number입니다.
ℝ(x) < ℝ(y)이면 true를 반환합니다.
false를 반환합니다.

6.1.6.1.13 Number::equal ( `x`, `y` )

추상 연산 Number::equal. 인수 x (Number) 및 y (Number). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

x가 NaN이면, false를 반환합니다.
y가 NaN이면, false를 반환합니다.
x가 y이면, true를 반환합니다.
x가 +0_𝔽이고 y가 -0_𝔽이면, true를 반환합니다.
x가 -0_𝔽이고 y가 +0_𝔽이면, true를 반환합니다.
false를 반환합니다.

6.1.6.1.14 Number::sameValue ( `x`, `y` )

추상 연산 Number::sameValue. 인수 x (Number) 및 y (Number). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

x가 NaN이고 y가 NaN이면, true를 반환합니다.
x가 +0_𝔽이고 y가 -0_𝔽이면, false를 반환합니다.
x가 -0_𝔽이고 y가 +0_𝔽이면, false를 반환합니다.
x가 y이면, true를 반환합니다.
false를 반환합니다.

6.1.6.1.15 Number::sameValueZero ( `x`, `y` )

추상 연산 Number::sameValueZero. 인수 x (Number) 및 y (Number). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

x가 NaN이고 y가 NaN이면, true를 반환합니다.
x가 +0_𝔽이고 y가 -0_𝔽이면, true를 반환합니다.
x가 -0_𝔽이고 y가 +0_𝔽이면, true를 반환합니다.
x가 y이면, true를 반환합니다.
false를 반환합니다.

6.1.6.1.16 NumberBitwiseOp ( `op`, `x`, `y` )

추상 연산 NumberBitwiseOp. 인수 op ((&, ^ 또는 |)), x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

leftNumber를 ! ToInt32(x)로 둡니다.
rightNumber를 ! ToInt32(y)로 둡니다.
leftBits를 ℝ(leftNumber)를 나타내는 32비트 2의 보수 비트 문자열로 둡니다.
rightBits를 ℝ(rightNumber)를 나타내는 32비트 2의 보수 비트 문자열로 둡니다.
op가 &이면,
1. result를 leftBits와 rightBits에 비트 단위 AND 연산을 적용한 결과로 둡니다.
그렇지 않고 op가 ^이면,
1. result를 leftBits와 rightBits에 비트 단위 XOR(배타적 OR) 연산을 적용한 결과로 둡니다.
그렇지 않으면,
1. 단언: op는 |입니다.
2. result를 leftBits와 rightBits에 비트 단위 OR(포괄적 OR) 연산을 적용한 결과로 둡니다.
32비트 2의 보수 비트 문자열 result가 나타내는 정수에 해당하는 Number 값을 반환합니다.

6.1.6.1.17 Number::bitwiseAND ( `x`, `y` )

추상 연산 Number::bitwiseAND. 인수 x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

NumberBitwiseOp(&, x, y)를 반환합니다.

6.1.6.1.18 Number::bitwiseXOR ( `x`, `y` )

추상 연산 Number::bitwiseXOR. 인수 x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

NumberBitwiseOp(^, x, y)를 반환합니다.

6.1.6.1.19 Number::bitwiseOR ( `x`, `y` )

추상 연산 Number::bitwiseOR. 인수 x (Number) 및 y (Number). 반환값: 정수인 Number. 호출되면 다음 단계를 수행한다.

NumberBitwiseOp(|, x, y)를 반환합니다.

6.1.6.1.20 Number::toString ( `x`, `radix` )

추상 연산 Number::toString. 인수 x (Number) 및 radix (an integer within the closed interval from 2 to 36). 반환값: String. 기수가 radix인 위치 기수법을 사용하여 x를 String으로 나타냅니다. 기수 r을 사용한 수의 표현에 사용되는 숫자는 "0123456789abcdefghijklmnopqrstuvwxyz"의 처음 r개 코드 단위에서 순서대로 가져옵니다. 크기가 1_𝔽 이상인 수의 표현에는 선행 0이 포함되지 않습니다. 호출되면 다음 단계를 수행한다.

x가 NaN이면, "NaN"을 반환합니다.
x가 +0_𝔽 또는 -0_𝔽이면, "0"을 반환합니다.
x < -0_𝔽이면, "-"와 Number::toString(-x, radix)의 문자열 연결을 반환합니다.
x가 +∞_𝔽이면, "Infinity"를 반환합니다.
k ≥ 1이고, radix^{k - 1} ≤ s < radix^k이며, 𝔽(s × radix^{n - k})가 x이고, k가 가능한 한 작은 정수 n, k 및 s를 둡니다. k는 기수 radix를 사용한 s 표현의 자릿수이고, s는 radix로 나누어떨어지지 않으며, 이러한 기준만으로 s의 최하위 자릿수가 반드시 고유하게 결정되는 것은 아니라는 점에 유의하시기 바랍니다.
radix ≠ 10이거나 n이 -5부터 21까지의 닫힌 구간에 있으면, 다음을 수행합니다.
1. n ≥ k이면, 다음을 수행합니다.
  1. 다음의 문자열 연결을 반환합니다:
    - 기수 radix를 사용한 s 표현의 k개 숫자의 코드 단위
    - 코드 단위 0x0030 (DIGIT ZERO)의 n - k개 발생
2. n > 0이면, 다음을 수행합니다.
  1. 다음의 문자열 연결을 반환합니다:
    - 기수 radix를 사용한 s 표현의 최상위 n개 숫자의 코드 단위
    - 코드 단위 0x002E (FULL STOP)
    - 기수 radix를 사용한 s 표현의 나머지 k - n개 숫자의 코드 단위
3. 단언: n ≤ 0입니다.
4. 다음의 문자열 연결을 반환합니다:
  - 코드 단위 0x0030 (DIGIT ZERO)
  - 코드 단위 0x002E (FULL STOP)
  - 코드 단위 0x0030 (DIGIT ZERO)의 -n개 발생
  - 기수 radix를 사용한 s 표현의 k개 숫자의 코드 단위
참고: 이 경우 입력은 1.2e+3과 같은 과학적 E 표기법을 사용하여 표현됩니다.
단언: radix는 10입니다.
n < 0이면, 다음을 수행합니다.
1. exponentSign을 코드 단위 0x002D (HYPHEN-MINUS)로 둡니다.
그렇지 않으면,
1. exponentSign을 코드 단위 0x002B (PLUS SIGN)로 둡니다.
k = 1이면, 다음을 수행합니다.
1. 다음의 문자열 연결을 반환합니다:
  - s의 단일 숫자의 코드 단위
  - 코드 단위 0x0065 (LATIN SMALL LETTER E)
  - exponentSign
  - abs(n - 1)의 십진 표현의 코드 단위
다음의 문자열 연결을 반환합니다:
- s의 십진 표현에서 최상위 숫자의 코드 단위
- 코드 단위 0x002E (FULL STOP)
- s의 십진 표현에서 나머지 k - 1개 숫자의 코드 단위
- 코드 단위 0x0065 (LATIN SMALL LETTER E)
- exponentSign
- abs(n - 1)의 십진 표현의 코드 단위

참고 1

다음 관찰 사항은 구현체를 위한 지침으로 유용할 수 있지만 이 표준의 규범적 요구 사항에 포함되지는 않습니다:

x가 -0_𝔽 이외의 임의의 Number 값이면 ToNumber(ToString(x))는 x입니다.
s의 최하위 자릿수는 5 단계에 나열된 요구 사항만으로 항상 고유하게 결정되는 것은 아닙니다.

참고 2

위 규칙에서 요구하는 것보다 더 정확한 변환을 제공하는 구현체에는 다음과 같은 5 단계의 대체 버전을 지침으로 사용할 것을 권장합니다:

k ≥ 1이고, radix^{k - 1} ≤ s < radix^k이며, 𝔽(s × radix^{n - k})가 x이고, k가 가능한 한 작은 정수 n, k 및 s를 둡니다. s에 여러 가능성이 있으면 s × radix^{n - k}가 ℝ(x)에 가장 가까워지는 s를 선택합니다. 그러한 가능한 s 값이 두 개이면 짝수인 값을 선택합니다. k는 기수 radix를 사용한 s 표현의 자릿수이고 s는 radix로 나누어떨어지지 않는다는 점에 유의하시기 바랍니다.

참고 3

ECMAScript 구현자는 부동소수점 수의 이진-십진 변환을 위해 David M. Gay가 작성한 다음 논문과 코드를 유용하게 활용할 수 있습니다:

Gay, David M. 정확하게 반올림된 이진-십진 및 십진-이진 변환. Numerical Analysis, Manuscript 90-10. AT&T Bell Laboratories (Murray Hill, New Jersey). 30 November 1990. 다음에서 이용할 수 있습니다
https://ampl.com/_archive/first-website/REFS/rounding.pdf. 관련 코드는 다음에서 이용할 수 있습니다
http://netlib.sandia.gov/fp/dtoa.c 및
http://netlib.sandia.gov/fp/g_fmt.c이며 다양한 netlib 미러 사이트에서도 찾을 수 있습니다.

6.1.6.2 BigInt 타입

BigInt 타입은 정숫값을 나타냅니다. 값의 크기는 임의적일 수 있으며 특정 비트 너비로 제한되지 않습니다. 일반적으로 달리 명시되지 않는 한 연산은 수학적으로 정확한 결과를 반환하도록 설계됩니다. 이항 연산에서 BigInt는 2의 보수 이진 문자열처럼 동작하며, 음수는 왼쪽으로 무한히 비트가 설정된 것으로 취급됩니다.

6.1.6.2.1 BigInt::unaryMinus ( `bigint` )

추상 연산 BigInt::unaryMinus. 인수 bigint (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

bigint = 0_ℤ이면, 0_ℤ을 반환합니다.
-bigint를 반환합니다.

6.1.6.2.2 BigInt::bitwiseNOT ( `bigint` )

추상 연산 BigInt::bitwiseNOT. 인수 bigint (BigInt). 반환값: BigInt. bigint의 1의 보수를 반환합니다. 호출되면 다음 단계를 수행한다.

-bigint - 1_ℤ을 반환합니다.

6.1.6.2.3 BigInt::exponentiate ( `base`, `exponent` )

추상 연산 BigInt::exponentiate. 인수 base (BigInt) 및 exponent (BigInt). 반환값: BigInt를 포함하는 정상 완료 또는 던지기 완료. 호출되면 다음 단계를 수행한다.

exponent < 0_ℤ이면, RangeError 예외를 던집니다.
base = 0_ℤ이고 exponent = 0_ℤ이면, 1_ℤ을 반환합니다.
base를 exponent 제곱한 값을 반환합니다.

6.1.6.2.4 BigInt::multiply ( `x`, `y` )

추상 연산 BigInt::multiply. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

x × y를 반환합니다.

참고

결과의 비트 너비가 입력보다 훨씬 크더라도 정확한 수학적 결과가 제공됩니다.

6.1.6.2.5 BigInt::divide ( `x`, `y` )

추상 연산 BigInt::divide. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt를 포함하는 정상 완료 또는 던지기 완료. 호출되면 다음 단계를 수행한다.

y = 0_ℤ이면, RangeError 예외를 던집니다.
quotient를 ℝ(x) / ℝ(y)로 둡니다.
ℤ(truncate(quotient))를 반환합니다.

6.1.6.2.6 BigInt::remainder ( `numerator`, `denominator` )

추상 연산 BigInt::remainder. 인수 numerator (BigInt) 및 denominator (BigInt). 반환값: BigInt를 포함하는 정상 완료 또는 던지기 완료. 호출되면 다음 단계를 수행한다.

denominator = 0_ℤ이면, RangeError 예외를 던집니다.
numerator = 0_ℤ이면, 0_ℤ을 반환합니다.
quotient를 ℝ(numerator) / ℝ(denominator)로 둡니다.
truncatedQuotient를 ℤ(truncate(quotient))로 둡니다.
numerator - (denominator × truncatedQuotient)를 반환합니다.

참고

결과의 부호는 피제수의 부호입니다.

6.1.6.2.7 BigInt::add ( `x`, `y` )

추상 연산 BigInt::add. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

x + y를 반환합니다.

6.1.6.2.8 BigInt::subtract ( `x`, `y` )

추상 연산 BigInt::subtract. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

x - y를 반환합니다.

6.1.6.2.9 BigInt::leftShift ( `x`, `y` )

추상 연산 BigInt::leftShift. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

y < 0_ℤ이면, 다음을 수행합니다.
1. ℤ(floor(ℝ(x) / 2^-ℝ(y)))를 반환합니다.
x × 2_ℤ^y를 반환합니다.

참고

여기에서의 의미론은 BigInt를 길이가 무한한 이진 2의 보수 숫자 문자열로 취급하는 비트 시프트와 동등해야 합니다.

6.1.6.2.10 BigInt::signedRightShift ( `x`, `y` )

추상 연산 BigInt::signedRightShift. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

BigInt::leftShift(x, -y)를 반환합니다.

6.1.6.2.11 BigInt::unsignedRightShift ( `x`, `y` )

추상 연산 BigInt::unsignedRightShift. 인수 x (BigInt) 및 y (BigInt). 반환값: 던지기 완료. 호출되면 다음 단계를 수행한다.

TypeError 예외를 던집니다.

6.1.6.2.12 BigInt::lessThan ( `x`, `y` )

추상 연산 BigInt::lessThan. 인수 x (BigInt) 및 y (BigInt). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

ℝ(x) < ℝ(y)이면, true를 반환합니다.
false를 반환합니다.

6.1.6.2.13 BigInt::equal ( `x`, `y` )

추상 연산 BigInt::equal. 인수 x (BigInt) 및 y (BigInt). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

ℝ(x) = ℝ(y)이면, true를 반환합니다.
false를 반환합니다.

6.1.6.2.14 BigIntBitwiseOp ( `op`, `x`, `y` )

추상 연산 BigIntBitwiseOp. 인수 op ((&, ^ 또는 |)), x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

x를 ℝ(x)로 설정합니다.
y를 ℝ(y)로 설정합니다.
result를 0으로 둡니다.
shift를 0으로 둡니다.
(x = 0 또는 x = -1)이고 (y = 0 또는 y = -1)이 될 때까지 다음을 반복합니다,
1. xBit를 x modulo 2로 둡니다.
2. yBit를 y modulo 2로 둡니다.
3. op가 &이면,
  1. resultBit를 xBit와 yBit에 단일 비트 AND 연산을 적용한 결과로 둡니다.
4. 그렇지 않고 op가 ^이면,
  1. resultBit를 xBit와 yBit에 단일 비트 XOR(배타적 OR) 연산을 적용한 결과로 둡니다.
5. 그렇지 않으면,
  1. 단언: op는 |입니다.
  2. resultBit를 xBit와 yBit에 단일 비트 OR(포괄적 OR) 연산을 적용한 결과로 둡니다.
6. result를 result + 2^shift × resultBit로 설정합니다.
7. shift를 shift + 1로 설정합니다.
8. x를 (x - xBit) / 2로 설정합니다.
9. y를 (y - yBit) / 2로 설정합니다.
op가 &이면,
1. signBit를 (x modulo 2)와 (y modulo 2)에 단일 비트 AND 연산을 적용한 결과로 둡니다.
그렇지 않고 op가 ^이면,
1. signBit를 (x modulo 2)와 (y modulo 2)에 단일 비트 XOR(배타적 OR) 연산을 적용한 결과로 둡니다.
그렇지 않으면,
1. 단언: op는 |입니다.
2. signBit를 (x modulo 2)와 (y modulo 2)에 단일 비트 OR(포괄적 OR) 연산을 적용한 결과로 둡니다.
signBit ≠ 0이면,
1. result를 result - 2^shift로 설정합니다.
2. 참고: 이는 부호를 확장합니다.
result에 해당하는 BigInt 값을 반환합니다.

6.1.6.2.15 BigInt::bitwiseAND ( `x`, `y` )

추상 연산 BigInt::bitwiseAND. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

BigIntBitwiseOp(&, x, y)를 반환합니다.

6.1.6.2.16 BigInt::bitwiseXOR ( `x`, `y` )

추상 연산 BigInt::bitwiseXOR. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

BigIntBitwiseOp(^, x, y)를 반환합니다.

6.1.6.2.17 BigInt::bitwiseOR ( `x`, `y` )

추상 연산 BigInt::bitwiseOR. 인수 x (BigInt) 및 y (BigInt). 반환값: BigInt. 호출되면 다음 단계를 수행한다.

BigIntBitwiseOp(|, x, y)를 반환합니다.

6.1.6.2.18 BigInt::toString ( `x`, `radix` )

추상 연산 BigInt::toString. 인수 x (BigInt) 및 radix (2부터 36까지의 닫힌 구간에 있는 정수). 반환값: String. 기수가 radix인 위치 기수법을 사용하여 x를 String으로 나타냅니다. 기수 r을 사용한 BigInt 표현에 사용되는 숫자는 "0123456789abcdefghijklmnopqrstuvwxyz"의 처음 r개 코드 단위에서 순서대로 가져옵니다. 0_ℤ 이외의 BigInt 표현에는 선행 0이 포함되지 않습니다. 호출되면 다음 단계를 수행한다.

x < 0_ℤ이면, "-"와 BigInt::toString(-x, radix)의 문자열 연결을 반환합니다.
기수 radix를 사용한 x의 표현으로 구성된 String 값을 반환합니다.

6.1.7 Object 타입

간단히 “Object”라고도 하는 Object 타입의 각 인스턴스는 프로퍼티의 컬렉션을 나타냅니다. 각 프로퍼티는 데이터 프로퍼티 또는 접근자 프로퍼티입니다:

데이터 프로퍼티는 키 값을 ECMAScript 언어 값 및 Boolean 속성 집합과 연결합니다.
접근자 프로퍼티는 키 값을 하나 또는 두 개의 접근자 함수 및 Boolean 속성 집합과 연결합니다. 접근자 함수는 프로퍼티와 연결된 ECMAScript 언어 값을 저장하거나 가져오는 데 사용됩니다.

객체의 프로퍼티는 프로퍼티 키를 사용하여 고유하게 식별됩니다. 프로퍼티 키는 String 또는 Symbol입니다. 빈 String을 포함하여 모든 String과 Symbol은 유효한 프로퍼티 키입니다. 프로퍼티 이름은 String인 프로퍼티 키입니다.

정수 인덱스는 CanonicalNumericIndexString(n)이 +0_𝔽부터 𝔽(2⁵³ - 1)까지의 닫힌 구간에 있는 정수인 Number를 반환하는 프로퍼티 이름 n입니다. 배열 인덱스는 CanonicalNumericIndexString(n)이 +0_𝔽부터 𝔽(2³² - 2)까지의 닫힌 구간에 있는 정수인 Number를 반환하는 정수 인덱스 n입니다.

참고

모든 음이 아닌 안전한 정수에는 대응하는 정수 인덱스가 있습니다. 2³² - 1을 제외한 모든 32비트 부호 없는 정수에는 대응하는 배열 인덱스가 있습니다. "-0"은 정수 인덱스도 배열 인덱스도 아닙니다.

프로퍼티 키는 프로퍼티와 그 값에 접근하는 데 사용됩니다. 프로퍼티 접근에는 값의 검색과 할당에 각각 대응하는 get과 set이라는 두 종류가 있습니다. get 및 set 접근을 통해 접근할 수 있는 프로퍼티에는 객체의 직접적인 일부인 자체 프로퍼티와 프로퍼티 상속 관계를 통해 연결된 다른 객체가 제공하는 상속된 프로퍼티가 모두 포함됩니다. 상속된 프로퍼티는 연결된 객체의 자체 프로퍼티 또는 상속된 프로퍼티일 수 있습니다. 객체의 각 자체 프로퍼티는 해당 객체의 다른 자체 프로퍼티 키 값과 구별되는 키 값을 가져야 합니다.

논리적으로 모든 객체는 프로퍼티의 컬렉션이지만, 프로퍼티에 접근하고 조작하는 의미론이 서로 다른 여러 형태의 객체가 있습니다. 여러 형태의 객체에 대한 정의는 6.1.7.2를 참조하시기 바랍니다.

또한 일부 객체는 호출할 수 있습니다. 이러한 객체를 함수 또는 함수 객체라고 하며 아래에서 더 자세히 설명합니다. ECMAScript의 모든 함수는 Object 타입의 구성원입니다.

6.1.7.1 프로퍼티 속성

속성은 표 3에 설명된 대로 이 명세에서 Object 프로퍼티의 상태를 정의하고 설명하는 데 사용됩니다. 명시적으로 지정되지 않는 한 각 속성의 초기값은 해당 기본값입니다.

표 3: Object 프로퍼티의 속성

속성 이름	이 속성이 존재하는 프로퍼티 타입	값 영역	기본값	설명
`[[Value]]`	데이터 프로퍼티	ECMAScript 언어 값	undefined	프로퍼티에 get 접근하여 가져오는 값입니다.
`[[Writable]]`	데이터 프로퍼티	Boolean	false	false이면 ECMAScript 코드가 `[[Set]]`을 사용하여 프로퍼티의 `[[Value]]` 속성을 변경하려는 시도는 성공하지 않습니다.
`[[Getter]]`	접근자 프로퍼티	함수 객체 또는 undefined	undefined	값이 undefined가 아니면 프로퍼티에 get 접근을 수행할 때마다 프로퍼티 값을 가져오기 위해 빈 인수 목록으로 해당 `[[Call]]` 내부 메서드(표 5)를 호출합니다.
`[[Setter]]`	접근자 프로퍼티	함수 객체 또는 undefined	undefined	값이 undefined가 아니면 프로퍼티에 set 접근을 수행할 때마다 할당된 값을 유일한 인수로 포함하는 인수 목록으로 해당 `[[Call]]` 내부 메서드(표 5)를 호출합니다. 프로퍼티의 `[[Setter]]` 내부 메서드 효과는 이후 해당 프로퍼티의 `[[Getter]]` 내부 메서드 호출이 반환하는 값에 영향을 줄 수 있지만 반드시 영향을 주어야 하는 것은 아닙니다.
`[[Enumerable]]`	데이터 프로퍼티 또는 접근자 프로퍼티	Boolean	false	true이면 프로퍼티가 for-in 열거(14.7.5 참조)에 포함됩니다. 그렇지 않으면 프로퍼티를 열거할 수 없다고 합니다.
`[[Configurable]]`	데이터 프로퍼티 또는 접근자 프로퍼티	Boolean	false	false이면 프로퍼티를 삭제하거나, 데이터 프로퍼티를 접근자 프로퍼티로 또는 접근자 프로퍼티를 데이터 프로퍼티로 변경하거나, 기존 `[[Value]]`를 교체하거나 `[[Writable]]`을 false로 설정하는 경우를 제외하고 속성을 변경하려는 시도는 실패합니다.

6.1.7.2 Object 내부 메서드와 내부 슬롯

ECMAScript에서 객체의 실제 의미론은 내부 메서드라고 하는 알고리즘을 통해 명시됩니다. ECMAScript 엔진의 각 객체에는 해당 객체의 런타임 동작을 정의하는 내부 메서드 집합이 연결되어 있습니다. 이러한 내부 메서드는 ECMAScript 언어의 일부가 아닙니다. 이 명세에서는 오직 설명을 목적으로 정의합니다. 그러나 ECMAScript 구현체의 각 객체는 해당 객체와 연결된 내부 메서드가 명시하는 대로 동작해야 합니다. 이를 정확히 어떤 방식으로 달성하는지는 구현체가 결정합니다.

내부 메서드 이름은 다형적입니다. 이는 공통 내부 메서드 이름을 서로 다른 객체 값에 대해 호출할 때 서로 다른 알고리즘을 수행할 수 있음을 의미합니다. 내부 메서드가 호출되는 실제 객체를 호출의 “대상”이라고 합니다. 런타임에 알고리즘 구현이 객체가 지원하지 않는 내부 메서드를 사용하려 하면 TypeError 예외가 던져집니다.

내부 슬롯은 객체, Symbol 또는 Private Name과 연결되고 여러 ECMAScript 명세 알고리즘에서 사용하는 내부 상태에 해당합니다. 내부 슬롯은 객체 프로퍼티가 아니며 상속되지 않습니다. 특정 내부 슬롯 명세에 따라 이러한 상태는 임의의 ECMAScript 언어 타입 값 또는 특정 ECMAScript 명세 타입 값으로 구성될 수 있습니다. 명시적으로 달리 지정되지 않는 한 내부 슬롯은 객체, Symbol 또는 Private Name을 생성하는 과정의 일부로 할당되며 동적으로 추가할 수 없습니다. 달리 명시되지 않는 한 내부 슬롯의 초기값은 undefined입니다. 이 명세의 여러 알고리즘은 내부 슬롯을 갖는 값을 생성합니다. 그러나 ECMAScript 언어는 내부 슬롯을 직접 조작할 방법을 제공하지 않습니다.

모든 객체에는 PrivateElements의 List인 [[PrivateElements]]라는 내부 슬롯이 있습니다. 이 List는 객체의 비공개 필드, 메서드 및 접근자의 값을 나타냅니다. 처음에는 빈 List입니다.

이 명세에서 내부 메서드와 내부 슬롯은 이중 대괄호 [[ ]]로 둘러싼 이름으로 식별됩니다.

표 4에는 ECMAScript 코드가 생성하거나 조작하는 모든 객체에 적용되는 이 명세의 필수 내부 메서드가 요약되어 있습니다. 모든 객체에는 모든 필수 내부 메서드에 대한 알고리즘이 있어야 합니다. 그러나 모든 객체가 이러한 메서드에 동일한 알고리즘을 사용하는 것은 아닙니다.

일반 객체는 다음 기준을 모두 만족하는 객체입니다:

표 4에 나열된 내부 메서드에 대해 객체는 10.1에 정의된 메서드를 사용합니다.
객체에 [[Call]] 내부 메서드가 있으면 10.2.1에 정의된 메서드 또는 10.3.1에 정의된 메서드를 사용합니다.
객체에 [[Construct]] 내부 메서드가 있으면 10.2.2에 정의된 메서드 또는 10.3.2에 정의된 메서드를 사용합니다.

특수 객체는 일반 객체가 아닌 객체입니다.

이 명세는 객체의 내부 메서드를 기준으로 서로 다른 종류의 특수 객체를 인식합니다. 특정 종류의 특수 객체(예: Array 특수 객체 또는 바인딩된 함수 특수 객체)와 동작상 동등하지만 해당 종류에 명시된 것과 동일한 내부 메서드 집합을 갖지 않는 객체는 그 종류의 특수 객체로 인식되지 않습니다.

표 4와 기타 유사한 표는 각 내부 메서드의 호출 패턴을 설명합니다. 호출 패턴에는 항상 괄호로 둘러싼 설명적 매개변수 이름 목록이 포함됩니다.

내부 메서드는 매개변수 외에도 항상 메서드 호출의 대상인 객체에 접근할 수 있습니다.

내부 메서드는 암묵적으로 Completion Record를 반환하며, 호출 패턴에 표시된 반환 타입의 값을 감싸는 정상 완료 또는 던지기 완료 중 하나입니다.

표 4: 필수 내부 메서드

내부 메서드	설명	정의
`[[GetPrototypeOf]]` ( )	내부 메서드 `[[GetPrototypeOf]]`. 인수 없음. 반환값: Object 또는 null을 포함하는 정상 완료 또는 던지기 완료. 이 객체에 상속된 프로퍼티를 제공하는 객체를 결정합니다. null 값은 그러한 객체가 없음을 나타냅니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.1 ordinary object 10.4.6.1 module namespace exotic object 10.5.1 Proxy exotic object
`[[SetPrototypeOf]]` ( `proto` )	내부 메서드 `[[SetPrototypeOf]]`. 인수 `proto` ((Object 또는 null)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 이 객체를 상속된 프로퍼티를 제공하는 다른 객체와 연결합니다. null을 전달하면 상속된 프로퍼티를 제공하는 객체가 없음을 나타냅니다. 연산이 성공적으로 완료되었음을 나타내는 true 또는 연산이 성공하지 못했음을 나타내는 false를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.2 ordinary object 10.4.6.2 module namespace exotic object 10.4.7.1 immutable prototype exotic object 10.5.2 Proxy exotic object
`[[IsExtensible]]` ( )	내부 메서드 `[[IsExtensible]]`. 인수 없음. 반환값: Boolean을 포함하는 정상 완료 또는 던지기 완료. 이 객체에 추가 프로퍼티를 추가하는 것이 허용되는지 결정합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.3 ordinary object 10.4.6.3 module namespace exotic object 10.5.3 Proxy exotic object
`[[PreventExtensions]]` ( )	내부 메서드 `[[PreventExtensions]]`. 인수 없음. 반환값: Boolean을 포함하는 정상 완료 또는 던지기 완료. 이 객체에 새 프로퍼티를 추가할 수 있는지 제어합니다. 연산이 성공하면 true를 반환하고 성공하지 못하면 false를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.4 ordinary object 10.4.5.1 TypedArray 10.4.6.4 module namespace exotic object 10.5.4 Proxy exotic object
`[[GetOwnProperty]]` ( `propertyKey` )	내부 메서드 `[[GetOwnProperty]]`. 인수 `propertyKey` (프로퍼티 키). 반환값: Property Descriptor 또는 undefined를 포함하는 정상 완료 또는 던지기 완료. 키가 `propertyKey`인 이 객체의 자체 프로퍼티에 대한 Property Descriptor를 반환하고, 그러한 프로퍼티가 없으면 undefined를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.5 ordinary object 10.4.3.1 String exotic object 10.4.4.1 arguments exotic object 10.4.5.2 TypedArray 10.4.6.5 module namespace exotic object 10.5.5 Proxy exotic object
`[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )	내부 메서드 `[[DefineOwnProperty]]`. 인수 `propertyKey` (프로퍼티 키) 및 `propertyDesc` (프로퍼티 서술자). 반환값: Boolean을 포함하는 정상 완료 또는 던지기 완료. 키가 `propertyKey`인 자체 프로퍼티를 생성하거나 변경하여 `propertyDesc`가 설명하는 상태를 갖게 합니다. 연산이 성공하면 true를 반환하고 프로퍼티를 생성하거나 갱신할 수 없으면 false를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.6 ordinary object 10.4.2.1 Array exotic object 10.4.3.2 String exotic object 10.4.4.2 arguments exotic object 10.4.5.4 TypedArray 10.4.6.6 module namespace exotic object 10.5.6 Proxy exotic object
`[[HasProperty]]` ( `propertyKey` )	내부 메서드 `[[HasProperty]]`. 인수 `propertyKey` (프로퍼티 키). 반환값: Boolean을 포함하는 정상 완료 또는 던지기 완료. 이 객체에 키가 `propertyKey`인 자체 프로퍼티 또는 상속된 프로퍼티가 이미 있는지를 나타내는 Boolean을 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.7 ordinary object 10.4.5.3 TypedArray 10.4.6.7 module namespace exotic object 10.5.7 Proxy exotic object
`[[Get]]` ( `propertyKey`, `receiver` )	내부 메서드 `[[Get]]`. 인수 `propertyKey` (프로퍼티 키) 및 `receiver` (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 이 객체에서 키가 `propertyKey`인 프로퍼티의 값을 반환합니다. 프로퍼티 값을 가져오기 위해 ECMAScript 코드를 실행해야 하는 경우 코드를 평가할 때 `receiver`를 this 값으로 사용합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.8 ordinary object 10.4.4.3 arguments exotic object 10.4.5.5 TypedArray 10.4.6.8 module namespace exotic object 10.5.8 Proxy exotic object
`[[Set]]` ( `propertyKey`, `value`, `receiver` )	내부 메서드 `[[Set]]`. 인수 `propertyKey` (프로퍼티 키), `value` (ECMAScript 언어 값) 및 `receiver` (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 키가 `propertyKey`인 프로퍼티의 값을 `value`로 설정합니다. 프로퍼티 값을 설정하기 위해 ECMAScript 코드를 실행해야 하는 경우 코드를 평가할 때 `receiver`를 this 값으로 사용합니다. 프로퍼티 값이 설정되었으면 true를 반환하고 설정할 수 없으면 false를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.9 ordinary object 10.4.4.4 arguments exotic object 10.4.5.6 TypedArray 10.4.6.9 module namespace exotic object 10.5.9 Proxy exotic object
`[[Delete]]` ( `propertyKey` )	내부 메서드 `[[Delete]]`. 인수 `propertyKey` (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 이 객체에서 키가 `propertyKey`인 자체 프로퍼티를 제거합니다. 프로퍼티가 삭제되지 않아 여전히 존재하면 false를 반환합니다. 프로퍼티가 삭제되었거나 존재하지 않으면 true를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.10 ordinary object 10.4.4.5 arguments exotic object 10.4.5.7 TypedArray 10.4.6.10 module namespace exotic object 10.5.10 Proxy exotic object
`[[OwnPropertyKeys]]` ( )	내부 메서드 `[[OwnPropertyKeys]]`. 인수 없음. 반환값: (정상 완료 (값: 리스트 (요소: 프로퍼티 키)) 또는 throw 완료). 객체의 모든 자체 프로퍼티 키를 요소로 갖는 List를 반환합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.1.11 ordinary object 10.4.3.3 String exotic object 10.4.5.8 TypedArray 10.4.6.11 module namespace exotic object 10.5.11 Proxy exotic object

표 5에는 함수로 호출될 수 있는 객체가 지원하는 추가 필수 내부 메서드가 요약되어 있습니다. 함수 객체는 [[Call]] 내부 메서드를 지원하는 객체입니다. 생성자는 [[Construct]] 내부 메서드를 지원하는 객체입니다. [[Construct]]를 지원하는 모든 객체는 [[Call]]도 지원해야 합니다. 즉, 모든 생성자는 함수 객체여야 합니다. 따라서 생성자는 생성자 함수 또는 생성자 함수 객체라고도 할 수 있습니다.

표 5: 함수 객체의 추가 필수 내부 메서드

내부 메서드	설명	정의
`[[Call]]` ( `thisArg`, `argList` )	내부 메서드 `[[Call]]`. 인수 `thisArg` (ECMAScript 언어 값) 및 `argList` (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 이 객체와 연결된 코드를 실행합니다. 함수 호출 표현식을 통해 호출됩니다. 내부 메서드의 인수는 this 값과, 호출 표현식이 함수에 전달한 인수를 요소로 갖는 List입니다. 이 내부 메서드를 구현하는 객체는 호출 가능합니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.2.1 ECMAScript function object 10.3.1 built-in function object 10.4.1.1 bound function exotic object 10.5.12 Proxy exotic object
`[[Construct]]` ( `argList`, `newTarget` )	내부 메서드 `[[Construct]]`. 인수 `argList` (리스트 (요소: ECMAScript 언어 값)) 및 `newTarget` (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 객체를 생성합니다. `new` 연산자 또는 `super` 호출을 통해 호출됩니다. 내부 메서드의 첫 번째 인수는 생성자 호출 또는 `super` 호출의 인수를 요소로 갖는 List입니다. 두 번째 인수는 처음에 `new` 연산자가 적용된 객체입니다. 이 내부 메서드를 구현하는 객체를 생성자라고 합니다. 함수 객체가 반드시 생성자인 것은 아니며, 이러한 생성자가 아닌 함수 객체에는 `[[Construct]]` 내부 메서드가 없습니다.	이 명세에서는 다음 타입에 정의되어 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 10.2.2 ECMAScript function object 10.3.2 built-in function object 10.4.1.2 bound function exotic object 10.5.13 Proxy exotic object

일반 객체와 표준 특수 객체의 필수 내부 메서드 의미론은 10 절에 명시되어 있습니다. 특수 객체의 내부 메서드를 명시된 방식으로 사용하는 것을 구현체가 지원하지 않는 경우, 해당 사용을 시도하면 TypeError 예외를 던져야 합니다.

6.1.7.3 필수 내부 메서드의 불변 조건

ECMAScript 엔진의 Object 내부 메서드는 아래에 명시된 불변 조건 목록을 준수해야 합니다. 일반 ECMAScript Object와 이 명세의 모든 표준 특수 객체는 이러한 불변 조건을 유지합니다. ECMAScript Proxy 객체는 [[ProxyHandler]] 객체에서 호출된 트랩의 결과에 대한 런타임 검사를 통해 이러한 불변 조건을 유지합니다.

구현체가 제공하는 모든 특수 객체도 해당 객체에 대해 이러한 불변 조건을 유지해야 합니다. 이러한 불변 조건을 위반하면 ECMAScript 코드가 예측할 수 없는 동작을 하거나 보안 문제를 일으킬 수 있습니다. 그러나 이러한 불변 조건의 위반으로 구현체의 메모리 안전성이 손상되어서는 안 됩니다.

구현체는 불변 조건을 강제하지 않은 채 필수 내부 메서드의 기능을 구현하는 대체 인터페이스를 제공하는 등의 방법으로 이러한 불변 조건을 우회할 수 있게 해서는 안 됩니다.

정의:

내부 메서드의 대상은 해당 내부 메서드가 호출되는 객체입니다.
[[IsExtensible]] 내부 메서드에서 false를 반환한 것이 관찰되었거나 [[PreventExtensions]] 내부 메서드에서 true를 반환한 것이 관찰된 대상은 확장 불가능합니다.
존재하지 않는 프로퍼티는 확장 불가능한 대상에 자체 프로퍼티로 존재하지 않는 프로퍼티입니다.
SameValue에 대한 모든 참조는 SameValue 알고리즘의 정의를 따릅니다.

반환값:

모든 내부 메서드가 반환하는 값은 다음 중 하나인 Completion Record여야 합니다:

[[Type]] = normal, [[Target]] = empty, 그리고 [[Value]] = 해당 내부 메서드에 대해 아래에 표시된 “정상 반환 타입”의 값, 또는
[[Type]] = throw, [[Target]] = empty, 그리고 [[Value]] = 임의의 ECMAScript 언어 값.

참고 1

내부 메서드는 continue 완료, break 완료 또는 return 완료를 반환해서는 안 됩니다.

`[[GetPrototypeOf]]` ( )

정상 반환 타입은 Object 또는 Null입니다.
대상이 확장 불가능하고 [[GetPrototypeOf]]가 값 proto를 반환하면, 이후 [[GetPrototypeOf]]의 모든 호출은 proto와 SameValue인 값을 반환해야 합니다.

참고 2

객체의 프로토타입 체인은 유한한 길이를 가져야 합니다(즉, 임의의 객체에서 시작하여 [[GetPrototypeOf]] 내부 메서드를 그 결과에 재귀적으로 적용하면 결국 null 값에 도달해야 합니다). 그러나 프로토타입 체인에 [[GetPrototypeOf]]의 일반 객체 정의를 사용하지 않는 특수 객체가 포함되어 있으면 이 요구 사항을 객체 수준의 불변 조건으로 강제할 수 없습니다. 이러한 순환 프로토타입 체인은 객체 프로퍼티에 접근할 때 무한 루프를 일으킬 수 있습니다.

`[[SetPrototypeOf]]` ( `proto` )

정상 반환 타입은 Boolean입니다.
대상이 확장 불가능하면 proto가 대상에서 관찰된 [[GetPrototypeOf]] 값과 SameValue인 경우를 제외하고 [[SetPrototypeOf]]는 false를 반환해야 합니다.

`[[IsExtensible]]` ( )

정상 반환 타입은 Boolean입니다.
[[IsExtensible]]이 false를 반환하면 이후 대상에 대한 모든 [[IsExtensible]] 호출도 false를 반환해야 합니다.

`[[PreventExtensions]]` ( )

정상 반환 타입은 Boolean입니다.
[[PreventExtensions]]가 true를 반환하면 이후 대상에 대한 모든 [[IsExtensible]] 호출은 false를 반환해야 하며, 이제 대상은 확장 불가능한 것으로 간주됩니다.

`[[GetOwnProperty]]` ( `propertyKey` )

정상 반환 타입은 Property Descriptor 또는 Undefined입니다.
반환값이 Property Descriptor이면 모든 필드가 채워진 Property Descriptor여야 합니다.
propertyKey가 구성 불가능하고 쓰기 불가능한 자체 데이터 프로퍼티로 기술되었으면 이후 [[GetOwnProperty]] ( propertyKey )의 모든 호출은 [[Value]]가 propertyKey의 [[Value]] 속성과 SameValue인 Property Descriptor를 반환해야 합니다.
[[Writable]]과 [[Value]] 이외의 propertyKey 속성이 시간에 따라 변경될 수 있거나 프로퍼티가 삭제될 수 있다면 propertyKey의 [[Configurable]] 속성은 true여야 합니다.
[[Writable]] 속성이 false에서 true로 변경될 수 있다면 [[Configurable]] 속성은 true여야 합니다.
대상이 확장 불가능하고 propertyKey가 존재하지 않으면 이후 대상에 대한 모든 [[GetOwnProperty]] (propertyKey) 호출은 propertyKey가 존재하지 않는 것으로 기술해야 합니다(즉, [[GetOwnProperty]] (propertyKey)는 undefined를 반환해야 합니다).

참고 3

세 번째 불변 조건의 결과로, 프로퍼티가 데이터 프로퍼티로 기술되고 시간에 따라 서로 다른 값을 반환할 수 있다면 다른 필수 내부 메서드를 통해 값을 변경하는 메커니즘이 노출되지 않더라도 [[Writable]]과 [[Configurable]] 속성 중 하나 또는 둘 모두가 true여야 합니다.

`[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

정상 반환 타입은 Boolean입니다.
propertyKey가 이전에 대상의 구성 불가능한 자체 프로퍼티로 관찰되었으면 다음 중 하나에 해당하지 않는 한 [[DefineOwnProperty]]는 false를 반환해야 합니다:
1. propertyKey가 쓰기 가능한 데이터 프로퍼티입니다. 구성 불가능하면서 쓰기 가능한 데이터 프로퍼티는 구성 불가능하면서 쓰기 불가능한 데이터 프로퍼티로 변경할 수 있습니다.
2. propertyDesc의 모든 속성이 propertyKey의 속성과 SameValue입니다.
대상이 확장 불가능하고 propertyKey가 존재하지 않는 자체 프로퍼티이면 [[DefineOwnProperty]] (propertyKey, propertyDesc)는 false를 반환해야 합니다. 즉, 확장 불가능한 대상 객체는 새 프로퍼티로 확장할 수 없습니다.

`[[HasProperty]]` ( `propertyKey` )

정상 반환 타입은 Boolean입니다.
propertyKey가 이전에 대상의 구성 불가능한 자체 데이터 프로퍼티 또는 접근자 프로퍼티로 관찰되었으면 [[HasProperty]]는 true를 반환해야 합니다.

`[[Get]]` ( `propertyKey`, `receiver` )

정상 반환 타입은 임의의 ECMAScript 언어 타입입니다.
propertyKey가 이전에 값 value를 갖는 대상의 구성 불가능하고 쓰기 불가능한 자체 데이터 프로퍼티로 관찰되었으면 [[Get]]은 value와 SameValue인 값을 반환해야 합니다.
propertyKey가 이전에 [[Getter]] 속성이 undefined인 대상의 구성 불가능한 자체 접근자 프로퍼티로 관찰되었으면 [[Get]] 연산은 undefined를 반환해야 합니다.

`[[Set]]` ( `propertyKey`, `value`, `receiver` )

정상 반환 타입은 Boolean입니다.
propertyKey가 이전에 대상의 구성 불가능하고 쓰기 불가능한 자체 데이터 프로퍼티로 관찰되었으면 value가 propertyKey의 [[Value]] 속성과 SameValue인 경우를 제외하고 [[Set]]은 false를 반환해야 합니다.
propertyKey가 이전에 [[Setter]] 속성이 undefined인 대상의 구성 불가능한 자체 접근자 프로퍼티로 관찰되었으면 [[Set]] 연산은 false를 반환해야 합니다.

`[[Delete]]` ( `propertyKey` )

정상 반환 타입은 Boolean입니다.
propertyKey가 이전에 대상의 구성 불가능한 자체 데이터 프로퍼티 또는 접근자 프로퍼티로 관찰되었으면 [[Delete]]는 false를 반환해야 합니다.

`[[OwnPropertyKeys]]` ( )

정상 반환 타입은 List입니다.
반환된 List에는 중복 항목이 포함되어서는 안 됩니다.
반환된 List의 각 요소는 프로퍼티 키여야 합니다.
반환된 List에는 이전에 관찰된 모든 구성 불가능한 자체 프로퍼티의 키가 적어도 포함되어야 합니다.
대상이 확장 불가능하면 반환된 List에는 [[GetOwnProperty]]를 사용하여 관찰할 수 있는 대상의 모든 자체 프로퍼티 키만 포함되어야 합니다.

`[[Call]]` ( )

정상 반환 타입은 임의의 ECMAScript 언어 타입입니다.

`[[Construct]]` ( )

정상 반환 타입은 Object입니다.
대상에는 [[Call]] 내부 메서드도 있어야 합니다.

6.1.7.4 잘 알려진 내재 객체

잘 알려진 내재 객체는 이 명세의 알고리즘에서 명시적으로 참조되며 일반적으로 realm별 고유한 동일성을 갖는 내장 객체입니다. 달리 명시되지 않는 한 각 내재 객체는 실제로 realm마다 하나씩 존재하는 유사한 객체의 집합에 대응합니다.

이 명세에서 %name%과 같은 참조는 현재 realm과 연관되고 해당 이름에 대응하는 내재 객체를 의미합니다. %name.a.b%와 같은 참조는 ECMAScript 코드가 평가되기 전에 내재 객체 %name%의 "a" 프로퍼티 값의 "b" 프로퍼티에 접근한 것과 같은 의미입니다. 현재 realm과 그 내재 객체를 결정하는 방법은 9.4에 설명되어 있습니다. 잘 알려진 내재 객체는 표 6에 나열되어 있습니다.

표 6: 잘 알려진 내재 객체

내재 이름	전역 이름	ECMAScript 언어 연관 항목
%AggregateError%	"AggregateError"	`AggregateError` 생성자 (20.5.7.1)
%Array%	"Array"	`Array` 생성자 (23.1.1)
%ArrayBuffer%	"ArrayBuffer"	`ArrayBuffer` 생성자 (25.1.4)
%ArrayIteratorPrototype%		Array Iterator 객체의 프로토타입 (23.1.5)
%AsyncDisposableStack%	"AsyncDisposableStack"	`AsyncDisposableStack` 생성자 (27.4.1)
%AsyncFromSyncIteratorPrototype%		Async-from-Sync Iterator 객체의 프로토타입 (27.1.5)
%AsyncFunction%		비동기 함수 객체의 생성자 (27.10.1)
%AsyncGeneratorFunction%		비동기 제너레이터 함수 객체의 생성자 (27.7.1)
%AsyncGeneratorPrototype%		비동기 제너레이터 객체의 프로토타입 (27.9)
%AsyncIteratorPrototype%		모든 표준 내장 비동기 이터레이터 객체가 간접적으로 상속하는 객체
%Atomics%	"Atomics"	`Atomics` 객체 (25.4)
%BigInt%	"BigInt"	`BigInt` 생성자 (21.2.1)
%BigInt64Array%	"BigInt64Array"	`BigInt64Array` 생성자 (23.2)
%BigUint64Array%	"BigUint64Array"	`BigUint64Array` 생성자 (23.2)
%Boolean%	"Boolean"	`Boolean` 생성자 (20.3.1)
%DataView%	"DataView"	`DataView` 생성자 (25.3.2)
%Date%	"Date"	`Date` 생성자 (21.4.2)
%decodeURI%	"decodeURI"	`decodeURI` 함수 (19.2.6.1)
%decodeURIComponent%	"decodeURIComponent"	`decodeURIComponent` 함수 (19.2.6.2)
%DisposableStack%	"DisposableStack"	`DisposableStack` 생성자 (27.3.1)
%encodeURI%	"encodeURI"	`encodeURI` 함수 (19.2.6.3)
%encodeURIComponent%	"encodeURIComponent"	`encodeURIComponent` 함수 (19.2.6.4)
%Error%	"Error"	`Error` 생성자 (20.5.1)
%eval%	"eval"	`eval` 함수 (19.2.1)
%EvalError%	"EvalError"	`EvalError` 생성자 (20.5.5.1)
%FinalizationRegistry%	"FinalizationRegistry"	`FinalizationRegistry` 생성자 (26.2.1)
%Float16Array%	"Float16Array"	`Float16Array` 생성자 (23.2)
%Float32Array%	"Float32Array"	`Float32Array` 생성자 (23.2)
%Float64Array%	"Float64Array"	`Float64Array` 생성자 (23.2)
%ForInIteratorPrototype%		For-In Iterator 객체의 프로토타입 (14.7.5.10)
%Function%	"Function"	`Function` 생성자 (20.2.1)
%GeneratorFunction%		제너레이터 함수 객체의 생성자 (27.6.1)
%GeneratorPrototype%		제너레이터 객체의 프로토타입 (27.8)
%Int8Array%	"Int8Array"	`Int8Array` 생성자 (23.2)
%Int16Array%	"Int16Array"	`Int16Array` 생성자 (23.2)
%Int32Array%	"Int32Array"	`Int32Array` 생성자 (23.2)
%isFinite%	"isFinite"	`isFinite` 함수 (19.2.2)
%isNaN%	"isNaN"	`isNaN` 함수 (19.2.3)
%Iterator%	"Iterator"	`Iterator` 생성자 (27.1.3.1)
%IteratorHelperPrototype%		Iterator Helper 객체의 프로토타입 (27.1.2.1)
%JSON%	"JSON"	`JSON` 객체 (25.5)
%Map%	"Map"	`Map` 생성자 (24.1.1)
%MapIteratorPrototype%		Map Iterator 객체의 프로토타입 (24.1.5)
%Math%	"Math"	`Math` 객체 (21.3)
%Number%	"Number"	`Number` 생성자 (21.1.1)
%Object%	"Object"	`Object` 생성자 (20.1.1)
%parseFloat%	"parseFloat"	`parseFloat` 함수 (19.2.4)
%parseInt%	"parseInt"	`parseInt` 함수 (19.2.5)
%Promise%	"Promise"	`Promise` 생성자 (27.5.3)
%Proxy%	"Proxy"	`Proxy` 생성자 (28.2.1)
%RangeError%	"RangeError"	`RangeError` 생성자 (20.5.5.2)
%ReferenceError%	"ReferenceError"	`ReferenceError` 생성자 (20.5.5.3)
%Reflect%	"Reflect"	`Reflect` 객체 (28.1)
%RegExp%	"RegExp"	`RegExp` 생성자 (22.2.4)
%RegExpStringIteratorPrototype%		RegExp String Iterator 객체의 프로토타입 (22.2.9)
%Set%	"Set"	`Set` 생성자 (24.2.2)
%SetIteratorPrototype%		Set Iterator 객체의 프로토타입 (24.2.6)
%SharedArrayBuffer%	"SharedArrayBuffer"	`SharedArrayBuffer` 생성자 (25.2.3)
%String%	"String"	`String` 생성자 (22.1.1)
%StringIteratorPrototype%		String Iterator 객체의 프로토타입 (22.1.5)
%SuppressedError%	"SuppressedError"	`SuppressedError` 생성자 (20.5.8.1)
%Symbol%	"Symbol"	`Symbol` 생성자 (20.4.1)
%SyntaxError%	"SyntaxError"	`SyntaxError` 생성자 (20.5.5.4)
%ThrowTypeError%		무조건 %TypeError%의 새 인스턴스를 던지는 함수 객체
%TypedArray%		모든 typed Array 생성자의 상위 클래스 (23.2.1)
%TypeError%	"TypeError"	`TypeError` 생성자 (20.5.5.5)
%Uint8Array%	"Uint8Array"	`Uint8Array` 생성자 (23.2)
%Uint8ClampedArray%	"Uint8ClampedArray"	`Uint8ClampedArray` 생성자 (23.2)
%Uint16Array%	"Uint16Array"	`Uint16Array` 생성자 (23.2)
%Uint32Array%	"Uint32Array"	`Uint32Array` 생성자 (23.2)
%URIError%	"URIError"	`URIError` 생성자 (20.5.5.6)
%WeakMap%	"WeakMap"	`WeakMap` 생성자 (24.3.1)
%WeakRef%	"WeakRef"	`WeakRef` 생성자 (26.1.1)
%WeakSet%	"WeakSet"	`WeakSet` 생성자 (24.4.1)
%WrapForValidIteratorPrototype%		`Iterator.from`이 반환하는 래핑된 이터레이터 객체의 프로토타입 (27.1.3.2.2.1)

참고

표 103에 추가 항목이 있습니다.

6.2 ECMAScript 명세 타입

명세 타입은 ECMAScript 언어 구성 요소와 ECMAScript 언어 타입의 의미론을 설명하기 위해 알고리즘 내에서 사용하는 메타 값에 대응합니다. 명세 타입에는 Reference Record, List, Completion Record, Property Descriptor, Environment Record, Abstract Closure 및 Data Block이 포함됩니다. 명세 타입 값은 ECMAScript 구현체 내의 특정 개체와 반드시 대응하지는 않는 명세상의 구성 요소입니다. 명세 타입 값은 ECMAScript 표현식 평가의 중간 결과를 설명하는 데 사용할 수 있지만, 이러한 값은 객체의 프로퍼티나 ECMAScript 언어 변수의 값으로 저장할 수 없습니다.

6.2.1 Enum 명세 타입

Enum은 명세 내부에서 사용되며 ECMAScript 코드에서 직접 관찰할 수 없는 값입니다. Enum은 산세리프체를 사용하여 대문자 케밥 표기법으로 나타냅니다. 예를 들어 Completion Record의 [[Type]] 필드는 normal, return 또는 throw와 같은 값을 가집니다. Enum에는 이름 이외의 특성이 없습니다. Enum의 이름은 다른 Enum과 구별하는 것 이외의 목적은 없으며, 문맥에서의 용도나 의미에 대해서는 아무것도 암시하지 않습니다.

6.2.2 List 및 Record 명세 타입

List 타입은 new 표현식, 함수 호출 및 단순한 순서 있는 값 목록이 필요한 기타 알고리즘에서 인수 목록의 평가(13.3.8 참조)를 설명하는 데 사용됩니다. List 타입의 값은 개별 값을 포함하는 목록 요소의 단순한 순서 있는 시퀀스입니다. 이러한 시퀀스는 임의의 길이를 가질 수 있습니다. 목록의 요소는 0부터 시작하는 인덱스를 사용하여 임의 접근할 수 있습니다. 표기상의 편의를 위해 배열과 유사한 구문을 사용하여 List 요소에 접근할 수 있습니다. 예를 들어 args[2]는 List args의 3^번째 요소를 나타내는 축약 표현입니다.

알고리즘이 순서를 지정하지 않고 List의 요소를 반복 처리하는 경우, List 내의 요소 순서를 사용합니다.

이 명세에서는 표기상의 편의를 위해 리터럴 구문을 사용하여 새로운 List 값을 표현할 수 있습니다. 예를 들어 « 1, 2 »는 각각 특정 값으로 초기화된 두 개의 요소를 갖는 List 값을 정의합니다. 새로운 빈 List는 « »로 표현할 수 있습니다.

이 명세에서 “A, B, ...의 목록 연결”이라는 문구(각 인수는 비어 있을 수도 있는 List입니다)는 각 인수의 요소를 인수 순서대로 연결한 요소를 갖는 새로운 List 값을 나타냅니다.

String의 List에 적용할 때 “사전식 코드 단위 순서에 따라 정렬”이라는 문구는 더 짧은 문자열의 길이까지 각 코드 단위의 숫자 값으로 정렬하고, 모든 값이 같으면 더 짧은 문자열을 더 긴 문자열보다 앞에 정렬하는 것을 의미하며, 이는 추상 연산 IsLessThan에 설명되어 있습니다.

Record 타입은 이 명세의 알고리즘 내에서 데이터 집합을 설명하는 데 사용됩니다. Record 타입 값은 하나 이상의 이름 있는 필드로 구성됩니다. 각 필드의 값은 ECMAScript 언어 값 또는 명세 값입니다. 필드 이름은 항상 이중 대괄호로 둘러싸며, 예를 들어 [[Value]]와 같습니다.

이 명세에서는 표기상의 편의를 위해 객체 리터럴과 유사한 구문을 사용하여 Record를 표현할 수 있습니다. 예를 들어 { [[Field1]]: 42, [[Field2]]: false, [[Field3]]: empty }는 각각 특정 값으로 초기화된 세 개의 필드를 갖는 Record를 정의합니다. 필드 이름의 순서는 중요하지 않습니다. 명시적으로 나열되지 않은 모든 필드는 존재하지 않는 것으로 간주됩니다.

명세 텍스트와 알고리즘에서는 점 표기법을 사용하여 Record의 특정 필드를 참조할 수 있습니다. 예를 들어 R이 이전 단락에 표시된 Record라면 R.[[Field2]]는 “이름이 [[Field2]]인 R의 필드”를 나타내는 축약 표현입니다.

자주 사용되는 Record 필드 조합의 스키마에는 이름을 지정할 수 있으며, 해당 이름을 리터럴 Record의 접두사로 사용하여 설명 중인 특정 종류의 집합을 식별할 수 있습니다. 예: PropertyDescriptor { [[Value]]: 42, [[Writable]]: false, [[Configurable]]: true }.

6.2.3 Set 및 Relation 명세 타입

Set 타입은 메모리 모델에서 사용하는 순서 없는 요소의 컬렉션을 설명하는 데 사용됩니다. 이는 같은 이름의 ECMAScript 컬렉션 타입과 구별됩니다. 모호함을 피하기 위해 이 명세에서는 ECMAScript 컬렉션의 인스턴스를 일관되게 “Set 객체”라고 합니다. Set 타입의 값은 요소의 단순한 컬렉션이며, 동일한 요소가 두 번 이상 나타나지 않습니다. Set에 요소를 추가하거나 제거할 수 있습니다. Set은 서로 합집합, 교집합 또는 차집합을 구할 수 있습니다.

Relation 타입은 Set에 대한 제약 조건을 설명하는 데 사용됩니다. Relation 타입의 값은 해당 값 영역의 값들로 이루어진 순서쌍의 Set입니다. 예를 들어 Memory 이벤트에 대한 Relation은 Memory 이벤트의 순서쌍으로 이루어진 집합입니다. Relation R과 R의 값 영역에 있는 두 값 a와 b에 대해 a R b는 순서쌍 (a, b)가 R의 구성원임을 나타내는 축약 표현입니다. 어떤 조건에 대해 Relation이 해당 조건을 만족하는 가장 작은 Relation이면 이를 최소 Relation이라고 합니다.

엄격 부분 순서는 다음을 만족하는 Relation 값 R입니다.

R의 영역에 있는 모든 a, b 및 c에 대해:
- a R a가 성립하지 않으며,
- a R b이고 b R c이면, a R c입니다.

참고 1

위의 두 특성을 각각 비반사성과 추이성이라고 합니다.

엄격 전순서는 다음을 만족하는 Relation 값 R입니다.

R의 영역에 있는 모든 a, b 및 c에 대해:
- a가 b이거나 a R b이거나 b R a이며,
- a R a가 성립하지 않으며,
- a R b이고 b R c이면, a R c입니다.

참고 2

위의 세 특성을 각각 전성, 비반사성 및 추이성이라고 합니다.

6.2.4 Completion Record 명세 타입

Completion Record 명세 타입은 비국소적인 제어 이전을 수행하는 문(break, continue, return 및 throw)의 동작과 같은 값 및 제어 흐름의 런타임 전파를 설명하는 데 사용됩니다.

Completion Record에는 표 7에 정의된 필드가 있습니다.

표 7: Completion Record 필드

필드 이름	값	의미
`[[Type]]`	normal, break, continue, return 또는 throw	발생한 완료의 타입입니다.
`[[Value]]`	Completion Record를 제외한 임의의 값	생성된 값입니다.
`[[Target]]`	String 또는 empty	지시된 제어 이전의 대상 레이블입니다.

Completion Record를 참조하기 위해 다음 축약 용어를 사용하는 경우가 있습니다.

정상 완료는 [[Type]] 값이 normal인 모든 Completion Record를 가리킵니다.
break 완료는 [[Type]] 값이 break인 모든 Completion Record를 가리킵니다.
continue 완료는 [[Type]] 값이 continue인 모든 Completion Record를 가리킵니다.
return 완료는 [[Type]] 값이 return인 모든 Completion Record를 가리킵니다.
throw 완료는 [[Type]] 값이 throw인 모든 Completion Record를 가리킵니다.
비정상 완료는 [[Type]] 값이 normal이 아닌 모든 Completion Record를 가리킵니다.
어떤 타입의 값을 포함하는 정상 완료는 [[Value]] 필드에 해당 타입의 값을 갖는 정상 완료를 가리킵니다.

이 명세에서 정의한 호출 가능 객체는 정상 완료 또는 throw 완료만 반환합니다. 그 밖의 종류의 Completion Record를 반환하는 것은 편집 오류로 간주됩니다.

구현체 정의 호출 가능 객체는 정상 완료 또는 throw 완료 중 하나를 반환해야 합니다.

6.2.4.1 NormalCompletion ( `value` )

추상 연산 NormalCompletion. 인수 value (Completion Record를 제외한 임의의 값). 반환값: 정상 완료. 호출되면 다음 단계를 수행한다.

Completion Record { [[Type]]: normal, [[Value]]: value, [[Target]]: empty }를 반환합니다.

6.2.4.2 ThrowCompletion ( `value` )

추상 연산 ThrowCompletion. 인수 value (ECMAScript 언어 값). 반환값: throw 완료. 호출되면 다음 단계를 수행한다.

Completion Record { [[Type]]: throw, [[Value]]: value, [[Target]]: empty }를 반환합니다.

6.2.4.3 ReturnCompletion ( `value` )

추상 연산 ReturnCompletion. 인수 value (ECMAScript 언어 값). 반환값: return 완료. 호출되면 다음 단계를 수행한다.

Completion Record { [[Type]]: return, [[Value]]: value, [[Target]]: empty }를 반환합니다.

6.2.4.4 UpdateEmpty ( `completionRecord`, `value` )

추상 연산 UpdateEmpty. 인수 completionRecord (Completion 레코드) 및 value (Completion Record를 제외한 임의의 값). 반환값: Completion 레코드. 호출되면 다음 단계를 수행한다.

단언: completionRecord가 return 완료 또는 throw 완료이면, completionRecord.[[Value]]는 empty가 아닙니다.
completionRecord.[[Value]]가 empty가 아니면, ? completionRecord를 반환합니다.
Completion Record { [[Type]]: completionRecord.[[Type]], [[Value]]: value, [[Target]]: completionRecord.[[Target]] }를 반환합니다.

6.2.5 Reference Record 명세 타입

Reference Record 타입은 delete, typeof, 할당 연산자, super 키워드 및 기타 언어 기능과 같은 연산자의 동작을 설명하는 데 사용됩니다. 예를 들어 할당의 왼쪽 피연산자는 Reference Record를 생성할 것으로 예상됩니다.

Reference Record는 해석된 이름 또는 (아직 해석되지 않았을 수도 있는) 프로퍼티 바인딩이며, 해당 필드는 표 8에 정의되어 있습니다.

표 8: Reference Record 필드

필드 이름	값	의미
`[[Base]]`	ECMAScript 언어 값, Environment Record 또는 unresolvable	바인딩을 보유하는 값 또는 Environment Record입니다. `[[Base]]`가 unresolvable이면 바인딩을 해석할 수 없었음을 나타냅니다.
`[[ReferencedName]]`	ECMAScript 언어 값 또는 Private Name	바인딩의 이름입니다. `[[Base]]` 값이 Environment Record이면 항상 String입니다. 그렇지 않으면 ToPropertyKey를 수행할 때까지 String이나 Symbol 이외의 ECMAScript 언어 값일 수도 있습니다.
`[[Strict]]`	Boolean	Reference Record가 엄격 모드 코드에서 유래했으면 true이고, 그렇지 않으면 false입니다.
`[[ThisValue]]`	ECMAScript 언어 값 또는 empty	empty가 아니면 Reference Record는 `super` 키워드를 사용하여 표현한 프로퍼티 바인딩을 나타냅니다. 이를 Super Reference Record라고 하며, 해당 `[[Base]]` 값은 절대로 Environment Record가 아닙니다. 이 경우 `[[ThisValue]]` 필드는 Reference Record가 생성된 시점의 this 값을 보유합니다.

이 명세에서는 Reference Record에 대해 연산하기 위해 다음 추상 연산을 사용합니다:

6.2.5.1 IsPropertyReference ( `refRecord` )

추상 연산 IsPropertyReference. 인수 refRecord (Reference 레코드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

refRecord.[[Base]]가 unresolvable이면, false를 반환합니다.
refRecord.[[Base]]가 Environment Record이면, false를 반환합니다.
true를 반환합니다.

6.2.5.2 IsUnresolvableReference ( `refRecord` )

추상 연산 IsUnresolvableReference. 인수 refRecord (Reference 레코드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

refRecord.[[Base]]가 unresolvable이면, true를 반환합니다.
false를 반환합니다.

6.2.5.3 IsSuperReference ( `refRecord` )

추상 연산 IsSuperReference. 인수 refRecord (Reference 레코드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

refRecord.[[ThisValue]]가 empty이면, false를 반환합니다.
true를 반환합니다.

6.2.5.4 IsPrivateReference ( `refRecord` )

추상 연산 IsPrivateReference. 인수 refRecord (Reference 레코드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

refRecord.[[ReferencedName]]이 Private Name이면, true를 반환합니다.
false를 반환합니다.

6.2.5.5 GetValue ( `refRecord` )

추상 연산 GetValue. 인수 refRecord (Reference Record 또는 ECMAScript 언어 값). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 호출되면 다음 단계를 수행한다.

refRecord가 Reference Record가 아니면, refRecord를 반환합니다.
IsUnresolvableReference(refRecord)가 true이면, ReferenceError 예외를 던집니다.
IsPropertyReference(refRecord)가 true이면, 다음을 수행합니다.
1. baseObj를 ? ToObject(refRecord.[[Base]])로 둡니다.
2. IsPrivateReference(refRecord)가 true이면, 다음을 수행합니다.
  1. ? PrivateGet(baseObj, refRecord.[[ReferencedName]])을 반환합니다.
3. refRecord.[[ReferencedName]]이 프로퍼티 키가 아니면, 다음을 수행합니다.
  1. refRecord.[[ReferencedName]]을 ? ToPropertyKey(refRecord.[[ReferencedName]])로 설정합니다.
4. ? baseObj.[[Get]](refRecord.[[ReferencedName]], GetThisValue(refRecord))를 반환합니다.
base를 refRecord.[[Base]]로 둡니다.
단언: base는 Environment Record입니다.
? base.GetBindingValue(refRecord.[[ReferencedName]], refRecord.[[Strict]])를 반환합니다(9.1 참조).

참고

3.a 단계에서 생성될 수 있는 객체에는 위 추상 연산과 일반 객체 [[Get]] 내부 메서드 외부에서 접근할 수 없습니다. 구현체는 실제 객체 생성을 피하도록 선택할 수도 있습니다.

6.2.5.6 PutValue ( `refRecord`, `value` )

추상 연산 PutValue. 인수 refRecord (Reference Record 또는 ECMAScript 언어 값) 및 value (ECMAScript 언어 값). 반환값: unused를 포함하는 정상 완료 또는 비정상 완료. 호출되면 다음 단계를 수행한다.

refRecord가 Reference Record가 아니면, ReferenceError 예외를 던집니다.
IsUnresolvableReference(refRecord)가 true이면, 다음을 수행합니다.
1. refRecord.[[Strict]]가 true이면, ReferenceError 예외를 던집니다.
2. globalObj를 GetGlobalObject()로 둡니다.
3. ? Set(globalObj, refRecord.[[ReferencedName]], value, false)를 수행합니다.
4. unused를 반환합니다.
IsPropertyReference(refRecord)가 true이면, 다음을 수행합니다.
1. baseObj를 ? ToObject(refRecord.[[Base]])로 둡니다.
2. IsPrivateReference(refRecord)가 true이면, 다음을 수행합니다.
  1. ? PrivateSet(baseObj, refRecord.[[ReferencedName]], value)를 반환합니다.
3. refRecord.[[ReferencedName]]이 프로퍼티 키가 아니면, 다음을 수행합니다.
  1. refRecord.[[ReferencedName]]을 ? ToPropertyKey(refRecord.[[ReferencedName]])로 설정합니다.
4. succeeded를 ? baseObj.[[Set]](refRecord.[[ReferencedName]], value, GetThisValue(refRecord))로 둡니다.
5. succeeded가 false이고 refRecord.[[Strict]]가 true이면, TypeError 예외를 던집니다.
6. unused를 반환합니다.
base를 refRecord.[[Base]]로 둡니다.
단언: base는 Environment Record입니다.
? base.SetMutableBinding(refRecord.[[ReferencedName]], value, refRecord.[[Strict]])를 반환합니다(9.1 참조).

참고

3.a 단계에서 생성될 수 있는 객체에는 위 추상 연산과 일반 객체 [[Set]] 내부 메서드 외부에서 접근할 수 없습니다. 구현체는 해당 객체의 실제 생성을 피하도록 선택할 수도 있습니다.

6.2.5.7 GetThisValue ( `refRecord` )

추상 연산 GetThisValue. 인수 refRecord (Reference 레코드). 반환값: ECMAScript 언어 값. 호출되면 다음 단계를 수행한다.

단언: IsPropertyReference(refRecord)는 true입니다.
IsSuperReference(refRecord)가 true이면, refRecord.[[ThisValue]]를 반환합니다.
refRecord.[[Base]]를 반환합니다.

6.2.5.8 InitializeReferencedBinding ( `refRecord`, `value` )

추상 연산 InitializeReferencedBinding. 인수 refRecord (Reference 레코드) 및 value (ECMAScript 언어 값). 반환값: unused를 포함하는 정상 완료 또는 비정상 완료. 호출되면 다음 단계를 수행한다.

단언: IsUnresolvableReference(refRecord)는 false입니다.
base를 refRecord.[[Base]]로 둡니다.
단언: base는 Environment Record입니다.
? base.InitializeBinding(refRecord.[[ReferencedName]], value)을 반환합니다.

6.2.5.9 MakePrivateReference ( `baseValue`, `privateIdentifier` )

추상 연산 MakePrivateReference. 인수 baseValue (ECMAScript 언어 값) 및 privateIdentifier (String). 반환값: Reference 레코드. 호출되면 다음 단계를 수행한다.

privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
단언: privateEnv는 null이 아닙니다.
privateName을 ResolvePrivateIdentifier(privateEnv, privateIdentifier)로 둡니다.
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: privateName, [[Strict]]: true, [[ThisValue]]: empty }를 반환합니다.

6.2.6 Property Descriptor 명세 타입

Property Descriptor 타입은 Object 프로퍼티 속성의 조작과 구체화를 설명하는 데 사용됩니다. Property Descriptor는 0개 이상의 필드를 갖는 Record이며, 각 필드의 이름은 속성 이름이고 값은 6.1.7.1에 명시된 대응하는 속성 값입니다. 이 명세에서 Property Descriptor Record의 리터럴 설명에 태그를 지정하는 데 사용하는 스키마 이름은 “PropertyDescriptor”입니다.

Property Descriptor 값은 특정 필드의 존재 여부 또는 사용에 따라 데이터 Property Descriptor와 접근자 Property Descriptor로 더 분류할 수 있습니다. 데이터 Property Descriptor는 [[Value]] 또는 [[Writable]]이라는 이름의 필드를 하나라도 포함하는 Property Descriptor입니다. 접근자 Property Descriptor는 [[Getter]] 또는 [[Setter]]라는 이름의 필드를 하나라도 포함하는 Property Descriptor입니다. 모든 Property Descriptor에는 [[Enumerable]] 및 [[Configurable]]이라는 이름의 필드가 있을 수 있습니다. Property Descriptor 값은 데이터 Property Descriptor이면서 동시에 접근자 Property Descriptor일 수 없습니다. 그러나 둘 다 아닐 수는 있습니다(이 경우 일반 Property Descriptor입니다). 모든 필드가 채워진 Property Descriptor는 접근자 Property Descriptor 또는 데이터 Property Descriptor 중 하나이면서 표 3에 정의된 해당 필드를 모두 갖는 Property Descriptor입니다.

이 명세에서는 Property Descriptor 값에 대해 연산하기 위해 다음 추상 연산을 사용합니다:

6.2.6.1 IsAccessorDescriptor ( `propertyDesc` )

추상 연산 IsAccessorDescriptor. 인수 propertyDesc (프로퍼티 서술자). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

propertyDesc에 [[Getter]] 필드가 있으면, true를 반환합니다.
propertyDesc에 [[Setter]] 필드가 있으면, true를 반환합니다.
false를 반환합니다.

6.2.6.2 IsDataDescriptor ( `propertyDesc` )

추상 연산 IsDataDescriptor. 인수 propertyDesc (프로퍼티 서술자). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

propertyDesc에 [[Value]] 필드가 있으면, true를 반환합니다.
propertyDesc에 [[Writable]] 필드가 있으면, true를 반환합니다.
false를 반환합니다.

6.2.6.3 IsGenericDescriptor ( `propertyDesc` )

추상 연산 IsGenericDescriptor. 인수 propertyDesc (프로퍼티 서술자). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

IsAccessorDescriptor(propertyDesc)가 true이면, false를 반환합니다.
IsDataDescriptor(propertyDesc)가 true이면, false를 반환합니다.
true를 반환합니다.

6.2.6.4 FromPropertyDescriptor ( `propertyDesc` )

추상 연산 FromPropertyDescriptor. 인수 propertyDesc (Property Descriptor 또는 undefined). 반환값: Object 또는 undefined. 호출되면 다음 단계를 수행한다.

propertyDesc가 undefined이면, undefined를 반환합니다.
obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
단언: obj는 자체 프로퍼티가 없는 확장 가능한 일반 객체입니다.
propertyDesc에 [[Value]] 필드가 있으면, 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(obj, "value", propertyDesc.[[Value]])를 수행합니다.
propertyDesc에 [[Writable]] 필드가 있으면, 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(obj, "writable", propertyDesc.[[Writable]])를 수행합니다.
propertyDesc에 [[Getter]] 필드가 있으면, 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(obj, "get", propertyDesc.[[Getter]])를 수행합니다.
propertyDesc에 [[Setter]] 필드가 있으면, 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(obj, "set", propertyDesc.[[Setter]])를 수행합니다.
propertyDesc에 [[Enumerable]] 필드가 있으면, 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(obj, "enumerable", propertyDesc.[[Enumerable]])를 수행합니다.
propertyDesc에 [[Configurable]] 필드가 있으면, 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(obj, "configurable", propertyDesc.[[Configurable]])를 수행합니다.
obj를 반환합니다.

6.2.6.5 ToPropertyDescriptor ( `obj` )

추상 연산 ToPropertyDescriptor. 인수 obj (ECMAScript 언어 값). 반환값: Property Descriptor를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

obj가 Object가 아니면, TypeError 예외를 던집니다.
propertyDesc를 처음에는 필드가 없는 새로운 Property Descriptor로 둡니다.
hasEnumerable을 ? HasProperty(obj, "enumerable")로 둡니다.
hasEnumerable이 true이면, 다음을 수행합니다.
1. enumerable을 ToBoolean(? Get(obj, "enumerable"))로 둡니다.
2. propertyDesc.[[Enumerable]]을 enumerable로 설정합니다.
hasConfigurable을 ? HasProperty(obj, "configurable")로 둡니다.
hasConfigurable이 true이면, 다음을 수행합니다.
1. configurable을 ToBoolean(? Get(obj, "configurable"))로 둡니다.
2. propertyDesc.[[Configurable]]을 configurable로 설정합니다.
hasValue를 ? HasProperty(obj, "value")로 둡니다.
hasValue가 true이면, 다음을 수행합니다.
1. value를 ? Get(obj, "value")로 둡니다.
2. propertyDesc.[[Value]]를 value로 설정합니다.
hasWritable을 ? HasProperty(obj, "writable")로 둡니다.
hasWritable이 true이면, 다음을 수행합니다.
1. writable을 ToBoolean(? Get(obj, "writable"))로 둡니다.
2. propertyDesc.[[Writable]]을 writable로 설정합니다.
hasGet을 ? HasProperty(obj, "get")로 둡니다.
hasGet이 true이면, 다음을 수행합니다.
1. getter를 ? Get(obj, "get")로 둡니다.
2. IsCallable(getter)이 false이고 getter가 undefined가 아니면, TypeError 예외를 던집니다.
3. propertyDesc.[[Getter]]를 getter로 설정합니다.
hasSet을 ? HasProperty(obj, "set")로 둡니다.
hasSet이 true이면, 다음을 수행합니다.
1. setter를 ? Get(obj, "set")로 둡니다.
2. IsCallable(setter)이 false이고 setter가 undefined가 아니면, TypeError 예외를 던집니다.
3. propertyDesc.[[Setter]]를 setter로 설정합니다.
propertyDesc에 [[Getter]] 필드가 있거나 propertyDesc에 [[Setter]] 필드가 있으면, 다음을 수행합니다.
1. propertyDesc에 [[Value]] 필드가 있거나 propertyDesc에 [[Writable]] 필드가 있으면, TypeError 예외를 던집니다.
propertyDesc를 반환합니다.

6.2.6.6 CompletePropertyDescriptor ( `propertyDesc` )

추상 연산 CompletePropertyDescriptor. 인수 propertyDesc (프로퍼티 서술자). 반환값: unused. 호출되면 다음 단계를 수행한다.

like를 Record { [[Value]]: undefined, [[Writable]]: false, [[Getter]]: undefined, [[Setter]]: undefined, [[Enumerable]]: false, [[Configurable]]: false }로 둡니다.
IsGenericDescriptor(propertyDesc)가 true이거나 IsDataDescriptor(propertyDesc)가 true이면, 다음을 수행합니다.
1. propertyDesc에 [[Value]] 필드가 없으면, propertyDesc.[[Value]]를 like.[[Value]]로 설정합니다.
2. propertyDesc에 [[Writable]] 필드가 없으면, propertyDesc.[[Writable]]을 like.[[Writable]]로 설정합니다.
그렇지 않으면,
1. propertyDesc에 [[Getter]] 필드가 없으면, propertyDesc.[[Getter]]를 like.[[Getter]]로 설정합니다.
2. propertyDesc에 [[Setter]] 필드가 없으면, propertyDesc.[[Setter]]를 like.[[Setter]]로 설정합니다.
propertyDesc에 [[Enumerable]] 필드가 없으면, propertyDesc.[[Enumerable]]을 like.[[Enumerable]]로 설정합니다.
propertyDesc에 [[Configurable]] 필드가 없으면, propertyDesc.[[Configurable]]을 like.[[Configurable]]로 설정합니다.
unused를 반환합니다.

6.2.7 Environment Record 명세 타입

Environment Record 타입은 중첩 함수와 블록에서 이름 해석의 동작을 설명하는 데 사용됩니다. 이 타입과 이에 대한 연산은 9.1에 정의되어 있습니다.

6.2.8 Abstract Closure 명세 타입

Abstract Closure 명세 타입은 알고리즘 단계와 값의 컬렉션을 함께 참조하는 데 사용됩니다. Abstract Closure는 메타 값이며 closure(arg1, arg2)와 같은 함수 적용 형식을 사용하여 호출합니다. 추상 연산과 마찬가지로 호출하면 Abstract Closure에 기술된 알고리즘 단계를 수행합니다.

Abstract Closure를 생성하는 알고리즘 단계에서는 “capture” 동사 뒤에 별칭 목록을 사용하여 값을 캡처합니다. Abstract Closure가 생성되면 해당 시점에 각 별칭과 연결된 값을 캡처합니다. Abstract Closure가 호출될 때 수행할 알고리즘을 명시하는 단계에서는 캡처된 각 값을 캡처할 때 사용한 별칭으로 참조합니다.

Abstract Closure가 Completion Record를 반환하는 경우, 해당 Completion Record는 정상 완료 또는 throw 완료 중 하나여야 합니다.

Abstract Closure는 다음 예에 표시된 것처럼 다른 알고리즘의 일부로 인라인 생성됩니다.

addend를 41로 둡니다.
closure를 매개변수 (x)를 갖고 addend를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. x + addend를 반환합니다.
value를 closure(1)로 둡니다.
단언: value는 42입니다.

6.2.9 데이터 블록

Data Block 명세 타입은 바이트 크기(8비트)의 숫자 값으로 이루어진 독립적이고 변경 가능한 시퀀스를 설명하는 데 사용됩니다. 바이트 값은 0부터 255까지의 닫힌 구간에 있는 정수입니다. Data Block 값은 고정된 개수의 바이트로 생성되며 각 바이트의 초기값은 0입니다.

이 명세에서는 표기상의 편의를 위해 배열과 유사한 구문을 사용하여 Data Block 값의 개별 바이트에 접근할 수 있습니다. 이 표기법은 Data Block 값을 0부터 시작하는 바이트의 정수 인덱스 시퀀스로 나타냅니다. 예를 들어 dataBlock이 5바이트 Data Block 값이면 dataBlock[2]를 사용하여 세 번째 바이트에 접근할 수 있습니다.

여러 에이전트가 동시에 참조할 수 있는 메모리에 존재하는 데이터 블록을 Shared Data Block이라고 합니다. Shared Data Block에는 Shared Data Block 값의 동등성 검사에 사용되는 주소 독립적 동일성이 있습니다. 즉, 블록이 어떤 프로세스에서 매핑되는 가상 주소에 연결되는 것이 아니라 블록이 나타내는 메모리 위치의 집합에 연결됩니다. 두 데이터 블록은 포함하는 위치 집합이 같을 때만 서로 같으며, 그렇지 않으면 서로 같지 않고 각 블록이 포함하는 위치 집합의 교집합은 비어 있습니다. 마지막으로 Shared Data Block은 Data Block과 구별할 수 있습니다.

Shared Data Block의 의미론은 메모리 모델에서 Shared Data Block 이벤트를 사용하여 정의됩니다. 아래의 추상 연산은 Shared Data Block 이벤트를 도입하고 평가 의미론과 메모리 모델의 이벤트 의미론 사이의 인터페이스 역할을 합니다. 이벤트는 후보 실행을 형성하며, 메모리 모델은 이를 필터로 처리합니다. 전체 의미론은 메모리 모델을 참조하시기 바랍니다.

Shared Data Block 이벤트는 메모리 모델에 정의된 Record로 모델링됩니다.

이 명세에서는 Data Block 값에 대해 연산하기 위해 다음 추상 연산을 사용합니다:

6.2.9.1 CreateByteDataBlock ( `size` )

추상 연산 CreateByteDataBlock. 인수 size (음이 아닌 정수). 반환값: Data Block을 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

size > 2⁵³ - 1이면, RangeError 예외를 던집니다.
dataBlock을 size바이트로 구성된 새로운 Data Block 값으로 둡니다. 그러한 Data Block을 생성할 수 없으면 RangeError 예외를 던집니다.
dataBlock의 모든 바이트를 0으로 설정합니다.
dataBlock을 반환합니다.

6.2.9.2 CreateSharedByteDataBlock ( `size` )

추상 연산 CreateSharedByteDataBlock. 인수 size (음이 아닌 정수). 반환값: Shared Data Block을 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

dataBlock을 size바이트로 구성된 새로운 Shared Data Block 값으로 둡니다. 그러한 Shared Data Block을 생성할 수 없으면 RangeError 예외를 던집니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
zero를 « 0 »으로 둡니다.
dataBlock의 각 인덱스 index에 대해 다음을 수행합니다.
1. WriteSharedMemory { [[Order]]: init, [[NoTear]]: true, [[Block]]: dataBlock, [[ByteIndex]]: index, [[ElementSize]]: 1, [[Payload]]: zero }를 eventsRecord.[[EventList]]에 추가합니다.
dataBlock을 반환합니다.

6.2.9.3 CopyDataBlockBytes ( `toBlock`, `toIndex`, `fromBlock`, `fromIndex`, `count` )

추상 연산 CopyDataBlockBytes. 인수 toBlock (Data Block 또는 Shared Data Block), toIndex (음이 아닌 정수), fromBlock (Data Block 또는 Shared Data Block), fromIndex (음이 아닌 정수) 및 count (음이 아닌 정수). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: fromBlock과 toBlock은 서로 다른 값입니다.
fromSize를 fromBlock의 바이트 수로 둡니다.
단언: fromIndex + count ≤ fromSize입니다.
toSize를 toBlock의 바이트 수로 둡니다.
단언: toIndex + count ≤ toSize입니다.
count > 0인 동안 다음을 반복합니다.
1. fromBlock이 Shared Data Block이면, 다음을 수행합니다.
  1. agentRecord를 주변 에이전트의 Agent Record로 둡니다.
  2. execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
  3. eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
  4. bytes를 비결정적으로 선택한 하나의 바이트 값만을 요소로 갖는 List로 둡니다.
  5. 참고: 구현체에서 bytes는 기반 하드웨어의 비원자적 읽기 명령 결과입니다. 비결정성은 약한 일관성을 가진 하드웨어에서 관찰 가능한 동작을 설명하기 위한 메모리 모델의 의미론적 규정입니다.
  6. readEvent를 ReadSharedMemory { [[Order]]: unordered, [[NoTear]]: true, [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 }로 둡니다.
  7. readEvent를 eventsRecord.[[EventList]]에 추가합니다.
  8. Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: bytes }를 execution.[[ChosenValues]]에 추가합니다.
  9. toBlock이 Shared Data Block이면, 다음을 수행합니다.
    1. WriteSharedMemory { [[Order]]: unordered, [[NoTear]]: true, [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes }를 eventsRecord.[[EventList]]에 추가합니다.
  10. 그렇지 않으면,
    1. toBlock[toIndex]를 bytes[0]으로 설정합니다.
2. 그렇지 않으면,
  1. 단언: toBlock은 Shared Data Block이 아닙니다.
  2. toBlock[toIndex]를 fromBlock[fromIndex]로 설정합니다.
3. toIndex를 toIndex + 1로 설정합니다.
4. fromIndex를 fromIndex + 1로 설정합니다.
5. count를 count - 1로 설정합니다.
unused를 반환합니다.

6.2.10 PrivateElement 명세 타입

PrivateElement 타입은 private 클래스 필드, 메서드 및 접근자의 명세에서 사용되는 Record입니다. private 요소는 Property Descriptor와 연결되지 않고 프로퍼티도 아니지만, 이를 참조하는 표현식의 런타임 의미론은 몇 가지 측면에서 구성 불가능한 프로퍼티의 런타임 의미론과 유사합니다(private 필드는 쓰기 가능한 데이터 프로퍼티와 유사하고, private 메서드는 쓰기 불가능한 데이터 프로퍼티와 유사하며, private 접근자는 접근자 프로퍼티와 유사합니다). 또한 대응하는 Record 필드는 유사한 목적으로 사용됩니다.

PrivateElement 타입의 값은 표 9에 의해 필드가 정의되는 Record입니다. 이러한 값을 PrivateElements라고 합니다.

표 9: PrivateElement 필드

필드 이름	이 필드가 존재하는 `[[Kind]]` 필드의 값	값	의미
`[[Key]]`	전체	Private Name	필드, 메서드 또는 접근자의 이름입니다.
`[[Kind]]`	전체	field, method 또는 accessor	요소의 종류입니다.
`[[Value]]`	field 및 method	ECMAScript 언어 값	필드의 값입니다.
`[[Getter]]`	accessor	함수 객체 또는 undefined	비공개 접근자의 getter입니다.
`[[Setter]]`	accessor	함수 객체 또는 undefined	비공개 접근자의 setter입니다.

6.2.11 ClassFieldDefinition Record 명세 타입

ClassFieldDefinition 타입은 클래스 필드의 명세에서 사용하는 Record입니다.

ClassFieldDefinition 타입의 값은 표 10에 의해 필드가 정의되는 Record입니다. 이러한 값을 ClassFieldDefinition Records라고 합니다.

표 10: ClassFieldDefinition Record 필드

필드 이름	값	의미
`[[Name]]`	Private Name, String 또는 Symbol	필드의 이름입니다.
`[[Initializer]]`	ECMAScript 함수 객체 또는 empty	필드의 이니셜라이저가 있는 경우 해당 이니셜라이저입니다.

6.2.12 Private Name

Private Name 명세 타입은 비공개 클래스 요소(필드, 메서드 또는 접근자)의 키를 나타내는 전역적으로 고유한 값(그 밖의 면에서 구별할 수 없더라도 다른 모든 Private Name과 서로 다른 값)을 설명하는 데 사용됩니다. 각 Private Name에는 String인 변경 불가능한 [[Description]] 내부 슬롯이 있습니다. Private Name은 PrivateFieldAdd 또는 PrivateMethodOrAccessorAdd를 사용하여 임의의 ECMAScript 객체에 설치할 수 있으며, 이후 PrivateGet과 PrivateSet을 사용하여 읽거나 쓸 수 있습니다.

6.2.13 ClassStaticBlockDefinition Record 명세 타입

ClassStaticBlockDefinition Record는 클래스 정적 초기화 블록의 실행 가능한 코드를 캡슐화하는 데 사용하는 Record입니다.

ClassStaticBlockDefinition Record에는 표 11에 나열된 필드가 있습니다.

표 11: ClassStaticBlockDefinition Record 필드

필드 이름	값	의미
`[[BodyFunction]]`	ECMAScript 함수 객체	클래스의 정적 초기화 중에 호출할 함수 객체입니다.

7 추상 연산

이러한 연산은 ECMAScript 언어의 일부가 아닙니다. ECMAScript 언어의 의미론을 명시하는 데 도움을 주기 위해서만 여기에서 정의합니다. 그 밖의 보다 특수한 추상 연산은 이 명세 전반에 걸쳐 정의되어 있습니다.

7.1 타입 변환

ECMAScript 언어는 필요에 따라 자동 타입 변환을 암묵적으로 수행합니다. 특정 구성 요소의 의미론을 명확히 하기 위해 변환 추상 연산의 집합을 정의하는 것이 유용합니다. 변환 추상 연산은 다형적이며 모든 ECMAScript 언어 타입의 값을 받을 수 있습니다. 그러나 이러한 연산에는 다른 명세 타입을 사용하지 않습니다.

BigInt 타입에는 ECMAScript 언어의 암묵적 변환이 없습니다. 프로그래머는 다른 타입의 값을 변환하려면 BigInt를 명시적으로 호출해야 합니다.

7.1.1 ToPrimitive ( `input` [ , `preferredType` ] )

추상 연산 ToPrimitive. 인수 input (ECMAScript 언어 값) 및 선택적 인수 preferredType ((string 또는 number)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). input 인수를 Object가 아닌 타입으로 변환합니다. 객체가 둘 이상의 원시 타입으로 변환될 수 있는 경우, 선택적 힌트 preferredType을 사용하여 해당 타입을 우선할 수 있습니다. 호출되면 다음 단계를 수행한다.

input이 Object이면, 다음을 수행합니다.
1. exoticToPrimitive를 ? GetMethod(input, %Symbol.toPrimitive%)로 둡니다.
2. exoticToPrimitive가 undefined가 아니면, 다음을 수행합니다.
  1. preferredType이 존재하지 않으면, 다음을 수행합니다.
    1. hint를 "default"로 둡니다.
  2. 그렇지 않고 preferredType이 string이면, 다음을 수행합니다.
    1. hint를 "string"으로 둡니다.
  3. 그렇지 않으면,
    1. 단언: preferredType은 number입니다.
    2. hint를 "number"로 둡니다.
  4. result를 ? Call(exoticToPrimitive, input, « hint »)로 둡니다.
  5. result가 Object가 아니면, result를 반환합니다.
  6. TypeError 예외를 던집니다.
3. preferredType이 존재하지 않으면, preferredType을 number로 설정합니다.
4. ? OrdinaryToPrimitive(input, preferredType)를 반환합니다.
input을 반환합니다.

참고

힌트 없이 ToPrimitive를 호출하면 일반적으로 힌트가 number인 것처럼 동작합니다. 그러나 객체는 %Symbol.toPrimitive% 메서드를 정의하여 이 동작을 재정의할 수 있습니다. 이 명세에 정의된 객체 중 기본 ToPrimitive 동작을 재정의하는 것은 Date(21.4.4.45 참조)와 Symbol 객체(20.4.3.5 참조)뿐입니다. Date는 힌트가 없는 경우를 힌트가 string인 것처럼 취급합니다.

7.1.1.1 OrdinaryToPrimitive ( `obj`, `hint` )

추상 연산 OrdinaryToPrimitive. 인수 obj (Object) 및 hint (string 또는 number). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

hint가 string이면, 다음을 수행합니다.
1. methodNames를 « "toString", "valueOf" »로 둡니다.
그렇지 않으면,
1. methodNames를 « "valueOf", "toString" »로 둡니다.
methodNames의 각 요소 name에 대해 다음을 수행합니다.
1. method를 ? Get(obj, name)으로 둡니다.
2. IsCallable(method)이 true이면, 다음을 수행합니다.
  1. result를 ? Call(method, obj)로 둡니다.
  2. result가 Object가 아니면, result를 반환합니다.
TypeError 예외를 던집니다.

7.1.2 ToBoolean ( `arg` )

추상 연산 ToBoolean. 인수 arg (ECMAScript 언어 값). 반환값: Boolean. arg를 Boolean 타입의 값으로 변환합니다. 호출되면 다음 단계를 수행한다.

arg가 Boolean이면, arg를 반환합니다.
arg가 undefined, null, +0_𝔽, -0_𝔽, NaN, 0_ℤ 또는 빈 String 중 하나이면, false를 반환합니다.
Normative Optional
호스트가 웹 브라우저이거나 그 밖의 방식으로 [[IsHTMLDDA]] 내부 슬롯을 지원하면, 다음을 수행합니다.
1. arg가 Object이고 arg에 [[IsHTMLDDA]] 내부 슬롯이 있으면, false를 반환합니다.
true를 반환합니다.

7.1.3 ToNumeric ( `arg` )

추상 연산 ToNumeric. 인수 arg (ECMAScript 언어 값). 반환값: Number 또는 BigInt를 포함하는 정상 완료 또는 throw 완료. arg를 Number 또는 BigInt로 변환하여 반환합니다. 호출되면 다음 단계를 수행한다.

primitiveValue를 ? ToPrimitive(arg, number)로 둡니다.
primitiveValue가 BigInt이면, primitiveValue를 반환합니다.
? ToNumber(primitiveValue)를 반환합니다.

7.1.4 ToNumber ( `arg` )

추상 연산 ToNumber. 인수 arg (ECMAScript 언어 값). 반환값: Number를 포함하는 정상 완료 또는 throw 완료. arg를 Number 타입의 값으로 변환합니다. 호출되면 다음 단계를 수행한다.

arg가 Number이면, arg를 반환합니다.
arg가 Symbol 또는 BigInt이면, TypeError 예외를 던집니다.
arg가 undefined이면, NaN을 반환합니다.
arg가 null 또는 false이면, +0_𝔽을 반환합니다.
arg가 true이면, 1_𝔽을 반환합니다.
arg가 String이면, StringToNumber(arg)를 반환합니다.
단언: arg는 Object입니다.
primitiveValue를 ? ToPrimitive(arg, number)로 둡니다.
단언: primitiveValue는 Object가 아닙니다.
? ToNumber(primitiveValue)를 반환합니다.

7.1.4.1 String 타입에 적용되는 ToNumber

추상 연산 StringToNumber는 다음 문법을 사용하여 String 값을 Number 값으로 변환하는 방법을 명시합니다.

구문

:::

opt

opt

opt

:::

opt

:::

:::

NonDecimalIntegerLiteral

[~Sep]

StrDecimalLiteral

:::

StrUnsignedDecimalLiteral

:::

Infinity

DecimalDigits

[~Sep]

DecimalDigits

[~Sep]

opt

ExponentPart

[~Sep]

opt

DecimalDigits

[~Sep]

ExponentPart

[~Sep]

opt

DecimalDigits

[~Sep]

ExponentPart

[~Sep]

opt

위에서 명시적으로 정의되지 않은 모든 문법 기호에는 숫자 리터럴의 어휘 문법(12.9.3)에서 사용하는 정의가 적용됩니다.

참고

StringNumericLiteral과 NumericLiteral의 구문에는 다음과 같은 몇 가지 차이가 있음을 유의하시기 바랍니다:

StringNumericLiteral에는 앞쪽 및/또는 뒤쪽 공백 및/또는 줄 종결자가 포함될 수 있습니다.
십진수인 StringNumericLiteral에는 임의 개수의 선행 0 숫자가 있을 수 있습니다.
십진수인 StringNumericLiteral에는 부호를 나타내는 + 또는 -가 포함될 수 있습니다.
비어 있거나 공백만 포함하는 StringNumericLiteral은 +0_𝔽으로 변환됩니다.
Infinity와 -Infinity는 StringNumericLiteral로 인식되지만 NumericLiteral로는 인식되지 않습니다.
StringNumericLiteral에는 BigIntLiteralSuffix를 포함할 수 없습니다.
StringNumericLiteral에는 NumericLiteralSeparator를 포함할 수 없습니다.

7.1.4.1.1 StringToNumber ( `string` )

추상 연산 StringToNumber. 인수 string (String). 반환값: Number. 호출되면 다음 단계를 수행한다.

literal을 ParseText(string, StringNumericLiteral)로 둡니다.
literal이 오류의 List이면, NaN을 반환합니다.
literal의 StringNumericValue를 반환합니다.

7.1.4.1.2 Runtime Semantics: StringNumericValue

구문 지향 연산 StringNumericValue. 인수 없음. 반환값: Number.

참고

StringNumericLiteral을 Number 값으로 변환하는 것은 전반적으로 NumericLiteral의 NumericValue를 결정하는 것과 유사하지만(12.9.3 참조), 일부 세부 사항은 다릅니다.

다음 생성 규칙별로 정의된다.

StringNumericLiteral

:::

StrWhiteSpace

opt

+0_𝔽을 반환합니다.

:::

opt

opt

StrNumericLiteral의 StringNumericValue를 반환합니다.

StrNumericLiteral

:::

NonDecimalIntegerLiteral

𝔽(NonDecimalIntegerLiteral의 MV)를 반환합니다.

StrDecimalLiteral

:::

StrUnsignedDecimalLiteral

a를 StrUnsignedDecimalLiteral의 StringNumericValue로 둡니다.
a가 +0_𝔽이면, -0_𝔽을 반환합니다.
-a를 반환합니다.

StrUnsignedDecimalLiteral

:::

Infinity

+∞_𝔽을 반환합니다.

StrUnsignedDecimalLiteral

:::

DecimalDigits

opt

ExponentPart

opt

a를 첫 번째 DecimalDigits의 MV로 둡니다.
두 번째 DecimalDigits가 존재하면, 다음을 수행합니다.
1. b를 두 번째 DecimalDigits의 MV로 둡니다.
2. n을 두 번째 DecimalDigits의 코드 포인트 수로 둡니다.
그렇지 않으면,
1. b를 0으로 둡니다.
2. n을 0으로 둡니다.
ExponentPart가 존재하면 e를 ExponentPart의 MV로 둡니다. 그렇지 않으면 e를 0으로 둡니다.
RoundMVResult((a + (b × 10^-n)) × 10^e)를 반환합니다.

StrUnsignedDecimalLiteral

:::

DecimalDigits

ExponentPart

opt

b를 DecimalDigits의 MV로 둡니다.
ExponentPart가 존재하면 e를 ExponentPart의 MV로 둡니다. 그렇지 않으면 e를 0으로 둡니다.
n을 DecimalDigits의 코드 포인트 수로 둡니다.
RoundMVResult(b × 10^{e - n})를 반환합니다.

StrUnsignedDecimalLiteral

:::

DecimalDigits

ExponentPart

opt

a를 DecimalDigits의 MV로 둡니다.
ExponentPart가 존재하면 e를 ExponentPart의 MV로 둡니다. 그렇지 않으면 e를 0으로 둡니다.
RoundMVResult(a × 10^e)를 반환합니다.

7.1.4.1.3 RoundMVResult ( `n` )

추상 연산 RoundMVResult. 인수 n (수학적 값). 반환값: Number. 구현체 정의 방식으로 n을 Number로 변환합니다. 이 추상 연산에서 숫자가 0이 아니거나, 그 왼쪽에 0이 아닌 숫자가 있고 오른쪽에도 0이 아닌 숫자가 있으면 해당 숫자는 유효한 것으로 간주됩니다. 이 추상 연산에서 수학적 값의 표현이 “나타내는 수학적 값”은 수학적 값의 “십진 표현”의 역변환입니다. 호출되면 다음 단계를 수행한다.

n의 십진 표현에 유효 숫자가 20개 이하이면, 𝔽(n)을 반환합니다.
option1을 n의 십진 표현에서 20번째 이후의 각 유효 숫자를 0 숫자로 바꾼 결과가 나타내는 수학적 값으로 둡니다.
option2를 n의 십진 표현에서 20번째 이후의 각 유효 숫자를 0 숫자로 바꾼 다음 20번째 위치의 값을 1 증가시킨 결과(필요한 경우 올림 포함)가 나타내는 수학적 값으로 둡니다.
chosen을 option1 또는 option2 중 구현체 정의 방식으로 선택한 값으로 둡니다.
𝔽(chosen)을 반환합니다.

7.1.5 ToIntegerOrInfinity ( `arg` )

추상 연산 ToIntegerOrInfinity. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: (정수, +∞ 또는 -∞)) 또는 throw 완료). arg를 소수 부분을 잘라낸 Number 값을 나타내는 정수로 변환하거나, 해당 Number 값이 무한이면 +∞ 또는 -∞로 변환합니다. 호출되면 다음 단계를 수행한다.

number를 ? ToNumber(arg)로 둡니다.
number가 NaN, +0_𝔽 또는 -0_𝔽 중 하나이면, 0을 반환합니다.
number가 +∞_𝔽이면, +∞를 반환합니다.
number가 -∞_𝔽이면, -∞를 반환합니다.
truncate(ℝ(number))를 반환합니다.

참고

𝔽(ToIntegerOrInfinity(x))는 x의 어떤 값에 대해서도 -0_𝔽을 반환하지 않습니다. 소수 부분의 절삭은 x를 수학적 값으로 변환한 후 수행됩니다.

7.1.6 SnapToInteger ( `arg`, `nonIntHandling` [ , `minimum` [ , `maximum` ] ] )

추상 연산 SnapToInteger. 인수 arg (ECMAScript 언어 값) 및 nonIntHandling ((reject 또는 truncate)) 및 선택적 인수 minimum (정수) 및 maximum (정수). 반환값: (정상 완료 (값: 정수) 또는 throw 완료). arg를 해당 Number 값을 나타내는 정수로 변환하며, 유한하지 않은 값을 거부하고 유한하지만 정수가 아닌 값은 거부하거나 절삭하여 처리하며, 선택적으로 양 끝을 포함하는 제한 범위를 적용합니다. 호출되면 다음 단계를 수행한다.

number를 ? ToNumber(arg)로 둡니다.
number가 NaN, +∞_𝔽 또는 -∞_𝔽 중 하나이면, RangeError 예외를 던집니다.
mv를 ℝ(number)로 둡니다.
nonIntHandling이 truncate이면, mv를 truncate(mv)로 설정합니다.
mv가 정수가 아니면, RangeError 예외를 던집니다.
minimum이 존재하고 mv < minimum이면, RangeError 예외를 던집니다.
maximum이 존재하고 mv > maximum이면, RangeError 예외를 던집니다.
mv를 반환합니다.

7.1.7 ToFixedSizeInteger ( `int`, `signed`, `bitWidth` )

추상 연산 ToFixedSizeInteger. 인수 int ((정수, +∞ 또는 -∞)), signed ((unsigned 또는 signed)) 및 bitWidth (양의 정수). 반환값: 정수. int를 2^bitWidth개의 정수 중 하나로 매핑합니다. signed가 unsigned이면 0부터 2^bitWidth - 1까지의 닫힌 구간에 있는 정수로, signed가 signed이면 -2^{bitWidth - 1}부터 2^{bitWidth - 1} - 1까지의 닫힌 구간에 있는 정수로 매핑합니다. 호출되면 다음 단계를 수행한다.

int = +∞ 또는 int = -∞이면, 0을 반환합니다.
fixedInt를 int modulo 2^bitWidth로 둡니다.
참고: 다음 단계는 fixedInt의 2의 보수 표현을 변경하지 않습니다.
signed가 signed이고 fixedInt ≥ 2^{bitWidth - 1}이면, fixedInt를 fixedInt - 2^bitWidth로 설정합니다.
fixedInt를 반환합니다.

참고

ToFixedSizeInteger는 멱등성을 가집니다. 즉, 임의의 ECMAScript 언어 값 x에 대해 ToFixedSizeInteger(ToFixedSizeInteger(x, signed, bitWidth), signed, bitWidth)는 ToFixedSizeInteger(x, signed, bitWidth)와 같습니다. 실제로 +∞와 -∞가 0으로 매핑되므로 이 불변 조건은 signed를 반대로 바꾸더라도 유지됩니다(예: ToFixedSizeInteger(ToFixedSizeInteger(x, signed, 32), unsigned, 32)는 ToFixedSizeInteger(x, unsigned, 32)와 같습니다).

7.1.8 ToInt32 ( `arg` )

추상 연산 ToInt32. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 𝔽(-2³¹)부터 𝔽(2³¹ - 1)까지의 닫힌 구간에 있는 2³²개의 정수인 Number 값 중 하나로 변환하며, -0_𝔽은 제외합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
𝔽(ToFixedSizeInteger(int, signed, 32))를 반환합니다.

7.1.9 ToUint32 ( `arg` )

추상 연산 ToUint32. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 +0_𝔽부터 𝔽(2³² - 1)까지의 닫힌 구간에 있는 2³²개의 정수인 Number 값 중 하나로 변환합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
𝔽(ToFixedSizeInteger(int, unsigned, 32))를 반환합니다.

7.1.10 ToInt16 ( `arg` )

추상 연산 ToInt16. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 𝔽(-2¹⁵)부터 𝔽(2¹⁵ - 1)까지의 닫힌 구간에 있는 2¹⁶개의 정수인 Number 값 중 하나로 변환하며, -0_𝔽은 제외합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
𝔽(ToFixedSizeInteger(int, signed, 16))를 반환합니다.

7.1.11 ToUint16 ( `arg` )

추상 연산 ToUint16. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 +0_𝔽부터 𝔽(2¹⁶ - 1)까지의 닫힌 구간에 있는 2¹⁶개의 정수인 Number 값 중 하나로 변환합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
𝔽(ToFixedSizeInteger(int, unsigned, 16))를 반환합니다.

7.1.12 ToInt8 ( `arg` )

추상 연산 ToInt8. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 -128_𝔽부터 127_𝔽까지의 닫힌 구간에 있는 2⁸개의 정수인 Number 값 중 하나로 변환하며, -0_𝔽은 제외합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
𝔽(ToFixedSizeInteger(int, signed, 8))를 반환합니다.

7.1.13 ToUint8 ( `arg` )

추상 연산 ToUint8. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 +0_𝔽부터 255_𝔽까지의 닫힌 구간에 있는 2⁸개의 정수인 Number 값 중 하나로 변환합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
𝔽(ToFixedSizeInteger(int, unsigned, 8))를 반환합니다.

7.1.14 ToUint8Clamp ( `arg` )

추상 연산 ToUint8Clamp. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 정수인 Number) 또는 throw 완료). arg를 제한하고 반올림하여 +0_𝔽부터 255_𝔽까지의 닫힌 구간에 있는 2⁸개의 정수인 Number 값 중 하나로 변환합니다. 호출되면 다음 단계를 수행한다.

number를 ? ToNumber(arg)로 둡니다.
number가 NaN이면, +0_𝔽을 반환합니다.
mv를 number의 확장된 수학적 값으로 둡니다.
clamped를 mv를 0과 255 사이로 제한한 결과로 둡니다.
f를 floor(clamped)로 둡니다.
clamped < f + 0.5이면, 𝔽(f)를 반환합니다.
clamped > f + 0.5이면, 𝔽(f + 1)을 반환합니다.
f가 짝수이면, 𝔽(f)를 반환합니다.
𝔽(f + 1)을 반환합니다.

참고

대부분의 다른 ECMAScript 정수 변환 연산과 달리 ToUint8Clamp는 정수가 아닌 값을 절삭하지 않고 반올림합니다. 또한 “가장 가까운 짝수로 절반 반올림” 동률 결정 방식을 사용하며, 이는 Math.round의 “절반 올림” 동률 결정 방식과 다릅니다.

7.1.15 ToBigInt ( `arg` )

추상 연산 ToBigInt. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: BigInt) 또는 throw 완료). arg를 BigInt 값으로 변환하며, Number에서 암묵적 변환이 필요하면 예외를 던집니다. 호출되면 다음 단계를 수행한다.

primitive를 ? ToPrimitive(arg, number)로 둡니다.
표 12에서 primitive에 대응하는 값을 반환합니다.

표 12: BigInt 변환

인수 타입	결과
Undefined	TypeError 예외를 던집니다.
Null	TypeError 예외를 던집니다.
Boolean	`primitive`가 true이면 `1n`을 반환하고, `primitive`가 false이면 `0n`을 반환합니다.
BigInt	`primitive`를 반환합니다.
Number	TypeError 예외를 던집니다.
String	`n`을 StringToBigInt(`primitive`)로 둡니다. `n`이 undefined이면, SyntaxError 예외를 던집니다. `n`을 반환합니다.
Symbol	TypeError 예외를 던집니다.

7.1.16 StringToBigInt ( `string` )

추상 연산 StringToBigInt. 인수 string (String). 반환값: (BigInt 또는 undefined). 호출되면 다음 단계를 수행한다.

literal을 ParseText(string, StringIntegerLiteral)로 둡니다.
literal이 오류의 List이면, undefined를 반환합니다.
mv를 literal의 MV로 둡니다.
단언: mv는 정수입니다.
ℤ(mv)를 반환합니다.

7.1.16.1 StringIntegerLiteral 문법

StringToBigInt는 다음 문법을 사용합니다.

구문

:::

opt

opt

opt

:::

[~Sep]

NonDecimalIntegerLiteral

[~Sep]

7.1.16.2 Runtime Semantics: MV

StringIntegerLiteral ::: StrWhiteSpaceopt 의 MV는 0입니다.
StringIntegerLiteral ::: StrWhiteSpaceopt StrIntegerLiteral StrWhiteSpaceopt 의 MV는 StrIntegerLiteral의 MV입니다.

7.1.17 ToBigInt64 ( `arg` )

추상 연산 ToBigInt64. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: BigInt) 또는 throw 완료). arg를 ℤ(-2⁶³)부터 ℤ(2⁶³ - 1)까지의 닫힌 구간에 있는 2⁶⁴개의 BigInt 값 중 하나로 변환합니다. 호출되면 다음 단계를 수행한다.

int를 ℝ(? ToBigInt(arg))로 둡니다.
ℤ(ToFixedSizeInteger(int, signed, 64))를 반환합니다.

7.1.18 ToBigUint64 ( `arg` )

추상 연산 ToBigUint64. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: BigInt) 또는 throw 완료). arg를 0_ℤ부터 ℤ(2⁶⁴ - 1)까지의 닫힌 구간에 있는 2⁶⁴개의 BigInt 값 중 하나로 변환합니다. 호출되면 다음 단계를 수행한다.

int를 ℝ(? ToBigInt(arg))로 둡니다.
ℤ(ToFixedSizeInteger(int, unsigned, 64))를 반환합니다.

7.1.19 ToString ( `arg` )

추상 연산 ToString. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: String) 또는 throw 완료). arg를 String 타입의 값으로 변환합니다. 호출되면 다음 단계를 수행한다.

arg가 String이면, arg를 반환합니다.
arg가 Symbol이면, TypeError 예외를 던집니다.
arg가 undefined이면, "undefined"를 반환합니다.
arg가 null이면, "null"을 반환합니다.
arg가 true이면, "true"를 반환합니다.
arg가 false이면, "false"를 반환합니다.
arg가 Number이면, Number::toString(arg, 10)을 반환합니다.
arg가 BigInt이면, BigInt::toString(arg, 10)을 반환합니다.
단언: arg는 Object입니다.
primitiveValue를 ? ToPrimitive(arg, string)로 둡니다.
단언: primitiveValue는 Object가 아닙니다.
? ToString(primitiveValue)를 반환합니다.

7.1.20 ToObject ( `arg` )

추상 연산 ToObject. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: Object) 또는 throw 완료). arg를 Object 타입의 값으로 변환합니다. 호출되면 다음 단계를 수행한다.

arg가 undefined 또는 null이면, TypeError 예외를 던집니다.
arg가 Boolean이면, [[BooleanData]] 내부 슬롯이 arg로 설정된 새로운 Boolean 객체를 반환합니다. Boolean 객체에 대한 설명은 20.3를 참조하시기 바랍니다.
arg가 Number이면, [[NumberData]] 내부 슬롯이 arg로 설정된 새로운 Number 객체를 반환합니다. Number 객체에 대한 설명은 21.1를 참조하시기 바랍니다.
arg가 String이면, [[StringData]] 내부 슬롯이 arg로 설정된 새로운 String 객체를 반환합니다. String 객체에 대한 설명은 22.1를 참조하시기 바랍니다.
arg가 Symbol이면, [[SymbolData]] 내부 슬롯이 arg로 설정된 새로운 Symbol 객체를 반환합니다. Symbol 객체에 대한 설명은 20.4를 참조하시기 바랍니다.
arg가 BigInt이면, [[BigIntData]] 내부 슬롯이 arg로 설정된 새로운 BigInt 객체를 반환합니다. BigInt 객체에 대한 설명은 21.2를 참조하시기 바랍니다.
단언: arg는 Object입니다.
arg를 반환합니다.

7.1.21 ToPropertyKey ( `arg` )

추상 연산 ToPropertyKey. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 프로퍼티 키) 또는 throw 완료). arg를 프로퍼티 키로 사용할 수 있는 값으로 변환합니다. 호출되면 다음 단계를 수행한다.

key를 ? ToPrimitive(arg, string)로 둡니다.
key가 Symbol이면, 다음을 수행합니다.
1. key를 반환합니다.
! ToString(key)을 반환합니다.

7.1.22 ToLength ( `arg` )

추상 연산 ToLength. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 음이 아닌 정수인 Number) 또는 throw 완료). arg를 제한하고 절삭하여 배열과 유사한 객체의 길이로 사용하기에 적합한 음이 아닌 정수인 Number로 변환합니다. 호출되면 다음 단계를 수행한다.

length를 ? ToIntegerOrInfinity(arg)로 둡니다.
clampedLength를 length를 0과 2⁵³ - 1 사이로 제한한 결과로 둡니다.
𝔽(clampedLength)를 반환합니다.

7.1.23 CanonicalNumericIndexString ( `arg` )

추상 연산 CanonicalNumericIndexString. 인수 arg (String). 반환값: (Number 또는 undefined). arg가 "-0"이거나 어떤 Number 값 n에 대한 ToString(n)과 정확히 일치하면 각각에 대응하는 Number 값을 반환합니다. 그렇지 않으면 undefined를 반환합니다. 호출되면 다음 단계를 수행한다.

arg가 "-0"이면, -0_𝔽을 반환합니다.
n을 ! ToNumber(arg)로 둡니다.
! ToString(n)이 arg이면, n을 반환합니다.
undefined를 반환합니다.

정규 숫자 문자열은 CanonicalNumericIndexString 추상 연산이 undefined를 반환하지 않는 모든 String입니다.

7.1.24 ToIndex ( `arg` )

추상 연산 ToIndex. 인수 arg (ECMAScript 언어 값). 반환값: 음이 아닌 정수를 포함하는 정상 완료 또는 throw 완료. arg를 정수로 변환하고 해당 정수가 음이 아니며 정수 인덱스에 대응하면 그 정수를 반환합니다. 그렇지 않으면 예외를 던집니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(arg)로 둡니다.
int가 0부터 2⁵³ - 1까지의 닫힌 구간에 없으면, RangeError 예외를 던집니다.
int를 반환합니다.

7.1.25 ToAbsoluteIndex ( `value`, `length` )

추상 연산 ToAbsoluteIndex. 인수 value (ECMAScript 언어 값) 및 length (음이 아닌 정수). 반환값: (정상 완료 (값: (정수, +∞ 또는 -∞)) 또는 throw 완료). value를 정수, +∞ 또는 -∞로 변환하며, 음수 값은 length를 기준으로 상대적으로 해석합니다. 호출되면 다음 단계를 수행한다.

int를 ? ToIntegerOrInfinity(value)로 둡니다.
int가 유한하고 int < 0이면, int를 length + int로 설정합니다.
int를 반환합니다.

7.1.26 ToClampedIndex ( `value`, `length` )

추상 연산 ToClampedIndex. 인수 value (ECMAScript 언어 값) 및 length (음이 아닌 정수). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). value를 정수로 변환하고(음수 값은 length를 기준으로 상대적으로 해석), 그 결과를 0부터 length까지의 닫힌 구간으로 제한합니다. 호출되면 다음 단계를 수행한다.

index를 ? ToAbsoluteIndex(value, length)로 둡니다.
index를 0과 length 사이로 제한한 결과를 반환합니다.

7.2 검사 및 비교 연산

7.2.1 RequireObjectCoercible ( `arg` )

추상 연산 RequireObjectCoercible. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). arg가 ToObject를 사용하여 Object로 변환할 수 없는 값이면 오류를 던집니다. 호출되면 다음 단계를 수행한다.

arg가 undefined 또는 null이면, TypeError 예외를 던집니다.
unused를 반환합니다.

7.2.2 IsArray ( `arg` )

추상 연산 IsArray. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

arg가 Object가 아니면, false를 반환합니다.
arg가 Array 특수 객체이면, true를 반환합니다.
arg가 Proxy 특수 객체이면, 다음을 수행합니다.
1. ? ValidateNonRevokedProxy(arg)를 수행합니다.
2. proxyTarget을 arg.[[ProxyTarget]]으로 둡니다.
3. ? IsArray(proxyTarget)를 반환합니다.
false를 반환합니다.

7.2.3 IsCallable ( `arg` )

추상 연산 IsCallable. 인수 arg (ECMAScript 언어 값). 반환값: Boolean. arg가 [[Call]] 내부 메서드를 갖는 호출 가능한 함수인지 결정합니다. 호출되면 다음 단계를 수행한다.

arg가 Object가 아니면, false를 반환합니다.
arg에 [[Call]] 내부 메서드가 있으면, true를 반환합니다.
false를 반환합니다.

7.2.4 IsConstructor ( `arg` )

추상 연산 IsConstructor. 인수 arg (ECMAScript 언어 값). 반환값: Boolean. arg가 [[Construct]] 내부 메서드를 갖는 함수 객체인지 결정합니다. 호출되면 다음 단계를 수행한다.

arg가 Object가 아니면, false를 반환합니다.
arg에 [[Construct]] 내부 메서드가 있으면, true를 반환합니다.
false를 반환합니다.

7.2.5 IsExtensible ( `obj` )

추상 연산 IsExtensible. 인수 obj (Object). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). obj에 추가 프로퍼티를 추가할 수 있는지 결정하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? obj.[[IsExtensible]]()를 반환합니다.

7.2.6 IsRegExp ( `arg` )

추상 연산 IsRegExp. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

arg가 Object가 아니면, false를 반환합니다.
matcher를 ? Get(arg, %Symbol.match%)로 둡니다.
matcher가 undefined가 아니면, ToBoolean(matcher)을 반환합니다.
arg에 [[RegExpMatcher]] 내부 슬롯이 있으면, true를 반환합니다.
false를 반환합니다.

7.2.7 Static Semantics: IsStringWellFormedUnicode ( `string` )

추상 연산 IsStringWellFormedUnicode. 인수 string (String). 반환값: Boolean. 6.1.4에 설명된 대로 string을 UTF-16로 인코딩된 코드 포인트 시퀀스로 해석하고, 이것이 올바른 형식의 UTF-16 시퀀스인지 결정합니다. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. codePoint를 CodePointAt(string, k)으로 둡니다.
2. codePoint.[[IsUnpairedSurrogate]]가 true이면, false를 반환합니다.
3. k를 k + codePoint.[[CodeUnitCount]]로 설정합니다.
true를 반환합니다.

7.2.8 SameType ( `x`, `y` )

추상 연산 SameType. 인수 x (ECMAScript 언어 값) 및 y (ECMAScript 언어 값). 반환값: Boolean. 두 인수가 같은 타입인지 결정합니다. 호출되면 다음 단계를 수행한다.

x가 undefined이고 y가 undefined이면, true를 반환합니다.
x가 null이고 y가 null이면, true를 반환합니다.
x가 Boolean이고 y가 Boolean이면, true를 반환합니다.
x가 Number이고 y가 Number이면, true를 반환합니다.
x가 BigInt이고 y가 BigInt이면, true를 반환합니다.
x가 Symbol이고 y가 Symbol이면, true를 반환합니다.
x가 String이고 y가 String이면, true를 반환합니다.
x가 Object이고 y가 Object이면, true를 반환합니다.
false를 반환합니다.

7.2.9 SameValue ( `x`, `y` )

추상 연산 SameValue. 인수 x (ECMAScript 언어 값) 및 y (ECMAScript 언어 값). 반환값: Boolean. 두 인수가 같은 값인지 결정합니다. 호출되면 다음 단계를 수행한다.

SameType(x, y)이 false이면, false를 반환합니다.
x가 Number이면, 다음을 수행합니다.
1. Number::sameValue(x, y)를 반환합니다.
SameValueNonNumber(x, y)를 반환합니다.

참고

이 알고리즘은 모든 NaN 값을 동등하게 취급하고 +0_𝔽과 -0_𝔽을 구별한다는 점에서 IsStrictlyEqual 알고리즘과 다릅니다.

7.2.10 SameValueZero ( `x`, `y` )

추상 연산 SameValueZero. 인수 x (ECMAScript 언어 값) 및 y (ECMAScript 언어 값). 반환값: Boolean. 두 인수가 같은 값인지 결정합니다(+0_𝔽과 -0_𝔽의 차이는 무시합니다). 호출되면 다음 단계를 수행한다.

SameType(x, y)이 false이면, false를 반환합니다.
x가 Number이면, 다음을 수행합니다.
1. Number::sameValueZero(x, y)를 반환합니다.
SameValueNonNumber(x, y)를 반환합니다.

참고

SameValueZero는 +0_𝔽과 -0_𝔽을 동등하게 취급한다는 점에서만 SameValue와 다릅니다.

7.2.11 SameValueNonNumber ( `x`, `y` )

추상 연산 SameValueNonNumber. 인수 x (Number가 아닌 ECMAScript 언어 값) 및 y (Number가 아닌 ECMAScript 언어 값). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

단언: SameType(x, y)은 true입니다.
x가 undefined 또는 null이면, true를 반환합니다.
x가 BigInt이면, 다음을 수행합니다.
1. BigInt::equal(x, y)를 반환합니다.
x가 String이면, 다음을 수행합니다.
1. x와 y의 길이가 같고 동일한 위치에 동일한 코드 단위가 있으면, true를 반환합니다.
2. false를 반환합니다.
x가 Boolean이면, 다음을 수행합니다.
1. x가 true이고 y가 true이면, true를 반환합니다.
2. x가 false이고 y가 false이면, true를 반환합니다.
3. false를 반환합니다.
참고: 그 밖의 모든 ECMAScript 언어 값은 동일성으로 비교됩니다.
x가 y이면, true를 반환합니다.
false를 반환합니다.

참고 1

설명을 위해 필요하지 않은 경우에도 일부 경우를 이 알고리즘 내에서 별도로 처리합니다.

참고 2

“x가 y이다”가 구체적으로 무엇을 의미하는지는 5.2.8에 자세히 설명되어 있습니다.

7.2.12 IsLessThan ( `x`, `y`, `leftFirst` )

추상 연산 IsLessThan. 인수 x (ECMAScript 언어 값), y (ECMAScript 언어 값) 및 leftFirst (Boolean). 반환값: Boolean 또는 undefined를 포함하는 정상 완료 또는 throw 완료. 비교 x < y의 의미론을 제공하며, true, false 또는 undefined(피연산자를 동일한 숫자 타입의 비교 가능한 값으로 강제 변환할 수 없음을 나타냅니다)를 반환합니다. leftFirst 플래그는 x와 y에 대해 관찰 가능한 부작용이 있을 수 있는 연산을 수행하는 순서를 제어하는 데 사용됩니다. ECMAScript가 표현식의 왼쪽에서 오른쪽 평가를 명시하기 때문에 필요합니다. leftFirst가 true이면 x 매개변수는 y 매개변수에 대응하는 표현식보다 왼쪽에 나타나는 표현식에 대응합니다. leftFirst가 false이면 반대이며, x보다 y에 대한 연산을 먼저 수행해야 합니다. 호출되면 다음 단계를 수행한다.

leftFirst가 true이면, 다음을 수행합니다.
1. px를 ? ToPrimitive(x, number)로 둡니다.
2. py를 ? ToPrimitive(y, number)로 둡니다.
그렇지 않으면,
1. 참고: 왼쪽에서 오른쪽 평가를 유지하기 위해 평가 순서를 반대로 해야 합니다.
2. py를 ? ToPrimitive(y, number)로 둡니다.
3. px를 ? ToPrimitive(x, number)로 둡니다.
px가 String이고 py가 String이면, 다음을 수행합니다.
1. lx를 px의 길이로 둡니다.
2. ly를 py의 길이로 둡니다.
3. 0 ≤ i < min(lx, ly)를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
  1. cx를 px 내 인덱스 i에 있는 코드 단위의 숫자 값으로 둡니다.
  2. cy를 py 내 인덱스 i에 있는 코드 단위의 숫자 값으로 둡니다.
  3. cx < cy이면, true를 반환합니다.
  4. cx > cy이면, false를 반환합니다.
4. lx < ly이면, true를 반환합니다.
5. false를 반환합니다.
px가 BigInt이고 py가 String이면, 다음을 수행합니다.
1. ny를 StringToBigInt(py)로 둡니다.
2. ny가 undefined이면, undefined를 반환합니다.
3. BigInt::lessThan(px, ny)을 반환합니다.
px가 String이고 py가 BigInt이면, 다음을 수행합니다.
1. nx를 StringToBigInt(px)로 둡니다.
2. nx가 undefined이면, undefined를 반환합니다.
3. BigInt::lessThan(nx, py)을 반환합니다.
참고: px와 py는 원시값이므로 평가 순서는 중요하지 않습니다.
nx를 ? ToNumeric(px)로 둡니다.
ny를 ? ToNumeric(py)로 둡니다.
SameType(nx, ny)이 true이면, 다음을 수행합니다.
1. nx가 Number이면, Number::lessThan(nx, ny)을 반환합니다.
2. 단언: nx는 BigInt입니다.
3. BigInt::lessThan(nx, ny)을 반환합니다.
단언: nx가 BigInt이고 ny가 Number이거나, nx가 Number이고 ny가 BigInt입니다.
nx가 NaN이거나 ny가 NaN이면, undefined를 반환합니다.
nx가 -∞_𝔽이거나 ny가 +∞_𝔽이면, true를 반환합니다.
nx가 +∞_𝔽이거나 ny가 -∞_𝔽이면, false를 반환합니다.
ℝ(nx) < ℝ(ny)이면, true를 반환합니다.
false를 반환합니다.

참고 1

3 단계는 덧셈 연산자 +를 처리하는 알고리즘(13.15.3)의 1.c 단계와 달리 논리 OR 연산 대신 논리 AND 연산을 사용합니다.

참고 2

String 비교에서는 UTF-16 코드 단위 값의 시퀀스에 대한 단순한 사전식 순서를 사용합니다. 유니코드 명세에 정의된 더 복잡하고 의미론 중심적인 문자 또는 문자열 동등성과 정렬 순서 정의를 사용하려는 시도는 하지 않습니다. 따라서 유니코드 표준에 따라 정규적으로 동등하지만 동일한 정규화 형식이 아닌 String 값은 서로 같지 않은 것으로 판정될 수 있습니다. 또한 서로게이트 쌍을 포함하는 String의 경우 코드 단위에 따른 사전식 순서는 코드 포인트에 따른 순서와 다르다는 점에 유의하시기 바랍니다.

7.2.13 IsLooselyEqual ( `x`, `y` )

추상 연산 IsLooselyEqual. 인수 x (ECMAScript 언어 값) 및 y (ECMAScript 언어 값). 반환값: Boolean을 포함하는 정상 완료 또는 throw 완료. == 연산자의 의미론을 제공합니다. 호출되면 다음 단계를 수행한다.

SameType(x, y)가 true이면 다음을 수행합니다.
1. IsStrictlyEqual(x, y)을 반환합니다.
x가 null이고 y가 undefined이면 true를 반환합니다.
x가 undefined이고 y가 null이면 true를 반환합니다.
Normative Optional
호스트가 웹 브라우저이거나 그 밖의 방식으로 [[IsHTMLDDA]] 내부 슬롯을 지원하면 다음을 수행합니다.
1. x가 Object이고, x에 [[IsHTMLDDA]] 내부 슬롯이 있으며, y가 undefined 또는 null 중 하나이면 true를 반환합니다.
2. x가 undefined 또는 null 중 하나이고, y가 Object이며, y에 [[IsHTMLDDA]] 내부 슬롯이 있으면 true를 반환합니다.
x가 Number이고 y가 String이면 ! IsLooselyEqual(x, ! ToNumber(y))을 반환합니다.
x가 String이고 y가 Number이면 ! IsLooselyEqual(! ToNumber(x), y)를 반환합니다.
x가 BigInt이고 y가 String이면 다음을 수행합니다.
1. n을 StringToBigInt(y)로 둡니다.
2. n이 undefined이면 false를 반환합니다.
3. ! IsLooselyEqual(x, n)을 반환합니다.
x가 String이고 y가 BigInt이면 ! IsLooselyEqual(y, x)를 반환합니다.
x가 Boolean이면 ! IsLooselyEqual(! ToNumber(x), y)를 반환합니다.
y가 Boolean이면 ! IsLooselyEqual(x, ! ToNumber(y))을 반환합니다.
x가 String, Number, BigInt 또는 Symbol 중 하나이고 y가 Object이면 ! IsLooselyEqual(x, ? ToPrimitive(y))을 반환합니다.
x가 Object이고 y가 String, Number, BigInt 또는 Symbol 중 하나이면 ! IsLooselyEqual(? ToPrimitive(x), y)를 반환합니다.
x가 BigInt이고 y가 유한 Number이거나, x가 유한 Number이고 y가 BigInt이면 다음을 수행합니다.
1. ℝ(x) = ℝ(y)이면 true를 반환합니다.
2. false를 반환합니다.
false를 반환합니다.

7.2.14 IsStrictlyEqual ( `x`, `y` )

추상 연산 IsStrictlyEqual. 인수 x (ECMAScript 언어 값) 및 y (ECMAScript 언어 값). 반환값: Boolean. === 연산자의 의미론을 제공합니다. 호출되면 다음 단계를 수행한다.

SameType(x, y)이 false이면, false를 반환합니다.
x가 Number이면, 다음을 수행합니다.
1. Number::equal(x, y)을 반환합니다.
SameValueNonNumber(x, y)을 반환합니다.

참고

이 알고리즘은 부호가 있는 0과 NaN을 처리하는 방식에서 SameValue 알고리즘과 다릅니다.

7.3 객체에 대한 연산

7.3.1 MakeBasicObject ( `internalSlotsList` )

추상 연산 MakeBasicObject. 인수 internalSlotsList (내부 슬롯 이름의 List). 반환값: Object. 일반 객체와 특수 객체를 모두 포함하여 알고리즘으로 생성되는 모든 ECMAScript 객체의 출처입니다. 모든 객체 생성에 공통으로 사용하는 단계를 분리하고 객체 생성을 중앙화합니다. 호출되면 다음 단계를 수행한다.

internalSlotsList를 internalSlotsList와 « [[PrivateElements]] »의 목록 연결로 설정합니다.
obj를 internalSlotsList의 각 이름에 대한 내부 슬롯을 갖는 새로 생성된 객체로 둡니다.
참고: Object 내부 메서드와 내부 슬롯에 설명된 대로 달리 명시되지 않는 한 이러한 각 내부 슬롯의 초기값은 undefined입니다.
obj.[[PrivateElements]]를 새로운 빈 List로 설정합니다.
obj의 필수 내부 메서드를 10.1에 명시된 기본 일반 객체 정의로 설정합니다.
단언: 호출자가 obj의 [[GetPrototypeOf]] 및 [[SetPrototypeOf]] 필수 내부 메서드를 모두 재정의하지 않을 예정이면, internalSlotsList에는 [[Prototype]]이 포함됩니다.
단언: 호출자가 obj의 [[SetPrototypeOf]], [[IsExtensible]] 및 [[PreventExtensions]] 필수 내부 메서드를 모두 재정의하지 않을 예정이면, internalSlotsList에는 [[Extensible]]이 포함됩니다.
internalSlotsList에 [[Extensible]]이 포함되어 있으면, obj.[[Extensible]]을 true로 설정합니다.
obj를 반환합니다.

참고

이 명세에서 특수 객체는 ArrayCreate 및 BoundFunctionCreate와 같은 추상 연산에서 먼저 MakeBasicObject를 호출하여 기본적인 기반 객체를 얻은 다음, 해당 객체의 일부 또는 모든 내부 메서드를 재정의하여 생성합니다. 특수 객체 생성을 캡슐화하기 위해 객체의 필수 내부 메서드는 이러한 연산 외부에서는 절대로 수정하지 않습니다.

7.3.2 Get ( `obj`, `propertyKey` )

추상 연산 Get. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 throw 완료. 객체의 특정 프로퍼티 값을 가져오는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? obj.[[Get]](propertyKey, obj)를 반환합니다.

7.3.3 GetV ( `value`, `propertyKey` )

추상 연산 GetV. 인수 value (ECMAScript 언어 값) 및 propertyKey (프로퍼티 키). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 throw 완료. ECMAScript 언어 값의 특정 프로퍼티 값을 가져오는 데 사용됩니다. 값이 객체가 아닌 경우 해당 값 타입에 적합한 래퍼 객체를 사용하여 프로퍼티 조회를 수행합니다. 호출되면 다음 단계를 수행한다.

obj를 ? ToObject(value)로 둡니다.
? obj.[[Get]](propertyKey, value)를 반환합니다.

7.3.4 Set ( `obj`, `propertyKey`, `value`, `throw` )

추상 연산 Set. 인수 obj (Object), propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 throw (Boolean). 반환값: unused를 포함하는 정상 완료 또는 throw 완료. 객체의 특정 프로퍼티 값을 설정하는 데 사용됩니다. value는 프로퍼티의 새 값입니다. 호출되면 다음 단계를 수행한다.

success를 ? obj.[[Set]](propertyKey, value, obj)로 둡니다.
success가 false이고 throw가 true이면, TypeError 예외를 던집니다.
unused를 반환합니다.

7.3.5 CreateDataProperty ( `obj`, `propertyKey`, `value` )

추상 연산 CreateDataProperty. 인수 obj (Object), propertyKey (프로퍼티 키) 및 value (ECMAScript 언어 값). 반환값: Boolean을 포함하는 정상 완료 또는 throw 완료. 객체에 새로운 자체 프로퍼티를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

newDesc를 PropertyDescriptor { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true }로 둡니다.
? obj.[[DefineOwnProperty]](propertyKey, newDesc)를 반환합니다.

참고

이 추상 연산은 ECMAScript 언어의 할당 연산자가 생성하는 프로퍼티에 사용되는 기본값과 동일하게 속성이 설정된 프로퍼티를 생성합니다. 일반적으로 해당 프로퍼티는 이미 존재하지 않습니다. 이미 존재하면서 구성 가능하지 않거나 obj가 확장 가능하지 않으면 [[DefineOwnProperty]]는 false를 반환합니다.

7.3.6 CreateDataPropertyOrThrow ( `obj`, `propertyKey`, `value` )

추상 연산 CreateDataPropertyOrThrow. 인수 obj (Object), propertyKey (프로퍼티 키) 및 value (ECMAScript 언어 값). 반환값: unused를 포함하는 정상 완료 또는 throw 완료. 객체에 새로운 자체 프로퍼티를 생성하는 데 사용됩니다. 요청한 프로퍼티 갱신을 수행할 수 없으면 TypeError 예외를 던집니다. 호출되면 다음 단계를 수행한다.

success를 ? CreateDataProperty(obj, propertyKey, value)로 둡니다.
success가 false이면, TypeError 예외를 던집니다.
unused를 반환합니다.

참고

이 추상 연산은 ECMAScript 언어의 할당 연산자가 생성하는 프로퍼티에 사용되는 기본값과 동일하게 속성이 설정된 프로퍼티를 생성합니다. 일반적으로 해당 프로퍼티는 이미 존재하지 않습니다. 이미 존재하면서 구성 가능하지 않거나 obj가 확장 가능하지 않으면 [[DefineOwnProperty]]는 false를 반환하여 이 연산이 TypeError 예외를 던지게 합니다.

7.3.7 CreateNonEnumerableDataPropertyOrThrow ( `obj`, `propertyKey`, `value` )

추상 연산 CreateNonEnumerableDataPropertyOrThrow. 인수 obj (Object), propertyKey (프로퍼티 키) 및 value (ECMAScript 언어 값). 반환값: unused. 일반 객체에 열거할 수 없는 새로운 자체 프로퍼티를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

단언: obj는 구성 불가능한 프로퍼티가 없는 일반 확장 가능 객체입니다.
newDesc를 PropertyDescriptor { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }로 둡니다.
! DefinePropertyOrThrow(obj, propertyKey, newDesc)를 수행합니다.
unused를 반환합니다.

참고

이 추상 연산은 열거 가능하지 않다는 점을 제외하면 ECMAScript 언어의 할당 연산자가 생성하는 프로퍼티에 사용되는 기본값과 동일하게 속성이 설정된 프로퍼티를 생성합니다. 일반적으로 해당 프로퍼티는 이미 존재하지 않습니다. 이미 존재하더라도 DefinePropertyOrThrow는 정상적으로 완료됨이 보장됩니다.

7.3.8 DefinePropertyOrThrow ( `obj`, `propertyKey`, `propertyDesc` )

추상 연산 DefinePropertyOrThrow. 인수 obj (Object), propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: unused를 포함하는 정상 완료 또는 throw 완료. 요청한 프로퍼티 갱신을 수행할 수 없는 경우 TypeError 예외를 던지는 방식으로 객체의 [[DefineOwnProperty]] 내부 메서드를 호출하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

success를 ? obj.[[DefineOwnProperty]](propertyKey, propertyDesc)로 둡니다.
success가 false이면, TypeError 예외를 던집니다.
unused를 반환합니다.

7.3.9 DeletePropertyOrThrow ( `obj`, `propertyKey` )

추상 연산 DeletePropertyOrThrow. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: unused를 포함하는 정상 완료 또는 throw 완료. 객체의 특정 자체 프로퍼티를 제거하는 데 사용됩니다. 프로퍼티가 구성 가능하지 않으면 예외를 던집니다. 호출되면 다음 단계를 수행한다.

success를 ? obj.[[Delete]](propertyKey)로 둡니다.
success가 false이면, TypeError 예외를 던집니다.
unused를 반환합니다.

7.3.10 GetMethod ( `value`, `propertyKey` )

추상 연산 GetMethod. 인수 value (ECMAScript 언어 값) 및 propertyKey (프로퍼티 키). 반환값: 함수 객체 또는 undefined를 포함하는 정상 완료 또는 throw 완료. 프로퍼티의 값이 함수일 것으로 예상되는 경우 ECMAScript 언어 값의 특정 프로퍼티 값을 가져오는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

func를 ? GetV(value, propertyKey)로 둡니다.
func가 undefined 또는 null이면, undefined를 반환합니다.
IsCallable(func)이 false이면, TypeError 예외를 던집니다.
func를 반환합니다.

7.3.11 HasProperty ( `obj`, `propertyKey` )

추상 연산 HasProperty. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: Boolean을 포함하는 정상 완료 또는 throw 완료. 객체가 지정된 프로퍼티 키를 갖는 프로퍼티를 보유하는지 결정하는 데 사용됩니다. 프로퍼티는 자체 프로퍼티 또는 상속된 프로퍼티일 수 있습니다. 호출되면 다음 단계를 수행한다.

? obj.[[HasProperty]](propertyKey)를 반환합니다.

7.3.12 HasOwnProperty ( `obj`, `propertyKey` )

추상 연산 HasOwnProperty. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: Boolean을 포함하는 정상 완료 또는 throw 완료. 객체가 지정된 프로퍼티 키를 갖는 자체 프로퍼티를 보유하는지 결정하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

propertyDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
propertyDesc가 undefined이면, false를 반환합니다.
true를 반환합니다.

7.3.13 Call ( `func`, `thisValue` [ , `argList` ] )

추상 연산 Call. 인수 func (ECMAScript 언어 값) 및 thisValue (ECMAScript 언어 값) 및 선택적 인수 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 함수 객체의 [[Call]] 내부 메서드를 호출하는 데 사용됩니다. func는 함수 객체이고, thisValue는 [[Call]]의 this 값인 ECMAScript 언어 값이며, argList는 내부 메서드의 대응하는 인수에 전달되는 값입니다. argList가 존재하지 않으면 새로운 빈 List를 값으로 사용합니다. 호출되면 다음 단계를 수행한다.

argList가 존재하지 않으면, argList를 새로운 빈 List로 설정합니다.
IsCallable(func)이 false이면, TypeError 예외를 던집니다.
? func.[[Call]](thisValue, argList)를 반환합니다.

7.3.14 Construct ( `ctor` [ , `argList` [ , `newTarget` ] ] )

추상 연산 Construct. 인수 ctor (생성자) 및 선택적 인수 argList (리스트 (요소: ECMAScript 언어 값)) 및 newTarget (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 함수 객체의 [[Construct]] 내부 메서드를 호출하는 데 사용됩니다. argList와 newTarget은 내부 메서드의 대응하는 인수로 전달되는 값입니다. argList가 존재하지 않으면 새로운 빈 List를 값으로 사용합니다. newTarget이 존재하지 않으면 ctor를 값으로 사용합니다. 호출되면 다음 단계를 수행한다.

newTarget이 존재하지 않으면, newTarget을 ctor로 설정합니다.
argList가 존재하지 않으면, argList를 새로운 빈 List로 설정합니다.
? ctor.[[Construct]](argList, newTarget)를 반환합니다.

참고

newTarget이 존재하지 않으면 이 연산은 new F(...argumentsList)와 동등합니다.

7.3.15 SetIntegrityLevel ( `obj`, `level` )

추상 연산 SetIntegrityLevel. 인수 obj (Object) 및 level ((sealed 또는 frozen)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 객체의 자체 프로퍼티 집합을 고정하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

status를 ? obj.[[PreventExtensions]]()로 둡니다.
status가 false이면, false를 반환합니다.
keys를 ? obj.[[OwnPropertyKeys]]()로 둡니다.
level이 sealed이면, 다음을 수행합니다.
1. keys의 각 요소 key에 대해 다음을 수행합니다.
  1. ? DefinePropertyOrThrow(obj, key, PropertyDescriptor { [[Configurable]]: false })를 수행합니다.
그렇지 않으면,
1. 단언: level은 frozen입니다.
2. keys의 각 요소 key에 대해 다음을 수행합니다.
  1. currentDesc를 ? obj.[[GetOwnProperty]](key)로 둡니다.
  2. currentDesc가 undefined가 아니면, 다음을 수행합니다.
    1. IsAccessorDescriptor(currentDesc)가 true이면, 다음을 수행합니다.
      1. propertyDesc를 PropertyDescriptor { [[Configurable]]: false }로 둡니다.
    2. 그렇지 않으면,
      1. propertyDesc를 PropertyDescriptor { [[Configurable]]: false, [[Writable]]: false }로 둡니다.
    3. ? DefinePropertyOrThrow(obj, key, propertyDesc)를 수행합니다.
true를 반환합니다.

7.3.16 TestIntegrityLevel ( `obj`, `level` )

추상 연산 TestIntegrityLevel. 인수 obj (Object) 및 level ((sealed 또는 frozen)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 객체의 자체 프로퍼티 집합이 고정되어 있는지 결정하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

extensible을 ? IsExtensible(obj)로 둡니다.
extensible이 true이면, false를 반환합니다.
참고: 객체가 확장 가능하면 해당 객체의 프로퍼티는 검사하지 않습니다.
keys를 ? obj.[[OwnPropertyKeys]]()로 둡니다.
keys의 각 요소 key에 대해 다음을 수행합니다.
1. currentDesc를 ? obj.[[GetOwnProperty]](key)로 둡니다.
2. currentDesc가 undefined가 아니면, 다음을 수행합니다.
  1. currentDesc.[[Configurable]]이 true이면, false를 반환합니다.
  2. level이 frozen이고 IsDataDescriptor(currentDesc)가 true이면, 다음을 수행합니다.
    1. currentDesc.[[Writable]]이 true이면, false를 반환합니다.
true를 반환합니다.

7.3.17 CreateArrayFromList ( `elements` )

추상 연산 CreateArrayFromList. 인수 elements (리스트 (요소: ECMAScript 언어 값)). 반환값: Array. elements가 제공하는 요소를 갖는 Array를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

array를 ! ArrayCreate(0)으로 둡니다.
n을 0으로 둡니다.
elements의 각 요소 element에 대해 다음을 수행합니다.
1. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(n)), element)를 수행합니다.
2. n을 n + 1로 설정합니다.
array를 반환합니다.

7.3.18 LengthOfArrayLike ( `obj` )

추상 연산 LengthOfArrayLike. 인수 obj (Object). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). 배열과 유사한 객체의 "length" 프로퍼티 값을 반환합니다. 호출되면 다음 단계를 수행한다.

ℝ(? ToLength(? Get(obj, "length")))를 반환합니다.

배열과 유사한 객체는 이 연산이 정상 완료를 반환하는 모든 객체입니다.

참고 1

일반적으로 배열과 유사한 객체에는 정수 인덱스 이름을 갖는 프로퍼티도 일부 있을 수 있습니다. 그러나 이는 이 정의의 요구 사항은 아닙니다.

참고 2

Array와 String 객체는 배열과 유사한 객체의 예입니다.

7.3.19 CreateListFromArrayLike ( `obj` [ , `validElementTypes` ] )

추상 연산 CreateListFromArrayLike. 인수 obj (ECMAScript 언어 값) 및 선택적 인수 validElementTypes ((any 또는 property-key)). 반환값: ECMAScript 언어 값의 List를 포함하는 정상 완료 또는 예외 완료. obj의 인덱스 속성에서 요소를 가져오는 List 값을 생성하는 데 사용됩니다. validElementTypes는 요소로 허용되는 값의 유형을 나타냅니다. 호출되면 다음 단계를 수행한다.

validElementTypes가 제공되지 않았으면 validElementTypes를 any로 설정합니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
list를 새로운 빈 List로 둡니다.
index를 0으로 둡니다.
index < length인 동안 다음 단계를 반복합니다,
1. indexName을 ! ToString(𝔽(index))으로 둡니다.
2. next를 ? Get(obj, indexName)로 둡니다.
3. validElementTypes가 property-key이고 next가 속성 키가 아니면 TypeError 예외를 던집니다.
4. next를 list에 추가합니다.
5. index를 index + 1로 설정합니다.
list를 반환합니다.

7.3.20 Invoke ( `value`, `propertyKey` [ , `argList` ] )

추상 연산 Invoke. 인수 value (ECMAScript 언어 값) 및 propertyKey (프로퍼티 키) 및 선택적 인수 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). ECMAScript 언어 값의 메서드 프로퍼티를 호출하는 데 사용됩니다. value는 프로퍼티 조회 지점이면서 호출의 this 값이기도 합니다. argList는 메서드에 전달되는 인수 값의 목록입니다. argList가 존재하지 않으면 새로운 빈 List를 값으로 사용합니다. 호출되면 다음 단계를 수행한다.

argList가 존재하지 않으면, argList를 새로운 빈 List로 설정합니다.
func를 ? GetV(value, propertyKey)로 둡니다.
? Call(func, value, argList)를 반환합니다.

7.3.21 OrdinaryHasInstance ( `ctor`, `instance` )

추상 연산 OrdinaryHasInstance. 인수 ctor (ECMAScript 언어 값) 및 instance (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). instance가 ctor가 제공하는 인스턴스 객체 상속 경로에서 상속하는지를 결정하는 기본 알고리즘을 구현합니다. 호출되면 다음 단계를 수행한다.

IsCallable(ctor)이 false이면, false를 반환합니다.
ctor에 [[BoundTargetFunction]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. boundCtor를 ctor.[[BoundTargetFunction]]으로 둡니다.
2. ? InstanceofOperator(instance, boundCtor)를 반환합니다.
instance가 Object가 아니면, false를 반환합니다.
proto를 ? Get(ctor, "prototype")로 둡니다.
proto가 Object가 아니면, TypeError 예외를 던집니다.
다음을 반복합니다.
1. instance를 ? instance.[[GetPrototypeOf]]()로 설정합니다.
2. instance가 null이면, false를 반환합니다.
3. SameValue(proto, instance)가 true이면, true를 반환합니다.

7.3.22 SpeciesConstructor ( `obj`, `defaultCtor` )

추상 연산 SpeciesConstructor. 인수 obj (Object) 및 defaultCtor (생성자). 반환값: (정상 완료 (값: 생성자) 또는 throw 완료). obj에서 파생되는 새로운 객체를 생성하는 데 사용해야 하는 생성자를 가져오는 데 사용됩니다. defaultCtor는 obj에서 시작하여 생성자 %Symbol.species% 프로퍼티를 찾을 수 없는 경우 사용할 생성자입니다. 호출되면 다음 단계를 수행한다.

ctor를 ? Get(obj, "constructor")로 둡니다.
ctor가 undefined이면, defaultCtor를 반환합니다.
ctor가 Object가 아니면, TypeError 예외를 던집니다.
species를 ? Get(ctor, %Symbol.species%)로 둡니다.
species가 undefined 또는 null이면, defaultCtor를 반환합니다.
IsConstructor(species)가 true이면, species를 반환합니다.
TypeError 예외를 던집니다.

7.3.23 EnumerableOwnProperties ( `obj`, `kind` )

추상 연산 EnumerableOwnProperties. 인수 obj (Object) 및 kind ((key, value 또는 key+value)). 반환값: (정상 완료 (값: 리스트 (요소: ECMAScript 언어 값)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

ownKeys를 ? obj.[[OwnPropertyKeys]]()로 둡니다.
results를 새로운 빈 List로 둡니다.
ownKeys의 각 요소 key에 대해 다음을 수행합니다.
1. key가 String이면, 다음을 수행합니다.
  1. propertyDesc를 ? obj.[[GetOwnProperty]](key)로 둡니다.
  2. propertyDesc가 undefined가 아니고 propertyDesc.[[Enumerable]]이 true이면, 다음을 수행합니다.
    1. kind가 key이면, 다음을 수행합니다.
      1. key를 results에 추가합니다.
    2. 그렇지 않으면,
      1. value를 ? Get(obj, key)로 둡니다.
      2. kind가 value이면, 다음을 수행합니다.
        value를 results에 추가합니다.
      3. 그렇지 않으면,
        단언: kind는 key+value입니다.
        entry를 CreateArrayFromList(« key, value »)로 둡니다.
        entry를 results에 추가합니다.
results를 반환합니다.

7.3.24 GetFunctionRealm ( `func` )

추상 연산 GetFunctionRealm. 인수 func (함수 객체). 반환값: (정상 완료 (값: Realm 레코드) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

func에 [[Realm]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. func.[[Realm]]을 반환합니다.
func가 바인딩된 함수 특수 객체이면, 다음을 수행합니다.
1. boundTargetFunc를 func.[[BoundTargetFunction]]으로 둡니다.
2. ? GetFunctionRealm(boundTargetFunc)을 반환합니다.
func가 Proxy 특수 객체이면, 다음을 수행합니다.
1. ? ValidateNonRevokedProxy(func)를 수행합니다.
2. proxyTarget을 func.[[ProxyTarget]]으로 둡니다.
3. 단언: proxyTarget은 함수 객체입니다.
4. ? GetFunctionRealm(proxyTarget)을 반환합니다.
현재 Realm Record를 반환합니다.

참고

4 단계에는 func가 [[Realm]] 내부 슬롯을 갖지 않는 비표준 함수 특수 객체인 경우에만 도달합니다.

7.3.25 CopyDataProperties ( `target`, `source`, `excludedItems` )

추상 연산 CopyDataProperties. 인수 target (Object), source (ECMAScript 언어 값) 및 excludedItems (리스트 (요소: 프로퍼티 키)). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

source가 undefined 또는 null이면, unused를 반환합니다.
from을 ! ToObject(source)로 둡니다.
keys를 ? from.[[OwnPropertyKeys]]()로 둡니다.
keys의 각 요소 nextKey에 대해 다음을 수행합니다.
1. excluded를 false로 둡니다.
2. excludedItems의 각 요소 element에 대해 다음을 수행합니다.
  1. SameValue(element, nextKey)가 true이면, 다음을 수행합니다.
    1. excluded를 true로 설정합니다.
3. excluded가 false이면, 다음을 수행합니다.
  1. propertyDesc를 ? from.[[GetOwnProperty]](nextKey)로 둡니다.
  2. propertyDesc가 undefined가 아니고 propertyDesc.[[Enumerable]]이 true이면, 다음을 수행합니다.
    1. propertyValue를 ? Get(from, nextKey)로 둡니다.
    2. ! CreateDataPropertyOrThrow(target, nextKey, propertyValue)를 수행합니다.
unused를 반환합니다.

참고

여기에 전달되는 대상은 항상 새로 생성된 객체이며, 오류가 던져진 경우 직접 접근할 수 없습니다.

7.3.26 PrivateElementFind ( `obj`, `privateName` )

추상 연산 PrivateElementFind. 인수 obj (Object) 및 privateName (비공개 이름). 반환값: (PrivateElement 또는 empty). 호출되면 다음 단계를 수행한다.

obj.[[PrivateElements]]에 entry.[[Key]]가 privateName인 PrivateElement entry가 포함되어 있으면, 다음을 수행합니다.
1. entry를 반환합니다.
empty를 반환합니다.

7.3.27 PrivateFieldAdd ( `obj`, `privateName`, `value` )

추상 연산 PrivateFieldAdd. 인수 obj (Object), privateName (비공개 이름) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

호스트가 웹 브라우저이면, 다음을 수행합니다.
1. ? HostEnsureCanAddPrivateElement(obj)를 수행합니다.
entry를 PrivateElementFind(obj, privateName)로 둡니다.
entry가 empty가 아니면, TypeError 예외를 던집니다.
PrivateElement { [[Key]]: privateName, [[Kind]]: field, [[Value]]: value }를 obj.[[PrivateElements]]에 추가합니다.
unused를 반환합니다.

7.3.28 PrivateMethodOrAccessorAdd ( `obj`, `method` )

추상 연산 PrivateMethodOrAccessorAdd. 인수 obj (Object) 및 method (PrivateElement). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: method.[[Kind]]는 method 또는 accessor입니다.
호스트가 웹 브라우저이면, 다음을 수행합니다.
1. ? HostEnsureCanAddPrivateElement(obj)를 수행합니다.
entry를 PrivateElementFind(obj, method.[[Key]])로 둡니다.
entry가 empty가 아니면, TypeError 예외를 던집니다.
method를 obj.[[PrivateElements]]에 추가합니다.
unused를 반환합니다.

참고

비공개 메서드와 접근자의 값은 인스턴스 간에 공유됩니다. 이 연산은 메서드 또는 접근자의 새 복사본을 생성하지 않습니다.

7.3.29 HostEnsureCanAddPrivateElement ( `obj` )

호스트 정의 추상 연산 HostEnsureCanAddPrivateElement. 인수 obj (Object). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호스트 환경이 특정 호스트 정의 특수 객체에 비공개 요소를 추가하는 것을 방지할 수 있도록 합니다.

HostEnsureCanAddPrivateElement의 구현은 다음 요구 사항을 준수해야 합니다:

obj가 호스트 정의 특수 객체가 아니면 이 추상 연산은 NormalCompletion(unused)을 반환해야 하며 다른 단계를 수행해서는 안 됩니다.
동일한 인수로 이 추상 연산을 두 번 호출하면 동일한 종류의 Completion Record를 반환해야 합니다.

HostEnsureCanAddPrivateElement의 기본 구현은 NormalCompletion(unused)을 반환하는 것입니다.

이 추상 연산은 웹 브라우저인 ECMAScript 호스트에서만 호출됩니다.

7.3.30 PrivateGet ( `obj`, `privateName` )

추상 연산 PrivateGet. 인수 obj (Object) 및 privateName (비공개 이름). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

entry를 PrivateElementFind(obj, privateName)로 둡니다.
entry가 empty이면, TypeError 예외를 던집니다.
entry.[[Kind]]가 field 또는 method이면, 다음을 수행합니다.
1. entry.[[Value]]를 반환합니다.
단언: entry.[[Kind]]는 accessor입니다.
entry.[[Getter]]가 undefined이면, TypeError 예외를 던집니다.
getter를 entry.[[Getter]]로 둡니다.
? Call(getter, obj)를 반환합니다.

7.3.31 PrivateSet ( `obj`, `privateName`, `value` )

추상 연산 PrivateSet. 인수 obj (Object), privateName (비공개 이름) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

entry를 PrivateElementFind(obj, privateName)로 둡니다.
entry가 empty이면, TypeError 예외를 던집니다.
entry.[[Kind]]가 method이면, TypeError 예외를 던집니다.
entry.[[Kind]]가 field이면, 다음을 수행합니다.
1. entry.[[Value]]를 value로 설정합니다.
그렇지 않으면,
1. 단언: entry.[[Kind]]는 accessor입니다.
2. entry.[[Setter]]가 undefined이면, TypeError 예외를 던집니다.
3. setter를 entry.[[Setter]]로 둡니다.
4. ? Call(setter, obj, « value »)를 수행합니다.
unused를 반환합니다.

7.3.32 DefineField ( `receiver`, `fieldRecord` )

추상 연산 DefineField. 인수 receiver (Object) 및 fieldRecord (ClassFieldDefinition 레코드). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

fieldName을 fieldRecord.[[Name]]으로 둡니다.
initializer를 fieldRecord.[[Initializer]]로 둡니다.
initializer가 empty가 아니면, 다음을 수행합니다.
1. initValue를 ? Call(initializer, receiver)로 둡니다.
그렇지 않으면,
1. initValue를 undefined로 둡니다.
fieldName이 Private Name이면, 다음을 수행합니다.
1. ? PrivateFieldAdd(receiver, fieldName, initValue)를 수행합니다.
그렇지 않으면,
1. 단언: fieldName은 프로퍼티 키입니다.
2. ? CreateDataPropertyOrThrow(receiver, fieldName, initValue)를 수행합니다.
unused를 반환합니다.

7.3.33 InitializeInstanceElements ( `obj`, `ctor` )

추상 연산 InitializeInstanceElements. 인수 obj (Object) 및 ctor ((ECMAScript 함수 객체 또는 내장 함수 객체)). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

methods를 ctor.[[PrivateMethods]]로 둡니다.
methods의 각 PrivateElement method에 대해 다음을 수행합니다.
1. ? PrivateMethodOrAccessorAdd(obj, method)를 수행합니다.
fields를 ctor.[[Fields]]로 둡니다.
fields의 각 요소 fieldRecord에 대해 다음을 수행합니다.
1. ? DefineField(obj, fieldRecord)를 수행합니다.
unused를 반환합니다.

7.3.34 AddValueToKeyedGroup ( `groups`, `key`, `value` )

추상 연산 AddValueToKeyedGroup. 인수 groups (리스트 (요소: 레코드 (필드: [[Key]] (ECMAScript 언어 값), [[Elements]] (리스트 (요소: ECMAScript 언어 값))))), key (ECMAScript 언어 값) 및 value (ECMAScript 언어 값). 반환값: unused. 호출되면 다음 단계를 수행한다.

groups의 각 Record { [[Key]], [[Elements]] } group에 대해 다음을 수행합니다.
1. SameValue(group.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. 단언: groups의 정확히 하나의 요소만 이 기준을 만족합니다.
  2. value를 group.[[Elements]]에 추가합니다.
  3. unused를 반환합니다.
group을 Record { [[Key]]: key, [[Elements]]: « value » }로 둡니다.
group을 groups에 추가합니다.
unused를 반환합니다.

7.3.35 GroupBy ( `items`, `callback`, `keyCoercion` )

추상 연산 GroupBy. 인수 items (ECMAScript 언어 값), callback (ECMAScript 언어 값) 및 keyCoercion ((property 또는 collection)). 반환값: (정상 완료 (값: 리스트 (요소: 레코드 (필드: [[Key]] (ECMAScript 언어 값), [[Elements]] (리스트 (요소: ECMAScript 언어 값))))) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireObjectCoercible(items)를 수행합니다.
IsCallable(callback)이 false이면, TypeError 예외를 던집니다.
groups를 새로운 빈 List로 둡니다.
iteratorRecord를 ? GetIterator(items, sync)로 둡니다.
k를 0으로 둡니다.
다음을 반복합니다.
1. k ≥ 2⁵³ - 1이면, 다음을 수행합니다.
  1. error를 ThrowCompletion(새로 생성된 TypeError 객체)으로 둡니다.
  2. ? IteratorClose(iteratorRecord, error)를 반환합니다.
2. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
3. next가 done이면, 다음을 수행합니다.
  1. groups를 반환합니다.
4. value를 next로 둡니다.
5. key를 Completion(Call(callback, undefined, « value, 𝔽(k) »))으로 둡니다.
6. IfAbruptCloseIterator(key, iteratorRecord).
7. keyCoercion이 property이면, 다음을 수행합니다.
  1. key를 Completion(ToPropertyKey(key))으로 설정합니다.
  2. IfAbruptCloseIterator(key, iteratorRecord).
8. 그렇지 않으면,
  1. 단언: keyCoercion은 collection입니다.
  2. key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
9. AddValueToKeyedGroup(groups, key, value)를 수행합니다.
10. k를 k + 1로 설정합니다.

7.3.36 GetOptionsObject ( `options` )

추상 연산 GetOptionsObject. 인수 options (ECMAScript 언어 값). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

options가 undefined이면, 다음을 수행합니다.
1. OrdinaryObjectCreate(null)을 반환합니다.
options가 Object이면, 다음을 수행합니다.
1. options를 반환합니다.
TypeError 예외를 던집니다.

7.3.37 SetterThatIgnoresPrototypeProperties ( `thisValue`, `home`, `propertyKey`, `value` )

추상 연산 SetterThatIgnoresPrototypeProperties. 인수 thisValue (ECMAScript 언어 값), home (Object), propertyKey (프로퍼티 키) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

thisValue가 Object가 아니면, 다음을 수행합니다.
1. TypeError 예외를 던집니다.
SameValue(thisValue, home)가 true이면, 다음을 수행합니다.
1. 참고: 여기에서 예외를 던지는 것은 엄격 모드 코드에서 home 객체의 쓰기 불가능한 데이터 프로퍼티에 할당하는 동작을 모방합니다.
2. TypeError 예외를 던집니다.
propertyDesc를 ? thisValue.[[GetOwnProperty]](propertyKey)로 둡니다.
propertyDesc가 undefined이면, 다음을 수행합니다.
1. ? CreateDataPropertyOrThrow(thisValue, propertyKey, value)를 수행합니다.
그렇지 않으면,
1. ? Set(thisValue, propertyKey, value, true)를 수행합니다.
unused를 반환합니다.

7.4 Iterator 객체에 대한 연산

공통 반복 인터페이스(27.1)를 참조하시기 바랍니다.

7.4.1 Iterator Record

Iterator Record는 이터레이터 또는 비동기 이터레이터와 next 메서드를 함께 캡슐화하는 데 사용하는 Record입니다.

Iterator Record에는 표 13에 나열된 필드가 있습니다.

표 13: Iterator Record 필드

필드 이름	값	의미
`[[Iterator]]`	Object	이터레이터 인터페이스 또는 비동기 이터레이터 인터페이스를 준수하는 객체입니다.
`[[NextMethod]]`	ECMAScript 언어 값	`[[Iterator]]` 객체의 `next` 메서드입니다.
`[[Done]]`	Boolean	이터레이터가 완료되었거나 닫혔는지를 나타냅니다.

7.4.2 GetIteratorDirect ( `obj` )

추상 연산 GetIteratorDirect. 인수 obj (Object). 반환값: Iterator Record를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

nextMethod를 ? Get(obj, "next")로 둡니다.
iteratorRecord를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: nextMethod, [[Done]]: false }로 둡니다.
iteratorRecord를 반환합니다.

7.4.3 GetIteratorFromMethod ( `obj`, `method` )

추상 연산 GetIteratorFromMethod. 인수 obj (ECMAScript 언어 값) 및 method (함수 객체). 반환값: Iterator Record를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

iterator를 ? Call(method, obj)로 둡니다.
iterator가 Object가 아니면, TypeError 예외를 던집니다.
? GetIteratorDirect(iterator)를 반환합니다.

7.4.4 GetIterator ( `obj`, `kind` )

추상 연산 GetIterator. 인수 obj (ECMAScript 언어 값) 및 kind (sync 또는 async). 반환값: Iterator Record를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

kind가 async이면, 다음을 수행합니다.
1. method를 ? GetMethod(obj, %Symbol.asyncIterator%)로 둡니다.
2. method가 undefined이면, 다음을 수행합니다.
  1. syncMethod를 ? GetMethod(obj, %Symbol.iterator%)로 둡니다.
  2. syncMethod가 undefined이면, TypeError 예외를 던집니다.
  3. syncIteratorRecord를 ? GetIteratorFromMethod(obj, syncMethod)로 둡니다.
  4. CreateAsyncFromSyncIterator(syncIteratorRecord)를 반환합니다.
그렇지 않으면,
1. method를 ? GetMethod(obj, %Symbol.iterator%)로 둡니다.
method가 undefined이면, TypeError 예외를 던집니다.
? GetIteratorFromMethod(obj, method)를 반환합니다.

7.4.5 GetIteratorFlattenable ( `obj`, `primitiveHandling` )

추상 연산 GetIteratorFlattenable. 인수 obj (ECMAScript 언어 값) 및 primitiveHandling (iterate-string-primitives 또는 reject-primitives). 반환값: Iterator Record를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

obj가 Object가 아니면, 다음을 수행합니다.
1. primitiveHandling이 reject-primitives이면, TypeError 예외를 던집니다.
2. 단언: primitiveHandling은 iterate-string-primitives입니다.
3. obj가 String이 아니면, TypeError 예외를 던집니다.
method를 ? GetMethod(obj, %Symbol.iterator%)로 둡니다.
method가 undefined이면, 다음을 수행합니다.
1. iterator를 obj로 둡니다.
그렇지 않으면,
1. iterator를 ? Call(method, obj)로 둡니다.
iterator가 Object가 아니면, TypeError 예외를 던집니다.
? GetIteratorDirect(iterator)를 반환합니다.

7.4.6 IteratorNext ( `iteratorRecord` [ , `value` ] )

추상 연산 IteratorNext. 인수 iteratorRecord (Iterator 레코드) 및 선택적 인수 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

value가 존재하지 않으면, 다음을 수행합니다.
1. result를 Completion(Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]))으로 둡니다.
그렇지 않으면,
1. result를 Completion(Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »))으로 둡니다.
result가 throw 완료이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]을 true로 설정합니다.
2. ? result를 반환합니다.
result를 ! result로 설정합니다.
result가 Object가 아니면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]을 true로 설정합니다.
2. TypeError 예외를 던집니다.
result를 반환합니다.

7.4.7 IteratorComplete ( `iteratorResult` )

추상 연산 IteratorComplete. 인수 iteratorResult (Object). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

ToBoolean(? Get(iteratorResult, "done"))을 반환합니다.

7.4.8 IteratorValue ( `iteratorResult` )

추상 연산 IteratorValue. 인수 iteratorResult (Object). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? Get(iteratorResult, "value")를 반환합니다.

7.4.9 IteratorStep ( `iteratorRecord` )

추상 연산 IteratorStep. 인수 iteratorRecord (Iterator 레코드). 반환값: (정상 완료 (값: (Object 또는 done)) 또는 throw 완료). iteratorRecord.[[NextMethod]]을 호출하여 iteratorRecord.[[Iterator]]에서 다음 값을 요청하고, 이터레이터가 끝에 도달했음을 나타내는 done 또는 다음 값이 있으면 IteratorResult 객체를 반환합니다. 호출되면 다음 단계를 수행한다.

result를 ? IteratorNext(iteratorRecord)로 둡니다.
done을 Completion(IteratorComplete(result))으로 둡니다.
done이 throw 완료이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]을 true로 설정합니다.
2. ? done을 반환합니다.
done을 ! done으로 설정합니다.
done이 true이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]을 true로 설정합니다.
2. done을 반환합니다.
result를 반환합니다.

7.4.10 IteratorStepValue ( `iteratorRecord` )

추상 연산 IteratorStepValue. 인수 iteratorRecord (Iterator 레코드). 반환값: (정상 완료 (값: (ECMAScript 언어 값 또는 done)) 또는 throw 완료). iteratorRecord.[[NextMethod]]을 호출하여 iteratorRecord.[[Iterator]]에서 다음 값을 요청하고, 이터레이터가 끝에 도달했음을 나타내는 done 또는 다음 값이 있으면 IteratorResult 객체의 값을 반환합니다. 호출되면 다음 단계를 수행한다.

result를 ? IteratorStep(iteratorRecord)로 둡니다.
result가 done이면, 다음을 수행합니다.
1. done을 반환합니다.
value를 Completion(IteratorValue(result))으로 둡니다.
value가 throw 완료이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]을 true로 설정합니다.
? value를 반환합니다.

7.4.11 IteratorClose ( `iteratorRecord`, `completion` )

추상 연산 IteratorClose. 인수 iteratorRecord (Iterator 레코드) 및 completion (완료 레코드). 반환값: 완료 레코드. 이터레이터가 완료 상태에 도달했을 때 일반적으로 수행하는 동작을 수행해야 함을 해당 이터레이터에 알리는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

단언: iteratorRecord.[[Iterator]]는 Object입니다.
iterator를 iteratorRecord.[[Iterator]]로 둡니다.
innerResult를 Completion(GetMethod(iterator, "return"))으로 둡니다.
innerResult가 정상 완료이면, 다음을 수행합니다.
1. return을 innerResult.[[Value]]로 둡니다.
2. return이 undefined이면, ? completion을 반환합니다.
3. innerResult를 Completion(Call(return, iterator))으로 설정합니다.
completion이 throw 완료이면, ? completion을 반환합니다.
innerResult가 throw 완료이면, ? innerResult를 반환합니다.
innerResult.[[Value]]가 Object가 아니면, TypeError 예외를 던집니다.
? completion을 반환합니다.

7.4.12 IteratorCloseAll ( `iterators`, `completion` )

추상 연산 IteratorCloseAll. 인수 iterators (리스트 (요소: Iterator 레코드)) 및 completion (완료 레코드). 반환값: 완료 레코드. 호출되면 다음 단계를 수행한다.

iterators의 각 요소 iterator에 대해 List 역순으로 다음을 수행합니다.
1. completion을 Completion(IteratorClose(iterator, completion))으로 설정합니다.
? completion을 반환합니다.

7.4.13 IfAbruptCloseIterator ( `value`, `iteratorRecord` )

IfAbruptCloseIterator는 Iterator Record를 사용하는 알고리즘 단계 시퀀스의 축약 표현입니다. 다음 형식의 알고리즘 단계:

IfAbruptCloseIterator(value, iteratorRecord).

는 다음과 같은 의미입니다:

단언: value는 Completion Record입니다.
value가 비정상 완료이면, ? IteratorClose(iteratorRecord, value)를 반환합니다.
value를 ! value로 설정합니다.

7.4.14 IfAbruptCloseIterators ( `value`, `iteratorRecords` )

IfAbruptCloseIterators는 Iterator Record의 목록을 사용하는 알고리즘 단계 시퀀스의 축약 표현입니다. 다음 형식의 알고리즘 단계:

IfAbruptCloseIterators(value, iteratorRecords).

는 다음과 같은 의미입니다:

단언: value는 Completion Record입니다.
value가 비정상 완료이면, ? IteratorCloseAll(iteratorRecords, value)을 반환합니다.
value를 ! value로 설정합니다.

7.4.15 AsyncIteratorClose ( `iteratorRecord`, `completion` )

추상 연산 AsyncIteratorClose. 인수 iteratorRecord (Iterator 레코드) 및 completion (완료 레코드). 반환값: 완료 레코드. 비동기 이터레이터가 완료 상태에 도달했을 때 일반적으로 수행하는 동작을 수행해야 함을 해당 이터레이터에 알리는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

단언: iteratorRecord.[[Iterator]]는 Object입니다.
iterator를 iteratorRecord.[[Iterator]]로 둡니다.
innerResult를 Completion(GetMethod(iterator, "return"))으로 둡니다.
innerResult가 정상 완료이면, 다음을 수행합니다.
1. return을 innerResult.[[Value]]로 둡니다.
2. return이 undefined이면, ? completion을 반환합니다.
3. innerResult를 Completion(Call(return, iterator))으로 설정합니다.
4. innerResult가 정상 완료이면, innerResult를 Completion(Await(innerResult.[[Value]]))으로 설정합니다.
completion이 throw 완료이면, ? completion을 반환합니다.
innerResult가 throw 완료이면, ? innerResult를 반환합니다.
innerResult.[[Value]]가 Object가 아니면, TypeError 예외를 던집니다.
? completion을 반환합니다.

7.4.16 IfAbruptCloseAsyncIterator ( `value`, `iteratorRecord` )

IfAbruptCloseAsyncIterator는 Iterator Record를 사용하는 알고리즘 단계 시퀀스의 축약 표현입니다. 다음 형식의 알고리즘 단계:

IfAbruptCloseAsyncIterator(value, iteratorRecord).

는 다음과 같은 의미입니다:

단언: value는 Completion Record입니다.
value가 비정상 완료이면, ? AsyncIteratorClose(iteratorRecord, value)를 반환합니다.
value를 ! value로 설정합니다.

7.4.17 CreateIteratorResultObject ( `value`, `done` )

추상 연산 CreateIteratorResultObject. 인수 value (ECMAScript 언어 값) 및 done (Boolean). 반환값: an Object that conforms to the IteratorResult interface. IteratorResult 인터페이스를 준수하는 객체를 생성합니다. 호출되면 다음 단계를 수행한다.

obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
! CreateDataPropertyOrThrow(obj, "value", value)를 수행합니다.
! CreateDataPropertyOrThrow(obj, "done", done)을 수행합니다.
obj를 반환합니다.

7.4.18 CreateListIteratorRecord ( `list` )

추상 연산 CreateListIteratorRecord. 인수 list (리스트 (요소: ECMAScript 언어 값)). 반환값: Iterator 레코드. [[NextMethod]]가 list의 연속된 요소를 반환하는 Iterator Record를 생성합니다. 호출되면 다음 단계를 수행한다.

closure를 매개변수가 없고 list를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. list의 각 요소 value에 대해 다음을 수행합니다.
  1. ? GeneratorYield(CreateIteratorResultObject(value, false))를 수행합니다.
2. NormalCompletion(undefined)을 반환합니다.
iterator를 CreateIteratorFromClosure(closure, empty, %Iterator.prototype%)로 둡니다.
Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]: false }를 반환합니다.

참고

목록 이터레이터 객체에는 ECMAScript 코드에서 직접 접근할 수 없습니다.

7.4.19 IteratorToList ( `iteratorRecord` )

추상 연산 IteratorToList. 인수 iteratorRecord (Iterator 레코드). 반환값: (정상 완료 (값: 리스트 (요소: ECMAScript 언어 값)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

values를 새로운 빈 List로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면, 다음을 수행합니다.
  1. values를 반환합니다.
3. next를 values에 추가합니다.

7.5 폐기 가능한 객체에 대한 연산

공통 리소스 관리 인터페이스(27.2.1)를 참조하시기 바랍니다.

7.5.1 DisposableResource Record

DisposableResource Record는 폐기 가능한 객체와 해당 객체를 폐기하는 데 사용하는 메서드를 함께 캡슐화하는 Record 값입니다. DisposableResource Record는 CreateDisposableResource 추상 연산에 의해 생성됩니다.

DisposableResource Record에는 표 14에 나열된 필드가 있습니다:

표 14: DisposableResource Record 필드

필드 이름	값	의미
`[[ResourceValue]]`	Object 또는 undefined	폐기할 값입니다.
`[[Kind]]`	sync-dispose 또는 async-dispose	리소스가 `using` 선언 또는 DisposableStack 객체(sync-dispose)에 의해 추가되었는지, 아니면 `await using` 선언 또는 AsyncDisposableStack 객체(async-dispose)에 의해 추가되었는지를 나타냅니다.
`[[DisposeMethod]]`	함수 객체 또는 undefined	리소스를 폐기할 때 `[[ResourceValue]]`를 this 값으로 하여 호출될 함수 객체입니다.

7.5.2 AddDisposableResource ( `disposableResourceStack`, `value`, `kind` [ , `method` ] )

추상 연산 AddDisposableResource. 인수 disposableResourceStack (리스트 (요소: DisposableResource 레코드)), value (ECMAScript 언어 값) 및 kind ((sync-dispose 또는 async-dispose)) 및 선택적 인수 method (함수 객체). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

method가 존재하면, 다음을 수행합니다.
1. 단언: value는 undefined입니다.
2. resource를 ? CreateDisposableResource(undefined, kind, method)로 둡니다.
그렇지 않으면,
1. value가 null 또는 undefined이고 kind가 sync-dispose이면, unused를 반환합니다.
2. 참고: value가 null 또는 undefined이고 kind가 async-dispose이면, 나중에 리소스를 폐기할 때에도 Await를 수행하도록 보장하기 위해 해당 리소스가 평가되었음을 기록합니다.
3. resource를 ? CreateDisposableResource(value, kind)로 둡니다.
resource를 disposableResourceStack에 추가합니다.
unused를 반환합니다.

7.5.3 CreateDisposableResource ( `value`, `kind` [ , `method` ] )

추상 연산 CreateDisposableResource. 인수 value (ECMAScript 언어 값) 및 kind ((sync-dispose 또는 async-dispose)) 및 선택적 인수 method (함수 객체). 반환값: (정상 완료 (값: DisposableResource 레코드) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

method가 존재하지 않으면, 다음을 수행합니다.
1. value가 null 또는 undefined이면, 다음을 수행합니다.
  1. value를 undefined로 설정합니다.
  2. method를 undefined로 설정합니다.
2. 그렇지 않으면,
  1. method를 ? GetDisposeMethod(value, kind)로 설정합니다.
  2. method가 undefined이면, TypeError 예외를 던집니다.
DisposableResource Record { [[ResourceValue]]: value, [[Kind]]: kind, [[DisposeMethod]]: method }를 반환합니다.

7.5.4 GetDisposeMethod ( `value`, `kind` )

추상 연산 GetDisposeMethod. 인수 value (ECMAScript 언어 값) 및 kind ((sync-dispose 또는 async-dispose)). 반환값: (정상 완료 (값: (함수 객체 또는 undefined)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

value가 Object가 아니면, TypeError 예외를 던집니다.
kind가 sync-dispose이면, ? GetMethod(value, %Symbol.dispose%)를 반환합니다.
단언: kind는 async-dispose입니다.
asyncMethod를 ? GetMethod(value, %Symbol.asyncDispose%)로 둡니다.
asyncMethod가 undefined가 아니면, asyncMethod를 반환합니다.
syncMethod를 ? GetMethod(value, %Symbol.dispose%)로 둡니다.
syncMethod가 undefined이면, undefined를 반환합니다.
closure를 매개변수가 없고 syncMethod를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. obj를 this 값으로 둡니다.
2. promiseCapability를 ! NewPromiseCapability(%Promise%)로 둡니다.
3. result를 Completion(Call(syncMethod, obj))으로 둡니다.
4. IfAbruptRejectPromise(result, promiseCapability).
5. ! Call(promiseCapability.[[Resolve]], undefined, « undefined »)를 수행합니다.
6. promiseCapability.[[Promise]]를 반환합니다.
참고: 이 함수는 사용자 코드에서 관찰할 수 없습니다. 동기 %Symbol.dispose% 메서드가 반환한 Promise를 기다리지 않도록 하고, 동기 예외를 거부된 Promise로 변환하기 위해 사용됩니다.
CreateBuiltinFunction(closure, 0, "", « »)을 반환합니다.

7.5.5 DisposeResources ( `disposableResourceStack`, `completion` )

추상 연산 DisposeResources. 인수 disposableResourceStack (리스트 (요소: DisposableResource 레코드)) 및 completion ((정상 완료 (값: (ECMAScript 언어 값 또는 empty)) 또는 중도 완료)). 반환값: (정상 완료 (값: (ECMAScript 언어 값 또는 empty)) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

needsAwait를 false로 둡니다.
hasAwaited를 false로 둡니다.
outputCompletion을 completion으로 둡니다.
disposableResourceStack의 각 요소 resource에 대해 List 역순으로 다음을 수행합니다.
1. value를 resource.[[ResourceValue]]로 둡니다.
2. kind를 resource.[[Kind]]로 둡니다.
3. method를 resource.[[DisposeMethod]]로 둡니다.
4. kind가 sync-dispose이고, needsAwait가 true이며, hasAwaited가 false이면, 다음을 수행합니다.
  1. ! Await(undefined)를 수행합니다.
  2. needsAwait를 false로 설정합니다.
5. method가 undefined가 아니면, 다음을 수행합니다.
  1. result를 Completion(Call(method, value))으로 둡니다.
  2. result가 정상 완료이고 kind가 async-dispose이면, 다음을 수행합니다.
    1. result를 Completion(Await(result.[[Value]]))으로 설정합니다.
    2. hasAwaited를 true로 설정합니다.
  3. result가 throw 완료이면, 다음을 수행합니다.
    1. outputCompletion이 throw 완료이면, 다음을 수행합니다.
      1. result를 result.[[Value]]로 설정합니다.
      2. suppressed를 outputCompletion.[[Value]]로 둡니다.
      3. error를 새로 생성된 SuppressedError 객체로 둡니다.
      4. CreateNonEnumerableDataPropertyOrThrow(error, "error", result)를 수행합니다.
      5. CreateNonEnumerableDataPropertyOrThrow(error, "suppressed", suppressed)를 수행합니다.
      6. outputCompletion을 ThrowCompletion(error)으로 설정합니다.
    2. 그렇지 않으면,
      1. outputCompletion을 result로 설정합니다.
6. 그렇지 않으면,
  1. 단언: kind는 async-dispose입니다.
  2. needsAwait를 true로 설정합니다.
  3. 참고: 이는 await using 선언의 초기화 값이 null 또는 undefined였던 경우만 나타낼 수 있습니다.
needsAwait가 true이고 hasAwaited가 false이면, 다음을 수행합니다.
1. ! Await(undefined)를 수행합니다.
참고: 이 시점 이후 disposableResourceStack은 다시 사용되지 않습니다. 구현체에서는 가비지 컬렉션 등의 방법으로 disposableResourceStack의 내용을 버릴 수 있습니다.
? outputCompletion을 반환합니다.

8 구문 지향 연산

이 절에 정의된 것 외에도 특수한 구문 지향 연산이 이 명세 전반에 걸쳐 정의되어 있습니다.

8.1 Runtime Semantics: Evaluation

구문 지향 연산 Evaluation. 인수 없음. 반환값: 완료 레코드.

참고

이 연산의 정의는 이 명세의 “ECMAScript 언어” 절 전반에 분산되어 있습니다. 각 정의는 관련 생성 규칙을 정의하는 부분 다음에 나타납니다.

8.2 스코프 분석

8.2.1 Static Semantics: BoundNames

구문 지향 연산 BoundNames. 인수 없음. 반환값: 리스트 (요소: String).

참고

"*default*"는 다른 이름이 없는 모듈의 기본 내보내기에 대한 합성 이름으로 이 명세에서 사용됩니다. 해당 이름으로 모듈의 [[Environment]]에 항목이 생성되어 대응하는 값을 보유하며, 모듈에 대해 ResolveExport ( exportName [ , resolveSet ] )를 호출하여 "default"라는 이름의 내보내기를 해석하면 [[BindingName]]이 "*default*"인 ResolvedBinding Record가 반환되고, 이는 다시 모듈의 [[Environment]]에서 위에서 언급한 값으로 해석됩니다. 이는 익명 기본 내보내기를 다른 내보내기와 동일하게 해석할 수 있도록 명세를 쉽게 작성하기 위한 것일 뿐입니다. 이 "*default*" String은 ECMAScript 코드나 모듈 연결 알고리즘에서 절대로 접근할 수 없습니다.

다음 생성 규칙별로 정의된다.

BindingIdentifier

Identifier

유일한 요소가 Identifier의 StringValue인 List를 반환합니다.

BindingIdentifier

yield

« "yield" »를 반환합니다.

BindingIdentifier

await

« "await" »를 반환합니다.

LexicalDeclaration

LetOrConst

BindingList

;

BindingList의 BoundNames를 반환합니다.

UsingDeclaration

using

BindingList

;

AwaitUsingDeclaration

CoverAwaitExpressionAndAwaitUsingDeclarationHead

BindingList

;

BindingList의 BoundNames를 반환합니다.

BindingList

LexicalBinding

names1을 BindingList의 BoundNames로 둡니다.
names2를 LexicalBinding의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

LexicalBinding

BindingIdentifier

Initializer

opt

BindingIdentifier의 BoundNames를 반환합니다.

LexicalBinding

BindingPattern

Initializer

BindingPattern의 BoundNames를 반환합니다.

VariableDeclarationList

VariableDeclaration

names1을 VariableDeclarationList의 BoundNames로 둡니다.
names2를 VariableDeclaration의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

VariableDeclaration

BindingIdentifier

Initializer

opt

BindingIdentifier의 BoundNames를 반환합니다.

VariableDeclaration

BindingPattern

Initializer

BindingPattern의 BoundNames를 반환합니다.

ObjectBindingPattern

{

}

새로운 빈 List를 반환합니다.

ObjectBindingPattern

{

BindingPropertyList

BindingRestProperty

}

names1을 BindingPropertyList의 BoundNames로 둡니다.
names2를 BindingRestProperty의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ArrayBindingPattern

[

Elision

opt

]

새로운 빈 List를 반환합니다.

ArrayBindingPattern

[

Elision

opt

BindingRestElement

]

BindingRestElement의 BoundNames를 반환합니다.

ArrayBindingPattern

[

BindingElementList

Elision

opt

]

BindingElementList의 BoundNames를 반환합니다.

[

opt

]

names1을 BindingElementList의 BoundNames로 둡니다.
names2를 BindingRestElement의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

BindingPropertyList

BindingProperty

names1을 BindingPropertyList의 BoundNames로 둡니다.
names2를 BindingProperty의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

BindingElementList

BindingElisionElement

names1을 BindingElementList의 BoundNames로 둡니다.
names2를 BindingElisionElement의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

BindingElisionElement

Elision

opt

BindingElement

BindingElement의 BoundNames를 반환합니다.

BindingProperty

PropertyName

BindingElement

BindingElement의 BoundNames를 반환합니다.

SingleNameBinding

BindingIdentifier

Initializer

opt

BindingIdentifier의 BoundNames를 반환합니다.

BindingElement

BindingPattern

Initializer

opt

BindingPattern의 BoundNames를 반환합니다.

ForDeclaration

LetOrConst

ForBinding

ForBinding의 BoundNames를 반환합니다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

BindingIdentifier의 BoundNames를 반환합니다.

FunctionDeclaration

function

(

FormalParameters

)

{

FunctionBody

}

« "*default*" »를 반환합니다.

FormalParameters

[empty]

새로운 빈 List를 반환합니다.

FormalParameters

FormalParameterList

FunctionRestParameter

names1을 FormalParameterList의 BoundNames로 둡니다.
names2를 FunctionRestParameter의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

FormalParameterList

FormalParameter

names1을 FormalParameterList의 BoundNames로 둡니다.
names2를 FormalParameter의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

formals를 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ArrowFormalParameters로 둡니다.
formals의 BoundNames를 반환합니다.

GeneratorDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

GeneratorBody

}

BindingIdentifier의 BoundNames를 반환합니다.

GeneratorDeclaration

function

(

FormalParameters

)

{

GeneratorBody

}

« "*default*" »를 반환합니다.

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

BindingIdentifier의 BoundNames를 반환합니다.

AsyncGeneratorDeclaration

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

« "*default*" »를 반환합니다.

ClassDeclaration

class

BindingIdentifier

ClassTail

BindingIdentifier의 BoundNames를 반환합니다.

ClassDeclaration

class

ClassTail

« "*default*" »를 반환합니다.

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

BindingIdentifier의 BoundNames를 반환합니다.

AsyncFunctionDeclaration

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

« "*default*" »를 반환합니다.

CoverCallExpressionAndAsyncArrowHead

MemberExpression

Arguments

head를 CoverCallExpressionAndAsyncArrowHead가 포괄하는 AsyncArrowHead로 둡니다.
head의 BoundNames를 반환합니다.

import

opt

;

ImportClause의 BoundNames를 반환합니다.

ImportDeclaration

import

ModuleSpecifier

WithClause

opt

;

새로운 빈 List를 반환합니다.

ImportClause

ImportedDefaultBinding

NameSpaceImport

names1을 ImportedDefaultBinding의 BoundNames로 둡니다.
names2를 NameSpaceImport의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ImportClause

ImportedDefaultBinding

NamedImports

names1을 ImportedDefaultBinding의 BoundNames로 둡니다.
names2를 NamedImports의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

NamedImports

{

}

새로운 빈 List를 반환합니다.

ImportsList

ImportSpecifier

names1을 ImportsList의 BoundNames로 둡니다.
names2를 ImportSpecifier의 BoundNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ImportSpecifier

ModuleExportName

ImportedBinding

ImportedBinding의 BoundNames를 반환합니다.

export

opt

;

export

NamedExports

;

새로운 빈 List를 반환합니다.

ExportDeclaration

export

VariableStatement

VariableStatement의 BoundNames를 반환합니다.

ExportDeclaration

export

Declaration

Declaration의 BoundNames를 반환합니다.

ExportDeclaration

export

default

HoistableDeclaration

declNames를 HoistableDeclaration의 BoundNames로 둡니다.
declNames에 "*default*" 요소가 포함되어 있지 않으면, "*default*"를 declNames에 추가합니다.
declNames를 반환합니다.

ExportDeclaration

export

default

ClassDeclaration

declNames를 ClassDeclaration의 BoundNames로 둡니다.
declNames에 "*default*" 요소가 포함되어 있지 않으면, "*default*"를 declNames에 추가합니다.
declNames를 반환합니다.

ExportDeclaration

export

default

AssignmentExpression

;

« "*default*" »를 반환합니다.

8.2.2 Static Semantics: DeclarationPart

구문 지향 연산 DeclarationPart. 인수 없음. 반환값: 구문 분석 노드. 다음 생성 규칙별로 정의된다.

HoistableDeclaration

FunctionDeclaration

FunctionDeclaration을 반환합니다.

HoistableDeclaration

GeneratorDeclaration

GeneratorDeclaration을 반환합니다.

HoistableDeclaration

AsyncFunctionDeclaration

AsyncFunctionDeclaration을 반환합니다.

HoistableDeclaration

AsyncGeneratorDeclaration

AsyncGeneratorDeclaration을 반환합니다.

Declaration

ClassDeclaration

ClassDeclaration을 반환합니다.

Declaration

LexicalDeclaration

LexicalDeclaration을 반환합니다.

8.2.3 Static Semantics: IsConstantDeclaration

구문 지향 연산 IsConstantDeclaration. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

LexicalDeclaration

LetOrConst

BindingList

;

LetOrConst의 IsConstantDeclaration을 반환합니다.

LetOrConst

let

false를 반환합니다.

LetOrConst

const

true를 반환합니다.

UsingDeclaration

using

BindingList

;

AwaitUsingDeclaration

CoverAwaitExpressionAndAwaitUsingDeclarationHead

BindingList

;

true를 반환합니다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

}

function

(

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

false를 반환합니다.

class

class

false를 반환합니다.

ExportDeclaration

export

ExportFromClause

FromClause

;

export

NamedExports

;

export

default

AssignmentExpression

;

false를 반환합니다.

참고

모듈의 기본 객체를 참조하는 데 사용하는 내부 바인딩 이름에 할당할 수 있는 구문이 없으므로 export default AssignmentExpression을 상수 선언으로 취급할 필요는 없습니다.

8.2.4 Static Semantics: IsUsingDeclaration

구문 지향 연산 IsUsingDeclaration. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

LexicalDeclaration

LetOrConst

BindingList

;

false를 반환합니다.

UsingDeclaration

using

BindingList

;

true를 반환합니다.

AwaitUsingDeclaration

CoverAwaitExpressionAndAwaitUsingDeclarationHead

BindingList

;

false를 반환합니다.

ForDeclaration

LetOrConst

ForBinding

false를 반환합니다.

ForDeclaration

using

ForBinding

true를 반환합니다.

ForDeclaration

await

using

ForBinding

false를 반환합니다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

}

function

(

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

false를 반환합니다.

class

class

false를 반환합니다.

8.2.5 Static Semantics: IsAwaitUsingDeclaration

구문 지향 연산 IsAwaitUsingDeclaration. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

LexicalDeclaration

LetOrConst

BindingList

;

false를 반환합니다.

UsingDeclaration

using

BindingList

;

false를 반환합니다.

AwaitUsingDeclaration

CoverAwaitExpressionAndAwaitUsingDeclarationHead

BindingList

;

true를 반환합니다.

ForDeclaration

LetOrConst

ForBinding

false를 반환합니다.

ForDeclaration

using

ForBinding

false를 반환합니다.

ForDeclaration

await

using

ForBinding

true를 반환합니다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

}

function

(

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

false를 반환합니다.

class

class

false를 반환합니다.

8.2.6 Static Semantics: LexicallyDeclaredNames

구문 지향 연산 LexicallyDeclaredNames. 인수 없음. 반환값: 리스트 (요소: String). 다음 생성 규칙별로 정의된다.

Block

{

}

새로운 빈 List를 반환합니다.

StatementList

StatementListItem

names1을 StatementList의 LexicallyDeclaredNames로 둡니다.
names2를 StatementListItem의 LexicallyDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

StatementListItem

Statement

Statement가 Statement : LabelledStatement 이면, LabelledStatement의 LexicallyDeclaredNames를 반환합니다.
새로운 빈 List를 반환합니다.

StatementListItem

Declaration

Declaration의 BoundNames를 반환합니다.

CaseBlock

{

}

새로운 빈 List를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, names1을 첫 번째 CaseClauses의 LexicallyDeclaredNames로 둡니다.
그렇지 않으면 names1을 새로운 빈 List로 둡니다.
names2를 DefaultClause의 LexicallyDeclaredNames로 둡니다.
두 번째 CaseClauses가 존재하면, names3을 두 번째 CaseClauses의 LexicallyDeclaredNames로 둡니다.
그렇지 않으면 names3을 새로운 빈 List로 둡니다.
names1, names2 및 names3의 목록 연결을 반환합니다.

CaseClauses

CaseClause

names1을 CaseClauses의 LexicallyDeclaredNames로 둡니다.
names2를 CaseClause의 LexicallyDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, StatementList의 LexicallyDeclaredNames를 반환합니다.
새로운 빈 List를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, StatementList의 LexicallyDeclaredNames를 반환합니다.
새로운 빈 List를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

LabelledItem의 LexicallyDeclaredNames를 반환합니다.

LabelledItem

Statement

새로운 빈 List를 반환합니다.

LabelledItem

FunctionDeclaration

FunctionDeclaration의 BoundNames를 반환합니다.

FunctionStatementList

[empty]

새로운 빈 List를 반환합니다.

FunctionStatementList

StatementList

StatementList의 TopLevelLexicallyDeclaredNames를 반환합니다.

ClassStaticBlockStatementList

[empty]

새로운 빈 List를 반환합니다.

ClassStaticBlockStatementList

StatementList

StatementList의 TopLevelLexicallyDeclaredNames를 반환합니다.

ConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

AsyncConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

Script

[empty]

새로운 빈 List를 반환합니다.

ScriptBody

StatementList

StatementList의 TopLevelLexicallyDeclaredNames를 반환합니다.

참고 1

Script의 최상위 수준에서 함수 선언은 렉시컬 선언이 아니라 var 선언처럼 취급됩니다.

참고 2

Module의 LexicallyDeclaredNames에는 가져온 모든 바인딩의 이름이 포함됩니다.

ModuleItemList

ModuleItem

names1을 ModuleItemList의 LexicallyDeclaredNames로 둡니다.
names2를 ModuleItem의 LexicallyDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ModuleItem

ImportDeclaration

ImportDeclaration의 BoundNames를 반환합니다.

ModuleItem

ExportDeclaration

ExportDeclaration이 export VariableStatement이면, 새로운 빈 List를 반환합니다.
ExportDeclaration의 BoundNames를 반환합니다.

ModuleItem

StatementListItem

StatementListItem의 LexicallyDeclaredNames를 반환합니다.

참고 3

Module의 최상위 수준에서 함수 선언은 var 선언이 아니라 렉시컬 선언처럼 취급됩니다.

8.2.7 Static Semantics: LexicallyScopedDeclarations

구문 지향 연산 LexicallyScopedDeclarations. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

decls1을 StatementList의 LexicallyScopedDeclarations로 둡니다.
decls2를 StatementListItem의 LexicallyScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

StatementListItem

Statement

Statement가 Statement : LabelledStatement 이면, LabelledStatement의 LexicallyScopedDeclarations를 반환합니다.
새로운 빈 List를 반환합니다.

StatementListItem

Declaration

유일한 요소가 Declaration의 DeclarationPart인 List를 반환합니다.

CaseBlock

{

}

새로운 빈 List를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, decls1을 첫 번째 CaseClauses의 LexicallyScopedDeclarations로 둡니다.
그렇지 않으면 decls1을 새로운 빈 List로 둡니다.
decls2를 DefaultClause의 LexicallyScopedDeclarations로 둡니다.
두 번째 CaseClauses가 존재하면, decls3을 두 번째 CaseClauses의 LexicallyScopedDeclarations로 둡니다.
그렇지 않으면 decls3을 새로운 빈 List로 둡니다.
decls1, decls2 및 decls3의 목록 연결을 반환합니다.

CaseClauses

CaseClause

decls1을 CaseClauses의 LexicallyScopedDeclarations로 둡니다.
decls2를 CaseClause의 LexicallyScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, StatementList의 LexicallyScopedDeclarations를 반환합니다.
새로운 빈 List를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, StatementList의 LexicallyScopedDeclarations를 반환합니다.
새로운 빈 List를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

LabelledItem의 LexicallyScopedDeclarations를 반환합니다.

LabelledItem

Statement

새로운 빈 List를 반환합니다.

LabelledItem

FunctionDeclaration

« FunctionDeclaration »을 반환합니다.

FunctionStatementList

[empty]

새로운 빈 List를 반환합니다.

FunctionStatementList

StatementList

StatementList의 TopLevelLexicallyScopedDeclarations를 반환합니다.

ClassStaticBlockStatementList

[empty]

새로운 빈 List를 반환합니다.

ClassStaticBlockStatementList

StatementList

StatementList의 TopLevelLexicallyScopedDeclarations를 반환합니다.

ConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

AsyncConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

Script

[empty]

새로운 빈 List를 반환합니다.

ScriptBody

StatementList

StatementList의 TopLevelLexicallyScopedDeclarations를 반환합니다.

Module

[empty]

새로운 빈 List를 반환합니다.

ModuleItemList

ModuleItem

decls1을 ModuleItemList의 LexicallyScopedDeclarations로 둡니다.
decls2를 ModuleItem의 LexicallyScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

ModuleItem

ImportDeclaration

새로운 빈 List를 반환합니다.

export

opt

;

export

NamedExports

;

export

VariableStatement

새로운 빈 List를 반환합니다.

ExportDeclaration

export

Declaration

유일한 요소가 Declaration의 DeclarationPart인 List를 반환합니다.

ExportDeclaration

export

default

HoistableDeclaration

유일한 요소가 HoistableDeclaration의 DeclarationPart인 List를 반환합니다.

ExportDeclaration

export

default

ClassDeclaration

유일한 요소가 ClassDeclaration인 List를 반환합니다.

ExportDeclaration

export

default

AssignmentExpression

;

유일한 요소가 이 ExportDeclaration인 List를 반환합니다.

8.2.8 Static Semantics: VarDeclaredNames

구문 지향 연산 VarDeclaredNames. 인수 없음. 반환값: 리스트 (요소: String). 다음 생성 규칙별로 정의된다.

새로운 빈 List를 반환합니다.

Block

{

}

새로운 빈 List를 반환합니다.

StatementList

StatementListItem

names1을 StatementList의 VarDeclaredNames로 둡니다.
names2를 StatementListItem의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

StatementListItem

Declaration

새로운 빈 List를 반환합니다.

VariableStatement

var

VariableDeclarationList

;

VariableDeclarationList의 BoundNames를 반환합니다.

(

)

else

names1을 첫 번째 Statement의 VarDeclaredNames로 둡니다.
names2를 두 번째 Statement의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

IfStatement

(

Expression

)

Statement

Statement의 VarDeclaredNames를 반환합니다.

DoWhileStatement

Statement

while

(

Expression

)

;

Statement의 VarDeclaredNames를 반환합니다.

WhileStatement

while

(

Expression

)

Statement

Statement의 VarDeclaredNames를 반환합니다.

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

Statement의 VarDeclaredNames를 반환합니다.

ForStatement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

names1을 VariableDeclarationList의 BoundNames로 둡니다.
names2를 Statement의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ForStatement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

Statement의 VarDeclaredNames를 반환합니다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

ForDeclaration

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

Statement의 VarDeclaredNames를 반환합니다.

ForInOfStatement

for

(

var

ForBinding

Expression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

names1을 ForBinding의 BoundNames로 둡니다.
names2를 Statement의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

참고

이 절은 부속서 B.3.5에 의해 확장됩니다.

WithStatement

with

(

Expression

)

Statement

Statement의 VarDeclaredNames를 반환합니다.

SwitchStatement

switch

(

Expression

)

CaseBlock

CaseBlock의 VarDeclaredNames를 반환합니다.

CaseBlock

{

}

새로운 빈 List를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, names1을 첫 번째 CaseClauses의 VarDeclaredNames로 둡니다.
그렇지 않으면 names1을 새로운 빈 List로 둡니다.
names2를 DefaultClause의 VarDeclaredNames로 둡니다.
두 번째 CaseClauses가 존재하면, names3을 두 번째 CaseClauses의 VarDeclaredNames로 둡니다.
그렇지 않으면 names3을 새로운 빈 List로 둡니다.
names1, names2 및 names3의 목록 연결을 반환합니다.

CaseClauses

CaseClause

names1을 CaseClauses의 VarDeclaredNames로 둡니다.
names2를 CaseClause의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, StatementList의 VarDeclaredNames를 반환합니다.
새로운 빈 List를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, StatementList의 VarDeclaredNames를 반환합니다.
새로운 빈 List를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

LabelledItem의 VarDeclaredNames를 반환합니다.

LabelledItem

FunctionDeclaration

새로운 빈 List를 반환합니다.

TryStatement

try

Block

Catch

names1을 Block의 VarDeclaredNames로 둡니다.
names2를 Catch의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

TryStatement

try

Block

Finally

names1을 Block의 VarDeclaredNames로 둡니다.
names2를 Finally의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

try

names1을 Block의 VarDeclaredNames로 둡니다.
names2를 Catch의 VarDeclaredNames로 둡니다.
names3을 Finally의 VarDeclaredNames로 둡니다.
names1, names2 및 names3의 목록 연결을 반환합니다.

Catch

catch

(

CatchParameter

)

Block

Block의 VarDeclaredNames를 반환합니다.

FunctionStatementList

[empty]

새로운 빈 List를 반환합니다.

FunctionStatementList

StatementList

StatementList의 TopLevelVarDeclaredNames를 반환합니다.

ClassStaticBlockStatementList

[empty]

새로운 빈 List를 반환합니다.

ClassStaticBlockStatementList

StatementList

StatementList의 TopLevelVarDeclaredNames를 반환합니다.

ConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

AsyncConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

Script

[empty]

새로운 빈 List를 반환합니다.

ScriptBody

StatementList

StatementList의 TopLevelVarDeclaredNames를 반환합니다.

ModuleItemList

ModuleItem

names1을 ModuleItemList의 VarDeclaredNames로 둡니다.
names2를 ModuleItem의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ModuleItem

ImportDeclaration

새로운 빈 List를 반환합니다.

ModuleItem

ExportDeclaration

ExportDeclaration이 export VariableStatement이면, ExportDeclaration의 BoundNames를 반환합니다.
새로운 빈 List를 반환합니다.

8.2.9 Static Semantics: VarScopedDeclarations

구문 지향 연산 VarScopedDeclarations. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

새로운 빈 List를 반환합니다.

Block

{

}

새로운 빈 List를 반환합니다.

StatementList

StatementListItem

decls1을 StatementList의 VarScopedDeclarations로 둡니다.
decls2를 StatementListItem의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

StatementListItem

Declaration

새로운 빈 List를 반환합니다.

VariableDeclarationList

VariableDeclaration

« VariableDeclaration »을 반환합니다.

VariableDeclarationList

VariableDeclaration

decls1을 VariableDeclarationList의 VarScopedDeclarations로 둡니다.
decls1과 « VariableDeclaration »의 목록 연결을 반환합니다.

(

)

else

decls1을 첫 번째 Statement의 VarScopedDeclarations로 둡니다.
decls2를 두 번째 Statement의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

IfStatement

(

Expression

)

Statement

Statement의 VarScopedDeclarations를 반환합니다.

DoWhileStatement

Statement

while

(

Expression

)

;

Statement의 VarScopedDeclarations를 반환합니다.

WhileStatement

while

(

Expression

)

Statement

Statement의 VarScopedDeclarations를 반환합니다.

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

Statement의 VarScopedDeclarations를 반환합니다.

ForStatement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

decls1을 VariableDeclarationList의 VarScopedDeclarations로 둡니다.
decls2를 Statement의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

ForStatement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

Statement의 VarScopedDeclarations를 반환합니다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

ForDeclaration

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

Statement의 VarScopedDeclarations를 반환합니다.

ForInOfStatement

for

(

var

ForBinding

Expression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

decls1을 « ForBinding »로 둡니다.
decls2를 Statement의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

참고

이 절은 부속서 B.3.5에 의해 확장됩니다.

WithStatement

with

(

Expression

)

Statement

Statement의 VarScopedDeclarations를 반환합니다.

SwitchStatement

switch

(

Expression

)

CaseBlock

CaseBlock의 VarScopedDeclarations를 반환합니다.

CaseBlock

{

}

새로운 빈 List를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, decls1을 첫 번째 CaseClauses의 VarScopedDeclarations로 둡니다.
그렇지 않으면 decls1을 새로운 빈 List로 둡니다.
decls2를 DefaultClause의 VarScopedDeclarations로 둡니다.
두 번째 CaseClauses가 존재하면, decls3을 두 번째 CaseClauses의 VarScopedDeclarations로 둡니다.
그렇지 않으면 decls3을 새로운 빈 List로 둡니다.
decls1, decls2 및 decls3의 목록 연결을 반환합니다.

CaseClauses

CaseClause

decls1을 CaseClauses의 VarScopedDeclarations로 둡니다.
decls2를 CaseClause의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, StatementList의 VarScopedDeclarations를 반환합니다.
새로운 빈 List를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, StatementList의 VarScopedDeclarations를 반환합니다.
새로운 빈 List를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

LabelledItem의 VarScopedDeclarations를 반환합니다.

LabelledItem

FunctionDeclaration

새로운 빈 List를 반환합니다.

TryStatement

try

Block

Catch

decls1을 Block의 VarScopedDeclarations로 둡니다.
decls2를 Catch의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

TryStatement

try

Block

Finally

decls1을 Block의 VarScopedDeclarations로 둡니다.
decls2를 Finally의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

try

decls1을 Block의 VarScopedDeclarations로 둡니다.
decls2를 Catch의 VarScopedDeclarations로 둡니다.
decls3을 Finally의 VarScopedDeclarations로 둡니다.
decls1, decls2 및 decls3의 목록 연결을 반환합니다.

Catch

catch

(

CatchParameter

)

Block

Block의 VarScopedDeclarations를 반환합니다.

FunctionStatementList

[empty]

새로운 빈 List를 반환합니다.

FunctionStatementList

StatementList

StatementList의 TopLevelVarScopedDeclarations를 반환합니다.

ClassStaticBlockStatementList

[empty]

새로운 빈 List를 반환합니다.

ClassStaticBlockStatementList

StatementList

StatementList의 TopLevelVarScopedDeclarations를 반환합니다.

ConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

AsyncConciseBody

ExpressionBody

새로운 빈 List를 반환합니다.

Script

[empty]

새로운 빈 List를 반환합니다.

ScriptBody

StatementList

StatementList의 TopLevelVarScopedDeclarations를 반환합니다.

Module

[empty]

새로운 빈 List를 반환합니다.

ModuleItemList

ModuleItem

decls1을 ModuleItemList의 VarScopedDeclarations로 둡니다.
decls2를 ModuleItem의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

ModuleItem

ImportDeclaration

새로운 빈 List를 반환합니다.

ModuleItem

ExportDeclaration

ExportDeclaration이 export VariableStatement이면, VariableStatement의 VarScopedDeclarations를 반환합니다.
새로운 빈 List를 반환합니다.

8.2.10 Static Semantics: TopLevelLexicallyDeclaredNames

구문 지향 연산 TopLevelLexicallyDeclaredNames. 인수 없음. 반환값: 리스트 (요소: String). 다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

names1을 StatementList의 TopLevelLexicallyDeclaredNames로 둡니다.
names2를 StatementListItem의 TopLevelLexicallyDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

StatementListItem

Statement

새로운 빈 List를 반환합니다.

StatementListItem

Declaration

Declaration이 Declaration : HoistableDeclaration 이면, 다음을 수행합니다.
1. 새로운 빈 List를 반환합니다.
Declaration의 BoundNames를 반환합니다.

참고

함수 또는 스크립트의 최상위 수준에서 함수 선언은 렉시컬 선언이 아니라 var 선언처럼 취급됩니다.

8.2.11 Static Semantics: TopLevelLexicallyScopedDeclarations

구문 지향 연산 TopLevelLexicallyScopedDeclarations. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

decls1을 StatementList의 TopLevelLexicallyScopedDeclarations로 둡니다.
decls2를 StatementListItem의 TopLevelLexicallyScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

StatementListItem

Statement

새로운 빈 List를 반환합니다.

StatementListItem

Declaration

Declaration이 Declaration : HoistableDeclaration 이면, 다음을 수행합니다.
1. 새로운 빈 List를 반환합니다.
« Declaration »을 반환합니다.

8.2.12 Static Semantics: TopLevelVarDeclaredNames

구문 지향 연산 TopLevelVarDeclaredNames. 인수 없음. 반환값: 리스트 (요소: String). 다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

names1을 StatementList의 TopLevelVarDeclaredNames로 둡니다.
names2를 StatementListItem의 TopLevelVarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

StatementListItem

Declaration

Declaration이 Declaration : HoistableDeclaration 이면, 다음을 수행합니다.
1. HoistableDeclaration의 BoundNames를 반환합니다.
새로운 빈 List를 반환합니다.

StatementListItem

Statement

Statement가 Statement : LabelledStatement 이면, Statement의 TopLevelVarDeclaredNames를 반환합니다.
Statement의 VarDeclaredNames를 반환합니다.

참고

함수 또는 스크립트의 최상위 수준에서 내부 함수 선언은 var 선언처럼 취급됩니다.

LabelledStatement

LabelIdentifier

LabelledItem

LabelledItem의 TopLevelVarDeclaredNames를 반환합니다.

LabelledItem

Statement

Statement가 Statement : LabelledStatement 이면, Statement의 TopLevelVarDeclaredNames를 반환합니다.
Statement의 VarDeclaredNames를 반환합니다.

LabelledItem

FunctionDeclaration

FunctionDeclaration의 BoundNames를 반환합니다.

8.2.13 Static Semantics: TopLevelVarScopedDeclarations

구문 지향 연산 TopLevelVarScopedDeclarations. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

decls1을 StatementList의 TopLevelVarScopedDeclarations로 둡니다.
decls2를 StatementListItem의 TopLevelVarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

StatementListItem

Statement

Statement가 Statement : LabelledStatement 이면, Statement의 TopLevelVarScopedDeclarations를 반환합니다.
Statement의 VarScopedDeclarations를 반환합니다.

StatementListItem

Declaration

Declaration이 Declaration : HoistableDeclaration 이면, 다음을 수행합니다.
1. decl을 HoistableDeclaration의 DeclarationPart로 둡니다.
2. « decl »을 반환합니다.
새로운 빈 List를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

LabelledItem의 TopLevelVarScopedDeclarations를 반환합니다.

LabelledItem

Statement

Statement가 Statement : LabelledStatement 이면, Statement의 TopLevelVarScopedDeclarations를 반환합니다.
Statement의 VarScopedDeclarations를 반환합니다.

LabelledItem

FunctionDeclaration

« FunctionDeclaration »을 반환합니다.

8.3 레이블

8.3.1 Static Semantics: ContainsDuplicateLabels

구문 지향 연산 ContainsDuplicateLabels. 인수 labelSet (리스트 (요소: String)). 반환값: Boolean. 다음 생성 규칙별로 정의된다.

{

}

StatementListItem

Declaration

false를 반환합니다.

StatementList

StatementListItem

hasDuplicates를 인수 labelSet을 사용한 StatementList의 ContainsDuplicateLabels로 둡니다.
hasDuplicates가 true이면, true를 반환합니다.
인수 labelSet을 사용한 StatementListItem의 ContainsDuplicateLabels를 반환합니다.

(

)

else

hasDuplicate를 인수 labelSet을 사용한 첫 번째 Statement의 ContainsDuplicateLabels로 둡니다.
hasDuplicate가 true이면, true를 반환합니다.
인수 labelSet을 사용한 두 번째 Statement의 ContainsDuplicateLabels를 반환합니다.

IfStatement

(

Expression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

DoWhileStatement

Statement

while

(

Expression

)

;

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

WhileStatement

while

(

Expression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

var

ForBinding

Expression

)

Statement

for

(

ForDeclaration

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

참고

이 절은 부속서 B.3.5에 의해 확장됩니다.

WithStatement

with

(

Expression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

SwitchStatement

switch

(

Expression

)

CaseBlock

인수 labelSet을 사용한 CaseBlock의 ContainsDuplicateLabels를 반환합니다.

CaseBlock

{

}

false를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, 다음을 수행합니다.
1. 인수 labelSet을 사용한 첫 번째 CaseClauses의 ContainsDuplicateLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 DefaultClause의 ContainsDuplicateLabels가 true이면, true를 반환합니다.
두 번째 CaseClauses가 존재하지 않으면, false를 반환합니다.
인수 labelSet을 사용한 두 번째 CaseClauses의 ContainsDuplicateLabels를 반환합니다.

CaseClauses

CaseClause

hasDuplicates를 인수 labelSet을 사용한 CaseClauses의 ContainsDuplicateLabels로 둡니다.
hasDuplicates가 true이면, true를 반환합니다.
인수 labelSet을 사용한 CaseClause의 ContainsDuplicateLabels를 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, 인수 labelSet을 사용한 StatementList의 ContainsDuplicateLabels를 반환합니다.
false를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, 인수 labelSet을 사용한 StatementList의 ContainsDuplicateLabels를 반환합니다.
false를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

label을 LabelIdentifier의 StringValue로 둡니다.
labelSet에 label이 포함되어 있으면, true를 반환합니다.
newLabelSet을 labelSet과 « label »의 목록 연결로 둡니다.
인수 newLabelSet을 사용한 LabelledItem의 ContainsDuplicateLabels를 반환합니다.

LabelledItem

FunctionDeclaration

false를 반환합니다.

TryStatement

try

Block

Catch

hasDuplicates를 인수 labelSet을 사용한 Block의 ContainsDuplicateLabels로 둡니다.
hasDuplicates가 true이면, true를 반환합니다.
인수 labelSet을 사용한 Catch의 ContainsDuplicateLabels를 반환합니다.

TryStatement

try

Block

Finally

hasDuplicates를 인수 labelSet을 사용한 Block의 ContainsDuplicateLabels로 둡니다.
hasDuplicates가 true이면, true를 반환합니다.
인수 labelSet을 사용한 Finally의 ContainsDuplicateLabels를 반환합니다.

try

인수 labelSet을 사용한 Block의 ContainsDuplicateLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 Catch의 ContainsDuplicateLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 Finally의 ContainsDuplicateLabels를 반환합니다.

Catch

catch

(

CatchParameter

)

Block

인수 labelSet을 사용한 Block의 ContainsDuplicateLabels를 반환합니다.

FunctionStatementList

[empty]

false를 반환합니다.

ClassStaticBlockStatementList

[empty]

false를 반환합니다.

ModuleItemList

ModuleItem

hasDuplicates를 인수 labelSet을 사용한 ModuleItemList의 ContainsDuplicateLabels로 둡니다.
hasDuplicates가 true이면, true를 반환합니다.
인수 labelSet을 사용한 ModuleItem의 ContainsDuplicateLabels를 반환합니다.

ModuleItem

ImportDeclaration

ExportDeclaration

false를 반환합니다.

8.3.2 Static Semantics: ContainsUndefinedBreakTarget

구문 지향 연산 ContainsUndefinedBreakTarget. 인수 labelSet (리스트 (요소: String)). 반환값: Boolean. 다음 생성 규칙별로 정의된다.

{

}

StatementListItem

Declaration

false를 반환합니다.

StatementList

StatementListItem

hasUndefinedLabels를 인수 labelSet을 사용한 StatementList의 ContainsUndefinedBreakTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 StatementListItem의 ContainsUndefinedBreakTarget을 반환합니다.

(

)

else

hasUndefinedLabels를 인수 labelSet을 사용한 첫 번째 Statement의 ContainsUndefinedBreakTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 두 번째 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

IfStatement

(

Expression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

DoWhileStatement

Statement

while

(

Expression

)

;

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

WhileStatement

while

(

Expression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

var

ForBinding

Expression

)

Statement

for

(

ForDeclaration

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

참고

이 절은 부속서 B.3.5에 의해 확장됩니다.

BreakStatement

break

;

false를 반환합니다.

BreakStatement

break

LabelIdentifier

;

labelSet에 LabelIdentifier의 StringValue가 포함되어 있으면, false를 반환합니다.
true를 반환합니다.

WithStatement

with

(

Expression

)

Statement

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

SwitchStatement

switch

(

Expression

)

CaseBlock

인수 labelSet을 사용한 CaseBlock의 ContainsUndefinedBreakTarget을 반환합니다.

CaseBlock

{

}

false를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, 다음을 수행합니다.
1. 인수 labelSet을 사용한 첫 번째 CaseClauses의 ContainsUndefinedBreakTarget이 true이면, true를 반환합니다.
인수 labelSet을 사용한 DefaultClause의 ContainsUndefinedBreakTarget이 true이면, true를 반환합니다.
두 번째 CaseClauses가 존재하지 않으면, false를 반환합니다.
인수 labelSet을 사용한 두 번째 CaseClauses의 ContainsUndefinedBreakTarget을 반환합니다.

CaseClauses

CaseClause

hasUndefinedLabels를 인수 labelSet을 사용한 CaseClauses의 ContainsUndefinedBreakTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 CaseClause의 ContainsUndefinedBreakTarget을 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, 인수 labelSet을 사용한 StatementList의 ContainsUndefinedBreakTarget을 반환합니다.
false를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, 인수 labelSet을 사용한 StatementList의 ContainsUndefinedBreakTarget을 반환합니다.
false를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

label을 LabelIdentifier의 StringValue로 둡니다.
newLabelSet을 labelSet과 « label »의 목록 연결로 둡니다.
인수 newLabelSet을 사용한 LabelledItem의 ContainsUndefinedBreakTarget을 반환합니다.

LabelledItem

FunctionDeclaration

false를 반환합니다.

TryStatement

try

Block

Catch

hasUndefinedLabels를 인수 labelSet을 사용한 Block의 ContainsUndefinedBreakTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 Catch의 ContainsUndefinedBreakTarget을 반환합니다.

TryStatement

try

Block

Finally

hasUndefinedLabels를 인수 labelSet을 사용한 Block의 ContainsUndefinedBreakTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 Finally의 ContainsUndefinedBreakTarget을 반환합니다.

try

인수 labelSet을 사용한 Block의 ContainsUndefinedBreakTarget이 true이면, true를 반환합니다.
인수 labelSet을 사용한 Catch의 ContainsUndefinedBreakTarget이 true이면, true를 반환합니다.
인수 labelSet을 사용한 Finally의 ContainsUndefinedBreakTarget을 반환합니다.

Catch

catch

(

CatchParameter

)

Block

인수 labelSet을 사용한 Block의 ContainsUndefinedBreakTarget을 반환합니다.

FunctionStatementList

[empty]

false를 반환합니다.

ClassStaticBlockStatementList

[empty]

false를 반환합니다.

ModuleItemList

ModuleItem

hasUndefinedLabels를 인수 labelSet을 사용한 ModuleItemList의 ContainsUndefinedBreakTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 labelSet을 사용한 ModuleItem의 ContainsUndefinedBreakTarget을 반환합니다.

ModuleItem

ImportDeclaration

ExportDeclaration

false를 반환합니다.

8.3.3 Static Semantics: ContainsUndefinedContinueTarget

구문 지향 연산 ContainsUndefinedContinueTarget. 인수 iterationSet (리스트 (요소: String)) 및 labelSet (리스트 (요소: String)). 반환값: Boolean. 다음 생성 규칙별로 정의된다.

{

}

StatementListItem

Declaration

false를 반환합니다.

Statement

BlockStatement

인수 iterationSet 및 « »를 사용한 BlockStatement의 ContainsUndefinedContinueTarget을 반환합니다.

BreakableStatement

IterationStatement

newIterationSet을 iterationSet과 labelSet의 목록 연결로 둡니다.
인수 newIterationSet 및 « »를 사용한 IterationStatement의 ContainsUndefinedContinueTarget을 반환합니다.

StatementList

StatementListItem

hasUndefinedLabels를 인수 iterationSet 및 « »를 사용한 StatementList의 ContainsUndefinedContinueTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 StatementListItem의 ContainsUndefinedContinueTarget을 반환합니다.

(

)

else

hasUndefinedLabels를 인수 iterationSet 및 « »를 사용한 첫 번째 Statement의 ContainsUndefinedContinueTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 두 번째 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

IfStatement

(

Expression

)

Statement

인수 iterationSet 및 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

DoWhileStatement

Statement

while

(

Expression

)

;

인수 iterationSet 및 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

WhileStatement

while

(

Expression

)

Statement

인수 iterationSet 및 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

인수 iterationSet 및 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

var

ForBinding

Expression

)

Statement

for

(

ForDeclaration

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

인수 iterationSet 및 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

참고

이 절은 부속서 B.3.5에 의해 확장됩니다.

ContinueStatement

continue

;

false를 반환합니다.

ContinueStatement

continue

LabelIdentifier

;

iterationSet에 LabelIdentifier의 StringValue가 포함되어 있으면, false를 반환합니다.
true를 반환합니다.

WithStatement

with

(

Expression

)

Statement

인수 iterationSet 및 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

SwitchStatement

switch

(

Expression

)

CaseBlock

인수 iterationSet 및 « »를 사용한 CaseBlock의 ContainsUndefinedContinueTarget을 반환합니다.

CaseBlock

{

}

false를 반환합니다.

{

opt

opt

}

첫 번째 CaseClauses가 존재하면, 다음을 수행합니다.
1. 인수 iterationSet 및 « »를 사용한 첫 번째 CaseClauses의 ContainsUndefinedContinueTarget이 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 DefaultClause의 ContainsUndefinedContinueTarget이 true이면, true를 반환합니다.
두 번째 CaseClauses가 존재하지 않으면, false를 반환합니다.
인수 iterationSet 및 « »를 사용한 두 번째 CaseClauses의 ContainsUndefinedContinueTarget을 반환합니다.

CaseClauses

CaseClause

hasUndefinedLabels를 인수 iterationSet 및 « »를 사용한 CaseClauses의 ContainsUndefinedContinueTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 CaseClause의 ContainsUndefinedContinueTarget을 반환합니다.

CaseClause

case

Expression

StatementList

opt

StatementList가 존재하면, 인수 iterationSet 및 « »를 사용한 StatementList의 ContainsUndefinedContinueTarget을 반환합니다.
false를 반환합니다.

DefaultClause

default

StatementList

opt

StatementList가 존재하면, 인수 iterationSet 및 « »를 사용한 StatementList의 ContainsUndefinedContinueTarget을 반환합니다.
false를 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

label을 LabelIdentifier의 StringValue로 둡니다.
newLabelSet을 labelSet과 « label »의 목록 연결로 둡니다.
인수 iterationSet 및 newLabelSet을 사용한 LabelledItem의 ContainsUndefinedContinueTarget을 반환합니다.

LabelledItem

FunctionDeclaration

false를 반환합니다.

TryStatement

try

Block

Catch

hasUndefinedLabels를 인수 iterationSet 및 « »를 사용한 Block의 ContainsUndefinedContinueTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 Catch의 ContainsUndefinedContinueTarget을 반환합니다.

TryStatement

try

Block

Finally

hasUndefinedLabels를 인수 iterationSet 및 « »를 사용한 Block의 ContainsUndefinedContinueTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 Finally의 ContainsUndefinedContinueTarget을 반환합니다.

try

인수 iterationSet 및 « »를 사용한 Block의 ContainsUndefinedContinueTarget이 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 Catch의 ContainsUndefinedContinueTarget이 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 Finally의 ContainsUndefinedContinueTarget을 반환합니다.

Catch

catch

(

CatchParameter

)

Block

인수 iterationSet 및 « »를 사용한 Block의 ContainsUndefinedContinueTarget을 반환합니다.

FunctionStatementList

[empty]

false를 반환합니다.

ClassStaticBlockStatementList

[empty]

false를 반환합니다.

ModuleItemList

ModuleItem

hasUndefinedLabels를 인수 iterationSet 및 « »를 사용한 ModuleItemList의 ContainsUndefinedContinueTarget으로 둡니다.
hasUndefinedLabels가 true이면, true를 반환합니다.
인수 iterationSet 및 « »를 사용한 ModuleItem의 ContainsUndefinedContinueTarget을 반환합니다.

ModuleItem

ImportDeclaration

ExportDeclaration

false를 반환합니다.

8.4 함수 이름 추론

8.4.1 Static Semantics: HasName

구문 지향 연산 HasName. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

expr을 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ParenthesizedExpression로 둡니다.
expr의 IsFunctionDefinition이 false이면, false를 반환합니다.
expr의 HasName을 반환합니다.

FunctionExpression

function

(

FormalParameters

)

{

FunctionBody

}

GeneratorExpression

function

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorExpression

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionExpression

async

function

(

FormalParameters

)

{

}

async

AsyncArrowBindingIdentifier

AsyncConciseBody

CoverCallExpressionAndAsyncArrowHead

AsyncConciseBody

ClassExpression

class

ClassTail

false를 반환합니다.

FunctionExpression

function

BindingIdentifier

(

FormalParameters

)

{

}

function

(

)

{

GeneratorBody

}

AsyncGeneratorExpression

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionExpression

async

function

BindingIdentifier

(

FormalParameters

)

{

}

class

true를 반환합니다.

8.4.2 Static Semantics: IsFunctionDefinition

구문 지향 연산 IsFunctionDefinition. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

expr을 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ParenthesizedExpression로 둡니다.
expr의 IsFunctionDefinition을 반환합니다.

this

RegularExpressionLiteral

[

]

new

new

LeftHandSideExpression

CallExpression

OptionalExpression

UpdateExpression

LeftHandSideExpression

delete

void

typeof

CoverAwaitExpressionAndAwaitUsingDeclarationHead

ExponentiationExpression

UpdateExpression

ExponentiationExpression

MultiplicativeExpression

MultiplicativeOperator

ExponentiationExpression

AdditiveExpression

MultiplicativeExpression

AdditiveExpression

MultiplicativeExpression

>>>

instanceof

===

!==

CoalesceExpressionHead

BitwiseORExpression

ConditionalExpression

ShortCircuitExpression

AssignmentExpression

YieldExpression

LeftHandSideExpression

AssignmentExpression

LeftHandSideExpression

AssignmentOperator

AssignmentExpression

LeftHandSideExpression

&&=

AssignmentExpression

LeftHandSideExpression

||=

AssignmentExpression

LeftHandSideExpression

??=

AssignmentExpression

Expression

AssignmentExpression

false를 반환합니다.

function

opt

(

FormalParameters

)

{

FunctionBody

}

GeneratorExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

}

class

opt

true를 반환합니다.

8.4.3 Static Semantics: IsAnonymousFunctionDefinition ( `expr` )

추상 연산 IsAnonymousFunctionDefinition. 인수 expr ((an AssignmentExpression Parse Node, an Initializer Parse Node 또는 an Expression Parse Node)). 반환값: Boolean. 인수가 이름을 바인딩하지 않는 함수 정의인지 결정합니다. 호출되면 다음 단계를 수행한다.

expr의 IsFunctionDefinition이 false이면, false를 반환합니다.
hasName을 expr의 HasName으로 둡니다.
hasName이 true이면, false를 반환합니다.
true를 반환합니다.

8.4.4 Static Semantics: IsIdentifierRef

구문 지향 연산 IsIdentifierRef. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

PrimaryExpression

IdentifierReference

true를 반환합니다.

this

AsyncFunctionExpression

AsyncGeneratorExpression

RegularExpressionLiteral

TemplateLiteral

CoverParenthesizedExpressionAndArrowParameterList

[

]

new

new

LeftHandSideExpression

CallExpression

OptionalExpression

false를 반환합니다.

8.4.5 Runtime Semantics: NamedEvaluation

구문 지향 연산 NamedEvaluation. 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: (정상 완료 (값: 함수 객체) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

expr을 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ParenthesizedExpression로 둡니다.
인수 name을 사용한 expr의 ? NamedEvaluation을 반환합니다.

ParenthesizedExpression

(

Expression

)

단언: IsAnonymousFunctionDefinition(Expression)은 true입니다.
인수 name을 사용한 Expression의 ? NamedEvaluation을 반환합니다.

FunctionExpression

function

(

FormalParameters

)

{

FunctionBody

}

인수 name을 사용한 FunctionExpression의 InstantiateOrdinaryFunctionExpression을 반환합니다.

GeneratorExpression

function

(

FormalParameters

)

{

GeneratorBody

}

인수 name을 사용한 GeneratorExpression의 InstantiateGeneratorFunctionExpression을 반환합니다.

AsyncGeneratorExpression

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

인수 name을 사용한 AsyncGeneratorExpression의 InstantiateAsyncGeneratorFunctionExpression을 반환합니다.

AsyncFunctionExpression

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

인수 name을 사용한 AsyncFunctionExpression의 InstantiateAsyncFunctionExpression을 반환합니다.

ArrowFunction

ArrowParameters

ConciseBody

인수 name을 사용한 ArrowFunction의 InstantiateArrowFunctionExpression을 반환합니다.

AsyncArrowFunction

async

AsyncArrowBindingIdentifier

AsyncConciseBody

CoverCallExpressionAndAsyncArrowHead

AsyncConciseBody

인수 name을 사용한 AsyncArrowFunction의 InstantiateAsyncArrowFunctionExpression을 반환합니다.

ClassExpression

class

ClassTail

sourceText를 ClassExpression에 일치하는 소스 텍스트로 둡니다.
인수 undefined, name 및 sourceText를 사용한 ClassTail의 ? ClassDefinitionEvaluation을 반환합니다.

8.5 포함 여부

8.5.1 Static Semantics: Contains

구문 지향 연산 Contains. 인수 symbol (문법 기호). 반환값: Boolean.

아래에 나열되지 않은 이 명세의 모든 문법 생성 규칙 대안에는 암묵적으로 다음과 같은 Contains의 기본 정의가 있습니다:

이 Parse Node의 각 자식 노드 child에 대해 다음을 수행합니다.
1. child가 symbol의 인스턴스이면, true를 반환합니다.
2. child가 비단말 기호의 인스턴스이면, 다음을 수행합니다.
  1. contained를 child Contains symbol의 결과로 둡니다.
  2. contained가 true이면, true를 반환합니다.
false를 반환합니다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

FunctionBody

}

FunctionExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

}

function

(

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

GeneratorExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

AsyncFunctionExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncFunctionBody

}

false를 반환합니다.

참고 1

하위 구조에 의존하는 정적 의미 규칙은 일반적으로 함수 정의 내부를 살펴보지 않습니다.

ClassTail

ClassHeritage

opt

{

ClassBody

}

symbol이 ClassBody이면, true를 반환합니다.
symbol이 ClassHeritage이면, 다음을 수행합니다.
1. ClassHeritage가 존재하면, true를 반환합니다.
2. false를 반환합니다.
ClassHeritage가 존재하면, 다음을 수행합니다.
1. ClassHeritage Contains symbol이 true이면, true를 반환합니다.
인수 symbol을 사용한 ClassBody의 ComputedPropertyContains 결과를 반환합니다.

참고 2

하위 구조에 의존하는 정적 의미 규칙은 일반적으로 PropertyName을 제외하고 클래스 본문 내부를 살펴보지 않습니다.

ClassStaticBlock

static

{

ClassStaticBlockBody

}

false를 반환합니다.

참고 3

하위 구조에 의존하는 정적 의미 규칙은 일반적으로 static 초기화 블록 내부를 살펴보지 않습니다.

ArrowFunction

ArrowParameters

ConciseBody

symbol이 NewTarget, SuperProperty, SuperCall, super 또는 this 중 하나가 아니면, false를 반환합니다.
ArrowParameters Contains symbol이 true이면, true를 반환합니다.
ConciseBody Contains symbol을 반환합니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

formals를 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ArrowFormalParameters로 둡니다.
formals Contains symbol을 반환합니다.

AsyncArrowFunction

async

AsyncArrowBindingIdentifier

AsyncConciseBody

symbol이 NewTarget, SuperProperty, SuperCall, super 또는 this 중 하나가 아니면, false를 반환합니다.
AsyncConciseBody Contains symbol을 반환합니다.

AsyncArrowFunction

CoverCallExpressionAndAsyncArrowHead

AsyncConciseBody

symbol이 NewTarget, SuperProperty, SuperCall, super 또는 this 중 하나가 아니면, false를 반환합니다.
head를 CoverCallExpressionAndAsyncArrowHead가 포괄하는 AsyncArrowHead로 둡니다.
head Contains symbol이 true이면, true를 반환합니다.
AsyncConciseBody Contains symbol을 반환합니다.

참고 4

Contains는 ArrowFunction 또는 AsyncArrowFunction 내에서 new.target, this 및 super 사용을 감지하는 데 사용됩니다.

PropertyDefinition

MethodDefinition

symbol이 MethodDefinition이면, true를 반환합니다.
인수 symbol을 사용한 MethodDefinition의 ComputedPropertyContains 결과를 반환합니다.

LiteralPropertyName

IdentifierName

false를 반환합니다.

MemberExpression

IdentifierName

MemberExpression Contains symbol이 true이면, true를 반환합니다.
false를 반환합니다.

SuperProperty

super

IdentifierName

symbol이 ReservedWord super이면, true를 반환합니다.
false를 반환합니다.

CallExpression

IdentifierName

CallExpression Contains symbol이 true이면, true를 반환합니다.
false를 반환합니다.

OptionalChain

IdentifierName

false를 반환합니다.

OptionalChain

IdentifierName

OptionalChain Contains symbol이 true이면, true를 반환합니다.
false를 반환합니다.

8.5.2 Static Semantics: ComputedPropertyContains

구문 지향 연산 ComputedPropertyContains. 인수 symbol (문법 기호). 반환값: Boolean. 다음 생성 규칙별로 정의된다.

false를 반환합니다.

PropertyName

ComputedPropertyName

ComputedPropertyName Contains symbol의 결과를 반환합니다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

get

ClassElementName

(

)

{

FunctionBody

}

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

인수 symbol을 사용한 ClassElementName의 ComputedPropertyContains 결과를 반환합니다.

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

인수 symbol을 사용한 ClassElementName의 ComputedPropertyContains 결과를 반환합니다.

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

인수 symbol을 사용한 ClassElementName의 ComputedPropertyContains 결과를 반환합니다.

ClassElementList

ClassElement

inList를 인수 symbol을 사용한 ClassElementList의 ComputedPropertyContains로 둡니다.
inList가 true이면, true를 반환합니다.
인수 symbol을 사용한 ClassElement의 ComputedPropertyContains 결과를 반환합니다.

ClassElement

ClassStaticBlock

false를 반환합니다.

ClassElement

;

false를 반환합니다.

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

인수 symbol을 사용한 ClassElementName의 ComputedPropertyContains 결과를 반환합니다.

FieldDefinition

ClassElementName

Initializer

opt

인수 symbol을 사용한 ClassElementName의 ComputedPropertyContains 결과를 반환합니다.

8.6 기타

이러한 연산은 명세 전반의 여러 위치에서 사용됩니다.

8.6.1 Runtime Semantics: InstantiateFunctionObject

구문 지향 연산 InstantiateFunctionObject. 인수 envRecord (Environment 레코드) 및 privateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

FunctionBody

}

인수 envRecord 및 privateEnv를 사용한 FunctionDeclaration의 InstantiateOrdinaryFunctionObject를 반환합니다.

GeneratorDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

인수 envRecord 및 privateEnv를 사용한 GeneratorDeclaration의 InstantiateGeneratorFunctionObject를 반환합니다.

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

인수 envRecord 및 privateEnv를 사용한 AsyncGeneratorDeclaration의 InstantiateAsyncGeneratorFunctionObject를 반환합니다.

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

인수 envRecord 및 privateEnv를 사용한 AsyncFunctionDeclaration의 InstantiateAsyncFunctionObject를 반환합니다.

8.6.2 Runtime Semantics: BindingInitialization

구문 지향 연산 BindingInitialization. 인수 value (ECMAScript 언어 값) 및 envRecord ((Environment 레코드 또는 undefined)). 반환값: (정상 완료 (값: unused) 또는 중도 완료).

참고

envRecord에 undefined를 전달하면 초기화 값을 할당하는 데 PutValue 연산을 사용해야 함을 나타냅니다. 이는 var 문과 일부 비엄격 함수의 형식 매개변수 목록에서 발생합니다(10.2.11 참조). 이러한 경우 렉시컬 바인딩은 이니셜라이저를 평가하기 전에 끌어올려지고 미리 초기화됩니다.

다음 생성 규칙별로 정의된다.

BindingIdentifier

Identifier

name을 Identifier의 StringValue로 둡니다.
? InitializeBoundName(name, value, envRecord)을 반환합니다.

BindingIdentifier

yield

? InitializeBoundName("yield", value, envRecord)을 반환합니다.

BindingIdentifier

await

? InitializeBoundName("await", value, envRecord)을 반환합니다.

BindingPattern

ObjectBindingPattern

? RequireObjectCoercible(value)를 수행합니다.
인수 value 및 envRecord를 사용한 ObjectBindingPattern의 ? BindingInitialization을 반환합니다.

BindingPattern

ArrayBindingPattern

iteratorRecord를 ? GetIterator(value, sync)로 둡니다.
result를 인수 iteratorRecord 및 envRecord를 사용한 ArrayBindingPattern의 IteratorBindingInitialization의 Completion으로 둡니다.
iteratorRecord.[[Done]]이 false이면, ? IteratorClose(iteratorRecord, result)를 반환합니다.
? result를 반환합니다.

ObjectBindingPattern

{

}

unused를 반환합니다.

ObjectBindingPattern

{

BindingPropertyList

opt

}

인수 value 및 envRecord를 사용한 BindingPropertyList의 ? PropertyBindingInitialization을 수행합니다.
unused를 반환합니다.

ObjectBindingPattern

{

BindingRestProperty

}

excludedNames를 새로운 빈 List로 둡니다.
인수 value, envRecord 및 excludedNames를 사용한 BindingRestProperty의 ? RestBindingInitialization을 반환합니다.

ObjectBindingPattern

{

BindingPropertyList

BindingRestProperty

}

excludedNames를 인수 value 및 envRecord를 사용한 BindingPropertyList의 ? PropertyBindingInitialization으로 둡니다.
인수 value, envRecord 및 excludedNames를 사용한 BindingRestProperty의 ? RestBindingInitialization을 반환합니다.

8.6.2.1 InitializeBoundName ( `name`, `value`, `envRecord` )

추상 연산 InitializeBoundName. 인수 name (String), value (ECMAScript 언어 값) 및 envRecord ((Environment 레코드 또는 undefined)). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

envRecord가 undefined가 아니면, 다음을 수행합니다.
1. ! envRecord.InitializeBinding(name, value)을 수행합니다.
2. unused를 반환합니다.
lhs를 ? ResolveBinding(name)으로 둡니다.
? PutValue(lhs, value)를 반환합니다.

8.6.3 Runtime Semantics: IteratorBindingInitialization

구문 지향 연산 IteratorBindingInitialization. 인수 iteratorRecord (Iterator 레코드) 및 envRecord ((Environment 레코드 또는 undefined)). 반환값: (정상 완료 (값: unused) 또는 중도 완료).

참고

envRecord에 undefined가 전달되면 초기화 값을 할당하는 데 PutValue 연산을 사용해야 함을 나타냅니다. 이는 비엄격 함수의 형식 매개변수 목록에서 발생합니다. 이 경우 동일한 이름을 갖는 여러 매개변수가 존재할 가능성을 처리하기 위해 형식 매개변수 바인딩을 미리 초기화합니다.

다음 생성 규칙별로 정의된다.

ArrayBindingPattern

[

]

unused를 반환합니다.

ArrayBindingPattern

[

Elision

]

인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 반환합니다.

ArrayBindingPattern

[

Elision

opt

BindingRestElement

]

Elision이 존재하면, 다음을 수행합니다.
1. 인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 수행합니다.
인수 iteratorRecord 및 envRecord를 사용한 BindingRestElement의 ? IteratorBindingInitialization을 반환합니다.

ArrayBindingPattern

[

BindingElementList

Elision

]

인수 iteratorRecord 및 envRecord를 사용한 BindingElementList의 ? IteratorBindingInitialization을 수행합니다.
인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 반환합니다.

[

opt

]

인수 iteratorRecord 및 envRecord를 사용한 BindingElementList의 ? IteratorBindingInitialization을 수행합니다.
Elision이 존재하면, 다음을 수행합니다.
1. 인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 수행합니다.
인수 iteratorRecord 및 envRecord를 사용한 BindingRestElement의 ? IteratorBindingInitialization을 반환합니다.

BindingElementList

BindingElisionElement

인수 iteratorRecord 및 envRecord를 사용한 BindingElementList의 ? IteratorBindingInitialization을 수행합니다.
인수 iteratorRecord 및 envRecord를 사용한 BindingElisionElement의 ? IteratorBindingInitialization을 반환합니다.

BindingElisionElement

Elision

BindingElement

인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 수행합니다.
인수 iteratorRecord 및 envRecord를 사용한 BindingElement의 ? IteratorBindingInitialization을 반환합니다.

SingleNameBinding

BindingIdentifier

Initializer

opt

name을 BindingIdentifier의 StringValue로 둡니다.
lhs를 ? ResolveBinding(name, envRecord)로 둡니다.
value를 undefined로 둡니다.
iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. value를 next로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. IsAnonymousFunctionDefinition(Initializer)이 true이면, 다음을 수행합니다.
  1. value를 인수 name을 사용한 Initializer의 ? NamedEvaluation으로 설정합니다.
2. 그렇지 않으면,
  1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
  2. value를 ? GetValue(defaultValue)로 설정합니다.
envRecord가 undefined이면, ? PutValue(lhs, value)를 반환합니다.
? InitializeReferencedBinding(lhs, value)을 반환합니다.

BindingElement

BindingPattern

Initializer

opt

value를 undefined로 둡니다.
iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. value를 next로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(defaultValue)로 설정합니다.
인수 value 및 envRecord를 사용한 BindingPattern의 ? BindingInitialization을 반환합니다.

BindingRestElement

...

BindingIdentifier

lhs를 ? ResolveBinding(BindingIdentifier의 StringValue, envRecord)로 둡니다.
array를 ! ArrayCreate(0)으로 둡니다.
n을 0으로 둡니다.
다음을 반복합니다.
1. next를 done으로 둡니다.
2. iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
  1. next를 ? IteratorStepValue(iteratorRecord)로 설정합니다.
3. next가 done이면, 다음을 수행합니다.
  1. envRecord가 undefined이면, ? PutValue(lhs, array)를 반환합니다.
  2. ? InitializeReferencedBinding(lhs, array)을 반환합니다.
4. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(n)), next)를 수행합니다.
5. n을 n + 1로 설정합니다.

BindingRestElement

...

BindingPattern

array를 ! ArrayCreate(0)으로 둡니다.
n을 0으로 둡니다.
다음을 반복합니다.
1. next를 done으로 둡니다.
2. iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
  1. next를 ? IteratorStepValue(iteratorRecord)로 설정합니다.
3. next가 done이면, 다음을 수행합니다.
  1. 인수 array 및 envRecord를 사용한 BindingPattern의 ? BindingInitialization을 반환합니다.
4. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(n)), next)를 수행합니다.
5. n을 n + 1로 설정합니다.

FormalParameters

[empty]

unused를 반환합니다.

FormalParameters

FormalParameterList

FunctionRestParameter

인수 iteratorRecord 및 envRecord를 사용한 FormalParameterList의 ? IteratorBindingInitialization을 수행합니다.
인수 iteratorRecord 및 envRecord를 사용한 FunctionRestParameter의 ? IteratorBindingInitialization을 반환합니다.

FormalParameterList

FormalParameter

인수 iteratorRecord 및 envRecord를 사용한 FormalParameterList의 ? IteratorBindingInitialization을 수행합니다.
인수 iteratorRecord 및 envRecord를 사용한 FormalParameter의 ? IteratorBindingInitialization을 반환합니다.

ArrowParameters

BindingIdentifier

value를 undefined로 둡니다.
단언: iteratorRecord.[[Done]]은 false입니다.
next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
next가 done이 아니면, 다음을 수행합니다.
1. value를 next로 설정합니다.
인수 value 및 envRecord를 사용한 BindingIdentifier의 ? BindingInitialization을 반환합니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

formals를 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ArrowFormalParameters로 둡니다.
인수 iteratorRecord 및 envRecord를 사용한 formals의 ? IteratorBindingInitialization을 반환합니다.

AsyncArrowBindingIdentifier

BindingIdentifier

value를 undefined로 둡니다.
단언: iteratorRecord.[[Done]]은 false입니다.
next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
next가 done이 아니면, 다음을 수행합니다.
1. value를 next로 설정합니다.
인수 value 및 envRecord를 사용한 BindingIdentifier의 ? BindingInitialization을 반환합니다.

8.6.4 Static Semantics: AssignmentTargetType

구문 지향 연산 AssignmentTargetType. 인수 없음. 반환값: (simple, web-compat 또는 invalid). 다음 생성 규칙별로 정의된다.

IdentifierReference

Identifier

IsStrict(this IdentifierReference)가 true이고 Identifier의 StringValue가 "eval" 또는 "arguments"이면, invalid를 반환합니다.
simple을 반환합니다.

IdentifierReference

yield

await

[

]

[

]

simple을 반환합니다.

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

expr을 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ParenthesizedExpression로 둡니다.
expr의 AssignmentTargetType을 반환합니다.

CallExpression

CoverCallExpressionAndAsyncArrowHead

CallExpression

Arguments

Normative Optional
호스트가 웹 브라우저이거나 그 밖의 방식으로 함수 호출 할당 대상의 런타임 오류을 지원하고 IsStrict(this CallExpression)가 false이면, 다음을 수행합니다.
1. web-compat을 반환합니다.
invalid를 반환합니다.

this

AsyncFunctionExpression

AsyncGeneratorExpression

RegularExpressionLiteral

new

new

new

target

ImportMeta

import

meta

LeftHandSideExpression

OptionalExpression

UpdateExpression

LeftHandSideExpression

delete

void

typeof

CoverAwaitExpressionAndAwaitUsingDeclarationHead

ExponentiationExpression

UpdateExpression

ExponentiationExpression

MultiplicativeExpression

MultiplicativeOperator

ExponentiationExpression

AdditiveExpression

MultiplicativeExpression

AdditiveExpression

MultiplicativeExpression

>>>

instanceof

===

!==

CoalesceExpressionHead

BitwiseORExpression

ConditionalExpression

ShortCircuitExpression

LeftHandSideExpression

AssignmentExpression

LeftHandSideExpression

AssignmentOperator

AssignmentExpression

LeftHandSideExpression

&&=

AssignmentExpression

LeftHandSideExpression

||=

AssignmentExpression

LeftHandSideExpression

??=

AssignmentExpression

Expression

AssignmentExpression

invalid를 반환합니다.

8.6.5 Static Semantics: PropName

구문 지향 연산 PropName. 인수 없음. 반환값: (String 또는 empty). 다음 생성 규칙별로 정의된다.

PropertyDefinition

IdentifierReference

IdentifierReference의 StringValue를 반환합니다.

PropertyDefinition

...

AssignmentExpression

empty를 반환합니다.

PropertyDefinition

PropertyName

AssignmentExpression

PropertyName의 PropName을 반환합니다.

IdentifierName의 StringValue를 반환합니다.

StringLiteral의 SV를 반환합니다.

LiteralPropertyName

NumericLiteral

number를 NumericLiteral의 NumericValue로 둡니다.
! ToString(number)을 반환합니다.

ComputedPropertyName

[

AssignmentExpression

]

empty를 반환합니다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

get

ClassElementName

(

)

{

FunctionBody

}

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

ClassElementName의 PropName을 반환합니다.

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

ClassElementName의 PropName을 반환합니다.

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

ClassElementName의 PropName을 반환합니다.

ClassElement

ClassStaticBlock

empty를 반환합니다.

ClassElement

;

empty를 반환합니다.

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

ClassElementName의 PropName을 반환합니다.

FieldDefinition

ClassElementName

Initializer

opt

ClassElementName의 PropName을 반환합니다.

ClassElementName

PrivateIdentifier

empty를 반환합니다.

8.6.6 Static Semantics: ContainsUsing

구문 지향 연산 ContainsUsing. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

파생된 StatementList의 ContainsUsing이 true이면, true를 반환합니다.
StatementListItem의 ContainsUsing이 true이면, true를 반환합니다.
false를 반환합니다.

StatementListItem

Statement

false를 반환합니다.

StatementListItem

Declaration

Declaration의 IsUsingDeclaration이 true이면, true를 반환합니다.
Declaration의 IsAwaitUsingDeclaration이 true이면, true를 반환합니다.
false를 반환합니다.

9 실행 가능 코드와 실행 컨텍스트

9.1 Environment Record

Environment Record는 ECMAScript 코드의 렉시컬 중첩 구조를 기반으로 Identifier를 특정 변수 및 함수와 연결하는 관계를 정의하는 데 사용하는 명세 타입입니다. 일반적으로 Environment Record는 FunctionDeclaration, BlockStatement 또는 TryStatement의 Catch 절과 같은 ECMAScript 코드의 특정 구문 구조와 연결됩니다. 이러한 코드가 평가될 때마다 해당 코드가 생성하는 식별자 바인딩을 기록하기 위해 새로운 Environment Record가 생성됩니다.

모든 Environment Record에는 [[OuterEnv]] 필드가 있으며, 이 필드는 null이거나 바깥쪽 Environment Record에 대한 참조입니다. 이는 Environment Record의 논리적 중첩을 모델링하는 데 사용됩니다. (안쪽) Environment Record의 바깥쪽 참조는 해당 안쪽 Environment Record를 논리적으로 둘러싸는 Environment Record에 대한 참조입니다. 물론 바깥쪽 Environment Record 자체도 자신의 바깥쪽 Environment Record를 가질 수 있습니다. 하나의 Environment Record는 여러 안쪽 Environment Record의 바깥쪽 환경으로 사용될 수 있습니다. 예를 들어 FunctionDeclaration에 두 개의 중첩된 FunctionDeclaration이 포함되어 있으면, 각 중첩 함수의 Environment Record는 둘러싸는 함수의 현재 평가에 대한 Environment Record를 바깥쪽 Environment Record로 갖습니다.

Environment Record는 순수하게 명세상의 메커니즘이며 ECMAScript 구현체의 특정 산출물과 대응할 필요는 없습니다. ECMAScript 프로그램에서 이러한 값에 직접 접근하거나 조작하는 것은 불가능합니다.

9.1.1 Environment Record 타입 계층

Environment Record는 단순한 객체 지향 계층 구조에 존재한다고 생각할 수 있습니다. 여기에서 Environment Record는 세 개의 구체적인 하위 클래스인 Declarative Environment Record, Object Environment Record 및 Global Environment Record를 갖는 추상 클래스입니다. Function Environment Record와 Module Environment Record는 Declarative Environment Record의 하위 클래스입니다.

Environment Record(추상)
- Declarative Environment Record는 식별자 바인딩을 ECMAScript 언어 값과 직접 연결하는 FunctionDeclaration, VariableDeclaration 및 Catch 절과 같은 ECMAScript 언어 구문 요소의 효과를 정의하는 데 사용됩니다.
  - Function Environment Record는 ECMAScript 함수 객체의 호출에 대응하며, 해당 함수 내 최상위 선언에 대한 바인딩을 포함합니다. 새로운 this 바인딩을 설정할 수도 있습니다. 또한 super 메서드 호출을 지원하는 데 필요한 상태를 캡처합니다.
  - Module Environment Record는 Module의 최상위 선언에 대한 바인딩을 포함합니다. 또한 Module이 명시적으로 가져온 바인딩도 포함합니다. 해당 [[OuterEnv]]는 Global Environment Record입니다.
- Object Environment Record는 식별자 바인딩을 특정 객체의 프로퍼티와 연결하는 WithStatement와 같은 ECMAScript 요소의 효과를 정의하는 데 사용됩니다.
- Global Environment Record는 Script의 전역 선언에 사용됩니다. 바깥쪽 환경은 없으며 [[OuterEnv]]는 null입니다. 미리 식별자 바인딩이 채워질 수 있으며, 프로퍼티가 전역 환경의 식별자 바인딩 일부를 제공하는 연결된 전역 객체를 포함합니다. ECMAScript 코드가 실행됨에 따라 전역 객체에 추가 프로퍼티가 추가될 수 있고 초기 프로퍼티가 수정될 수도 있습니다.

Environment Record 추상 클래스에는 표 15에 정의된 추상 명세 메서드가 포함됩니다. 이러한 추상 메서드는 각 구체적인 하위 클래스마다 서로 다른 구체적 알고리즘을 갖습니다.

표 15: Environment Records의 추상 메서드

메서드	목적	정의
HasBinding ( `name` )	추상 메서드 HasBinding. 인수 `name` (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). Environment Record에 `name`에 대한 바인딩이 있는지 결정합니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.1 Declarative Environment Record 9.1.1.2.1 Object Environment Record 9.1.1.4.1 Global Environment Record
CreateMutableBinding ( `name`, `deletable` )	추상 메서드 CreateMutableBinding. 인수 `name` (String) 및 `deletable` (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Environment Record에 새롭지만 초기화되지 않은 변경 가능한 바인딩을 생성합니다. `name`은 바인딩된 이름의 텍스트입니다. `deletable`이 true이면 나중에 해당 바인딩을 삭제할 수 있습니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.2 Declarative Environment Record 9.1.1.2.2 Object Environment Record 9.1.1.4.2 Global Environment Record
CreateImmutableBinding ( `name`, `strict` )	추상 메서드 CreateImmutableBinding. 인수 `name` (String) 및 `strict` (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Environment Record에 새롭지만 초기화되지 않은 변경 불가능한 바인딩을 생성합니다. `name`은 바인딩된 이름의 텍스트입니다. `strict`가 true이면 해당 바인딩이 초기화된 후 이를 설정하려는 시도는 해당 바인딩을 참조하는 연산의 엄격 모드 설정과 관계없이 항상 예외를 던집니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.3 Declarative Environment Record 9.1.1.4.3 Global Environment Record
InitializeBinding ( `name`, `value` )	추상 메서드 InitializeBinding. 인수 `name` (String) 및 `value` (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Environment Record에 이미 존재하지만 초기화되지 않은 바인딩의 값을 설정합니다. `name`은 바인딩된 이름의 텍스트입니다. `value`는 바인딩에 사용할 값입니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.4 Declarative Environment Record 9.1.1.2.4 Object Environment Record 9.1.1.4.4 Global Environment Record
SetMutableBinding ( `name`, `value`, `strict` )	추상 메서드 SetMutableBinding. 인수 `name` (String), `value` (ECMAScript 언어 값) 및 `strict` (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Environment Record에 이미 존재하는 변경 가능한 바인딩의 값을 설정합니다. `name`은 바인딩된 이름의 텍스트입니다. `value`는 바인딩의 값입니다. `strict`가 true이고 바인딩을 설정할 수 없으면 TypeError 예외를 던집니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.5 Declarative Environment Record 9.1.1.2.5 Object Environment Record 9.1.1.4.5 Global Environment Record
GetBindingValue ( `name`, `strict` )	추상 메서드 GetBindingValue. 인수 `name` (String) 및 `strict` (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). Environment Record에 이미 존재하는 바인딩의 값을 반환합니다. `name`은 바인딩된 이름의 텍스트입니다. `strict`는 엄격 모드 코드에서 시작된 참조 또는 그 밖에 엄격 모드 참조 의미론이 필요한 참조를 식별하는 데 사용됩니다. `strict`가 true이고 바인딩이 존재하지 않으면 ReferenceError 예외를 던집니다. 바인딩은 존재하지만 초기화되지 않았으면 `strict` 값과 관계없이 ReferenceError를 던집니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.6 Declarative Environment Record 9.1.1.2.6 Object Environment Record 9.1.1.4.6 Global Environment Record 9.1.1.5.1 Module Environment Record
DeleteBinding ( `name` )	추상 메서드 DeleteBinding. 인수 `name` (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). Environment Record에서 바인딩을 삭제합니다. `name`은 바인딩된 이름의 텍스트입니다. `name`에 대한 바인딩이 존재하면 해당 바인딩을 제거하고 true를 반환합니다. 바인딩이 존재하지만 제거할 수 없으면 false를 반환합니다. 바인딩이 존재하지 않으면 true를 반환합니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.7 Declarative Environment Record 9.1.1.2.7 Object Environment Record 9.1.1.4.7 Global Environment Record
HasThisBinding ( )	추상 메서드 HasThisBinding. 인수 없음. 반환값: Boolean. Environment Record가 `this` 바인딩을 설정하는지 결정합니다. 설정하면 true를 반환하고 그렇지 않으면 false를 반환합니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.8 Declarative Environment Record 9.1.1.2.8 Object Environment Record 9.1.1.3.2 Function Environment Record 9.1.1.4.8 Global Environment Record 9.1.1.5.3 Module Environment Record
GetThisBinding ( )	추상 메서드 GetThisBinding. 인수 없음. 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 이 Environment Record의 `this` 바인딩 값을 반환합니다. `this` 바인딩이 초기화되지 않았으면 ReferenceError를 던집니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.3.3 Function Environment Record 9.1.1.4.9 Global Environment Record 9.1.1.5.4 Module Environment Record
HasSuperBinding ( )	추상 메서드 HasSuperBinding. 인수 없음. 반환값: Boolean. Environment Record가 `super` 메서드 바인딩을 설정하는지 결정합니다. 설정하면 true를 반환하고 그렇지 않으면 false를 반환합니다. true를 반환하면 해당 Environment Record가 Function Environment Record임을 의미하지만, 그 역은 성립하지 않습니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.10 Declarative Environment Record 9.1.1.2.10 Object Environment Record 9.1.1.3.4 Function Environment Record 9.1.1.4.10 Global Environment Record
WithBaseObject ( )	추상 메서드 WithBaseObject. 인수 없음. 반환값: (Object 또는 undefined). 이 Environment Record가 `with` 문과 연결되어 있으면 with 객체를 반환합니다. 그렇지 않으면 undefined를 반환합니다.	다음 타입에 구체적인 정의가 있습니다: 9.1.1.1.11 Declarative Environment Record 9.1.1.2.11 Object Environment Record 9.1.1.4.11 Global Environment Record

9.1.1.1 Declarative Environment Record

각 Declarative Environment Record는 변수, 상수, let, 클래스, 모듈, import 및/또는 함수 선언을 포함하는 ECMAScript 프로그램 스코프와 연결됩니다. Declarative Environment Record는 해당 스코프 안의 선언에서 정의한 식별자 집합을 바인딩합니다.

모든 Declarative Environment Record에는 DisposableResource Record의 List를 포함하는 [[DisposableResourceStack]] 필드도 있습니다. 이 목록의 요소는 Environment Record를 생성한 Evaluation 단계가 완료될 때 폐기해야 하는 using 선언 및 await using 선언에 의해 추적됩니다.

9.1.1.1.1 HasBinding ( `name` )

a Declarative Environment Record envRecord의 구체 메서드 HasBinding. 인수 name (String). 반환값: 정상 완료 (값: Boolean). 인수 식별자가 해당 Record에 의해 바인딩된 식별자 중 하나인지 결정합니다. 호출되면 다음 단계를 수행한다.

envRecord에 name에 대한 바인딩이 있으면, true를 반환합니다.
false를 반환합니다.

9.1.1.1.2 CreateMutableBinding ( `name`, `deletable` )

a Declarative Environment Record envRecord의 구체 메서드 CreateMutableBinding. 인수 name (String) 및 deletable (Boolean). 반환값: 정상 완료 (값: unused). 초기화되지 않은 이름 name에 대한 새로운 변경 가능한 바인딩을 생성합니다. 이 Environment Record에는 name에 대한 바인딩이 이미 존재해서는 안 됩니다. deletable이 true이면 새 바인딩을 삭제할 수 있는 것으로 표시합니다. 호출되면 다음 단계를 수행한다.

단언: envRecord에는 name에 대한 바인딩이 이미 존재하지 않습니다.
envRecord에 name에 대한 변경 가능한 바인딩을 생성하고 초기화되지 않았음을 기록합니다. deletable이 true이면 새로 생성한 바인딩을 이후의 DeleteBinding 호출로 삭제할 수 있음을 기록합니다.
unused를 반환합니다.

9.1.1.1.3 CreateImmutableBinding ( `name`, `strict` )

a Declarative Environment Record envRecord의 구체 메서드 CreateImmutableBinding. 인수 name (String) 및 strict (Boolean). 반환값: 정상 완료 (값: unused). 초기화되지 않은 이름 name에 대한 새로운 변경 불가능한 바인딩을 생성합니다. 이 Environment Record에는 name에 대한 바인딩이 이미 존재해서는 안 됩니다. strict가 true이면 새 바인딩을 엄격 바인딩으로 표시합니다. 호출되면 다음 단계를 수행한다.

단언: envRecord에는 name에 대한 바인딩이 이미 존재하지 않습니다.
envRecord에 name에 대한 변경 불가능한 바인딩을 생성하고 초기화되지 않았음을 기록합니다. strict가 true이면 새로 생성한 바인딩을 엄격 바인딩으로 기록합니다.
unused를 반환합니다.

9.1.1.1.4 InitializeBinding ( `name`, `value` )

a Declarative Environment Record envRecord의 구체 메서드 InitializeBinding. 인수 name (String) 및 value (ECMAScript 언어 값). 반환값: 정상 완료 (값: unused). 이 메서드는 이름이 name인 식별자의 현재 바인딩 값을 value 값으로 설정하는 데 사용됩니다. name에 대한 초기화되지 않은 바인딩이 이미 존재해야 합니다. 호출되면 다음 단계를 수행한다.

단언: envRecord에는 name에 대한 초기화되지 않은 바인딩이 있어야 합니다.
envRecord에서 name의 바인딩된 값을 value로 설정합니다.
envRecord에서 name에 대한 바인딩이 초기화되었음을 기록합니다.
unused를 반환합니다.

9.1.1.1.5 SetMutableBinding ( `name`, `value`, `strict` )

a Declarative Environment Record envRecord의 구체 메서드 SetMutableBinding. 인수 name (String), value (ECMAScript 언어 값) 및 strict (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 이름이 name인 식별자의 현재 바인딩 값을 value 값으로 변경하려고 시도합니다. 일반적으로 name에 대한 바인딩이 이미 존재하지만 드문 경우에는 존재하지 않을 수 있습니다. 바인딩이 변경 불가능한 바인딩이고 strict가 true이면 TypeError를 던집니다. 호출되면 다음 단계를 수행한다.

envRecord에 name에 대한 바인딩이 없으면, 다음을 수행합니다.
1. strict가 true이면, ReferenceError 예외를 던집니다.
2. ! envRecord.CreateMutableBinding(name, true)를 수행합니다.
3. ! envRecord.InitializeBinding(name, value)을 수행합니다.
4. unused를 반환합니다.
envRecord에서 name에 대한 바인딩이 엄격 바인딩이면 strict를 true로 설정합니다.
envRecord에서 name에 대한 바인딩이 아직 초기화되지 않았으면, 다음을 수행합니다.
1. ReferenceError 예외를 던집니다.
그렇지 않고 envRecord에서 name에 대한 바인딩이 변경 가능한 바인딩이면, 다음을 수행합니다.
1. 해당 바인딩 값을 value로 변경합니다.
그렇지 않으면,
1. 단언: 이는 변경 불가능한 바인딩의 값을 변경하려는 시도입니다.
2. strict가 true이면, TypeError 예외를 던집니다.
unused를 반환합니다.

참고

1 단계에서 누락된 바인딩이 발생하는 ECMAScript 코드의 예는 다음과 같습니다:

function f() { eval("var x; x = (delete x, 0);"); }

9.1.1.1.6 GetBindingValue ( `name`, `strict` )

a Declarative Environment Record envRecord의 구체 메서드 GetBindingValue. 인수 name (String) 및 strict (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 이름이 name인 바인딩된 식별자의 값을 반환합니다. 바인딩은 존재하지만 초기화되지 않았으면 strict 값과 관계없이 ReferenceError를 던집니다. 호출되면 다음 단계를 수행한다.

단언: envRecord에는 name에 대한 바인딩이 있습니다.
envRecord에서 name에 대한 바인딩이 초기화되지 않은 바인딩이면, ReferenceError 예외를 던집니다.
현재 envRecord에서 name에 바인딩된 값을 반환합니다.

9.1.1.1.7 DeleteBinding ( `name` )

a Declarative Environment Record envRecord의 구체 메서드 DeleteBinding. 인수 name (String). 반환값: 정상 완료 (값: Boolean). 명시적으로 삭제 가능 대상으로 지정된 바인딩만 삭제할 수 있습니다. 호출되면 다음 단계를 수행한다.

단언: envRecord에는 name에 대한 바인딩이 있습니다.
name에 대한 바인딩을 삭제할 수 없으면, false를 반환합니다.
envRecord에서 name에 대한 바인딩을 제거합니다.
true를 반환합니다.

9.1.1.1.8 HasThisBinding ( )

a Declarative Environment Record envRecord의 구체 메서드 HasThisBinding. 인수 없음. 반환값: false. 호출되면 다음 단계를 수행한다.

false를 반환합니다.

참고

일반적인 Declarative Environment Record(즉, Function Environment Record도 Module Environment Record도 아닌 Record)는 this 바인딩을 제공하지 않습니다.

9.1.1.1.9 GetThisBinding ( )

Declarative Environment Record의 GetThisBinding 구체 메서드는 이 명세에서 절대로 사용되지 않습니다.

9.1.1.1.10 HasSuperBinding ( )

a Declarative Environment Record envRecord의 구체 메서드 HasSuperBinding. 인수 없음. 반환값: false. 호출되면 다음 단계를 수행한다.

false를 반환합니다.

참고

일반적인 Declarative Environment Record(즉, Function Environment Record도 Module Environment Record도 아닌 Record)는 super 바인딩을 제공하지 않습니다.

9.1.1.1.11 WithBaseObject ( )

a Declarative Environment Record envRecord의 구체 메서드 WithBaseObject. 인수 없음. 반환값: undefined. 호출되면 다음 단계를 수행한다.

undefined를 반환합니다.

9.1.1.2 Object Environment Record

각 Object Environment Record는 바인딩 객체라고 하는 객체와 연결됩니다. Object Environment Record는 자신의 바인딩 객체의 프로퍼티 이름과 직접 대응하는 문자열 식별자 이름 집합을 바인딩합니다. IdentifierName 형태의 String이 아닌 프로퍼티 키는 바인딩된 식별자 집합에 포함되지 않습니다. [[Enumerable]] 속성의 설정과 관계없이 자체 프로퍼티와 상속된 프로퍼티를 모두 집합에 포함합니다. 객체에 프로퍼티를 동적으로 추가하거나 삭제할 수 있으므로 Object Environment Record가 바인딩하는 식별자 집합은 프로퍼티를 추가하거나 삭제하는 모든 연산의 부작용으로 변경될 수 있습니다. 이러한 부작용의 결과로 생성되는 모든 바인딩은 대응하는 프로퍼티의 Writable 속성이 false이더라도 변경 가능한 바인딩으로 간주합니다. Object Environment Record에는 변경 불가능한 바인딩이 존재하지 않습니다.

with 문(14.11)을 위해 생성된 Object Environment Record는 함수 호출에 사용할 암묵적인 this 값으로 자신의 바인딩 객체를 제공할 수 있습니다. 이 기능은 Boolean [[IsWithEnvironment]] 필드로 제어됩니다.

Object Environment Record에는 표 16에 나열된 추가 상태 필드가 있습니다.

표 16: Object Environment Record의 추가 필드

필드 이름	값	의미
`[[BindingObject]]`	Object	이 Environment Record의 바인딩 객체입니다.
`[[IsWithEnvironment]]`	Boolean	이 Environment Record가 `with` 문을 위해 생성되었는지를 나타냅니다.

9.1.1.2.1 HasBinding ( `name` )

an Object Environment Record envRecord의 구체 메서드 HasBinding. 인수 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 연결된 바인딩 객체에 이름이 name인 프로퍼티가 있는지 결정합니다. 호출되면 다음 단계를 수행한다.

bindingObj를 envRecord.[[BindingObject]]로 둡니다.
foundBinding을 ? HasProperty(bindingObj, name)으로 둡니다.
foundBinding이 false이면, false를 반환합니다.
envRecord.[[IsWithEnvironment]]가 false이면, true를 반환합니다.
unscopables를 ? Get(bindingObj, %Symbol.unscopables%)로 둡니다.
unscopables가 Object이면, 다음을 수행합니다.
1. blocked를 ToBoolean(? Get(unscopables, name))로 둡니다.
2. blocked가 true이면, false를 반환합니다.
true를 반환합니다.

9.1.1.2.2 CreateMutableBinding ( `name`, `deletable` )

an Object Environment Record envRecord의 구체 메서드 CreateMutableBinding. 인수 name (String) 및 deletable (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Environment Record와 연결된 바인딩 객체에 이름이 name인 프로퍼티를 생성하고 undefined 값으로 초기화합니다. deletable이 true이면 새 프로퍼티의 [[Configurable]] 속성을 true로 설정하고, 그렇지 않으면 false로 설정합니다. 호출되면 다음 단계를 수행한다.

bindingObj를 envRecord.[[BindingObject]]로 둡니다.
? DefinePropertyOrThrow(bindingObj, name, PropertyDescriptor { [[Value]]: undefined, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: deletable })를 수행합니다.
unused를 반환합니다.

참고

일반적으로 envRecord에는 name에 대한 바인딩이 없지만, 바인딩이 있는 경우 DefinePropertyOrThrow의 의미론에 따라 기존 바인딩이 교체되거나 가려지거나 비정상 완료가 반환될 수 있습니다.

9.1.1.2.3 CreateImmutableBinding ( `name`, `strict` )

Object Environment Record의 CreateImmutableBinding 구체 메서드는 이 명세에서 절대로 사용되지 않습니다.

9.1.1.2.4 InitializeBinding ( `name`, `value` )

an Object Environment Record envRecord의 구체 메서드 InitializeBinding. 인수 name (String) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 이름이 name인 식별자의 현재 바인딩 값을 value 값으로 설정하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? envRecord.SetMutableBinding(name, value, false)를 수행합니다.
unused를 반환합니다.

참고

이 명세에서 Object Environment Record에 대한 CreateMutableBinding의 모든 사용은 같은 이름에 대한 InitializeBinding 호출이 바로 뒤따릅니다. 따라서 이 명세에서는 Object Environment Record의 바인딩 초기화 상태를 명시적으로 추적하지 않습니다.

9.1.1.2.5 SetMutableBinding ( `name`, `value`, `strict` )

an Object Environment Record envRecord의 구체 메서드 SetMutableBinding. 인수 name (String), value (ECMAScript 언어 값) 및 strict (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Environment Record와 연결된 바인딩 객체에서 이름이 name인 프로퍼티 값을 value 값으로 설정하려고 시도합니다. 일반적으로 name이라는 프로퍼티가 이미 존재하지만, 존재하지 않거나 현재 쓰기 가능하지 않은 경우 오류 처리는 strict에 따라 결정됩니다. 호출되면 다음 단계를 수행한다.

bindingObj를 envRecord.[[BindingObject]]로 둡니다.
stillExists를 ? HasProperty(bindingObj, name)으로 둡니다.
stillExists가 false이고 strict가 true이면, ReferenceError 예외를 던집니다.
? Set(bindingObj, name, value, strict)를 수행합니다.
unused를 반환합니다.

9.1.1.2.6 GetBindingValue ( `name`, `strict` )

an Object Environment Record envRecord의 구체 메서드 GetBindingValue. 인수 name (String) 및 strict (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 연결된 바인딩 객체에서 이름이 name인 프로퍼티의 값을 반환합니다. 해당 프로퍼티는 이미 존재해야 하지만 존재하지 않는 경우 결과는 strict에 따라 달라집니다. 호출되면 다음 단계를 수행한다.

bindingObj를 envRecord.[[BindingObject]]로 둡니다.
value를 ? HasProperty(bindingObj, name)으로 둡니다.
value가 false이면, 다음을 수행합니다.
1. strict가 false이면, undefined를 반환합니다.
2. ReferenceError 예외를 던집니다.
? Get(bindingObj, name)을 반환합니다.

9.1.1.2.7 DeleteBinding ( `name` )

an Object Environment Record envRecord의 구체 메서드 DeleteBinding. 인수 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 환경 객체의 [[Configurable]] 속성 값이 true인 프로퍼티에 대응하는 바인딩만 삭제할 수 있습니다. 호출되면 다음 단계를 수행한다.

bindingObj를 envRecord.[[BindingObject]]로 둡니다.
? bindingObj.[[Delete]](name)을 반환합니다.

9.1.1.2.8 HasThisBinding ( )

an Object Environment Record envRecord의 구체 메서드 HasThisBinding. 인수 없음. 반환값: false. 호출되면 다음 단계를 수행한다.

false를 반환합니다.

참고

Object Environment Record는 this 바인딩을 제공하지 않습니다.

9.1.1.2.9 GetThisBinding ( )

Object Environment Record의 GetThisBinding 구체 메서드는 이 명세에서 절대로 사용되지 않습니다.

9.1.1.2.10 HasSuperBinding ( )

an Object Environment Record envRecord의 구체 메서드 HasSuperBinding. 인수 없음. 반환값: false. 호출되면 다음 단계를 수행한다.

false를 반환합니다.

참고

Object Environment Record는 super 바인딩을 제공하지 않습니다.

9.1.1.2.11 WithBaseObject ( )

an Object Environment Record envRecord의 구체 메서드 WithBaseObject. 인수 없음. 반환값: (Object 또는 undefined). 호출되면 다음 단계를 수행한다.

envRecord.[[IsWithEnvironment]]가 true이면, envRecord.[[BindingObject]]를 반환합니다.
undefined를 반환합니다.

9.1.1.3 Function Environment Record

Function Environment Record는 함수의 최상위 스코프를 나타내는 데 사용하는 Declarative Environment Record이며, 함수가 ArrowFunction 함수 또는 AsyncArrowFunction 함수가 아니면 this 바인딩을 제공합니다. 함수가 ArrowFunction 함수 또는 AsyncArrowFunction 함수가 아니고 super를 참조하면, 해당 Function Environment Record에는 함수 내부에서 super 메서드 호출을 수행하는 데 사용하는 상태도 포함됩니다.

Function Environment Record에는 표 17에 나열된 추가 상태 필드가 있습니다.

표 17: Function Environment Record의 추가 필드

필드 이름	값	의미
`[[ThisValue]]`	ECMAScript 언어 값	이 함수 호출에 사용하는 this 값입니다.
`[[ThisBindingStatus]]`	lexical, initialized 또는 uninitialized	값이 lexical이면 이는 ArrowFunction 또는 AsyncArrowFunction이며 로컬 this 값을 갖지 않습니다.
`[[FunctionObject]]`	ECMAScript 함수 객체	호출됨으로써 이 Environment Record가 생성된 함수 객체입니다.
`[[NewTarget]]`	생성자 또는 undefined	이 Environment Record가 `[[Construct]]` 내부 메서드에 의해 생성되었으면 `[[NewTarget]]`은 `[[Construct]]`의 `newTarget` 매개변수 값입니다. 그렇지 않으면 값은 undefined입니다.

Function Environment Record는 표 15에 나열된 모든 Declarative Environment Record 메서드를 지원하며, HasThisBinding, GetThisBinding 및 HasSuperBinding을 제외한 모든 메서드에 대해 동일한 명세를 공유합니다.

9.1.1.3.1 BindThisValue ( `envRecord`, `value` )

추상 연산 BindThisValue. 인수 envRecord (Function Environment 레코드) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). envRecord.[[ThisValue]]를 설정하고 초기화되었음을 기록합니다. 호출되면 다음 단계를 수행한다.

단언: envRecord.[[ThisBindingStatus]]는 lexical이 아닙니다.
envRecord.[[ThisBindingStatus]]가 initialized이면, ReferenceError 예외를 던집니다.
envRecord.[[ThisValue]]를 value로 설정합니다.
envRecord.[[ThisBindingStatus]]를 initialized로 설정합니다.
unused를 반환합니다.

9.1.1.3.2 HasThisBinding ( )

a Function Environment Record envRecord의 구체 메서드 HasThisBinding. 인수 없음. 반환값: Boolean. 호출되면 다음 단계를 수행한다.

envRecord.[[ThisBindingStatus]]가 lexical이면, false를 반환합니다.
true를 반환합니다.

9.1.1.3.3 GetThisBinding ( )

a Function Environment Record envRecord의 구체 메서드 GetThisBinding. 인수 없음. 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: envRecord.[[ThisBindingStatus]]는 lexical이 아닙니다.
envRecord.[[ThisBindingStatus]]가 uninitialized이면, ReferenceError 예외를 던집니다.
envRecord.[[ThisValue]]를 반환합니다.

9.1.1.3.4 HasSuperBinding ( )

a Function Environment Record envRecord의 구체 메서드 HasSuperBinding. 인수 없음. 반환값: Boolean. 호출되면 다음 단계를 수행한다.

envRecord.[[ThisBindingStatus]]가 lexical이면, false를 반환합니다.
envRecord.[[FunctionObject]].[[HomeObject]]가 undefined이면, false를 반환합니다.
true를 반환합니다.

9.1.1.3.5 GetSuperBase ( `envRecord` )

추상 연산 GetSuperBase. 인수 envRecord (Function Environment 레코드). 반환값: (Object, null 또는 undefined). envRecord에 바인딩된 super 프로퍼티 접근의 기반이 되는 객체를 반환합니다. undefined 값은 이러한 접근이 런타임 오류를 생성함을 나타냅니다. 호출되면 다음 단계를 수행한다.

home을 envRecord.[[FunctionObject]].[[HomeObject]]로 둡니다.
home이 undefined이면, undefined를 반환합니다.
단언: home은 일반 객체입니다.
! home.[[GetPrototypeOf]]()를 반환합니다.

9.1.1.4 Global Environment Record

Global Environment Record는 공통 realm에서 처리되는 모든 ECMAScript Script 요소가 공유하는 가장 바깥쪽 스코프를 나타내는 데 사용됩니다. Global Environment Record는 내장 전역(절 19), 전역 객체의 프로퍼티 및 Script 내에서 발생하는 모든 최상위 선언(8.2.11, 8.2.13)에 대한 바인딩을 제공합니다.

Global Environment Record는 논리적으로 하나의 Record이지만, Object Environment Record와 Declarative Environment Record를 캡슐화한 복합체로 명시됩니다. Object Environment Record는 연결된 Realm Record의 전역 객체를 기반 객체로 갖습니다. 이 전역 객체는 Global Environment Record의 GetThisBinding 구체 메서드가 반환하는 값입니다. Global Environment Record의 Object Environment Record 구성 요소에는 모든 내장 전역(절 19)에 대한 바인딩과 전역 코드에 포함된 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration, AsyncGeneratorDeclaration 또는 VariableStatement가 도입한 모든 바인딩이 포함됩니다. 전역 코드에 있는 그 밖의 모든 ECMAScript 선언에 대한 바인딩은 Global Environment Record의 Declarative Environment Record 구성 요소에 포함됩니다.

프로퍼티는 전역 객체에 직접 생성될 수 있습니다. 따라서 Global Environment Record의 Object Environment Record 구성 요소에는 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration, AsyncGeneratorDeclaration 또는 VariableDeclaration 선언에 의해 명시적으로 생성된 바인딩과 전역 객체의 프로퍼티로서 암묵적으로 생성된 바인딩이 모두 포함될 수 있습니다.

Global Environment Record에는 표 18에 나열된 추가 필드가 있습니다.

표 18: Global Environment Record의 추가 필드

필드 이름	값	의미
`[[ObjectRecord]]`	Object Environment Record	바인딩 객체는 전역 객체입니다. 연결된 realm의 전역 코드에서 전역 내장 바인딩뿐만 아니라 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration, AsyncGeneratorDeclaration 및 VariableDeclaration 바인딩을 포함합니다.
`[[GlobalThisValue]]`	Object	전역 스코프에서 `this`가 반환하는 값입니다. 호스트는 임의의 ECMAScript Object 값을 제공할 수 있습니다.
`[[DeclarativeRecord]]`	Declarative Environment Record	연결된 realm 코드의 전역 코드에 있는 모든 선언에 대한 바인딩을 포함합니다. 단, FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration, AsyncGeneratorDeclaration 및 VariableDeclaration 바인딩은 제외합니다.

9.1.1.4.1 HasBinding ( `name` )

a Global Environment Record envRecord의 구체 메서드 HasBinding. 인수 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 인수 식별자가 해당 Record에 의해 바인딩된 식별자 중 하나인지 결정합니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, true를 반환합니다.
objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
? objRecord.HasBinding(name)을 반환합니다.

9.1.1.4.2 CreateMutableBinding ( `name`, `deletable` )

a Global Environment Record envRecord의 구체 메서드 CreateMutableBinding. 인수 name (String) 및 deletable (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 초기화되지 않은 이름 name에 대한 새로운 변경 가능한 바인딩을 생성합니다. 바인딩은 연결된 DeclarativeRecord에 생성됩니다. DeclarativeRecord에는 name에 대한 바인딩이 이미 존재해서는 안 됩니다. deletable이 true이면 새 바인딩을 삭제 가능 대상으로 표시합니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, TypeError 예외를 던집니다.
! declRecord.CreateMutableBinding(name, deletable)을 반환합니다.

9.1.1.4.3 CreateImmutableBinding ( `name`, `strict` )

a Global Environment Record envRecord의 구체 메서드 CreateImmutableBinding. 인수 name (String) 및 strict (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 초기화되지 않은 이름 name에 대한 새로운 변경 불가능한 바인딩을 생성합니다. 이 Environment Record에는 name에 대한 바인딩이 이미 존재해서는 안 됩니다. strict가 true이면 새 바인딩을 엄격 바인딩으로 표시합니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, TypeError 예외를 던집니다.
! declRecord.CreateImmutableBinding(name, strict)을 반환합니다.

9.1.1.4.4 InitializeBinding ( `name`, `value` )

a Global Environment Record envRecord의 구체 메서드 InitializeBinding. 인수 name (String) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 이름이 name인 식별자의 현재 바인딩 값을 value 값으로 설정하는 데 사용됩니다. name에 대한 초기화되지 않은 바인딩이 이미 존재해야 합니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, 다음을 수행합니다.
1. ! declRecord.InitializeBinding(name, value)을 반환합니다.
단언: 바인딩이 존재하면 Object Environment Record에 있어야 합니다.
objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
? objRecord.InitializeBinding(name, value)을 반환합니다.

9.1.1.4.5 SetMutableBinding ( `name`, `value`, `strict` )

a Global Environment Record envRecord의 구체 메서드 SetMutableBinding. 인수 name (String), value (ECMAScript 언어 값) 및 strict (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 이름이 name인 식별자의 현재 바인딩 값을 value 값으로 변경하려고 시도합니다. 바인딩이 변경 불가능한 바인딩이고 strict가 true이면 TypeError를 던집니다. 일반적으로 name이라는 바인딩이 이미 존재하지만, 존재하지 않거나 현재 쓰기 가능하지 않은 경우 오류 처리는 strict에 따라 결정됩니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, 다음을 수행합니다.
1. ? declRecord.SetMutableBinding(name, value, strict)을 반환합니다.
objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
? objRecord.SetMutableBinding(name, value, strict)을 반환합니다.

9.1.1.4.6 GetBindingValue ( `name`, `strict` )

a Global Environment Record envRecord의 구체 메서드 GetBindingValue. 인수 name (String) 및 strict (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 이름이 name인 바인딩된 식별자의 값을 반환합니다. 바인딩이 초기화되지 않은 바인딩이면 ReferenceError 예외를 던집니다. 일반적으로 name이라는 바인딩이 이미 존재하지만, 존재하지 않거나 현재 쓰기 가능하지 않은 경우 오류 처리는 strict에 따라 결정됩니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, 다음을 수행합니다.
1. ? declRecord.GetBindingValue(name, strict)을 반환합니다.
objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
? objRecord.GetBindingValue(name, strict)을 반환합니다.

9.1.1.4.7 DeleteBinding ( `name` )

a Global Environment Record envRecord의 구체 메서드 DeleteBinding. 인수 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 명시적으로 삭제 가능 대상으로 지정된 바인딩만 삭제할 수 있습니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)이 true이면, 다음을 수행합니다.
1. ! declRecord.DeleteBinding(name)을 반환합니다.
objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
globalObj를 objRecord.[[BindingObject]]로 둡니다.
existingProperty를 ? HasOwnProperty(globalObj, name)으로 둡니다.
existingProperty가 true이면, 다음을 수행합니다.
1. ? objRecord.DeleteBinding(name)을 반환합니다.
true를 반환합니다.

9.1.1.4.8 HasThisBinding ( )

a Global Environment Record envRecord의 구체 메서드 HasThisBinding. 인수 없음. 반환값: true. 호출되면 다음 단계를 수행한다.

true를 반환합니다.

참고

Global Environment Record는 항상 this 바인딩을 제공합니다.

9.1.1.4.9 GetThisBinding ( )

a Global Environment Record envRecord의 구체 메서드 GetThisBinding. 인수 없음. 반환값: 정상 완료 (값: Object). 호출되면 다음 단계를 수행한다.

envRecord.[[GlobalThisValue]]를 반환합니다.

9.1.1.4.10 HasSuperBinding ( )

a Global Environment Record envRecord의 구체 메서드 HasSuperBinding. 인수 없음. 반환값: false. 호출되면 다음 단계를 수행한다.

false를 반환합니다.

참고

Global Environment Record는 super 바인딩을 제공하지 않습니다.

9.1.1.4.11 WithBaseObject ( )

a Global Environment Record envRecord의 구체 메서드 WithBaseObject. 인수 없음. 반환값: undefined. 호출되면 다음 단계를 수행한다.

undefined를 반환합니다.

9.1.1.4.12 HasLexicalDeclaration ( `envRecord`, `name` )

추상 연산 HasLexicalDeclaration. 인수 envRecord (Global Environment 레코드) 및 name (String). 반환값: Boolean. 인수 식별자에 LexicalDeclaration 또는 ClassDeclaration과 같은 렉시컬 선언을 사용하여 생성된 envRecord 내 바인딩이 있는지 결정합니다. 호출되면 다음 단계를 수행한다.

declRecord를 envRecord.[[DeclarativeRecord]]로 둡니다.
! declRecord.HasBinding(name)을 반환합니다.

9.1.1.4.13 HasRestrictedGlobalProperty ( `envRecord`, `name` )

추상 연산 HasRestrictedGlobalProperty. 인수 envRecord (Global Environment 레코드) 및 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 인수 식별자가 전역 렉시컬 바인딩으로 가려져서는 안 되는 전역 객체 프로퍼티의 이름인지 결정합니다. 호출되면 다음 단계를 수행한다.

objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
globalObj를 objRecord.[[BindingObject]]로 둡니다.
existingProperty를 ? globalObj.[[GetOwnProperty]](name)으로 둡니다.
existingProperty가 undefined이면, false를 반환합니다.
existingProperty.[[Configurable]]이 true이면, false를 반환합니다.
true를 반환합니다.

참고

전역 객체에는 var 또는 함수 선언을 사용해 선언하지 않고 직접 생성된 프로퍼티가 존재할 수 있습니다. 전역 객체의 구성 불가능한 프로퍼티와 같은 이름을 갖는 전역 렉시컬 바인딩은 생성할 수 없습니다. 전역 프로퍼티 "undefined"는 이러한 프로퍼티의 예입니다.

9.1.1.4.14 CanDeclareGlobalVar ( `envRecord`, `name` )

추상 연산 CanDeclareGlobalVar. 인수 envRecord (Global Environment 레코드) 및 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 동일한 인수 name으로 대응하는 CreateGlobalVarBinding 호출을 수행했을 때 성공할지를 결정합니다. 중복 var 선언과 기존 전역 객체 프로퍼티에 대한 var 선언은 허용됩니다. 호출되면 다음 단계를 수행한다.

objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
globalObj를 objRecord.[[BindingObject]]로 둡니다.
hasProperty를 ? HasOwnProperty(globalObj, name)으로 둡니다.
hasProperty가 true이면, true를 반환합니다.
? IsExtensible(globalObj)을 반환합니다.

9.1.1.4.15 CanDeclareGlobalFunction ( `envRecord`, `name` )

추상 연산 CanDeclareGlobalFunction. 인수 envRecord (Global Environment 레코드) 및 name (String). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 동일한 인수 name으로 대응하는 CreateGlobalFunctionBinding 호출을 수행했을 때 성공할지를 결정합니다. 호출되면 다음 단계를 수행한다.

objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
globalObj를 objRecord.[[BindingObject]]로 둡니다.
existingProperty를 ? globalObj.[[GetOwnProperty]](name)으로 둡니다.
existingProperty가 undefined이면, ? IsExtensible(globalObj)을 반환합니다.
existingProperty.[[Configurable]]이 true이면, true를 반환합니다.
IsDataDescriptor(existingProperty)가 true이고 existingProperty가 속성 값 { [[Writable]]: true, [[Enumerable]]: true }를 가지면, true를 반환합니다.
false를 반환합니다.

9.1.1.4.16 CreateGlobalVarBinding ( `envRecord`, `name`, `deletable` )

추상 연산 CreateGlobalVarBinding. 인수 envRecord (Global Environment 레코드), name (String) 및 deletable (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 연결된 Object Environment Record에 변경 가능한 바인딩을 생성하고 초기화합니다. 바인딩이 이미 존재하면 이를 재사용하며 초기화된 것으로 간주합니다. 호출되면 다음 단계를 수행한다.

objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
globalObj를 objRecord.[[BindingObject]]로 둡니다.
hasProperty를 ? HasOwnProperty(globalObj, name)으로 둡니다.
extensible을 ? IsExtensible(globalObj)로 둡니다.
hasProperty가 false이고 extensible이 true이면, 다음을 수행합니다.
1. ? objRecord.CreateMutableBinding(name, deletable)를 수행합니다.
2. ? objRecord.InitializeBinding(name, undefined)를 수행합니다.
unused를 반환합니다.

9.1.1.4.17 CreateGlobalFunctionBinding ( `envRecord`, `name`, `value`, `deletable` )

추상 연산 CreateGlobalFunctionBinding. 인수 envRecord (Global Environment 레코드), name (String), value (ECMAScript 함수 객체) 및 deletable (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 연결된 Object Environment Record에 변경 가능한 바인딩을 생성하고 초기화합니다. 바인딩이 이미 존재하면 이를 교체합니다. 호출되면 다음 단계를 수행한다.

objRecord를 envRecord.[[ObjectRecord]]로 둡니다.
globalObj를 objRecord.[[BindingObject]]로 둡니다.
existingProperty를 ? globalObj.[[GetOwnProperty]](name)으로 둡니다.
existingProperty가 undefined이거나 existingProperty.[[Configurable]]이 true이면, 다음을 수행합니다.
1. propertyDesc를 PropertyDescriptor { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: deletable }로 둡니다.
그렇지 않으면,
1. propertyDesc를 PropertyDescriptor { [[Value]]: value }로 둡니다.
? DefinePropertyOrThrow(globalObj, name, propertyDesc)를 수행합니다.
? Set(globalObj, name, value, false)를 수행합니다.
unused를 반환합니다.

참고

전역 함수 선언은 항상 전역 객체의 자체 프로퍼티로 나타납니다. 가능한 경우 기존 자체 프로퍼티를 표준 속성 값 집합을 갖도록 재구성합니다. 7 단계는 InitializeBinding 구체 메서드를 호출하는 것과 동등하며, globalObj가 Proxy이면 동일한 Proxy 트랩 호출 시퀀스를 생성합니다.

9.1.1.5 Module Environment Record

Module Environment Record는 ECMAScript Module의 바깥쪽 스코프를 나타내는 데 사용하는 Declarative Environment Record입니다. 일반적인 변경 가능한 바인딩과 변경 불가능한 바인딩 외에도 Module Environment Record는 다른 Environment Record에 존재하는 대상 바인딩에 대한 간접 접근을 제공하는 변경 불가능한 import 바인딩도 제공합니다.

Module Environment Record는 표 15에 나열된 모든 Declarative Environment Record 메서드를 지원하며, GetBindingValue, DeleteBinding, HasThisBinding 및 GetThisBinding을 제외한 모든 메서드에 대해 동일한 명세를 공유합니다.

9.1.1.5.1 GetBindingValue ( `name`, `strict` )

a Module Environment Record envRecord의 구체 메서드 GetBindingValue. 인수 name (String) 및 strict (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 이름이 name인 바인딩된 식별자의 값을 반환합니다. 그러나 바인딩이 간접 바인딩이면 대상 바인딩의 값을 반환합니다. 바인딩은 존재하지만 초기화되지 않았으면 ReferenceError를 던집니다. 호출되면 다음 단계를 수행한다.

단언: strict는 true입니다.
단언: envRecord에는 name에 대한 바인딩이 있습니다.
name에 대한 바인딩이 간접 바인딩이면, 다음을 수행합니다.
1. module과 targetName을 이 name에 대한 바인딩이 생성될 때 제공된 간접 참조 값으로 둡니다.
2. targetEnv를 module.[[Environment]]로 둡니다.
3. targetEnv가 empty이면, ReferenceError 예외를 던집니다.
4. ? targetEnv.GetBindingValue(targetName, true)를 반환합니다.
envRecord에서 name에 대한 바인딩이 초기화되지 않은 바인딩이면, ReferenceError 예외를 던집니다.
현재 envRecord에서 name에 바인딩된 값을 반환합니다.

참고

Module은 항상 엄격 모드 코드이므로 strict는 항상 true입니다.

9.1.1.5.2 DeleteBinding ( `name` )

Module Environment Record의 DeleteBinding 구체 메서드는 이 명세에서 절대로 사용되지 않습니다.

참고

Module Environment Record는 엄격 코드에서만 사용되며, 조기 오류 규칙은 엄격 코드에서 delete 연산자를 Module Environment Record 바인딩으로 해석되는 Reference Record에 적용하는 것을 방지합니다. 13.5.1.1를 참조하시기 바랍니다.

9.1.1.5.3 HasThisBinding ( )

a Module Environment Record envRecord의 구체 메서드 HasThisBinding. 인수 없음. 반환값: true. 호출되면 다음 단계를 수행한다.

true를 반환합니다.

참고

Module Environment Record는 항상 this 바인딩을 제공합니다.

9.1.1.5.4 GetThisBinding ( )

a Module Environment Record envRecord의 구체 메서드 GetThisBinding. 인수 없음. 반환값: 정상 완료 (값: undefined). 호출되면 다음 단계를 수행한다.

undefined를 반환합니다.

9.1.1.5.5 CreateImportBinding ( `envRecord`, `name`, `targetModule`, `targetName` )

추상 연산 CreateImportBinding. 인수 envRecord (Module Environment 레코드), name (String), targetModule (Module 레코드) 및 targetName (String). 반환값: unused. 이름 name에 대해 초기화된 새로운 변경 불가능한 간접 바인딩을 생성합니다. envRecord에는 name에 대한 바인딩이 이미 존재해서는 안 됩니다. targetName은 targetModule의 Module Environment Record에 존재하는 바인딩의 이름입니다. 새 바인딩의 값에 접근하면 대상 바인딩의 바인딩된 값에 간접적으로 접근합니다. 호출되면 다음 단계를 수행한다.

단언: envRecord에는 name에 대한 바인딩이 이미 존재하지 않습니다.
단언: targetModule.[[Environment]]가 인스턴스화되면 targetName에 대한 직접 바인딩을 갖습니다.
envRecord에 name에 대한 변경 불가능한 간접 바인딩을 생성하여 targetModule 및 targetName을 대상 바인딩으로 참조하게 하고, 바인딩이 초기화되었음을 기록합니다.
unused를 반환합니다.

9.1.2 Environment Record 연산

다음 추상 연산은 이 명세에서 Environment Record에 대해 연산하는 데 사용됩니다:

9.1.2.1 GetIdentifierReference ( `envRecord`, `name`, `strict` )

추상 연산 GetIdentifierReference. 인수 envRecord ((Environment 레코드 또는 null)), name (String) 및 strict (Boolean). 반환값: (정상 완료 (값: Reference 레코드) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

envRecord가 null이면, 다음을 수행합니다.
1. Reference Record { [[Base]]: unresolvable, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]: empty }를 반환합니다.
exists를 ? envRecord.HasBinding(name)으로 둡니다.
exists가 true이면, 다음을 수행합니다.
1. Reference Record { [[Base]]: envRecord, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]: empty }를 반환합니다.
outer를 envRecord.[[OuterEnv]]로 둡니다.
? GetIdentifierReference(outer, name, strict)를 반환합니다.

9.1.2.2 NewDeclarativeEnvironment ( `outerEnv` )

추상 연산 NewDeclarativeEnvironment. 인수 outerEnv ((Environment 레코드 또는 null)). 반환값: Declarative Environment 레코드. 호출되면 다음 단계를 수행한다.

envRecord를 바인딩을 포함하지 않는 새로운 Declarative Environment Record로 둡니다.
envRecord.[[OuterEnv]]를 outerEnv로 설정합니다.
envRecord.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
envRecord를 반환합니다.

9.1.2.3 NewObjectEnvironment ( `obj`, `isWithEnv`, `outerEnv` )

추상 연산 NewObjectEnvironment. 인수 obj (Object), isWithEnv (Boolean) 및 outerEnv ((Environment 레코드 또는 null)). 반환값: Object Environment 레코드. 호출되면 다음 단계를 수행한다.

envRecord를 새로운 Object Environment Record로 둡니다.
envRecord.[[BindingObject]]를 obj로 설정합니다.
envRecord.[[IsWithEnvironment]]을 isWithEnv로 설정합니다.
envRecord.[[OuterEnv]]를 outerEnv로 설정합니다.
envRecord를 반환합니다.

9.1.2.4 NewFunctionEnvironment ( `func`, `newTarget` )

추상 연산 NewFunctionEnvironment. 인수 func (ECMAScript 함수 객체) 및 newTarget ((Object 또는 undefined)). 반환값: Function Environment 레코드. 호출되면 다음 단계를 수행한다.

envRecord를 바인딩을 포함하지 않는 새로운 Function Environment Record로 둡니다.
envRecord.[[FunctionObject]]를 func로 설정합니다.
func.[[ThisMode]]가 lexical이면, envRecord.[[ThisBindingStatus]]를 lexical로 설정합니다.
그렇지 않으면 envRecord.[[ThisBindingStatus]]를 uninitialized로 설정합니다.
envRecord.[[NewTarget]]을 newTarget으로 설정합니다.
envRecord.[[OuterEnv]]를 func.[[Environment]]로 설정합니다.
envRecord.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
envRecord를 반환합니다.

9.1.2.5 NewGlobalEnvironment ( `obj`, `thisValue` )

추상 연산 NewGlobalEnvironment. 인수 obj (Object) 및 thisValue (Object). 반환값: Global Environment 레코드. 호출되면 다음 단계를 수행한다.

objRecord를 NewObjectEnvironment(obj, false, null)로 둡니다.
declRecord를 NewDeclarativeEnvironment(null)로 둡니다.
envRecord를 새로운 Global Environment Record로 둡니다.
envRecord.[[ObjectRecord]]를 objRecord로 설정합니다.
envRecord.[[GlobalThisValue]]를 thisValue로 설정합니다.
envRecord.[[DeclarativeRecord]]를 declRecord로 설정합니다.
envRecord.[[OuterEnv]]를 null로 설정합니다.
envRecord를 반환합니다.

9.1.2.6 NewModuleEnvironment ( `outerEnv` )

추상 연산 NewModuleEnvironment. 인수 outerEnv (Global Environment 레코드). 반환값: Module Environment 레코드. 호출되면 다음 단계를 수행한다.

envRecord를 바인딩을 포함하지 않는 새로운 Module Environment Record로 둡니다.
envRecord.[[OuterEnv]]를 outerEnv로 설정합니다.
envRecord.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
envRecord를 반환합니다.

9.2 PrivateEnvironment Record

PrivateEnvironment Record는 ECMAScript 코드에서 ClassDeclaration 및 ClassExpression의 렉시컬 중첩 구조를 기반으로 Private Name을 추적하는 데 사용하는 명세 메커니즘입니다. 이는 Environment Record와 유사하지만 서로 구별됩니다. 각 PrivateEnvironment Record는 ClassDeclaration 또는 ClassExpression과 연결됩니다. 이러한 클래스가 평가될 때마다 해당 클래스에서 선언한 Private Name을 기록하기 위해 새로운 PrivateEnvironment Record가 생성됩니다.

각 PrivateEnvironment Record에는 표 19에 정의된 필드가 있습니다.

표 19: PrivateEnvironment Record 필드

필드 이름	값 타입	의미
`[[OuterPrivateEnvironment]]`	PrivateEnvironment Record 또는 null	가장 가까운 둘러싸는 클래스의 PrivateEnvironment Record입니다. 이 PrivateEnvironment Record와 연결된 클래스가 다른 클래스 안에 포함되지 않으면 null입니다.
`[[Names]]`	Private Name의 List	이 클래스가 선언한 Private Name입니다.

9.2.1 PrivateEnvironment Record 연산

다음 추상 연산은 이 명세에서 PrivateEnvironment Record에 대해 연산하는 데 사용됩니다:

9.2.1.1 NewPrivateEnvironment ( `outerPrivateEnv` )

추상 연산 NewPrivateEnvironment. 인수 outerPrivateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: PrivateEnvironment 레코드. 호출되면 다음 단계를 수행한다.

names를 새로운 빈 List로 둡니다.
PrivateEnvironment Record { [[OuterPrivateEnvironment]]: outerPrivateEnv, [[Names]]: names }를 반환합니다.

9.2.1.2 ResolvePrivateIdentifier ( `privateEnv`, `identifier` )

추상 연산 ResolvePrivateIdentifier. 인수 privateEnv (PrivateEnvironment 레코드) 및 identifier (String). 반환값: 비공개 이름. 호출되면 다음 단계를 수행한다.

names를 privateEnv.[[Names]]로 둡니다.
names의 각 Private Name privateName에 대해 다음을 수행합니다.
1. privateName.[[Description]]이 identifier이면, 다음을 수행합니다.
  1. privateName을 반환합니다.
outerPrivateEnv를 privateEnv.[[OuterPrivateEnvironment]]로 둡니다.
단언: outerPrivateEnv는 null이 아닙니다.
ResolvePrivateIdentifier(outerPrivateEnv, identifier)를 반환합니다.

9.3 Realm

모든 ECMAScript 코드는 평가되기 전에 realm과 연결되어야 합니다. 개념적으로 realm은 내재 객체 집합, ECMAScript 전역 환경, 해당 전역 환경의 스코프 내에서 로드된 모든 ECMAScript 코드 및 기타 연결된 상태와 리소스로 구성됩니다.

realm은 이 명세에서 표 20에 명시된 필드를 갖는 Realm Record로 나타냅니다:

표 20: Realm Record 필드

필드 이름	값	의미
`[[AgentSignifier]]`	에이전트 식별자	이 realm을 소유하는 에이전트
`[[Intrinsics]]`	필드 이름이 내재 키이고 값이 객체인 Record	이 realm과 연결된 코드가 사용하는 내재 값
`[[GlobalObject]]`	Object	이 realm의 전역 객체
`[[GlobalEnv]]`	Global Environment Record	이 realm의 전역 환경
`[[TemplateMap]]`	`[[Site]]`(TemplateLiteral Parse Node) 및 `[[Array]]`(Array) 필드를 갖는 Record의 List	템플릿 객체는 각 realm의 Realm Record `[[TemplateMap]]`을 사용하여 realm별로 별도로 정규화됩니다. 각 `[[Site]]` 값은 TemplateLiteral인 Parse Node입니다. 연결된 `[[Array]]` 값은 태그 함수에 전달되는 대응하는 템플릿 객체입니다. 참고 1 Parse Node에 더 이상 접근할 수 없게 되면 대응하는 `[[Array]]`에도 접근할 수 없게 되며, 구현체가 `[[TemplateMap]]` 목록에서 해당 쌍을 제거하더라도 관찰할 수 없습니다.
`[[LoadedModules]]`	LoadedModuleRequest Record의 List	이 realm이 가져온 지정자 문자열에서 해석된 Module Record로의 매핑입니다. 이 목록에는 ModuleRequestsEqual(`r1`, `r2`)가 true인 서로 다른 두 Record `r1`과 `r2`가 포함되지 않습니다. 참고 2 HostLoadImportedModule(16.2.1.10 참고 1)에서 언급했듯이 Realm Record의 `[[LoadedModules]]`는 활성 스크립트 또는 모듈이 없는 문맥에서 `import()` 표현식을 실행할 때만 사용됩니다.
`[[HostDefined]]`	임의의 값(기본값은 undefined)	Realm Record에 추가 정보를 연결해야 하는 호스트가 사용하도록 예약된 필드입니다.

9.3.1 InitializeHostDefinedRealm ( )

추상 연산 InitializeHostDefinedRealm. 인수 없음. 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

realm을 새로운 Realm Record로 둡니다.
CreateIntrinsics(realm)를 수행합니다.
realm.[[AgentSignifier]]을 AgentSignifier()로 설정합니다.
realm.[[TemplateMap]]을 새로운 빈 List로 설정합니다.
newContext를 새로운 실행 컨텍스트로 둡니다.
newContext의 Function을 null로 설정합니다.
newContext의 Realm을 realm으로 설정합니다.
newContext의 ScriptOrModule을 null로 설정합니다.
newContext를 실행 컨텍스트 스택에 푸시합니다. 이제 newContext가 실행 중인 실행 컨텍스트입니다.
호스트가 realm의 전역 객체로 사용할 특정 객체를 요구하면, 다음을 수행합니다.
1. global을 호스트 정의 방식으로 생성한 해당 객체로 둡니다.
그렇지 않으면,
1. global을 OrdinaryObjectCreate(realm.[[Intrinsics]].[[%Object.prototype%]])로 둡니다.
호스트가 realm의 전역 스코프에서 this 바인딩이 전역 객체가 아닌 객체를 반환하도록 요구하면, 다음을 수행합니다.
1. thisValue를 호스트 정의 방식으로 생성한 해당 객체로 둡니다.
그렇지 않으면,
1. thisValue를 global로 둡니다.
realm.[[GlobalObject]]를 global로 설정합니다.
realm.[[GlobalEnv]]를 NewGlobalEnvironment(global, thisValue)로 설정합니다.
? SetDefaultGlobalBindings(realm)를 수행합니다.
global에 호스트 정의 전역 객체 프로퍼티를 생성합니다.
unused를 반환합니다.

9.3.2 CreateIntrinsics ( `realmRecord` )

추상 연산 CreateIntrinsics. 인수 realmRecord (Realm 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

realmRecord.[[Intrinsics]]를 새로운 Record로 설정합니다.
realmRecord.[[Intrinsics]]의 필드를 표 6에 나열된 값으로 설정합니다. 필드 이름은 표의 “Intrinsic Name” 열에 나열된 이름입니다. 각 필드의 값은 절 19부터 28까지 각 객체의 명세에 정의된 프로퍼티 값으로 완전히 재귀적으로 채워진 새로운 객체 값입니다. 모든 객체 프로퍼티 값은 새로 생성된 객체 값입니다. 내장 함수 객체인 모든 값은 CreateBuiltinFunction(steps, length, name, slots, realmRecord, proto, async)을 수행하여 생성합니다. 여기에서 steps는 이 명세가 제공하는 해당 함수의 정의이고, name은 함수의 "name" 프로퍼티 초기값이며, length는 함수의 "length" 프로퍼티 초기값이고, slots는 지정된 함수 내부 슬롯 이름의 목록이며(있는 경우), proto는 함수의 [[Prototype]] 내부 슬롯에 지정된 값이고, async는 함수가 “async”로 설명되면 true, 그렇지 않으면 false입니다. 내재 객체와 그 프로퍼티의 생성은 아직 생성되지 않은 객체에 대한 의존성이 발생하지 않도록 순서를 정해야 합니다.
AddRestrictedFunctionProperties(realmRecord.[[Intrinsics]].[[%Function.prototype%]], realmRecord)를 수행합니다.
unused를 반환합니다.

9.3.3 SetDefaultGlobalBindings ( `realmRecord` )

추상 연산 SetDefaultGlobalBindings. 인수 realmRecord (Realm 레코드). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

global을 realmRecord.[[GlobalObject]]로 둡니다.
절 19에 명시된 전역 객체의 각 프로퍼티에 대해 다음을 수행합니다.
1. name을 프로퍼티 이름의 String 값으로 둡니다.
2. propertyDesc를 해당 프로퍼티에 지정된 속성을 포함하는, 프로퍼티에 대해 모든 필드가 채워진 데이터 Property Descriptor로 둡니다. 19.2, 19.3 또는 19.4에 나열된 프로퍼티의 경우 [[Value]] 속성의 값은 realmRecord의 대응하는 내재 객체입니다.
3. ? DefinePropertyOrThrow(global, name, propertyDesc)를 수행합니다.
unused를 반환합니다.

9.4 실행 컨텍스트

실행 컨텍스트는 ECMAScript 구현체가 코드의 런타임 평가를 추적하는 데 사용하는 명세 장치입니다. 어느 시점이든 실제로 코드를 실행 중인 실행 컨텍스트는 에이전트당 최대 하나입니다. 이를 에이전트의 실행 중인 실행 컨텍스트라고 합니다. 이 명세에서 실행 중인 실행 컨텍스트에 대한 모든 참조는 주변 에이전트의 실행 중인 실행 컨텍스트를 나타냅니다.

실행 컨텍스트 스택은 실행 컨텍스트를 추적하는 데 사용됩니다. 실행 중인 실행 컨텍스트는 항상 이 스택의 최상위 요소입니다. 현재 실행 중인 실행 컨텍스트와 연결된 실행 가능 코드에서 해당 실행 컨텍스트와 연결되지 않은 실행 가능 코드로 제어가 이전될 때마다 새로운 실행 컨텍스트가 생성됩니다. 새로 생성된 실행 컨텍스트는 스택에 푸시되어 실행 중인 실행 컨텍스트가 됩니다.

실행 컨텍스트에는 연결된 코드의 실행 진행 상황을 추적하는 데 필요한 구현체별 상태가 포함됩니다. 각 실행 컨텍스트에는 최소한 표 21에 나열된 상태 구성 요소가 있습니다.

표 21: 모든 실행 컨텍스트의 상태 구성 요소

구성 요소	목적
코드 평가 상태	이 실행 컨텍스트와 연결된 코드의 평가를 수행, 일시 중단 및 재개하는 데 필요한 모든 상태입니다.
Function	이 실행 컨텍스트가 함수 객체의 코드를 평가 중이면 이 구성 요소의 값은 해당 함수 객체입니다. 컨텍스트가 Script 또는 Module의 코드를 평가 중이면 값은 null입니다.
Realm	연결된 코드가 ECMAScript 리소스에 접근하는 Realm Record입니다.
ScriptOrModule	연결된 코드가 유래한 Module Record 또는 Script Record입니다. InitializeHostDefinedRealm에서 생성되는 최초 실행 컨텍스트처럼 원본 스크립트 또는 모듈이 없으면 값은 null입니다.

실행 중인 실행 컨텍스트에 의한 코드 평가는 이 명세에 정의된 여러 지점에서 일시 중단될 수 있습니다. 실행 중인 실행 컨텍스트가 일시 중단되면 다른 실행 컨텍스트가 실행 중인 실행 컨텍스트가 되어 자신의 코드를 평가하기 시작할 수 있습니다. 이후 어느 시점에 일시 중단된 실행 컨텍스트가 다시 실행 중인 실행 컨텍스트가 되어 이전에 일시 중단된 지점부터 코드 평가를 계속할 수 있습니다. 실행 중인 실행 컨텍스트 상태의 실행 컨텍스트 간 전환은 일반적으로 스택과 같은 후입선출 방식으로 이루어집니다. 그러나 일부 ECMAScript 기능에는 비LIFO 방식의 실행 컨텍스트 전환이 필요합니다.

실행 중인 실행 컨텍스트의 Realm 구성 요소 값은 현재 Realm Record라고도 합니다. 실행 중인 실행 컨텍스트의 Function 구성 요소 값은 활성 함수 객체라고도 합니다.

ECMAScript 코드 실행 컨텍스트에는 표 22에 나열된 추가 상태 구성 요소가 있습니다.

표 22: ECMAScript 코드 실행 컨텍스트의 추가 상태 구성 요소

구성 요소	목적
LexicalEnvironment	이 실행 컨텍스트 내의 코드가 만든 식별자 참조를 해석하는 데 사용하는 Environment Record를 식별합니다.
VariableEnvironment	이 실행 컨텍스트 내의 VariableStatement가 생성한 바인딩을 보유하는 Environment Record를 식별합니다.
PrivateEnvironment	가장 가까운 둘러싸는 클래스에서 ClassElement가 생성한 Private Name을 보유하는 PrivateEnvironment Record를 식별합니다. 둘러싸는 클래스가 없으면 null입니다.

실행 컨텍스트의 LexicalEnvironment와 VariableEnvironment 구성 요소는 항상 Environment Record입니다.

Generator의 평가를 나타내는 실행 컨텍스트에는 표 23에 나열된 추가 상태 구성 요소가 있습니다.

표 23: Generator 실행 컨텍스트의 추가 상태 구성 요소

구성 요소	목적
Generator	이 실행 컨텍스트가 평가 중인 Generator입니다.

대부분의 상황에서 이 명세의 알고리즘은 실행 중인 실행 컨텍스트(실행 컨텍스트 스택의 최상위)만 직접 조작합니다. 따라서 “LexicalEnvironment” 및 “VariableEnvironment”라는 용어를 별도의 한정 없이 사용하면 실행 중인 실행 컨텍스트의 해당 구성 요소를 가리킵니다.

실행 컨텍스트는 순수하게 명세상의 메커니즘이며 ECMAScript 구현체의 특정 산출물과 대응할 필요는 없습니다. ECMAScript 코드가 실행 컨텍스트에 직접 접근하거나 이를 관찰하는 것은 불가능합니다.

9.4.1 GetActiveScriptOrModule ( )

추상 연산 GetActiveScriptOrModule. 인수 없음. 반환값: (Script 레코드, Module 레코드 또는 null). 실행 중인 실행 컨텍스트를 기반으로 실행 중인 스크립트 또는 모듈을 결정하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

실행 컨텍스트 스택이 비어 있으면, null을 반환합니다.
executionContext를 실행 컨텍스트 스택에서 ScriptOrModule 구성 요소가 null이 아닌 가장 위쪽의 실행 컨텍스트로 둡니다.
그러한 실행 컨텍스트가 존재하지 않으면, null을 반환합니다.
executionContext의 ScriptOrModule을 반환합니다.

9.4.2 ResolveBinding ( `name` [ , `envRecord` ] )

추상 연산 ResolveBinding. 인수 name (String) 및 선택적 인수 envRecord ((Environment 레코드 또는 undefined)). 반환값: (정상 완료 (값: Reference 레코드) 또는 throw 완료). name의 바인딩을 결정하는 데 사용됩니다. envRecord를 사용하여 바인딩을 검색할 Environment Record를 명시적으로 제공할 수 있습니다. 호출되면 다음 단계를 수행한다.

envRecord가 존재하지 않거나 envRecord가 undefined이면, 다음을 수행합니다.
1. envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 설정합니다.
단언: envRecord는 Environment Record입니다.
strict를 IsStrict(평가 중인 구문 생성 규칙)으로 둡니다.
? GetIdentifierReference(envRecord, name, strict)를 반환합니다.

참고

ResolveBinding의 결과는 항상 [[ReferencedName]] 필드가 name인 Reference Record입니다.

9.4.3 GetThisEnvironment ( )

추상 연산 GetThisEnvironment. 인수 없음. 반환값: Environment 레코드. 현재 키워드 this의 바인딩을 제공하는 Environment Record를 찾습니다. 호출되면 다음 단계를 수행한다.

envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
다음을 반복합니다.
1. exists를 envRecord.HasThisBinding()으로 둡니다.
2. exists가 true이면, envRecord를 반환합니다.
3. outer를 envRecord.[[OuterEnv]]로 둡니다.
4. 단언: outer는 null이 아닙니다.
5. envRecord를 outer로 설정합니다.

참고

환경 목록은 항상 this 바인딩을 갖는 전역 환경으로 끝나므로 2 단계의 반복은 항상 종료됩니다.

9.4.4 ResolveThisBinding ( )

추상 연산 ResolveThisBinding. 인수 없음. 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 실행 중인 실행 컨텍스트의 LexicalEnvironment를 사용하여 키워드 this의 바인딩을 결정합니다. 호출되면 다음 단계를 수행한다.

envRecord를 GetThisEnvironment()로 둡니다.
? envRecord.GetThisBinding()을 반환합니다.

9.4.5 GetNewTarget ( )

추상 연산 GetNewTarget. 인수 없음. 반환값: (Object 또는 undefined). 실행 중인 실행 컨텍스트의 LexicalEnvironment를 사용하여 NewTarget 값을 결정합니다. 호출되면 다음 단계를 수행한다.

envRecord를 GetThisEnvironment()로 둡니다.
단언: envRecord에는 [[NewTarget]] 필드가 있습니다.
envRecord.[[NewTarget]]을 반환합니다.

9.4.6 GetGlobalObject ( )

추상 연산 GetGlobalObject. 인수 없음. 반환값: Object. 현재 실행 중인 실행 컨텍스트가 사용하는 전역 객체를 반환합니다. 호출되면 다음 단계를 수행한다.

currentRealm을 현재 Realm Record로 둡니다.
currentRealm.[[GlobalObject]]를 반환합니다.

9.4.7 RunSuspendedContext ( `context`, `completionRecord` )

추상 연산 RunSuspendedContext. 인수 context (실행 컨텍스트) 및 completionRecord (완료 레코드). 반환값: (정상 완료 (값: (ECMAScript 언어 값 또는 unused)) 또는 중도 완료). context를 재개하고(completionRecord를 재개 값으로 전달합니다) 결과를 기다립니다. 호출되면 다음 단계를 수행한다.

callerContext를 실행 중인 실행 컨텍스트로 둡니다.
callerContext를 일시 중단합니다.
context를 실행 컨텍스트 스택에 푸시합니다. 이제 context가 실행 중인 실행 컨텍스트입니다.
context의 일시 중단된 평가를 재개합니다. 이때 completionRecord를 해당 컨텍스트를 일시 중단시킨 연산의 결과로 전달합니다. result를 재개된 계산이 전달한 Completion Record로 둡니다.
단언: 이 단계에 도달했을 때 context는 이미 실행 컨텍스트 스택에서 제거되었고 callerContext가 다시 실행 중인 실행 컨텍스트입니다.
Completion(result)를 반환합니다.

9.4.8 RunCallerContext ( `value` )

추상 연산 RunCallerContext. 인수 value ((ECMAScript 언어 값 또는 empty)). 반환값: 완료 레코드. 호출자 컨텍스트를 재개하고(value를 재개 값으로 전달합니다), 결과가 있으면 이를 기다립니다. 호출되면 다음 단계를 수행한다.

genContext를 실행 중인 실행 컨텍스트로 둡니다.
genContext를 실행 컨텍스트 스택에서 제거하고 실행 컨텍스트 스택 최상위에 있는 실행 컨텍스트를 실행 중인 실행 컨텍스트로 복원합니다.
callerContext를 실행 중인 실행 컨텍스트로 둡니다.
NormalCompletion(value)을 전달하여 callerContext를 재개합니다.
참고: 위 단계는 제어를 callerContext로 이전하고 일시 중단합니다. 이 알고리즘의 이후 단계로 제어가 진행될 수 있는 유일한 방법은 genContext가 다시 재개되는 것이며, 이는 영원히 발생하지 않을 수도 있습니다.
단언: genContext가 실행 중인 실행 컨텍스트입니다.
result를 방금 genContext가 재개될 때 사용된 Completion Record로 둡니다.
Completion(result)를 반환합니다.

9.5 Job과 Job을 큐에 넣는 호스트 연산

Job은 매개변수가 없고 다른 ECMAScript 계산이 현재 진행 중이지 않을 때 ECMAScript 계산을 시작하는 Abstract Closure입니다.

Job은 특정 에이전트에서 ECMAScript 호스트 환경에 의해 실행되도록 예약됩니다. 이 명세에서는 Job을 예약하기 위한 호스트 훅 HostEnqueueGenericJob, HostEnqueueFinalizationRegistryCleanupJob, HostEnqueuePromiseJob 및 HostEnqueueTimeoutJob을 설명합니다. 이 명세의 호스트 훅은 Job 예약에 부과되는 추가 제약 조건에 따라 구성됩니다. 호스트는 Job을 예약하는 추가 추상 연산을 정의할 수 있습니다. 이러한 연산은 Job Abstract Closure와 realm(Realm Record 또는 null)을 매개변수로 받습니다. Realm Record가 제공되면 해당 연산은 제공된 realm을 소유하는 에이전트에서 미래의 어느 시점에 Job을 수행하도록 예약합니다. realm 대신 null이 제공되면 해당 Job은 ECMAScript 코드를 평가하지 않습니다. 구현은 다음 요구 사항을 준수해야 합니다:

미래의 어느 시점에 Job이 예약된 에이전트에 실행 중인 컨텍스트가 없고 해당 에이전트의 실행 컨텍스트 스택이 비어 있을 때 구현체는 다음을 수행해야 합니다:
1. 호스트 정의 준비 단계를 수행합니다.
2. Job Abstract Closure를 호출합니다.
3. 호스트 정의 정리 단계를 수행하며, 이후 실행 컨텍스트 스택은 비어 있어야 합니다.
에이전트에서는 어느 시점이든 하나의 Job만 활성 상태로 평가될 수 있습니다.
Job의 평가가 시작되면 에이전트에서 다른 Job의 평가가 시작되기 전에 완료될 때까지 실행되어야 합니다.
Abstract Closure는 오류 처리를 자체적으로 구현하고 정상 완료를 반환해야 합니다.

참고 1

호스트 환경은 예약과 관련하여 모든 Job을 동일하게 취급할 필요가 없습니다. 예를 들어 웹 브라우저와 Node.js는 Promise 처리 Job을 다른 작업보다 더 높은 우선순위로 취급합니다. 향후 기능에서는 이처럼 높은 우선순위로 처리되지 않는 Job이 추가될 수 있습니다.

특정 시점에 scriptOrModule(Script Record, Module Record 또는 null)은 다음 조건이 모두 참인 경우 활성 스크립트 또는 모듈입니다:

GetActiveScriptOrModule()이 scriptOrModule입니다.
scriptOrModule이 Script Record 또는 Module Record이면 executionContext를 실행 컨텍스트 스택에서 ScriptOrModule 구성 요소가 scriptOrModule인 가장 위쪽의 실행 컨텍스트로 둡니다. executionContext의 Realm 구성 요소는 scriptOrModule.[[Realm]]입니다.

특정 시점에 실행은 다음 조건이 모두 참이면 ECMAScript 코드를 평가할 준비가 된 상태입니다:

실행 컨텍스트 스택이 비어 있지 않습니다.
실행 컨텍스트 스택 최상위 실행 컨텍스트의 Realm 구성 요소가 Realm Record입니다.

참고 2

호스트 환경은 실행 컨텍스트를 실행 컨텍스트 스택에 푸시하여 코드 평가를 위한 실행을 준비할 수 있습니다. 구체적인 단계는 구현체 정의입니다.

구체적으로 어떤 Realm을 선택할지는 호스트 환경이 결정합니다. 이 최초 실행 컨텍스트와 Realm은 콜백 함수가 호출되기 전까지만 사용됩니다. Promise 핸들러와 같이 Job과 관련된 콜백 함수가 호출되면 해당 호출은 자신의 실행 컨텍스트와 Realm을 푸시합니다.

특정 종류의 Job에는 추가 적합성 요구 사항이 있습니다.

9.5.1 JobCallback Record

JobCallback Record는 함수 객체와 호스트 정의 값을 저장하는 데 사용하는 Record입니다. 호스트가 큐에 넣은 Job을 통해 호출되는 함수 객체는 추가적인 호스트 정의 문맥을 가질 수 있습니다. 이 상태를 전파하기 위해 Job Abstract Closure는 함수 객체를 직접 캡처하여 호출하지 않아야 합니다. 대신 HostMakeJobCallback과 HostCallJobCallback을 사용합니다.

참고

예를 들어 WHATWG HTML 명세(https://html.spec.whatwg.org/)는 호스트 정의 값을 사용하여 Promise 콜백에 대한 incumbent settings object를 전파합니다.

JobCallback Record에는 표 24에 나열된 필드가 있습니다.

표 24: JobCallback Record 필드

필드 이름	값	의미
`[[Callback]]`	함수 객체	Job이 호출될 때 호출할 함수입니다.
`[[HostDefined]]`	임의의 값(기본값은 empty)	호스트가 사용하도록 예약된 필드입니다.

9.5.2 HostMakeJobCallback ( `callback` )

호스트 정의 추상 연산 HostMakeJobCallback. 인수 callback (함수 객체). 반환값: JobCallback 레코드.

HostMakeJobCallback의 구현은 다음 요구 사항을 준수해야 합니다:

[[Callback]] 필드가 callback인 JobCallback Record를 반환해야 합니다.

HostMakeJobCallback의 기본 구현은 호출될 때 다음 단계를 수행합니다:

JobCallback Record { [[Callback]]: callback, [[HostDefined]]: empty }를 반환합니다.

웹 브라우저가 아닌 ECMAScript 호스트는 HostMakeJobCallback의 기본 구현을 사용해야 합니다.

참고

이는 콜백이 나중에 예약되어 실행되도록 하는 함수에 전달되는 시점에 호출됩니다. 예를 들어 promise.then(thenAction)은 반응 Job을 예약하는 시점이 아니라 Promise.prototype.then을 호출하는 시점에 thenAction에 대해 MakeJobCallback을 호출합니다.

9.5.3 HostCallJobCallback ( `jobCallback`, `thisValue`, `argList` )

호스트 정의 추상 연산 HostCallJobCallback. 인수 jobCallback (JobCallback 레코드), thisValue (ECMAScript 언어 값) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료).

HostCallJobCallback의 구현은 다음 요구 사항을 준수해야 합니다:

Call(jobCallback.[[Callback]], thisValue, argList)을 수행하고 그 결과를 반환해야 합니다.

참고

이 요구 사항은 호스트가 이 명세에 정의된 함수 객체의 [[Call]] 동작을 변경할 수 없음을 의미합니다.

HostCallJobCallback의 기본 구현은 호출될 때 다음 단계를 수행합니다:

단언: IsCallable(jobCallback.[[Callback]])은 true입니다.
? Call(jobCallback.[[Callback]], thisValue, argList)을 반환합니다.

웹 브라우저가 아닌 ECMAScript 호스트는 HostCallJobCallback의 기본 구현을 사용해야 합니다.

9.5.4 HostEnqueueGenericJob ( `job`, `realm` )

호스트 정의 추상 연산 HostEnqueueGenericJob. 인수 job (a Job Abstract Closure) 및 realm (Realm 레코드). 반환값: unused. realm.[[AgentSignifier]]로 나타내는 에이전트에서 미래의 어느 시점에 수행되도록 realm realm에 job을 예약합니다. 이 알고리즘과 함께 사용하는 Abstract Closure는 우선순위나 순서와 같은 추가 제약 조건 없이 예약되도록 의도되었습니다.

HostEnqueueGenericJob의 구현은 9.5의 요구 사항을 준수해야 합니다.

9.5.5 HostEnqueuePromiseJob ( `job`, `realm` )

호스트 정의 추상 연산 HostEnqueuePromiseJob. 인수 job (a Job Abstract Closure) 및 realm ((Realm 레코드 또는 null)). 반환값: unused. 미래의 어느 시점에 수행되도록 job을 예약합니다. 이 알고리즘과 함께 사용하는 Abstract Closure는 Promise 처리와 관련되거나 그 밖에 Promise 처리 연산과 같은 우선순위로 예약되도록 의도되었습니다.

HostEnqueuePromiseJob의 구현은 9.5의 요구 사항뿐만 아니라 다음 사항도 준수해야 합니다:

realm이 null이 아니면 job이 호출될 때마다 구현체는 job 호출 시점에 실행이 ECMAScript 코드를 평가할 준비가 되도록 구현체 정의 단계를 수행해야 합니다.
HostEnqueuePromiseJob이 호출되는 시점의 GetActiveScriptOrModule()을 scriptOrModule로 둡니다. realm이 null이 아니면 job이 호출될 때마다 구현체는 job 호출 시점에 scriptOrModule이 활성 스크립트 또는 모듈이 되도록 구현체 정의 단계를 수행해야 합니다.
Job은 이를 예약한 HostEnqueuePromiseJob 호출과 동일한 순서로 실행되어야 합니다.

참고

NewPromiseResolveThenableJob이 반환한 Job의 realm은 일반적으로 then 함수 객체에 대해 GetFunctionRealm을 호출한 결과입니다. NewPromiseReactionJob이 반환한 Job의 realm은 핸들러가 undefined가 아니면 일반적으로 핸들러에 대해 GetFunctionRealm을 호출한 결과입니다. 핸들러가 undefined이면 realm은 null입니다. 두 종류의 Job 모두 GetFunctionRealm이 비정상적으로 완료되면(즉, 해제된 Proxy에서 호출된 경우) realm은 GetFunctionRealm 호출 시점의 현재 Realm Record입니다. realm이 null이면 사용자 ECMAScript 코드는 평가되지 않고 새로운 ECMAScript 객체(예: Error 객체)도 생성되지 않습니다. 예를 들어 WHATWG HTML 명세(https://html.spec.whatwg.org/)는 realm을 사용하여 스크립트를 실행할 수 있는지와 entry 개념을 검사합니다.

9.5.6 HostEnqueueTimeoutJob ( `timeoutJob`, `realm`, `milliseconds` )

호스트 정의 추상 연산 HostEnqueueTimeoutJob. 인수 timeoutJob (a Job Abstract Closure), realm (Realm 레코드) 및 milliseconds (음이 아닌 유한한 Number). 반환값: unused. realm.[[AgentSignifier]]로 나타내는 에이전트에서 최소 milliseconds밀리초 후에 수행되도록 realm realm에 timeoutJob을 예약합니다.

HostEnqueueTimeoutJob의 구현은 9.5의 요구 사항을 준수해야 합니다.

9.6 에이전트

에이전트는 ECMAScript 실행 컨텍스트의 집합, 실행 컨텍스트 스택, 실행 중인 실행 컨텍스트, Agent Record 및 실행 스레드로 구성됩니다. 실행 스레드를 제외한 에이전트의 구성 요소는 해당 에이전트에만 속합니다.

에이전트의 실행 스레드는 다른 에이전트와 독립적으로 해당 에이전트의 실행 컨텍스트에서 알고리즘 단계를 실행합니다. 단, 스레드를 공유하는 에이전트 중 [[CanBlock]] 필드가 true인 Agent Record를 갖는 에이전트가 없다면 하나의 실행 스레드를 여러 에이전트의 실행 스레드로 사용할 수 있습니다.

참고 1

예를 들어 일부 웹 브라우저는 브라우저 창의 관련 없는 여러 탭 사이에서 하나의 실행 스레드를 공유합니다.

에이전트의 실행 스레드가 알고리즘 단계를 실행하는 동안 해당 에이전트는 그 단계의 주변 에이전트입니다. 단계는 주변 에이전트를 사용하여 에이전트가 보유하는 명세 수준 실행 객체, 즉 실행 중인 실행 컨텍스트, 실행 컨텍스트 스택 및 Agent Record의 필드에 접근합니다.

에이전트 식별자는 Agent를 식별하는 데 사용하는 전역적으로 고유한 불투명 값입니다.

표 25: Agent Record 필드

필드 이름	값	의미
`[[LittleEndian]]`	Boolean	GetValueFromBuffer 및 SetValueInBuffer 알고리즘에서 isLittleEndian 매개변수가 필요할 때 계산되는 기본값입니다. 선택은 구현체 정의이며 구현체에 가장 효율적인 대안을 사용해야 합니다.
`[[CanBlock]]`	Boolean	에이전트가 블로킹될 수 있는지를 결정합니다.
`[[Signifier]]`	에이전트 식별자	에이전트 클러스터 내에서 에이전트를 고유하게 식별합니다.
`[[IsLockFree1]]`	Boolean	1바이트 값에 대한 원자적 연산이 lock-free이면 true, 그렇지 않으면 false입니다.
`[[IsLockFree2]]`	Boolean	2바이트 값에 대한 원자적 연산이 lock-free이면 true, 그렇지 않으면 false입니다.
`[[IsLockFree8]]`	Boolean	8바이트 값에 대한 원자적 연산이 lock-free이면 true, 그렇지 않으면 false입니다.
`[[CandidateExecution]]`	후보 실행 Record	메모리 모델을 참조하시기 바랍니다.
`[[KeptAlive]]`	Object 또는 Symbol의 List	처음에는 새로운 빈 List이며, 현재 Job이 끝날 때까지 생존 상태로 유지할 객체 및/또는 Symbol의 목록을 나타냅니다.
`[[ModuleAsyncEvaluationCount]]`	정수	처음에는 0이며, 비동기이거나 비동기 의존성을 갖는 모듈의 `[[AsyncEvaluationOrder]]` 필드에 증가하는 고유 값을 할당하는 데 사용됩니다.
`[[GlobalSymbolRegistry]]`	GlobalSymbolRegistry Record의 List	처음에는 새로운 빈 List이며, Symbol.for가 생성한 Symbol 값의 목록을 나타냅니다.

[[LittleEndian]], [[Signifier]], [[IsLockFree1]], [[IsLockFree2]] 및 [[IsLockFree8]]의 값은 변경될 수 없습니다.

[[GlobalSymbolRegistry]] List는 추가만 가능하며 다시 할당되지 않습니다.

참고 2

[[IsLockFree1]], [[IsLockFree2]] 및 [[IsLockFree8]]의 값은 반드시 하드웨어에 의해 결정되는 것은 아니며, 시간에 따라 또는 ECMAScript 구현체마다 달라질 수 있는 구현 선택을 반영할 수도 있습니다.

[[IsLockFree4]] 필드는 없습니다. 4바이트 원자적 연산은 항상 lock-free입니다.

실제로 어떤 형태의 락을 사용하여 원자적 연산을 구현하면 해당 연산은 lock-free가 아닙니다. lock-free가 wait-free를 의미하지는 않습니다. lock-free 원자적 연산을 완료하는 데 필요한 머신 단계 수에는 상한이 없습니다.

크기가 n인 원자적 접근이 lock-free라는 사실은 크기가 n인 비원자적 접근의 (인지되는) 원자성에 대해 아무것도 의미하지 않습니다. 특히 비원자적 접근은 여전히 여러 개의 별도 메모리 접근 시퀀스로 수행될 수 있습니다. 자세한 내용은 ReadSharedMemory 및 WriteSharedMemory를 참조하시기 바랍니다.

참고 3

에이전트는 명세상의 메커니즘이며 ECMAScript 구현체의 특정 산출물과 대응할 필요는 없습니다.

9.6.1 AgentSignifier ( )

추상 연산 AgentSignifier. 인수 없음. 반환값: an agent signifier. 호출되면 다음 단계를 수행한다.

agentRecord를 주변 에이전트의 Agent Record로 둡니다.
agentRecord.[[Signifier]]을 반환합니다.

9.6.2 AgentCanSuspend ( )

추상 연산 AgentCanSuspend. 인수 없음. 반환값: Boolean. 호출되면 다음 단계를 수행한다.

agentRecord를 주변 에이전트의 Agent Record로 둡니다.
agentRecord.[[CanBlock]]을 반환합니다.

참고

일부 환경에서는 특정 에이전트가 일시 중단되는 것이 합리적이지 않을 수 있습니다. 예를 들어 웹 브라우저 환경에서는 문서의 주 이벤트 처리 스레드가 일시 중단되는 것은 허용하지 않으면서 worker의 이벤트 처리 스레드는 일시 중단할 수 있도록 하는 것이 합리적일 수 있습니다.

9.6.3 IncrementModuleAsyncEvaluationCount ( )

추상 연산 IncrementModuleAsyncEvaluationCount. 인수 없음. 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

agentRecord를 주변 에이전트의 Agent Record로 둡니다.
count를 agentRecord.[[ModuleAsyncEvaluationCount]]로 둡니다.
agentRecord.[[ModuleAsyncEvaluationCount]]를 count + 1로 설정합니다.
count를 반환합니다.

참고

이 값은 보류 중인 모듈 사이의 상대적인 평가 순서를 추적하는 데만 사용됩니다. 보류 중인 모듈이 없을 때 구현체는 관찰할 수 없는 방식으로 [[ModuleAsyncEvaluationCount]]를 0으로 재설정할 수 있습니다.

9.7 에이전트 클러스터

에이전트 클러스터는 공유 메모리에서 연산하여 서로 통신할 수 있는 에이전트의 극대 집합입니다.

참고 1

서로 다른 에이전트의 프로그램은 명시되지 않은 수단으로 메모리를 공유할 수 있습니다. 최소한 SharedArrayBuffer의 기반 메모리는 클러스터의 에이전트 사이에서 공유할 수 있습니다.

메시지 전달을 통해 통신할 수 있지만 메모리를 공유할 수 없는 에이전트가 있을 수 있으며, 이러한 에이전트는 절대로 같은 에이전트 클러스터에 있지 않습니다.

모든 에이전트는 정확히 하나의 에이전트 클러스터에 속합니다.

참고 2

클러스터의 모든 에이전트가 특정 시점에 동시에 생존해 있을 필요는 없습니다. 에이전트 A가 다른 에이전트 B를 생성한 뒤 A가 종료되고, B가 에이전트 C를 생성하는 경우, A가 B와 일부 메모리를 공유할 수 있고 B가 C와 일부 메모리를 공유할 수 있었다면 세 에이전트는 같은 클러스터에 있습니다.

클러스터 내의 모든 에이전트는 각자의 Agent Record에 있는 [[LittleEndian]] 필드에 대해 동일한 값을 가져야 합니다.

참고 3

에이전트 클러스터 내의 서로 다른 에이전트가 서로 다른 [[LittleEndian]] 값을 가지면 다중 바이트 데이터에 공유 메모리를 사용하기 어려워집니다.

클러스터 내의 모든 에이전트는 각자의 Agent Record에 있는 [[IsLockFree1]] 필드에 대해 동일한 값을 가져야 하며, [[IsLockFree2]] 및 [[IsLockFree8]] 필드도 마찬가지입니다.

클러스터 내의 모든 에이전트는 각자의 Agent Record에 있는 [[Signifier]] 필드에 서로 다른 값을 가져야 합니다.

임베딩은 에이전트의 인지나 협조 없이 에이전트를 비활성화(전진 진행 중지)하거나 활성화(전진 진행 재개)할 수 있습니다. 임베딩이 이를 수행하는 경우 클러스터 내 일부 에이전트는 활성 상태로 둔 채 다른 에이전트를 무기한 비활성화 상태로 두어서는 안 됩니다.

참고 4

앞의 제한은 다른 에이전트가 비활성화되었기 때문에 어떤 에이전트가 교착되거나 기아 상태에 빠지는 상황을 방지하기 위한 것입니다. 예를 들어 어떤 창의 문서와 독립적인 수명을 갖는 HTML shared worker가 그러한 독립 문서의 dedicated worker와 메모리를 공유할 수 있고, dedicated worker가 락을 보유한 상태에서 문서와 해당 dedicated worker가 비활성화된 후(예: 문서가 창의 방문 기록에 들어간 경우) shared worker가 해당 락을 획득하려고 시도한다면, shared worker는 dedicated worker가 다시 활성화될 때까지, 어쩌면 영원히, 블로킹됩니다. 그동안 다른 창에서 shared worker에 접근하려는 다른 worker는 기아 상태에 빠집니다.

이 제한의 결과로 임베딩 내부에서 동일한 suspend/wake 집합에 속하지 않는 에이전트 사이에서는 메모리를 공유할 수 없습니다.

임베딩은 에이전트 클러스터의 다른 에이전트가 사전에 알거나 협조하지 않아도 에이전트를 종료할 수 있습니다. 에이전트가 자신 또는 클러스터 내 다른 에이전트의 프로그램적 동작이 아니라 클러스터 외부의 요인으로 종료되면, 임베딩은 두 전략 중 하나를 선택해야 합니다. 클러스터의 모든 에이전트를 종료하거나, 클러스터의 에이전트가 협력하여 최소 하나의 남은 구성원이 종료를 감지할 수 있도록 신뢰할 수 있는 API를 제공해야 하며, 종료 데이터에는 종료된 에이전트를 식별하기에 충분한 정보가 포함되어야 합니다.

참고 5

이러한 종료의 예로는 운영 체제나 사용자가 별도 프로세스에서 실행 중인 에이전트를 종료하는 경우, 또는 에이전트별 리소스 계측 결과 해당 에이전트가 폭주 중임을 나타내어 임베딩 자체가 다른 에이전트와 같은 프로세스에서 실행 중인 에이전트를 종료하는 경우가 있습니다.

다음의 각 명세 값과 그 값에서 전이적으로 도달 가능한 값은 정확히 하나의 에이전트 클러스터에 속합니다.

후보 실행 Record
Shared Data Block
WaiterList Record

클러스터의 임의의 에이전트가 ECMAScript 코드를 평가하기 전에, 클러스터 내 모든 에이전트의 Agent Record에 있는 [[CandidateExecution]] 필드는 초기 후보 실행으로 설정됩니다. 초기 후보 실행은 [[EventsRecords]] 필드가 각 에이전트마다 하나씩 Agent Events Record를 포함하는 List인 빈 후보 실행입니다. 각 Agent Events Record의 [[AgentSignifier]] 필드는 해당 에이전트의 에이전트 식별자이며, [[EventList]]와 [[AgentSynchronizesWith]] 필드는 빈 List입니다.

참고 6

에이전트 클러스터의 모든 에이전트는 Agent Record의 [[CandidateExecution]] 필드에서 동일한 후보 실행을 공유합니다. 후보 실행은 메모리 모델에서 사용하는 명세 메커니즘입니다.

참고 7

에이전트 클러스터는 명세상의 메커니즘이며 ECMAScript 구현체의 특정 산출물과 대응할 필요는 없습니다.

9.8 전진 진행

에이전트가 전진 진행을 한다는 것은 이 명세에 따라 평가 단계를 수행하는 것을 의미합니다.

에이전트의 실행 중인 실행 컨텍스트가 외부 이벤트를 동기적으로 무기한 기다리게 되면 에이전트는 블로킹 상태가 됩니다. Agent Record의 [[CanBlock]] 필드가 true인 에이전트만 이러한 의미에서 블로킹될 수 있습니다. 블로킹되지 않은 에이전트는 블로킹 상태가 아닌 에이전트입니다.

구현체는 다음을 보장해야 합니다:

전용 실행 스레드를 갖는 모든 블로킹되지 않은 에이전트는 결국 전진 진행을 합니다.
하나의 실행 스레드를 공유하는 에이전트 집합에서는 하나의 에이전트가 결국 전진 진행을 합니다.
에이전트는 명시적으로 블로킹을 제공하는 API를 통하는 경우를 제외하고 다른 에이전트가 블로킹되도록 해서는 안 됩니다.

참고

이 요구 사항은 메모리 모델의 생존성 보장과 함께 모든 seq-cst 쓰기가 결국 모든 에이전트에서 관찰 가능해짐을 보장합니다.

9.9 WeakRef 및 FinalizationRegistry 대상의 처리 모델

9.9.1 목표

이 명세는 어떤 객체나 Symbol이 가비지 컬렉션될 것이라는 보장도 하지 않습니다. 생존하지 않는 객체나 Symbol도 오랜 시간이 지난 후 해제될 수도 있고, 전혀 해제되지 않을 수도 있습니다. 이러한 이유로 이 명세에서는 가비지 컬렉션에 의해 발생하는 동작을 설명할 때 “할 수 있습니다”라는 표현을 사용합니다.

WeakRef 및 FinalizationRegistry의 의미론은 특정 시점에 발생하는 두 연산을 기반으로 합니다:

WeakRef.prototype.deref가 호출되면, 참조 대상(undefined가 반환되지 않은 경우)은 이후의 동기적 접근에서도 동일한 값이 반환되도록 생존 상태로 유지됩니다. 이 목록은 ClearKeptObjects 추상 연산을 사용하여 동기 작업이 완료될 때 재설정됩니다.
FinalizationRegistry에 등록된 객체나 Symbol에 더 이상 접근할 수 없게 되면, 동기 ECMAScript 실행이 완료된 후 FinalizationRegistry의 정리 콜백이 결국 호출될 수 있습니다. FinalizationRegistry 정리는 CleanupFinalizationRegistry 추상 연산으로 수행됩니다.

이 두 동작(ClearKeptObjects 또는 CleanupFinalizationRegistry)은 모두 동기 ECMAScript 실행을 중단시켜서는 안 됩니다. 호스트가 더 긴 동기 ECMAScript 실행 구간을 구성할 수 있으므로 이 명세에서는 ClearKeptObjects 및 CleanupFinalizationRegistry의 예약을 호스트 환경에 위임합니다.

일부 ECMAScript 구현체에는 ECMAScript가 유휴 상태일 때를 포함하여 백그라운드에서 실행되는 가비지 컬렉터 구현이 있습니다. 호스트 환경이 CleanupFinalizationRegistry를 예약할 수 있게 하면 finalizer 작업을 실행하기 위해 ECMAScript 실행을 재개하고, 보유 중인 값을 해제하여 전체 메모리 사용량을 줄일 수 있습니다.

9.9.2 생존성

객체 및/또는 Symbol의 어떤 집합 objSet에 대해 objSet에 대한 가상의 WeakRef 비인식 실행은, 참조 대상이 objSet의 요소인 WeakRef에 대해 추상 연산 WeakRefDeref가 항상 undefined를 반환하는 실행입니다.

참고 1

WeakRef 비인식성과 생존성은 함께 두 가지 개념을 포착합니다. 첫째, WeakRef 자체는 참조 대상을 생존 상태로 유지하지 않습니다. 둘째, 생존성의 순환이 값이 생존 상태임을 의미하지는 않습니다. 구체적으로 v의 생존성 결정이 WeakRef 참조 대상 r의 생존성 결정에 의존하는 경우, r의 생존성은 v의 생존성을 가정할 수 없습니다. 그렇게 하면 순환 추론이 됩니다.

참고 2

WeakRef 비인식성은 순환을 고려하기 위해 개별 값이 아니라 객체 또는 Symbol의 집합에 대해 정의됩니다. 개별 값에 대해 정의하면 순환 안의 WeakRef 참조 대상은 그 동일성이 순환 내 다른 WeakRef 참조 대상을 통해서만 관찰되더라도 생존 상태로 간주됩니다.

참고 3

비공식적으로 개별 객체 또는 Symbol을 포함하는 모든 집합이 생존 상태이면 해당 객체 또는 Symbol도 생존 상태라고 합니다.

평가 중 어느 시점이든 객체 및/또는 Symbol의 집합 objSet은 다음 조건 중 하나라도 충족하면 생존 상태로 간주합니다:

objSet의 어떤 요소가 임의의 에이전트의 [[KeptAlive]] List에 포함되어 있습니다.
objSet에 대해, objSet의 값 중 하나의 동일성을 관찰하는 유효한 미래의 가상 WeakRef 비인식 실행이 존재합니다.

참고 4

위의 두 번째 조건은 값의 동일성을 WeakRef가 아닌 수단으로 관찰할 수 있으면 해당 값이 생존 상태라는 직관을 포착하려는 것입니다. 값의 동일성은 엄격 동등성 비교 결과를 관찰하거나 해당 값이 Map의 키로 사용되는 것을 관찰하여 확인할 수 있습니다.

참고 5

객체 또는 Symbol이 필드, 내부 슬롯 또는 프로퍼티에 존재한다고 해서 해당 값이 생존 상태임을 의미하지는 않습니다. 예를 들어 문제의 값이 프로그램에 다시 전달되지 않는다면 관찰할 수 없습니다.

이는 WeakMap의 키, WeakSet의 구성원, 그리고 FinalizationRegistry Cell Record의 [[WeakRefTarget]] 및 [[UnregisterToken]] 필드에 해당합니다.

위 정의에 따르면 WeakMap의 키가 생존 상태가 아니라면 이에 대응하는 값도 반드시 생존 상태라고 할 수는 없습니다.

참고 6

생존성은 엔진이 어떤 WeakRef를 비워서는 안 되는지를 보장하기 위한 하한입니다. 여기에서 정의한 생존성은 결정 불가능합니다. 실제로 엔진은 도달 가능성과 같은 보수적인 근사를 사용합니다. 구현에는 상당한 재량이 있을 것으로 예상됩니다.

9.9.3 실행

어느 시점이든 객체 및/또는 Symbol의 집합 objSet이 생존 상태가 아니면 ECMAScript 구현체는 다음 단계를 원자적으로 수행할 수 있습니다:

objSet의 각 요소 value에 대해 다음을 수행합니다.
1. ref.[[WeakRefTarget]]이 value인 각 WeakRef ref에 대해 다음을 수행합니다.
  1. ref.[[WeakRefTarget]]을 empty로 설정합니다.
2. finalizationRegistry.[[Cells]]가 cell.[[WeakRefTarget]]이 value인 Record cell을 포함하는 각 FinalizationRegistry finalizationRegistry에 대해 다음을 수행합니다.
  1. cell.[[WeakRefTarget]]을 empty로 설정합니다.
  2. enqueueCleanup을 true 또는 false 중 하나를 선택하는 구현체 정의 선택으로 둡니다.
  3. enqueueCleanup이 true이면, HostEnqueueFinalizationRegistryCleanupJob(finalizationRegistry)을 수행합니다.
3. map.[[WeakMapData]]가 entry.[[Key]]가 value인 Record entry를 포함하는 각 WeakMap map에 대해 다음을 수행합니다.
  1. entry.[[Key]]를 empty로 설정합니다.
  2. entry.[[Value]]를 empty로 설정합니다.
4. set.[[WeakSetData]]가 value를 포함하는 각 WeakSet set에 대해 다음을 수행합니다.
  1. set.[[WeakSetData]]에서 값이 value인 요소를 값이 empty인 요소로 교체합니다.

참고 1

생존성의 정의와 함께 이 절은 구현체가 WeakRef에 적용할 수 있는 최적화를 규정합니다.

객체의 동일성을 관찰하지 않고도 객체에 접근할 수 있습니다. 동일성이 관찰되지 않는 탈출하지 않는 객체의 프로퍼티에 대해 죽은 변수 제거 및 스칼라 대체와 같은 최적화가 허용됩니다. 따라서 이러한 최적화로 해당 객체를 가리키는 WeakRef가 관찰 가능하게 비워지는 것도 허용됩니다.

반면 객체의 동일성을 관찰할 수 있고 해당 객체가 WeakRef의 [[WeakRefTarget]] 내부 슬롯에 있으면, WeakRef를 관찰 가능하게 비우는 재구체화와 같은 최적화는 금지됩니다.

HostEnqueueFinalizationRegistryCleanupJob 호출은 선택 사항이므로 FinalizationRegistry에 등록된 객체가 반드시 해당 FinalizationRegistry를 생존 상태로 유지하는 것은 아닙니다. 구현체는 어떤 이유로든 FinalizationRegistry 콜백을 생략할 수 있습니다. 예를 들어 FinalizationRegistry 자체가 생존 상태가 아니게 되거나 애플리케이션이 종료 중인 경우가 있습니다.

참고 2

구현체는 생존 상태가 아닌 객체 또는 Symbol의 최대 집합에 대해 WeakRef를 비울 의무가 없습니다.

구현체가 WeakRef를 비울 생존하지 않는 집합 objSet을 선택하면, 이 정의에 따라 objSet의 모든 값에 대한 WeakRef를 동시에 비워야 합니다. 다시 말해, 구현체가 값 v를 가리키는 WeakRef를 비우면서, 비우지 않을 경우 v의 값을 관찰하는 실행이 가능해지는 다른 WeakRef를 비우지 않는 것은 적합하지 않습니다.

9.9.4 호스트 훅

9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( `finalizationRegistry` )

호스트 정의 추상 연산 HostEnqueueFinalizationRegistryCleanupJob. 인수 finalizationRegistry (FinalizationRegistry). 반환값: unused.

cleanupJob을 매개변수가 없고 finalizationRegistry를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Job Abstract Closure로 둡니다:

cleanupResult를 Completion(CleanupFinalizationRegistry(finalizationRegistry))으로 둡니다.
cleanupResult가 비정상 완료이면 오류 보고를 위한 호스트 정의 단계를 수행합니다.
unused를 반환합니다.

HostEnqueueFinalizationRegistryCleanupJob의 구현은 가능하면 미래의 어느 시점에 수행되도록 cleanupJob을 예약합니다. 또한 9.5의 요구 사항도 준수해야 합니다.

9.10 ClearKeptObjects ( )

추상 연산 ClearKeptObjects. 인수 없음. 반환값: unused. ECMAScript 구현체는 동기 ECMAScript 실행 시퀀스가 완료될 때 ClearKeptObjects를 호출하는 것이 기대됩니다. 호출되면 다음 단계를 수행한다.

agentRecord를 주변 에이전트의 Agent Record로 둡니다.
agentRecord.[[KeptAlive]]를 새로운 빈 List로 설정합니다.
unused를 반환합니다.

9.11 AddToKeptObjects ( `value` )

추상 연산 AddToKeptObjects. 인수 value ((Object 또는 Symbol)). 반환값: unused. 호출되면 다음 단계를 수행한다.

agentRecord를 주변 에이전트의 Agent Record로 둡니다.
value를 agentRecord.[[KeptAlive]]에 추가합니다.
unused를 반환합니다.

참고

추상 연산 AddToKeptObjects가 대상 객체 또는 Symbol을 인수로 호출되면 ClearKeptObjects가 호출될 때까지 대상을 강하게 참조하는 목록에 해당 대상을 추가합니다.

9.12 CleanupFinalizationRegistry ( `finalizationRegistry` )

추상 연산 CleanupFinalizationRegistry. 인수 finalizationRegistry (FinalizationRegistry). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: finalizationRegistry에는 [[Cells]] 및 [[CleanupCallback]] 내부 슬롯이 있습니다.
callback을 finalizationRegistry.[[CleanupCallback]]으로 둡니다.
finalizationRegistry.[[Cells]]가 cell.[[WeakRefTarget]]이 empty인 Record cell을 포함하는 동안, 구현체는 다음 단계를 수행할 수 있습니다:
1. 그러한 cell 중 하나를 선택합니다.
2. finalizationRegistry.[[Cells]]에서 cell을 제거합니다.
3. ? HostCallJobCallback(callback, undefined, « cell.[[HeldValue]] »)을 수행합니다.
unused를 반환합니다.

9.13 CanBeHeldWeakly ( `arg` )

추상 연산 CanBeHeldWeakly. 인수 arg (ECMAScript 언어 값). 반환값: Boolean. arg가 약한 참조로 사용하기에 적합한 경우에만 true를 반환합니다. 약한 참조로 사용하기에 적합한 값만 WeakMap의 키, WeakSet의 요소, WeakRef의 대상 또는 FinalizationRegistry의 대상 중 하나가 될 수 있습니다. 호출되면 다음 단계를 수행한다.

arg가 Object이면, true를 반환합니다.
arg가 Symbol이고 KeyForSymbol(arg)이 undefined이면, true를 반환합니다.
false를 반환합니다.

참고

언어 동일성이 없는 언어 값은 사전 참조 없이 만들어질 수 있으므로 약한 참조로 사용하기에 적합하지 않습니다. Symbol.for가 생성한 Symbol 값은 다른 Symbol 값과 달리 언어 동일성이 없으므로 약한 참조로 사용하기에 적합하지 않습니다. 잘 알려진 Symbol은 가비지 컬렉션되지 않을 가능성이 높지만, 수가 제한되어 있어 다양한 구현 방식으로 관리할 수 있으므로 약한 참조로 사용하기에 적합한 것으로 취급됩니다. 그러나 생존 상태인 WeakMap에서 잘 알려진 Symbol에 연결된 모든 값은 가비지 컬렉션되지 않을 가능성이 높아 구현체에서 메모리 리소스를 “누수”할 수 있습니다.

10 일반 객체와 특수 객체의 동작

10.1 일반 객체 내부 메서드와 내부 슬롯

모든 일반 객체에는 [[Prototype]]이라는 내부 슬롯이 있습니다. 이 내부 슬롯의 값은 null 또는 객체이며 상속을 구현하는 데 사용됩니다. propertyKey라는 이름의 프로퍼티가 일반 객체 obj에는 없지만 해당 [[Prototype]] 객체에는 존재한다고 가정합니다. propertyKey가 [[Prototype]] 객체의 데이터 프로퍼티를 참조하면 obj는 get 접근을 위해 이를 상속하며, propertyKey가 obj의 프로퍼티인 것처럼 동작합니다. propertyKey가 [[Prototype]] 객체의 쓰기 가능한 데이터 프로퍼티를 참조하면 obj에서 propertyKey에 대한 set 접근은 obj에 propertyKey라는 이름의 새로운 데이터 프로퍼티를 생성합니다. propertyKey가 [[Prototype]] 객체의 쓰기 불가능한 데이터 프로퍼티를 참조하면 obj에서 propertyKey에 대한 set 접근은 실패합니다. propertyKey가 [[Prototype]] 객체의 접근자 프로퍼티를 참조하면 해당 접근자는 get 접근과 set 접근 모두에 대해 obj에 상속됩니다.

모든 일반 객체에는 Boolean 값을 갖는 [[Extensible]] 내부 슬롯이 있으며, 이는 6.1.7.3에 명시된 확장 가능성과 관련된 내부 메서드 불변 조건을 충족하는 데 사용됩니다. 즉, 객체의 [[Extensible]] 내부 슬롯 값이 false로 설정되고 나면 더 이상 객체에 프로퍼티를 추가하거나, 객체의 [[Prototype]] 내부 슬롯 값을 수정하거나, 이후 [[Extensible]] 값을 true로 변경할 수 없습니다.

다음 알고리즘 설명에서는 obj가 일반 객체이고, propertyKey가 프로퍼티 키 값이며, value가 임의의 ECMAScript 언어 값이고, propertyDesc가 Property Descriptor Record라고 가정합니다.

각 일반 객체 내부 메서드는 이름이 유사한 추상 연산에 위임합니다. 그러한 추상 연산이 다른 내부 메서드에 의존하면 이름이 유사한 추상 연산을 직접 호출하는 대신 obj에서 내부 메서드를 호출합니다. 이러한 의미론은 일반 객체 내부 메서드가 특수 객체에 적용될 때 해당 특수 객체에서 재정의된 내부 메서드가 호출되도록 보장합니다.

10.1.1 `[[GetPrototypeOf]]` ( )

an ordinary object obj의 내부 메서드 [[GetPrototypeOf]]. 인수 없음. 반환값: 정상 완료 (값: (Object 또는 null)). 호출되면 다음 단계를 수행한다.

OrdinaryGetPrototypeOf(obj)를 반환합니다.

10.1.1.1 OrdinaryGetPrototypeOf ( `obj` )

추상 연산 OrdinaryGetPrototypeOf. 인수 obj (Object). 반환값: (Object 또는 null). 호출되면 다음 단계를 수행한다.

obj.[[Prototype]]을 반환합니다.

10.1.2 `[[SetPrototypeOf]]` ( `proto` )

an ordinary object obj의 내부 메서드 [[SetPrototypeOf]]. 인수 proto ((Object 또는 null)). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

OrdinarySetPrototypeOf(obj, proto)를 반환합니다.

10.1.2.1 OrdinarySetPrototypeOf ( `obj`, `proto` )

추상 연산 OrdinarySetPrototypeOf. 인수 obj (Object) 및 proto ((Object 또는 null)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

current를 obj.[[Prototype]]으로 둡니다.
SameValue(proto, current)가 true이면, true를 반환합니다.
extensible을 obj.[[Extensible]]로 둡니다.
extensible이 false이면, false를 반환합니다.
cursor를 proto로 둡니다.
done을 false로 둡니다.
done이 false인 동안 다음을 반복합니다.
1. cursor가 null이면, 다음을 수행합니다.
  1. done을 true로 설정합니다.
2. 그렇지 않고 SameValue(cursor, obj)가 true이면, 다음을 수행합니다.
  1. false를 반환합니다.
3. 그렇지 않으면,
  1. cursor.[[GetPrototypeOf]]가 10.1.1에 정의된 일반 객체 내부 메서드가 아니면 done을 true로 설정합니다.
  2. 그렇지 않으면 cursor를 cursor.[[Prototype]]으로 설정합니다.
obj.[[Prototype]]을 proto로 설정합니다.
true를 반환합니다.

참고

7 단계의 반복은 [[GetPrototypeOf]] 및 [[SetPrototypeOf]]에 일반 객체 정의만 사용하는 객체로 이루어진 모든 프로토타입 체인에 순환이 생기지 않도록 보장합니다.

10.1.3 `[[IsExtensible]]` ( )

an ordinary object obj의 내부 메서드 [[IsExtensible]]. 인수 없음. 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

OrdinaryIsExtensible(obj)를 반환합니다.

10.1.3.1 OrdinaryIsExtensible ( `obj` )

추상 연산 OrdinaryIsExtensible. 인수 obj (Object). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

obj.[[Extensible]]을 반환합니다.

10.1.4 `[[PreventExtensions]]` ( )

an ordinary object obj의 내부 메서드 [[PreventExtensions]]. 인수 없음. 반환값: 정상 완료 (값: true). 호출되면 다음 단계를 수행한다.

OrdinaryPreventExtensions(obj)를 반환합니다.

10.1.4.1 OrdinaryPreventExtensions ( `obj` )

추상 연산 OrdinaryPreventExtensions. 인수 obj (Object). 반환값: true. 호출되면 다음 단계를 수행한다.

obj.[[Extensible]]을 false로 설정합니다.
true를 반환합니다.

10.1.5 `[[GetOwnProperty]]` ( `propertyKey` )

an ordinary object obj의 내부 메서드 [[GetOwnProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: (프로퍼티 서술자 또는 undefined)). 호출되면 다음 단계를 수행한다.

OrdinaryGetOwnProperty(obj, propertyKey)를 반환합니다.

10.1.5.1 OrdinaryGetOwnProperty ( `obj`, `propertyKey` )

추상 연산 OrdinaryGetOwnProperty. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: (프로퍼티 서술자 또는 undefined). 호출되면 다음 단계를 수행한다.

obj에 키가 propertyKey인 자체 프로퍼티가 없으면, undefined를 반환합니다.
propertyDesc를 필드가 없는 새로 생성된 Property Descriptor로 둡니다.
ownProperty를 키가 propertyKey인 obj의 자체 프로퍼티로 둡니다.
ownProperty가 데이터 프로퍼티이면, 다음을 수행합니다.
1. propertyDesc.[[Value]]를 ownProperty의 [[Value]] 속성 값으로 설정합니다.
2. propertyDesc.[[Writable]]을 ownProperty의 [[Writable]] 속성 값으로 설정합니다.
그렇지 않으면,
1. 단언: ownProperty는 접근자 프로퍼티입니다.
2. propertyDesc.[[Getter]]를 ownProperty의 [[Getter]] 속성 값으로 설정합니다.
3. propertyDesc.[[Setter]]를 ownProperty의 [[Setter]] 속성 값으로 설정합니다.
propertyDesc.[[Enumerable]]을 ownProperty의 [[Enumerable]] 속성 값으로 설정합니다.
propertyDesc.[[Configurable]]을 ownProperty의 [[Configurable]] 속성 값으로 설정합니다.
propertyDesc를 반환합니다.

10.1.6 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

an ordinary object obj의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? OrdinaryDefineOwnProperty(obj, propertyKey, propertyDesc)를 반환합니다.

10.1.6.1 OrdinaryDefineOwnProperty ( `obj`, `propertyKey`, `propertyDesc` )

추상 연산 OrdinaryDefineOwnProperty. 인수 obj (Object), propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

current를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
extensible을 ? IsExtensible(obj)로 둡니다.
ValidateAndApplyPropertyDescriptor(obj, propertyKey, extensible, propertyDesc, current)를 반환합니다.

10.1.6.2 IsCompatiblePropertyDescriptor ( `extensible`, `propertyDesc`, `current` )

추상 연산 IsCompatiblePropertyDescriptor. 인수 extensible (Boolean), propertyDesc (프로퍼티 서술자) 및 current ((프로퍼티 서술자 또는 undefined)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

ValidateAndApplyPropertyDescriptor(undefined, "", extensible, propertyDesc, current)를 반환합니다.

10.1.6.3 ValidateAndApplyPropertyDescriptor ( `obj`, `propertyKey`, `extensible`, `propertyDesc`, `current` )

추상 연산 ValidateAndApplyPropertyDescriptor. 인수 obj ((Object 또는 undefined)), propertyKey (프로퍼티 키), extensible (Boolean), propertyDesc (프로퍼티 서술자) 및 current ((프로퍼티 서술자 또는 undefined)). 반환값: Boolean. 지정된 extensibility와 현재 프로퍼티 current를 갖는 객체의 프로퍼티로 propertyDesc를 적용하면서 불변 조건을 유지할 수 있는 경우에만 true를 반환합니다. 이러한 적용이 가능하고 obj가 undefined가 아니면 propertyKey라는 이름의 프로퍼티에 적용하며, 필요한 경우 해당 프로퍼티를 생성합니다. 호출되면 다음 단계를 수행한다.

단언: propertyKey는 프로퍼티 키입니다.
current가 undefined이면, 다음을 수행합니다.
1. extensible이 false이면, false를 반환합니다.
2. obj가 undefined이면, true를 반환합니다.
3. IsAccessorDescriptor(propertyDesc)가 true이면, 다음을 수행합니다.
  1. 객체 obj에 propertyKey라는 이름의 자체 접근자 프로퍼티를 생성합니다. 해당 프로퍼티의 [[Getter]], [[Setter]], [[Enumerable]] 및 [[Configurable]] 속성은 propertyDesc에 대응하는 필드가 있으면 해당 필드 값으로 설정하고, 그렇지 않으면 해당 속성의 기본값으로 설정합니다.
4. 그렇지 않으면,
  1. 객체 obj에 propertyKey라는 이름의 자체 데이터 프로퍼티를 생성합니다. 해당 프로퍼티의 [[Value]], [[Writable]], [[Enumerable]] 및 [[Configurable]] 속성은 propertyDesc에 대응하는 필드가 있으면 해당 필드 값으로 설정하고, 그렇지 않으면 해당 속성의 기본값으로 설정합니다.
5. true를 반환합니다.
단언: current는 모든 필드가 채워진 Property Descriptor입니다.
propertyDesc에 필드가 하나도 없으면, true를 반환합니다.
current.[[Configurable]]이 false이면, 다음을 수행합니다.
1. propertyDesc에 [[Configurable]] 필드가 있고 propertyDesc.[[Configurable]]이 true이면, false를 반환합니다.
2. propertyDesc에 [[Enumerable]] 필드가 있고 propertyDesc.[[Enumerable]]이 current.[[Enumerable]]과 다르면, false를 반환합니다.
3. IsGenericDescriptor(propertyDesc)가 false이고 IsAccessorDescriptor(propertyDesc)가 IsAccessorDescriptor(current)와 다르면, false를 반환합니다.
4. IsAccessorDescriptor(current)가 true이면, 다음을 수행합니다.
  1. propertyDesc에 [[Getter]] 필드가 있고 SameValue(propertyDesc.[[Getter]], current.[[Getter]])가 false이면, false를 반환합니다.
  2. propertyDesc에 [[Setter]] 필드가 있고 SameValue(propertyDesc.[[Setter]], current.[[Setter]])가 false이면, false를 반환합니다.
5. 그렇지 않고 current.[[Writable]]이 false이면, 다음을 수행합니다.
  1. propertyDesc에 [[Writable]] 필드가 있고 propertyDesc.[[Writable]]이 true이면, false를 반환합니다.
  2. 참고: SameValue는 다른 방법으로 구별될 수 있는 NaN 값에 대해 true를 반환합니다. 여기에서 반환하면 obj의 기존 프로퍼티가 수정되지 않도록 보장합니다.
  3. propertyDesc에 [[Value]] 필드가 있으면, SameValue(propertyDesc.[[Value]], current.[[Value]])를 반환합니다.
obj가 undefined가 아니면, 다음을 수행합니다.
1. IsDataDescriptor(current)가 true이고 IsAccessorDescriptor(propertyDesc)가 true이면, 다음을 수행합니다.
  1. propertyDesc에 [[Configurable]] 필드가 있으면 configurable을 propertyDesc.[[Configurable]]로 둡니다. 그렇지 않으면 configurable을 current.[[Configurable]]로 둡니다.
  2. propertyDesc에 [[Enumerable]] 필드가 있으면 enumerable을 propertyDesc.[[Enumerable]]로 둡니다. 그렇지 않으면 enumerable을 current.[[Enumerable]]로 둡니다.
  3. 객체 obj에서 propertyKey라는 이름의 프로퍼티를 접근자 프로퍼티로 교체합니다. 해당 프로퍼티의 [[Configurable]] 및 [[Enumerable]] 속성은 각각 configurable 및 enumerable로 설정하고, [[Getter]] 및 [[Setter]] 속성은 propertyDesc에 대응하는 필드가 있으면 해당 필드 값으로 설정하며, 그렇지 않으면 해당 속성의 기본값으로 설정합니다.
2. 그렇지 않고 IsAccessorDescriptor(current)가 true이고 IsDataDescriptor(propertyDesc)가 true이면, 다음을 수행합니다.
  1. propertyDesc에 [[Configurable]] 필드가 있으면 configurable을 propertyDesc.[[Configurable]]로 둡니다. 그렇지 않으면 configurable을 current.[[Configurable]]로 둡니다.
  2. propertyDesc에 [[Enumerable]] 필드가 있으면 enumerable을 propertyDesc.[[Enumerable]]로 둡니다. 그렇지 않으면 enumerable을 current.[[Enumerable]]로 둡니다.
  3. 객체 obj에서 propertyKey라는 이름의 프로퍼티를 데이터 프로퍼티로 교체합니다. 해당 프로퍼티의 [[Configurable]] 및 [[Enumerable]] 속성은 각각 configurable 및 enumerable로 설정하고, [[Value]] 및 [[Writable]] 속성은 propertyDesc에 대응하는 필드가 있으면 해당 필드 값으로 설정하며, 그렇지 않으면 해당 속성의 기본값으로 설정합니다.
3. 그렇지 않으면,
  1. propertyDesc의 각 필드 이름 fieldName에 대해 객체 obj에서 propertyKey라는 이름의 프로퍼티에 있는 fieldName이라는 이름의 속성을 propertyDesc의 fieldName 필드 값으로 설정합니다.
true를 반환합니다.

10.1.7 `[[HasProperty]]` ( `propertyKey` )

an ordinary object obj의 내부 메서드 [[HasProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? OrdinaryHasProperty(obj, propertyKey)를 반환합니다.

10.1.7.1 OrdinaryHasProperty ( `obj`, `propertyKey` )

추상 연산 OrdinaryHasProperty. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

hasOwn을 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
hasOwn이 undefined가 아니면, true를 반환합니다.
parent를 ? obj.[[GetPrototypeOf]]()로 둡니다.
parent가 null이 아니면, 다음을 수행합니다.
1. ? parent.[[HasProperty]](propertyKey)를 반환합니다.
false를 반환합니다.

10.1.8 `[[Get]]` ( `propertyKey`, `receiver` )

an ordinary object obj의 내부 메서드 [[Get]]. 인수 propertyKey (프로퍼티 키) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? OrdinaryGet(obj, propertyKey, receiver)를 반환합니다.

10.1.8.1 OrdinaryGet ( `obj`, `propertyKey`, `receiver` )

추상 연산 OrdinaryGet. 인수 obj (Object), propertyKey (프로퍼티 키) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
propertyDesc가 undefined이면, 다음을 수행합니다.
1. parent를 ? obj.[[GetPrototypeOf]]()로 둡니다.
2. parent가 null이면, undefined를 반환합니다.
3. ? parent.[[Get]](propertyKey, receiver)를 반환합니다.
IsDataDescriptor(propertyDesc)가 true이면, propertyDesc.[[Value]]를 반환합니다.
단언: IsAccessorDescriptor(propertyDesc)는 true입니다.
getter를 propertyDesc.[[Getter]]로 둡니다.
getter가 undefined이면, undefined를 반환합니다.
? Call(getter, receiver)를 반환합니다.

10.1.9 `[[Set]]` ( `propertyKey`, `value`, `receiver` )

an ordinary object obj의 내부 메서드 [[Set]]. 인수 propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? OrdinarySet(obj, propertyKey, value, receiver)를 반환합니다.

10.1.9.1 OrdinarySet ( `obj`, `propertyKey`, `value`, `receiver` )

추상 연산 OrdinarySet. 인수 obj (Object), propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

ownDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
? OrdinarySetWithOwnDescriptor(obj, propertyKey, value, receiver, ownDesc)를 반환합니다.

10.1.9.2 OrdinarySetWithOwnDescriptor ( `obj`, `propertyKey`, `value`, `receiver`, `ownDesc` )

추상 연산 OrdinarySetWithOwnDescriptor. 인수 obj (Object), propertyKey (프로퍼티 키), value (ECMAScript 언어 값), receiver (ECMAScript 언어 값) 및 ownDesc ((프로퍼티 서술자 또는 undefined)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

ownDesc가 undefined이면, 다음을 수행합니다.
1. parent를 ? obj.[[GetPrototypeOf]]()로 둡니다.
2. parent가 null이 아니면, ? parent.[[Set]](propertyKey, value, receiver)를 반환합니다.
3. ownDesc를 PropertyDescriptor { [[Value]]: undefined, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true }로 설정합니다.
IsDataDescriptor(ownDesc)가 true이면, 다음을 수행합니다.
1. ownDesc.[[Writable]]이 false이면, false를 반환합니다.
2. receiver가 Object가 아니면, false를 반환합니다.
3. existingDesc를 ? receiver.[[GetOwnProperty]](propertyKey)로 둡니다.
4. existingDesc가 undefined이면, 다음을 수행합니다.
  1. 단언: receiver에는 현재 프로퍼티 propertyKey가 없습니다.
  2. ? CreateDataProperty(receiver, propertyKey, value)를 반환합니다.
5. IsAccessorDescriptor(existingDesc)가 true이면, false를 반환합니다.
6. existingDesc.[[Writable]]이 false이면, false를 반환합니다.
7. valueDesc를 PropertyDescriptor { [[Value]]: value }로 둡니다.
8. ? receiver.[[DefineOwnProperty]](propertyKey, valueDesc)를 반환합니다.
단언: IsAccessorDescriptor(ownDesc)는 true입니다.
setter를 ownDesc.[[Setter]]로 둡니다.
setter가 undefined이면, false를 반환합니다.
? Call(setter, receiver, « value »)를 수행합니다.
true를 반환합니다.

10.1.10 `[[Delete]]` ( `propertyKey` )

an ordinary object obj의 내부 메서드 [[Delete]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? OrdinaryDelete(obj, propertyKey)를 반환합니다.

10.1.10.1 OrdinaryDelete ( `obj`, `propertyKey` )

추상 연산 OrdinaryDelete. 인수 obj (Object) 및 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
propertyDesc가 undefined이면, true를 반환합니다.
propertyDesc.[[Configurable]]이 true이면, 다음을 수행합니다.
1. obj에서 이름이 propertyKey인 자체 프로퍼티를 제거합니다.
2. true를 반환합니다.
false를 반환합니다.

10.1.11 `[[OwnPropertyKeys]]` ( )

an ordinary object obj의 내부 메서드 [[OwnPropertyKeys]]. 인수 없음. 반환값: 정상 완료 (값: 리스트 (요소: 프로퍼티 키)). 호출되면 다음 단계를 수행한다.

OrdinaryOwnPropertyKeys(obj)를 반환합니다.

10.1.11.1 OrdinaryOwnPropertyKeys ( `obj` )

추상 연산 OrdinaryOwnPropertyKeys. 인수 obj (Object). 반환값: 리스트 (요소: 프로퍼티 키). 호출되면 다음 단계를 수행한다.

keys를 새로운 빈 List로 둡니다.
배열 인덱스인 obj의 각 자체 프로퍼티 키 propertyKey에 대해 숫자 인덱스 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
String이고 배열 인덱스가 아닌 obj의 각 자체 프로퍼티 키 propertyKey에 대해 프로퍼티 생성 시간 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
Symbol인 obj의 각 자체 프로퍼티 키 propertyKey에 대해 프로퍼티 생성 시간 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
keys를 반환합니다.

10.1.12 OrdinaryObjectCreate ( `proto` [ , `additionalInternalSlotsList` ] )

추상 연산 OrdinaryObjectCreate. 인수 proto ((Object 또는 null)) 및 선택적 인수 additionalInternalSlotsList (리스트 (요소: 내부 슬롯 이름)). 반환값: Object. 새로운 일반 객체의 런타임 생성을 명시하는 데 사용됩니다. additionalInternalSlotsList에는 [[Prototype]] 및 [[Extensible]] 외에 객체의 일부로 정의해야 하는 추가 내부 슬롯의 이름이 포함됩니다. additionalInternalSlotsList가 제공되지 않으면 새로운 빈 List를 사용합니다. 호출되면 다음 단계를 수행한다.

internalSlotsList를 « [[Prototype]], [[Extensible]] »로 둡니다.
additionalInternalSlotsList가 존재하면 internalSlotsList를 internalSlotsList와 additionalInternalSlotsList의 목록 연결로 설정합니다.
obj를 MakeBasicObject(internalSlotsList)로 둡니다.
obj.[[Prototype]]을 proto로 설정합니다.
obj를 반환합니다.

참고

OrdinaryObjectCreate는 MakeBasicObject를 호출하는 것 이상을 거의 수행하지 않지만, 이를 사용하면 특수 객체가 아니라 일반 객체를 생성하려는 의도가 전달됩니다. 따라서 이 명세에서는 이후 객체의 내부 메서드를 결과가 일반 객체가 아니게 되는 방식으로 수정하는 알고리즘에서 이를 호출하지 않습니다. 특수 객체를 생성하는 연산은 MakeBasicObject를 직접 호출합니다.

10.1.13 OrdinaryCreateFromConstructor ( `ctor`, `intrinsicDefaultProto` [ , `internalSlotsList` ] )

추상 연산 OrdinaryCreateFromConstructor. 인수 ctor (함수 객체) 및 intrinsicDefaultProto (String) 및 선택적 인수 internalSlotsList (리스트 (요소: 내부 슬롯 이름)). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 생성자의 "prototype" 속성이 존재하면 해당 속성에서 [[Prototype]] 값을 가져오고, 그렇지 않으면 생성자의 영역에서 intrinsicDefaultProto로 지정된 내장 객체를 [[Prototype]] 값으로 사용하는 일반 객체를 생성합니다. internalSlotsList에는 해당 객체의 일부로 정의해야 하는 추가 내부 슬롯의 이름이 포함됩니다. 호출되면 다음 단계를 수행한다.

단언: intrinsicDefaultProto는 이 명세에서 내재 객체에 사용하는 이름입니다. 대응하는 객체는 객체의 [[Prototype]] 값으로 사용하도록 의도된 내재 객체여야 합니다.
proto를 ? GetPrototypeFromConstructor(ctor, intrinsicDefaultProto)로 둡니다.
internalSlotsList가 존재하면 slots를 internalSlotsList로 둡니다.
그렇지 않으면 slots를 새로운 빈 List로 둡니다.
OrdinaryObjectCreate(proto, slots)를 반환합니다.

10.1.14 GetPrototypeFromConstructor ( `ctor`, `intrinsicDefaultProto` )

추상 연산 GetPrototypeFromConstructor. 인수 ctor (함수 객체) 및 intrinsicDefaultProto (String). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 특정 생성자를 사용하여 생성된 객체에 사용해야 하는 [[Prototype]] 값을 결정합니다. 생성자의 "prototype" 속성이 존재하면 해당 속성에서 값을 가져옵니다. 그렇지 않으면 생성자의 영역에서 intrinsicDefaultProto로 지정된 내장 객체를 사용합니다. 호출되면 다음 단계를 수행한다.

단언: intrinsicDefaultProto는 이 명세에서 정의한 내장 객체의 이름입니다. 해당 객체는 객체의 [[Prototype]] 값으로 사용하도록 의도된 내장 객체여야 합니다.
proto를 ? Get(ctor, "prototype")으로 설정합니다.
proto가 Object이면 proto를 반환합니다.
참고: ctor의 영역에서 가져온 대체 값은 현재 실행 중인 실행 컨텍스트와 무관합니다.
realm을 ? GetFunctionRealm(ctor)으로 설정합니다.
realm.[[Intrinsics]]에서 intrinsicDefaultProto로 식별되는 필드의 값을 반환합니다.

10.1.15 RequireInternalSlot ( `obj`, `internalSlot` )

추상 연산 RequireInternalSlot. 인수 obj (ECMAScript 언어 값) 및 internalSlot (내부 슬롯 이름). 반환값: (정상 완료 (값: unused) 또는 throw 완료). obj가 Object이고 주어진 내부 슬롯을 갖는 경우가 아니면 예외를 던집니다. 호출되면 다음 단계를 수행한다.

obj가 Object가 아니면, TypeError 예외를 던집니다.
obj에 internalSlot 내부 슬롯이 없으면, TypeError 예외를 던집니다.
unused를 반환합니다.

10.2 ECMAScript 함수 객체

ECMAScript 함수 객체는 렉시컬 환경을 클로저로 캡처한 매개변수화된 ECMAScript 코드를 캡슐화하고 해당 코드의 동적 평가를 지원합니다. ECMAScript 함수 객체는 일반 객체이며 다른 일반 객체와 동일한 내부 슬롯과 내부 메서드를 갖습니다. ECMAScript 함수 객체의 코드는 엄격 모드 코드(11.2.2)이거나 비엄격 코드일 수 있습니다. 코드가 엄격 모드 코드인 ECMAScript 함수 객체를 엄격 함수라고 합니다. 코드가 엄격 모드 코드가 아닌 함수 객체를 비엄격 함수라고 합니다.

[[Extensible]] 및 [[Prototype]] 외에도 ECMAScript 함수 객체에는 표 26에 나열된 내부 슬롯이 있습니다.

표 26: ECMAScript 함수 객체의 내부 슬롯

내부 슬롯	타입	설명
`[[Environment]]`	Environment Record	함수가 클로저로 캡처한 Environment Record입니다. 함수 코드를 평가할 때 바깥쪽 환경으로 사용됩니다.
`[[PrivateEnvironment]]`	PrivateEnvironment Record 또는 null	함수가 클로저로 캡처한 Private Name에 대한 PrivateEnvironment Record입니다. 이 함수가 구문상 클래스 내부에 포함되지 않으면 null입니다. 함수 코드를 평가할 때 내부 클래스의 바깥쪽 PrivateEnvironment로 사용됩니다.
`[[FormalParameters]]`	Parse Node	함수의 형식 매개변수 목록을 정의하는 소스 텍스트의 루트 Parse Node입니다.
`[[ECMAScriptCode]]`	Parse Node	함수 본문을 정의하는 소스 텍스트의 루트 Parse Node입니다.
`[[ConstructorKind]]`	base 또는 derived	함수가 파생 클래스 생성자인지를 나타냅니다.
`[[Realm]]`	Realm Record	함수가 생성된 realm이며 함수 평가 중 접근하는 모든 내재 객체를 제공합니다.
`[[ScriptOrModule]]`	Script Record 또는 Module Record	함수가 생성된 스크립트 또는 모듈입니다.
`[[ThisMode]]`	lexical, strict 또는 global	함수의 형식 매개변수와 코드 본문 내에서 `this` 참조를 해석하는 방법을 정의합니다. lexical은 `this`가 렉시컬하게 둘러싸는 함수의 this 값을 참조함을 의미합니다. strict는 함수 호출에서 제공된 this 값을 정확히 그대로 사용함을 의미합니다. global은 undefined 또는 null인 this 값을 전역 객체에 대한 참조로 해석하고, 그 밖의 모든 this 값은 먼저 ToObject에 전달함을 의미합니다.
`[[Strict]]`	Boolean	엄격 함수이면 true, 비엄격 함수이면 false입니다.
`[[HomeObject]]`	Object 또는 undefined	함수가 `super`를 사용하면 이는 `[[GetPrototypeOf]]`가 `super` 프로퍼티 조회를 시작할 객체를 제공하는 객체입니다.
`[[SourceText]]`	유니코드 코드 포인트 시퀀스	함수를 정의하는 소스 텍스트입니다.
`[[Fields]]`	ClassFieldDefinition Record의 List	함수가 클래스이면 클래스의 비정적 필드와 대응하는 이니셜라이저를 나타내는 Record의 목록입니다.
`[[PrivateMethods]]`	PrivateElement의 List	함수가 클래스이면 클래스의 비정적 비공개 메서드와 접근자를 나타내는 목록입니다.
`[[ClassFieldInitializerName]]`	String, Symbol, Private Name 또는 empty	함수가 클래스 필드의 이니셜라이저로 생성되었으면 해당 필드의 NamedEvaluation에 사용할 이름이고, 그렇지 않으면 empty입니다.
`[[IsClassConstructor]]`	Boolean	함수가 클래스 생성자인지를 나타냅니다. (true이면 함수의 `[[Call]]`을 호출하면 즉시 TypeError 예외를 던집니다.)

모든 ECMAScript 함수 객체에는 여기에 정의된 [[Call]] 내부 메서드가 있습니다. 생성자이기도 한 ECMAScript 함수에는 추가로 [[Construct]] 내부 메서드가 있습니다.

10.2.1 `[[Call]]` ( `thisArg`, `argList` )

an ECMAScript function object func의 내부 메서드 [[Call]]. 인수 thisArg (ECMAScript 언어 값) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

callerContext를 실행 중인 실행 컨텍스트로 둡니다.
calleeContext를 PrepareForOrdinaryCall(func, undefined)로 둡니다.
단언: 이제 calleeContext가 실행 중인 실행 컨텍스트입니다.
func.[[IsClassConstructor]]가 true이면, 다음을 수행합니다.
1. error를 새로 생성된 TypeError 객체로 둡니다.
2. 참고: error는 func와 연결된 Realm Record를 사용하여 calleeContext에서 생성됩니다.
3. 실행 컨텍스트 스택에서 calleeContext를 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
4. error를 던집니다.
OrdinaryCallBindThis(func, calleeContext, thisArg)를 수행합니다.
result를 Completion(OrdinaryCallEvaluateBody(func, argList))로 둡니다.
실행 컨텍스트 스택에서 calleeContext를 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
result가 throw 완료이면, ? result를 반환합니다.
단언: result는 return 완료입니다.
result.[[Value]]를 반환합니다.

참고

7 단계에서 calleeContext가 실행 컨텍스트 스택에서 제거될 때, 접근 가능한 Generator에 의해 일시 중단되고 이후 재개를 위해 유지되고 있다면 파기해서는 안 됩니다.

10.2.1.1 PrepareForOrdinaryCall ( `func`, `newTarget` )

추상 연산 PrepareForOrdinaryCall. 인수 func (ECMAScript 함수 객체) 및 newTarget ((Object 또는 undefined)). 반환값: 실행 컨텍스트. 호출되면 다음 단계를 수행한다.

callerContext를 실행 중인 실행 컨텍스트로 둡니다.
calleeContext를 새로운 ECMAScript 코드 실행 컨텍스트로 둡니다.
calleeContext의 Function을 func로 설정합니다.
calleeRealm을 func.[[Realm]]로 둡니다.
calleeContext의 Realm을 calleeRealm로 설정합니다.
calleeContext의 ScriptOrModule을 func.[[ScriptOrModule]]로 설정합니다.
localEnv를 NewFunctionEnvironment(func, newTarget)으로 둡니다.
calleeContext의 LexicalEnvironment를 localEnv로 설정합니다.
calleeContext의 VariableEnvironment를 localEnv로 설정합니다.
calleeContext의 PrivateEnvironment를 func.[[PrivateEnvironment]]로 설정합니다.
callerContext가 아직 일시 중단되지 않았으면 callerContext를 일시 중단합니다.
calleeContext를 실행 컨텍스트 스택에 푸시합니다. 이제 calleeContext가 실행 중인 실행 컨텍스트입니다.
참고: 이 시점 이후 생성되는 모든 예외 객체는 calleeRealm과 연결됩니다.
calleeContext를 반환합니다.

10.2.1.2 OrdinaryCallBindThis ( `func`, `calleeContext`, `thisArg` )

추상 연산 OrdinaryCallBindThis. 인수 func (ECMAScript 함수 객체), calleeContext (실행 컨텍스트) 및 thisArg (ECMAScript 언어 값). 반환값: unused. 호출되면 다음 단계를 수행한다.

thisMode를 func.[[ThisMode]]로 둡니다.
thisMode가 lexical이면, unused를 반환합니다.
calleeRealm을 func.[[Realm]]로 둡니다.
localEnv를 calleeContext의 LexicalEnvironment로 둡니다.
thisMode가 strict이면, 다음을 수행합니다.
1. thisValue를 thisArg로 둡니다.
그렇지 않으면,
1. thisArg가 undefined 또는 null이면, 다음을 수행합니다.
  1. globalEnv를 calleeRealm.[[GlobalEnv]]로 둡니다.
  2. 단언: globalEnv는 Global Environment Record입니다.
  3. thisValue를 globalEnv.[[GlobalThisValue]]로 둡니다.
2. 그렇지 않으면,
  1. thisValue를 ! ToObject(thisArg)로 둡니다.
  2. 참고: ToObject는 calleeRealm을 사용하여 래퍼 객체를 생성합니다.
단언: localEnv는 Function Environment Record입니다.
단언: localEnv.[[ThisBindingStatus]]가 initialized가 아니므로 다음 단계는 절대로 비정상 완료를 반환하지 않습니다.
! BindThisValue(localEnv, thisValue)를 수행합니다.
unused를 반환합니다.

10.2.1.3 Runtime Semantics: EvaluateBody

구문 지향 연산 EvaluateBody. 인수 func (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (return 완료 또는 throw 완료). 다음 생성 규칙별로 정의된다.

FunctionBody

FunctionStatementList

인수 func 및 argList를 사용한 FunctionBody의 ? EvaluateFunctionBody를 반환합니다.

ConciseBody

ExpressionBody

인수 func 및 argList를 사용한 ConciseBody의 ? EvaluateConciseBody를 반환합니다.

GeneratorBody

FunctionBody

인수 func 및 argList를 사용한 GeneratorBody의 ? EvaluateGeneratorBody를 반환합니다.

AsyncGeneratorBody

FunctionBody

인수 func 및 argList를 사용한 AsyncGeneratorBody의 ? EvaluateAsyncGeneratorBody를 반환합니다.

AsyncFunctionBody

FunctionBody

인수 func 및 argList를 사용한 AsyncFunctionBody의 ? EvaluateAsyncFunctionBody를 반환합니다.

AsyncConciseBody

ExpressionBody

인수 func 및 argList를 사용한 AsyncConciseBody의 ? EvaluateAsyncConciseBody를 반환합니다.

Initializer

AssignmentExpression

단언: argList는 비어 있습니다.
단언: func.[[ClassFieldInitializerName]]은 empty가 아닙니다.
IsAnonymousFunctionDefinition(AssignmentExpression)이 true이면, 다음을 수행합니다.
1. value를 인수 func.[[ClassFieldInitializerName]]을 사용한 Initializer의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rhs를 AssignmentExpression의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(rhs)로 둡니다.
ReturnCompletion(value)을 반환합니다.

참고

필드 이니셜라이저가 함수 경계를 구성하더라도 FunctionDeclarationInstantiation을 호출하는 것은 관찰 가능한 효과가 없으므로 생략합니다.

ClassStaticBlockBody

ClassStaticBlockStatementList

단언: argList는 비어 있습니다.
인수 func를 사용한 ClassStaticBlockBody의 ? EvaluateClassStaticBlockBody를 반환합니다.

10.2.1.4 OrdinaryCallEvaluateBody ( `func`, `argList` )

추상 연산 OrdinaryCallEvaluateBody. 인수 func (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (return 완료 또는 throw 완료). 호출되면 다음 단계를 수행한다.

인수 func 및 argList를 사용한 func.[[ECMAScriptCode]]의 ? EvaluateBody를 반환합니다.

10.2.2 `[[Construct]]` ( `argList`, `newTarget` )

an ECMAScript function object func의 내부 메서드 [[Construct]]. 인수 argList (리스트 (요소: ECMAScript 언어 값)) 및 newTarget (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

callerContext를 실행 중인 실행 컨텍스트로 둡니다.
kind를 func.[[ConstructorKind]]로 둡니다.
kind가 base이면, 다음을 수행합니다.
1. thisArg를 ? OrdinaryCreateFromConstructor(newTarget, "%Object.prototype%")로 둡니다.
calleeContext를 PrepareForOrdinaryCall(func, newTarget)로 둡니다.
단언: 이제 calleeContext가 실행 중인 실행 컨텍스트입니다.
kind가 base이면, 다음을 수행합니다.
1. OrdinaryCallBindThis(func, calleeContext, thisArg)를 수행합니다.
2. initializeResult를 Completion(InitializeInstanceElements(thisArg, func))로 둡니다.
3. initializeResult가 비정상 완료이면, 다음을 수행합니다.
  1. 실행 컨텍스트 스택에서 calleeContext를 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
  2. ? initializeResult를 반환합니다.
ctorEnv를 calleeContext의 LexicalEnvironment로 둡니다.
result를 Completion(OrdinaryCallEvaluateBody(func, argList))로 둡니다.
실행 컨텍스트 스택에서 calleeContext를 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
result가 throw 완료이면, ? result를 반환합니다.
단언: result는 return 완료입니다.
result.[[Value]]가 Object이면, result.[[Value]]를 반환합니다.
kind가 base이면, thisArg를 반환합니다.
result.[[Value]]가 undefined가 아니면, TypeError 예외를 던집니다.
thisBinding을 ? ctorEnv.GetThisBinding()으로 둡니다.
단언: thisBinding은 Object입니다.
thisBinding을 반환합니다.

10.2.3 OrdinaryFunctionCreate ( `proto`, `sourceText`, `paramList`, `body`, `thisMode`, `envRecord`, `privateEnv` )

추상 연산 OrdinaryFunctionCreate. 인수 proto (Object), sourceText (a sequence of Unicode code points), paramList (구문 분석 노드), body (구문 분석 노드), thisMode ((lexical-this 또는 non-lexical-this)), envRecord (Environment 레코드) 및 privateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: ECMAScript 함수 객체. 기본 [[Call]] 내부 메서드를 갖고 [[Construct]] 내부 메서드는 없는 새로운 함수의 런타임 생성을 명시하는 데 사용됩니다(다만 MakeConstructor와 같은 연산에 의해 이후 [[Construct]]가 추가될 수 있습니다). sourceText는 생성할 함수의 구문 정의에 해당하는 소스 텍스트입니다. 호출되면 다음 단계를 수행한다.

internalSlotsList를 표 26에 나열된 내부 슬롯으로 둡니다.
func를 OrdinaryObjectCreate(proto, internalSlotsList)로 둡니다.
func.[[Call]]을 10.2.1에 명시된 정의로 설정합니다.
func.[[SourceText]]를 sourceText로 설정합니다.
func.[[FormalParameters]]를 paramList로 설정합니다.
func.[[ECMAScriptCode]]를 body로 설정합니다.
strict를 IsStrict(body)로 둡니다.
func.[[Strict]]을 strict로 설정합니다.
thisMode가 lexical-this이면 func.[[ThisMode]]를 lexical로 설정합니다.
그렇지 않고 strict가 true이면 func.[[ThisMode]]를 strict로 설정합니다.
그렇지 않으면 func.[[ThisMode]]를 global로 설정합니다.
func.[[IsClassConstructor]]를 false로 설정합니다.
func.[[Environment]]을 envRecord로 설정합니다.
func.[[PrivateEnvironment]]을 privateEnv로 설정합니다.
func.[[ScriptOrModule]]을 GetActiveScriptOrModule()로 설정합니다.
func.[[Realm]]을 현재 Realm Record로 설정합니다.
func.[[HomeObject]]을 undefined로 설정합니다.
func.[[Fields]]를 새로운 빈 List로 설정합니다.
func.[[PrivateMethods]]를 새로운 빈 List로 설정합니다.
func.[[ClassFieldInitializerName]]을 empty로 설정합니다.
length를 paramList의 ExpectedArgumentCount로 둡니다.
SetFunctionLength(func, length)를 수행합니다.
func를 반환합니다.

10.2.4 AddRestrictedFunctionProperties ( `func`, `realm` )

추상 연산 AddRestrictedFunctionProperties. 인수 func (함수 객체) 및 realm (Realm 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: realm.[[Intrinsics]].[[%ThrowTypeError%]]가 존재하며 초기화되어 있습니다.
thrower를 realm.[[Intrinsics]].[[%ThrowTypeError%]]로 둡니다.
! DefinePropertyOrThrow(func, "caller", PropertyDescriptor { [[Getter]]: thrower, [[Setter]]: thrower, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
! DefinePropertyOrThrow(func, "arguments", PropertyDescriptor { [[Getter]]: thrower, [[Setter]]: thrower, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
unused를 반환합니다.

10.2.4.1 %ThrowTypeError% ( )

이 함수는 %ThrowTypeError% 내재 객체입니다.

각 realm마다 한 번 정의되는 익명 내장 함수 객체입니다.

호출되면 다음 단계를 수행합니다:

TypeError 예외를 던집니다.

이 함수의 [[Extensible]] 내부 슬롯 값은 false입니다.

이 함수의 "length" 프로퍼티는 속성 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }를 갖습니다.

이 함수의 "name" 프로퍼티는 속성 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }를 갖습니다.

10.2.5 MakeConstructor ( `func` [ , `writableProto` [ , `proto` ] ] )

추상 연산 MakeConstructor. 인수 func ((ECMAScript 함수 객체 또는 내장 함수 객체)) 및 선택적 인수 writableProto (Boolean) 및 proto (Object). 반환값: unused. func를 생성자로 변환합니다. 호출되면 다음 단계를 수행한다.

func가 ECMAScript 함수 객체이면, 다음을 수행합니다.
1. 단언: IsConstructor(func)는 false입니다.
2. 단언: func는 "prototype" 자체 프로퍼티를 갖지 않는 확장 가능한 객체입니다.
3. func.[[Construct]]를 10.2.2에 명시된 정의로 설정합니다.
그렇지 않으면,
1. func.[[Construct]]를 10.3.2에 명시된 정의로 설정합니다.
func.[[ConstructorKind]]를 base로 설정합니다.
writableProto가 존재하지 않으면 writableProto를 true로 설정합니다.
proto가 존재하지 않으면, 다음을 수행합니다.
1. proto를 OrdinaryObjectCreate(%Object.prototype%)로 설정합니다.
2. ! DefinePropertyOrThrow(proto, "constructor", PropertyDescriptor { [[Value]]: func, [[Writable]]: writableProto, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
! DefinePropertyOrThrow(func, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: writableProto, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
unused를 반환합니다.

10.2.6 MakeClassConstructor ( `func` )

추상 연산 MakeClassConstructor. 인수 func (ECMAScript 함수 객체). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: func.[[IsClassConstructor]]는 false입니다.
func.[[IsClassConstructor]]를 true로 설정합니다.
unused를 반환합니다.

10.2.7 MakeMethod ( `func`, `homeObj` )

추상 연산 MakeMethod. 인수 func (ECMAScript 함수 객체) 및 homeObj (Object). 반환값: unused. func를 메서드로 구성합니다. 호출되면 다음 단계를 수행한다.

단언: homeObj는 일반 객체입니다.
func.[[HomeObject]]을 homeObj로 설정합니다.
unused를 반환합니다.

10.2.8 DefineMethodProperty ( `homeObj`, `name`, `closure`, `enumerable` )

추상 연산 DefineMethodProperty. 인수 homeObj (Object), name ((프로퍼티 키 또는 비공개 이름)), closure (함수 객체) 및 enumerable (Boolean). 반환값: (정상 완료 (값: (PrivateElement 또는 empty)) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

단언: homeObj는 일반 확장 가능 객체입니다.
name이 Private Name이면, PrivateElement { [[Key]]: name, [[Kind]]: method, [[Value]]: closure }를 반환합니다.
propertyDesc를 PropertyDescriptor { [[Value]]: closure, [[Writable]]: true, [[Enumerable]]: enumerable, [[Configurable]]: true }로 둡니다.
? DefinePropertyOrThrow(homeObj, name, propertyDesc)를 수행합니다.
참고: DefinePropertyOrThrow는 name이 "prototype"인 클래스 정적 메서드를 정의하려고 할 때만 비정상 완료를 반환합니다.
empty를 반환합니다.

10.2.9 SetFunctionName ( `func`, `name` [ , `prefix` ] )

추상 연산 SetFunctionName. 인수 func (함수 객체) 및 name ((프로퍼티 키 또는 비공개 이름)) 및 선택적 인수 prefix (String). 반환값: unused. func에 "name" 프로퍼티를 추가합니다. 호출되면 다음 단계를 수행한다.

단언: func는 "name" 자체 프로퍼티를 갖지 않는 확장 가능한 객체입니다.
name이 Symbol이면, 다음을 수행합니다.
1. description을 name.[[Description]]으로 둡니다.
2. description이 undefined이면 name을 빈 String으로 설정합니다.
3. 그렇지 않으면 name을 "[", description 및 "]"의 문자열 연결로 설정합니다.
그렇지 않고 name이 Private Name이면, 다음을 수행합니다.
1. name을 name.[[Description]]으로 설정합니다.
initialName을 name으로 둡니다.
prefix가 존재하면, 다음을 수행합니다.
1. prefixedName을 prefix, 코드 단위 0x0020 (SPACE) 및 name의 문자열 연결로 둡니다.
2. initialName을 prefixedName으로 설정합니다.
3. Normative Optional, Legacy
  initialName을 name 또는 prefixedName 중 구현체 정의 방식으로 선택한 값으로 설정합니다.
4. name을 prefixedName으로 설정합니다.
func에 [[InitialName]] 내부 슬롯이 있으면 func.[[InitialName]]을 initialName으로 설정합니다.
! DefinePropertyOrThrow(func, "name", PropertyDescriptor { [[Value]]: name, [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
unused를 반환합니다.

참고

func.[[InitialName]]에 prefixedName을 사용할지 여부에 대한 선택은 Function.prototype.toString ( )의 출력에 영향을 줍니다. 5.c 단계에서 서로 다른 내장 함수에 대해 서로 다른 선택을 하는 것은 권장되지 않는 레거시 동작입니다.

10.2.10 SetFunctionLength ( `func`, `length` )

추상 연산 SetFunctionLength. 인수 func (함수 객체) 및 length ((음이 아닌 정수 또는 +∞)). 반환값: unused. func에 "length" 프로퍼티를 추가합니다. 호출되면 다음 단계를 수행한다.

단언: func는 "length" 자체 프로퍼티를 갖지 않는 확장 가능한 객체입니다.
! DefinePropertyOrThrow(func, "length", PropertyDescriptor { [[Value]]: 𝔽(length), [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
unused를 반환합니다.

10.2.11 FunctionDeclarationInstantiation ( `func`, `argList` )

추상 연산 FunctionDeclarationInstantiation. 인수 func (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: unused) 또는 throw 완료). func는 실행 컨텍스트를 설정하는 대상 함수 객체입니다.

참고

ECMAScript 함수를 평가하기 위한 실행 컨텍스트를 설정하면 새로운 Function Environment Record가 생성되고 각 형식 매개변수에 대한 바인딩이 해당 Environment Record에서 인스턴스화됩니다. 함수 본문의 각 선언도 인스턴스화됩니다. 함수의 형식 매개변수에 기본값 이니셜라이저가 포함되지 않으면 본문 선언은 매개변수와 동일한 Environment Record에서 인스턴스화됩니다. 기본값 매개변수 이니셜라이저가 존재하면 본문 선언을 위해 두 번째 Environment Record가 생성됩니다. 형식 매개변수와 함수는 FunctionDeclarationInstantiation의 일부로 초기화됩니다. 그 밖의 모든 바인딩은 함수 본문 평가 중에 초기화됩니다.

호출되면 다음 단계를 수행합니다:

calleeContext를 실행 중인 실행 컨텍스트로 둡니다.
code를 func.[[ECMAScriptCode]]로 둡니다.
strict를 func.[[Strict]]로 둡니다.
formals를 func.[[FormalParameters]]로 둡니다.
paramNames를 formals의 BoundNames로 둡니다.
paramNames에 중복 항목이 있으면 hasDuplicates를 true로 둡니다. 그렇지 않으면 hasDuplicates를 false로 둡니다.
simpleParamList를 formals의 IsSimpleParameterList로 둡니다.
hasParamExprs를 formals의 ContainsExpression으로 둡니다.
variableNames를 code의 VarDeclaredNames로 둡니다.
variableDecls를 code의 VarScopedDeclarations로 둡니다.
lexicalNames를 code의 LexicallyDeclaredNames로 둡니다.
funcNames를 새로운 빈 List로 둡니다.
funcsToInitialize를 새로운 빈 List로 둡니다.
variableDecls의 각 요소 variableDecl에 대해 List 역순으로 다음을 수행합니다.
1. variableDecl이 VariableDeclaration도 ForBinding도 BindingIdentifier도 아니면, 다음을 수행합니다.
  1. 단언: variableDecl은 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration 또는 AsyncGeneratorDeclaration 중 하나입니다.
  2. funcName을 variableDecl의 BoundNames의 유일한 요소로 둡니다.
  3. funcNames에 funcName이 포함되어 있지 않으면, 다음을 수행합니다.
    1. funcName을 funcNames의 첫 번째 요소로 삽입합니다.
    2. 참고: 동일한 이름의 함수 선언이 여러 개 있으면 마지막 선언을 사용합니다.
    3. variableDecl을 funcsToInitialize의 첫 번째 요소로 삽입합니다.
argumentsObjNeeded를 true로 둡니다.
func.[[ThisMode]]가 lexical이면, 다음을 수행합니다.
1. 참고: 화살표 함수에는 arguments 객체가 없습니다.
2. argumentsObjNeeded를 false로 설정합니다.
그렇지 않고 paramNames에 "arguments"가 포함되어 있으면, 다음을 수행합니다.
1. argumentsObjNeeded를 false로 설정합니다.
그렇지 않고 hasParamExprs가 false이면, 다음을 수행합니다.
1. funcNames에 "arguments"가 포함되어 있거나 lexicalNames에 "arguments"가 포함되어 있으면, 다음을 수행합니다.
  1. argumentsObjNeeded를 false로 설정합니다.
strict가 true이거나 hasParamExprs가 false이면, 다음을 수행합니다.
1. 참고: 엄격 모드 코드의 eval 호출은 eval 외부에서 볼 수 있는 새로운 바인딩을 생성할 수 없으므로 매개변수에는 하나의 Environment Record만 필요합니다.
2. envRecord를 calleeContext의 LexicalEnvironment로 둡니다.
그렇지 않으면,
1. 참고: 형식 매개변수 목록에서 직접 eval 호출로 생성된 바인딩이 매개변수가 선언되는 환경 바깥에 있도록 보장하기 위해 별도의 Environment Record가 필요합니다.
2. calleeEnv를 calleeContext의 LexicalEnvironment로 둡니다.
3. envRecord를 NewDeclarativeEnvironment(calleeEnv)로 둡니다.
4. 단언: calleeContext의 VariableEnvironment와 calleeEnv는 같은 Environment Record입니다.
5. calleeContext의 LexicalEnvironment를 envRecord로 설정합니다.
paramNames의 각 String paramName에 대해 다음을 수행합니다.
1. alreadyDeclared를 ! envRecord.HasBinding(paramName)으로 둡니다.
2. 참고: 조기 오류는 중복 매개변수 이름이 매개변수 기본값이나 나머지 매개변수를 갖지 않는 비엄격 함수에서만 나타날 수 있도록 보장합니다.
3. alreadyDeclared가 false이면, 다음을 수행합니다.
  1. ! envRecord.CreateMutableBinding(paramName, false)를 수행합니다.
  2. hasDuplicates가 true이면, 다음을 수행합니다.
    1. ! envRecord.InitializeBinding(paramName, undefined)를 수행합니다.
argumentsObjNeeded가 true이면, 다음을 수행합니다.
1. strict가 true이거나 simpleParamList가 false이면, 다음을 수행합니다.
  1. argumentsObj를 CreateUnmappedArgumentsObject(argList)로 둡니다.
2. 그렇지 않으면,
  1. 참고: 매핑된 arguments 객체는 나머지 매개변수, 매개변수 기본값 이니셜라이저 또는 구조 분해 매개변수가 없는 비엄격 함수에만 제공됩니다.
  2. argumentsObj를 CreateMappedArgumentsObject(func, formals, argList, envRecord)로 둡니다.
3. strict가 true이면, 다음을 수행합니다.
  1. ! envRecord.CreateImmutableBinding("arguments", false)를 수행합니다.
  2. 참고: 엄격 모드 코드에서는 조기 오류가 이 바인딩에 할당하려는 시도를 방지하므로 변경 가능 여부를 관찰할 수 없습니다.
4. 그렇지 않으면,
  1. ! envRecord.CreateMutableBinding("arguments", false)를 수행합니다.
5. ! envRecord.InitializeBinding("arguments", argumentsObj)를 수행합니다.
6. paramBindings를 paramNames와 « "arguments" »의 목록 연결로 둡니다.
그렇지 않으면,
1. paramBindings를 paramNames로 둡니다.
iteratorRecord를 CreateListIteratorRecord(argList)로 둡니다.
hasDuplicates가 true이면, 다음을 수행합니다.
1. usedEnv를 undefined로 둡니다.
그렇지 않으면,
1. usedEnv를 envRecord로 둡니다.
참고: 다음 단계는 ReturnCompletion을 반환할 수 없습니다. 표현식 위치에서 그러한 완료가 발생할 수 있는 유일한 방법은 YieldExpression을 사용하는 것이지만, 이는 15.5.1 및 15.6.1의 조기 오류 규칙에 의해 매개변수 목록에서 금지됩니다.
인수 iteratorRecord 및 usedEnv를 사용한 formals의 ? IteratorBindingInitialization을 수행합니다.
hasParamExprs가 false이면, 다음을 수행합니다.
1. 참고: 매개변수와 최상위 var에는 하나의 Environment Record만 필요합니다.
2. instantiatedVariableNames를 List paramBindings의 복사본으로 둡니다.
3. variableNames의 각 요소 name에 대해 다음을 수행합니다.
  1. instantiatedVariableNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
    1. name을 instantiatedVariableNames에 추가합니다.
    2. ! envRecord.CreateMutableBinding(name, false)를 수행합니다.
    3. ! envRecord.InitializeBinding(name, undefined)를 수행합니다.
4. variableEnv를 envRecord로 둡니다.
그렇지 않으면,
1. 참고: 형식 매개변수 목록의 표현식에서 생성된 클로저가 함수 본문의 선언을 볼 수 없도록 별도의 Environment Record가 필요합니다.
2. variableEnv를 NewDeclarativeEnvironment(envRecord)로 둡니다.
3. calleeContext의 VariableEnvironment를 variableEnv로 설정합니다.
4. instantiatedVariableNames를 새로운 빈 List로 둡니다.
5. variableNames의 각 요소 name에 대해 다음을 수행합니다.
  1. instantiatedVariableNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
    1. name을 instantiatedVariableNames에 추가합니다.
    2. ! variableEnv.CreateMutableBinding(name, false)를 수행합니다.
    3. paramBindings에 name이 포함되어 있지 않거나 funcNames에 name이 포함되어 있으면, 다음을 수행합니다.
      1. initialValue를 undefined로 둡니다.
    4. 그렇지 않으면,
      1. initialValue를 ! envRecord.GetBindingValue(name, false)로 둡니다.
    5. ! variableEnv.InitializeBinding(name, initialValue)을 수행합니다.
    6. 참고: 형식 매개변수와 같은 이름의 var는 처음에는 대응하는 초기화된 매개변수와 같은 값을 갖습니다.
strict가 true이면, 다음을 수행합니다.
1. lexicalEnv를 variableEnv로 둡니다.
그렇지 않으면,
1. Normative Optional
  호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하면, 다음을 수행합니다.
  1. code Contains x가 true인 Block, CaseClause 또는 DefaultClause x의 StatementList에 직접 포함된 각 FunctionDeclaration funcDecl에 대해 다음을 수행합니다.
    1. funcName을 funcDecl의 BindingIdentifier의 StringValue로 둡니다.
    2. FunctionDeclaration funcDecl을 funcName을 BindingIdentifier로 갖는 VariableStatement로 교체해도 func에 대한 조기 오류가 발생하지 않고 paramNames에 funcName이 포함되어 있지 않으면, 다음을 수행합니다.
      1. 참고: funcName에 대한 var 바인딩은 여기에서 funcName이 VarDeclaredName도, 형식 매개변수 이름도, 다른 FunctionDeclaration도 아닌 경우에만 인스턴스화됩니다.
      2. instantiatedVariableNames에 funcName이 포함되어 있지 않고 funcName이 "arguments"가 아니면, 다음을 수행합니다.
        ! variableEnv.CreateMutableBinding(funcName, false)를 수행합니다.
        ! variableEnv.InitializeBinding(funcName, undefined)를 수행합니다.
        funcName을 instantiatedVariableNames에 추가합니다.
      3. FunctionDeclaration funcDecl이 평가될 때 15.2.6에 제공된 FunctionDeclaration Evaluation 알고리즘 대신 다음 단계를 수행합니다.
        funcEnv를 실행 중인 실행 컨텍스트의 VariableEnvironment로 둡니다.
        blockEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
        funcObj를 ! blockEnv.GetBindingValue(funcName, false)로 둡니다.
        ! funcEnv.SetMutableBinding(funcName, funcObj, false)를 수행합니다.
        unused를 반환합니다.
2. lexicalEnv를 NewDeclarativeEnvironment(variableEnv)로 둡니다.
3. 참고: 비엄격 함수는 최상위 렉시컬 선언에 별도의 Environment Record를 사용하여 직접 eval이 eval 코드에서 도입한 var 스코프 선언과 기존 최상위 렉시컬 스코프 선언 사이의 충돌 여부를 결정할 수 있도록 합니다. 엄격 직접 eval은 항상 모든 선언을 새로운 Environment Record에 배치하므로 엄격 함수에는 이것이 필요하지 않습니다.
calleeContext의 LexicalEnvironment를 lexicalEnv로 설정합니다.
lexicalDecls를 code의 LexicallyScopedDeclarations로 둡니다.
lexicalDecls의 각 요소 lexicalDecl에 대해 다음을 수행합니다.
1. 참고: 렉시컬하게 선언된 이름은 함수/제너레이터 선언, 형식 매개변수 또는 var 이름과 같을 수 없습니다. 렉시컬하게 선언된 이름은 여기에서 인스턴스화만 되고 초기화되지는 않습니다.
2. lexicalDecl의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
  1. lexicalDecl의 IsConstantDeclaration이 true이면, 다음을 수행합니다.
    1. ! lexicalEnv.CreateImmutableBinding(name, true)를 수행합니다.
  2. 그렇지 않으면,
    1. ! lexicalEnv.CreateMutableBinding(name, false)를 수행합니다.
privateEnv를 calleeContext의 PrivateEnvironment로 둡니다.
funcsToInitialize의 각 Parse Node funcDecl에 대해 다음을 수행합니다.
1. funcName을 funcDecl의 BoundNames의 유일한 요소로 둡니다.
2. funcObj를 인수 lexicalEnv 및 privateEnv를 사용한 funcDecl의 InstantiateFunctionObject로 둡니다.
3. ! variableEnv.SetMutableBinding(funcName, funcObj, false)를 수행합니다.
unused를 반환합니다.

10.3 내장 함수 객체

내장 함수 객체는 일반 객체이며 10.1에 명시된 일반 객체에 대한 요구 사항을 충족해야 합니다.

모든 일반 객체에 필요한 내부 슬롯(10.1 참조) 외에도 내장 함수 객체에는 다음 내부 슬롯이 있어야 합니다:

[[Realm]]은 함수가 생성된 realm을 나타내는 Realm Record입니다.
[[InitialName]]은 함수의 초기 이름인 String입니다. 20.2.3.5에서 사용됩니다.
[[Async]]는 BuiltinCallOrConstruct에서 함수가 async 함수 호출 및 생성 동작을 갖는지를 나타내는 Boolean입니다.

달리 명시되지 않는 한 내장 함수 객체의 [[Prototype]] 내부 슬롯 초기값은 %Function.prototype%입니다.

내장 함수 객체에는 10.3.1의 정의를 따르는 [[Call]] 내부 메서드가 있어야 합니다.

내장 함수 객체가 “constructor”로 설명되어 있거나 이 명세의 어떤 알고리즘이 해당 [[Construct]] 내부 메서드를 명시적으로 설정하는 경우에만 [[Construct]] 내부 메서드를 갖습니다. 이러한 [[Construct]] 내부 메서드는 10.3.2의 정의를 따라야 합니다.

구현체는 이 명세에 정의되지 않은 추가 내장 함수 객체를 제공할 수 있습니다.

10.3.1 `[[Call]]` ( `thisArg`, `argList` )

a built-in function object func의 내부 메서드 [[Call]]. 인수 thisArg (ECMAScript 언어 값) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? BuiltinCallOrConstruct(func, thisArg, argList, undefined)를 반환합니다.

10.3.2 `[[Construct]]` ( `argList`, `newTarget` )

a built-in function object func (when the method is present)의 내부 메서드 [[Construct]]. 인수 argList (리스트 (요소: ECMAScript 언어 값)) 및 newTarget (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

result를 ? BuiltinCallOrConstruct(func, uninitialized, argList, newTarget)로 둡니다.
단언: result는 Object입니다.
result를 반환합니다.

10.3.3 BuiltinCallOrConstruct ( `func`, `thisArg`, `argList`, `newTarget` )

추상 연산 BuiltinCallOrConstruct. 인수 func (내장 함수 객체), thisArg ((ECMAScript 언어 값 또는 uninitialized)), argList (리스트 (요소: ECMAScript 언어 값)) 및 newTarget ((생성자 또는 undefined)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

callerContext를 실행 중인 실행 컨텍스트로 둡니다.
callerContext가 아직 일시 중단되지 않았으면 callerContext를 일시 중단합니다.
calleeContext를 새로운 실행 컨텍스트로 둡니다.
calleeContext의 Function을 func로 설정합니다.
calleeRealm을 func.[[Realm]]로 둡니다.
calleeContext의 Realm을 calleeRealm으로 설정합니다.
calleeContext의 ScriptOrModule을 null로 설정합니다.
calleeContext에 필요한 구현체 정의 초기화를 수행합니다.
calleeContext를 실행 컨텍스트 스택에 푸시합니다. 이제 calleeContext가 실행 중인 실행 컨텍스트입니다.
func.[[Async]]가 true이면, 다음을 수행합니다.
1. promiseCapability를 ! NewPromiseCapability(%Promise%)로 둡니다.
2. resultsClosure를 매개변수가 없고 func, thisArg, argList 및 newTarget을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. result를 func의 명세에 부합하는 방식으로 func를 평가한 결과인 Completion Record로 둡니다. thisArg가 uninitialized이면 this 값은 초기화되지 않습니다. 그렇지 않으면 thisArg가 this 값을 제공합니다. argList는 이름 있는 매개변수를 제공합니다. newTarget은 NewTarget 값을 제공합니다.
  2. 참고: func가 이 문서에 정의되어 있으면 “func의 명세”는 알고리즘 단계 또는 다른 수단으로 해당 함수에 대해 명시된 동작입니다.
  3. Completion(result)를 반환합니다.
3. AsyncFunctionStart(promiseCapability, resultsClosure)를 수행합니다.
4. 실행 컨텍스트 스택에서 calleeContext를 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
5. promiseCapability.[[Promise]]를 반환합니다.
result를 func의 명세에 부합하는 방식으로 func를 평가한 결과인 Completion Record로 둡니다. thisArg가 uninitialized이면 this 값은 초기화되지 않습니다. 그렇지 않으면 thisArg가 this 값을 제공합니다. argList는 이름 있는 매개변수를 제공합니다. newTarget은 NewTarget 값을 제공합니다.
참고: func가 이 문서에 정의되어 있으면 “func의 명세”는 알고리즘 단계 또는 다른 수단으로 해당 함수에 대해 명시된 동작입니다.
실행 컨텍스트 스택에서 calleeContext를 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
? result를 반환합니다.

참고

calleeContext가 일시 중단되어 접근 가능한 Generator에 의해 이후 재개를 위해 유지되고 있다면 실행 컨텍스트 스택에서 제거될 때 파기해서는 안 됩니다.

10.3.4 CreateBuiltinFunction ( `behaviour`, `length`, `name`, `additionalInternalSlotsList` [ , `realm` [ , `proto` [ , `prefix` [ , `async` ] ] ] ] )

추상 연산 CreateBuiltinFunction. 인수 behaviour ((추상 클로저, a set of algorithm steps 또는 some other definition of a function's behaviour provided in this specification)), length ((음이 아닌 정수 또는 +∞)), name ((프로퍼티 키 또는 비공개 이름)) 및 additionalInternalSlotsList (리스트 (요소: 내부 슬롯 이름)) 및 선택적 인수 realm (Realm 레코드), proto ((Object 또는 null)), prefix (String) 및 async (Boolean). 반환값: 내장 함수 객체. additionalInternalSlotsList에는 객체의 일부로 정의해야 하는 추가 내부 슬롯의 이름이 포함됩니다. 이 연산은 내장 함수 객체를 생성합니다. 호출되면 다음 단계를 수행한다.

realm이 존재하지 않으면 realm을 현재 Realm Record로 설정합니다.
proto가 존재하지 않으면 proto를 realm.[[Intrinsics]].[[%Function.prototype%]]로 설정합니다.
async가 존재하지 않으면 async를 false로 설정합니다.
internalSlotsList를 10.3가 생성하려는 내장 함수 객체에 요구하는 모든 내부 슬롯의 이름을 포함하는 List로 둡니다.
additionalInternalSlotsList의 요소를 internalSlotsList에 추가합니다.
func를 호출될 때 behaviour가 지정한 대응 매개변수의 값으로 제공된 인수를 사용하여 behaviour가 설명하는 동작을 수행하는 새로운 내장 함수 객체로 둡니다. 새로운 함수 객체에는 이름이 internalSlotsList의 요소인 내부 슬롯과 [[InitialName]] 내부 슬롯이 있습니다.
func.[[Async]]를 async로 설정합니다.
func.[[Prototype]]을 proto로 설정합니다.
func.[[Extensible]]을 true로 설정합니다.
func.[[Realm]]을 realm으로 설정합니다.
func.[[InitialName]]을 null로 설정합니다.
SetFunctionLength(func, length)를 수행합니다.
prefix가 존재하지 않으면, 다음을 수행합니다.
1. SetFunctionName(func, name)을 수행합니다.
그렇지 않으면,
1. SetFunctionName(func, name, prefix)을 수행합니다.
func를 반환합니다.

이 명세에 정의된 각 내장 함수는 CreateBuiltinFunction 추상 연산을 호출하여 생성됩니다.

10.4 내장 특수 객체의 내부 메서드와 슬롯

이 명세에서는 여러 종류의 내장 특수 객체를 정의합니다. 이러한 객체는 일반적으로 몇몇 특정 상황을 제외하면 일반 객체와 유사하게 동작합니다. 다음 특수 객체는 아래에서 명시적으로 달리 지정한 경우를 제외하고 일반 객체 내부 메서드를 사용합니다:

10.4.1 바인딩된 함수 특수 객체

바인딩된 함수 특수 객체는 다른 함수 객체를 래핑하는 특수 객체입니다. 바인딩된 함수 특수 객체는 호출 가능합니다([[Call]] 내부 메서드를 가지며 [[Construct]] 내부 메서드를 가질 수도 있습니다). 바인딩된 함수 특수 객체를 호출하면 일반적으로 래핑된 함수가 호출됩니다.

객체의 [[Call]] 및 (해당하는 경우) [[Construct]] 내부 메서드가 다음 구현을 사용하고, 그 밖의 필수 내부 메서드가 10.1에 있는 정의를 사용하면 해당 객체는 바인딩된 함수 특수 객체입니다. 이러한 메서드는 BoundFunctionCreate에서 설치됩니다.

바인딩된 함수 특수 객체에는 표 26에 나열된 ECMAScript 함수 객체의 내부 슬롯이 없습니다. 대신 [[Prototype]] 및 [[Extensible]] 외에도 표 27에 나열된 내부 슬롯이 있습니다.

표 27: 바인딩된 함수 특수 객체의 내부 슬롯

내부 슬롯	타입	설명
`[[BoundTargetFunction]]`	호출 가능한 Object	래핑된 함수 객체입니다.
`[[BoundThis]]`	ECMAScript 언어 값	래핑된 함수를 호출할 때 항상 this 값으로 전달되는 값입니다.
`[[BoundArguments]]`	ECMAScript 언어 값의 List	래핑된 함수를 호출할 때마다 첫 번째 인수로 사용되는 요소를 갖는 값의 목록입니다.

10.4.1.1 `[[Call]]` ( `thisArg`, `argList` )

a bound function exotic object func의 내부 메서드 [[Call]]. 인수 thisArg (ECMAScript 언어 값) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

target을 func.[[BoundTargetFunction]]으로 둡니다.
boundThis를 func.[[BoundThis]]로 둡니다.
boundArgs를 func.[[BoundArguments]]로 둡니다.
args를 boundArgs와 argList의 목록 연결로 둡니다.
? Call(target, boundThis, args)를 반환합니다.

10.4.1.2 `[[Construct]]` ( `argList`, `newTarget` )

a bound function exotic object func의 내부 메서드 [[Construct]]. 인수 argList (리스트 (요소: ECMAScript 언어 값)) 및 newTarget (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

target을 func.[[BoundTargetFunction]]으로 둡니다.
단언: IsConstructor(target)은 true입니다.
boundArgs를 func.[[BoundArguments]]로 둡니다.
args를 boundArgs와 argList의 목록 연결로 둡니다.
SameValue(func, newTarget)가 true이면 newTarget을 target으로 설정합니다.
? Construct(target, args, newTarget)를 반환합니다.

10.4.1.3 BoundFunctionCreate ( `targetFunc`, `boundThis`, `boundArgs` )

추상 연산 BoundFunctionCreate. 인수 targetFunc (함수 객체), boundThis (ECMAScript 언어 값) 및 boundArgs (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: 함수 객체) 또는 throw 완료). 새로운 바인딩된 함수 특수 객체의 생성을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

proto를 ? targetFunc.[[GetPrototypeOf]]()로 둡니다.
internalSlotsList를 « [[Prototype]], [[Extensible]] »과 표 27에 나열된 내부 슬롯의 목록 연결로 둡니다.
obj를 MakeBasicObject(internalSlotsList)로 둡니다.
obj.[[Prototype]]을 proto로 설정합니다.
obj.[[Call]]을 10.4.1.1에 명시된 대로 설정합니다.
IsConstructor(targetFunc)가 true이면, 다음을 수행합니다.
1. obj.[[Construct]]를 10.4.1.2에 명시된 대로 설정합니다.
obj.[[BoundTargetFunction]]을 targetFunc로 설정합니다.
obj.[[BoundThis]]를 boundThis로 설정합니다.
obj.[[BoundArguments]]를 boundArgs로 설정합니다.
obj를 반환합니다.

10.4.2 Array 특수 객체

Array는 배열 인덱스 프로퍼티 키를 특별하게 처리하는 특수 객체입니다(6.1.7 참조). 프로퍼티 이름이 배열 인덱스인 프로퍼티를 요소라고도 합니다. 모든 Array에는 구성 불가능한 "length" 프로퍼티가 있으며, 그 값은 수학적 값이 2³²보다 엄격히 작은 음이 아닌 정수 Number입니다. "length" 프로퍼티의 값은 이름이 배열 인덱스인 모든 자체 프로퍼티 이름의 숫자 값보다 큽니다. Array의 자체 프로퍼티가 생성되거나 변경될 때마다 이 불변 조건을 유지하기 위해 필요에 따라 다른 프로퍼티를 조정합니다. 구체적으로 이름이 배열 인덱스인 자체 프로퍼티가 추가될 때마다 필요한 경우 "length" 프로퍼티 값을 해당 배열 인덱스의 숫자 값보다 1 큰 값으로 변경합니다. 또한 "length" 프로퍼티 값이 변경될 때마다 배열 인덱스 이름의 값이 새로운 길이보다 작지 않은 모든 자체 프로퍼티를 삭제합니다. 이 제약 조건은 Array의 자체 프로퍼티에만 적용되며 프로토타입에서 상속될 수 있는 "length" 또는 배열 인덱스 프로퍼티의 영향을 받지 않습니다.

객체의 [[DefineOwnProperty]] 내부 메서드가 다음 구현을 사용하고 그 밖의 필수 내부 메서드가 10.1에 있는 정의를 사용하면 해당 객체는 Array 특수 객체(또는 간단히 Array)입니다. 이러한 메서드는 ArrayCreate에서 설치됩니다.

10.4.2.1 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

an Array exotic object array의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 "length"이면, ? ArraySetLength(array, propertyDesc)를 반환합니다.
propertyKey가 배열 인덱스이면, 다음을 수행합니다.
1. lengthDesc를 OrdinaryGetOwnProperty(array, "length")로 둡니다.
2. 단언: lengthDesc는 undefined가 아닙니다.
3. 단언: IsDataDescriptor(lengthDesc)는 true입니다.
4. 단언: lengthDesc.[[Configurable]]은 false입니다.
5. length를 lengthDesc.[[Value]]로 둡니다.
6. 단언: length는 음이 아닌 정수 Number입니다.
7. index를 ! ToUint32(propertyKey)로 둡니다.
8. index ≥ length이고 lengthDesc.[[Writable]]이 false이면, false를 반환합니다.
9. succeeded를 ! OrdinaryDefineOwnProperty(array, propertyKey, propertyDesc)로 둡니다.
10. succeeded가 false이면, false를 반환합니다.
11. index ≥ length이면, 다음을 수행합니다.
  1. lengthDesc.[[Value]]를 index + 1_𝔽로 설정합니다.
  2. succeeded를 ! OrdinaryDefineOwnProperty(array, "length", lengthDesc)로 설정합니다.
  3. 단언: succeeded는 true입니다.
12. true를 반환합니다.
? OrdinaryDefineOwnProperty(array, propertyKey, propertyDesc)를 반환합니다.

10.4.2.2 ArrayCreate ( `length` [ , `proto` ] )

추상 연산 ArrayCreate. 인수 length (음이 아닌 정수) 및 선택적 인수 proto (Object). 반환값: (정상 완료 (값: Array 특수 객체) 또는 throw 완료). 새로운 Array의 생성을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

length > 2³² - 1이면, RangeError 예외를 던집니다.
proto가 존재하지 않으면 proto를 %Array.prototype%로 설정합니다.
array를 MakeBasicObject(« [[Prototype]], [[Extensible]] »)로 둡니다.
array.[[Prototype]]을 proto로 설정합니다.
array.[[DefineOwnProperty]]를 10.4.2.1에 명시된 대로 설정합니다.
! OrdinaryDefineOwnProperty(array, "length", PropertyDescriptor { [[Value]]: 𝔽(length), [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
array를 반환합니다.

10.4.2.3 ArraySpeciesCreate ( `originalArray`, `length` )

추상 연산 ArraySpeciesCreate. 인수 originalArray (Object) 및 length (음이 아닌 정수). 반환값: (정상 완료 (값: Object) 또는 throw 완료). originalArray에서 파생된 생성자 함수를 사용하여 새로운 Array 또는 유사한 객체의 생성을 명시하는 데 사용됩니다. 생성자 함수가 반드시 Array를 반환하도록 강제하지는 않습니다. 호출되면 다음 단계를 수행한다.

isArray를 ? IsArray(originalArray)로 둡니다.
isArray가 false이면, ? ArrayCreate(length)를 반환합니다.
ctor를 ? Get(originalArray, "constructor")로 둡니다.
IsConstructor(ctor)가 true이면, 다음을 수행합니다.
1. thisRealm을 현재 Realm Record로 둡니다.
2. ctorRealm을 ? GetFunctionRealm(ctor)로 둡니다.
3. thisRealm과 ctorRealm이 같은 Realm Record가 아니면, 다음을 수행합니다.
  1. SameValue(ctor, ctorRealm.[[Intrinsics]].[[%Array%]])가 true이면 ctor를 undefined로 설정합니다.
ctor가 Object이면, 다음을 수행합니다.
1. ctor를 ? Get(ctor, %Symbol.species%)로 설정합니다.
2. ctor가 null이면 ctor를 undefined로 설정합니다.
ctor가 undefined이면, ? ArrayCreate(length)를 반환합니다.
IsConstructor(ctor)가 false이면, TypeError 예외를 던집니다.
? Construct(ctor, « 𝔽(length) »)를 반환합니다.

참고

originalArray가 실행 중인 실행 컨텍스트의 realm이 아닌 realm의 표준 내장 Array 생성자를 사용하여 생성되었다면, 실행 중인 실행 컨텍스트의 realm을 사용하여 새로운 Array를 생성합니다. 이는 현재 ArraySpeciesCreate를 사용하여 정의된 Array.prototype 메서드에 대해 역사적으로 이러한 동작을 해 온 웹 브라우저와의 호환성을 유지합니다.

10.4.2.4 ArraySetLength ( `array`, `propertyDesc` )

추상 연산 ArraySetLength. 인수 array (Array) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyDesc에 [[Value]] 필드가 없으면, 다음을 수행합니다.
1. ! OrdinaryDefineOwnProperty(array, "length", propertyDesc)를 반환합니다.
newLengthDesc를 propertyDesc의 복사본으로 둡니다.
newLength를 ? ToUint32(propertyDesc.[[Value]])로 둡니다.
numberLength를 ? ToNumber(propertyDesc.[[Value]])로 둡니다.
SameValueZero(newLength, numberLength)가 false이면, RangeError 예외를 던집니다.
newLengthDesc.[[Value]]를 newLength로 설정합니다.
oldLengthDesc를 OrdinaryGetOwnProperty(array, "length")로 둡니다.
단언: oldLengthDesc는 undefined가 아닙니다.
단언: IsDataDescriptor(oldLengthDesc)는 true입니다.
단언: oldLengthDesc.[[Configurable]]은 false입니다.
oldLength를 oldLengthDesc.[[Value]]로 둡니다.
newLength ≥ oldLength이면, 다음을 수행합니다.
1. ! OrdinaryDefineOwnProperty(array, "length", newLengthDesc)를 반환합니다.
oldLengthDesc.[[Writable]]이 false이면, false를 반환합니다.
newLengthDesc에 [[Writable]] 필드가 없거나 newLengthDesc.[[Writable]]이 true이면, 다음을 수행합니다.
1. newWritable을 true로 둡니다.
그렇지 않으면,
1. 참고: 일부 요소를 삭제할 수 없는 경우를 대비하여 [[Writable]] 속성을 false로 설정하는 작업을 연기합니다.
2. newWritable을 false로 둡니다.
3. newLengthDesc.[[Writable]]을 true로 설정합니다.
succeeded를 ! OrdinaryDefineOwnProperty(array, "length", newLengthDesc)로 둡니다.
succeeded가 false이면, false를 반환합니다.
배열 인덱스이고 ! ToUint32(propertyKey) ≥ newLength인 array의 각 자체 프로퍼티 키 propertyKey에 대해 숫자 인덱스 내림차순으로 다음을 수행합니다.
1. deleteSucceeded를 ! array.[[Delete]](propertyKey)로 둡니다.
2. deleteSucceeded가 false이면, 다음을 수행합니다.
  1. newLengthDesc.[[Value]]를 ! ToUint32(propertyKey) + 1_𝔽로 설정합니다.
  2. newWritable이 false이면 newLengthDesc.[[Writable]]을 false로 설정합니다.
  3. ! OrdinaryDefineOwnProperty(array, "length", newLengthDesc)를 수행합니다.
  4. false를 반환합니다.
newWritable이 false이면, 다음을 수행합니다.
1. succeeded를 ! OrdinaryDefineOwnProperty(array, "length", PropertyDescriptor { [[Writable]]: false })로 설정합니다.
2. 단언: succeeded는 true입니다.
true를 반환합니다.

참고

3 및 4 단계에서 propertyDesc.[[Value]]가 객체이면 해당 valueOf 메서드를 두 번 호출합니다. 이는 이 명세 제2판부터 이러한 효과로 명시된 레거시 동작입니다.

10.4.3 String 특수 객체

String 객체는 String 값을 캡슐화하고 해당 String 값의 개별 코드 단위 요소에 대응하는 가상 정수 인덱스 데이터 프로퍼티를 노출하는 특수 객체입니다. String 특수 객체에는 항상 "length"라는 데이터 프로퍼티가 있으며, 그 값은 캡슐화된 String 값의 길이입니다. 코드 단위 데이터 프로퍼티와 "length" 프로퍼티는 모두 쓰기 불가능하고 구성 불가능합니다.

객체의 [[GetOwnProperty]], [[DefineOwnProperty]] 및 [[OwnPropertyKeys]] 내부 메서드가 다음 구현을 사용하고, 그 밖의 필수 내부 메서드가 10.1에 있는 정의를 사용하면 해당 객체는 String 특수 객체(또는 간단히 String 객체)입니다. 이러한 메서드는 StringCreate에서 설치됩니다.

String 특수 객체에는 일반 객체와 동일한 내부 슬롯이 있습니다. 또한 [[StringData]] 내부 슬롯도 있습니다.

10.4.3.1 `[[GetOwnProperty]]` ( `propertyKey` )

a String exotic object string의 내부 메서드 [[GetOwnProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: (프로퍼티 서술자 또는 undefined)). 호출되면 다음 단계를 수행한다.

propertyDesc를 OrdinaryGetOwnProperty(string, propertyKey)로 둡니다.
propertyDesc가 undefined가 아니면, propertyDesc를 반환합니다.
StringGetOwnProperty(string, propertyKey)를 반환합니다.

10.4.3.2 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

a String exotic object string의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

stringDesc를 StringGetOwnProperty(string, propertyKey)로 둡니다.
stringDesc가 undefined가 아니면, 다음을 수행합니다.
1. extensible을 string.[[Extensible]]로 둡니다.
2. IsCompatiblePropertyDescriptor(extensible, propertyDesc, stringDesc)를 반환합니다.
! OrdinaryDefineOwnProperty(string, propertyKey, propertyDesc)를 반환합니다.

10.4.3.3 `[[OwnPropertyKeys]]` ( )

a String exotic object obj의 내부 메서드 [[OwnPropertyKeys]]. 인수 없음. 반환값: 정상 완료 (값: 리스트 (요소: 프로퍼티 키)). 호출되면 다음 단계를 수행한다.

keys를 새로운 빈 List로 둡니다.
string을 obj.[[StringData]]로 둡니다.
단언: string은 String입니다.
length를 string의 길이로 둡니다.
0 ≤ i < length를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
1. ! ToString(𝔽(i))을 keys에 추가합니다.
배열 인덱스이고 ! ToIntegerOrInfinity(propertyKey) ≥ length인 obj의 각 자체 프로퍼티 키 propertyKey에 대해 숫자 인덱스 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
String이고 배열 인덱스가 아닌 obj의 각 자체 프로퍼티 키 propertyKey에 대해 프로퍼티 생성 시간 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
Symbol인 obj의 각 자체 프로퍼티 키 propertyKey에 대해 프로퍼티 생성 시간 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
keys를 반환합니다.

10.4.3.4 StringCreate ( `value`, `proto` )

추상 연산 StringCreate. 인수 value (String) 및 proto (Object). 반환값: String 특수 객체. 새로운 String 특수 객체의 생성을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

string을 MakeBasicObject(« [[Prototype]], [[Extensible]], [[StringData]] »)로 둡니다.
string.[[Prototype]]을 proto로 설정합니다.
string.[[StringData]]를 value로 설정합니다.
string.[[GetOwnProperty]]을 10.4.3.1에 명시된 대로 설정합니다.
string.[[DefineOwnProperty]]을 10.4.3.2에 명시된 대로 설정합니다.
string.[[OwnPropertyKeys]]를 10.4.3.3에 명시된 대로 설정합니다.
length를 value의 길이로 둡니다.
! DefinePropertyOrThrow(string, "length", PropertyDescriptor { [[Value]]: 𝔽(length), [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
string을 반환합니다.

10.4.3.5 StringGetOwnProperty ( `string`, `propertyKey` )

추상 연산 StringGetOwnProperty. 인수 string (String 특수 객체) 및 propertyKey (프로퍼티 키). 반환값: (프로퍼티 서술자 또는 undefined). 호출되면 다음 단계를 수행한다.

propertyKey가 String이 아니면, undefined를 반환합니다.
numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
numericIndex가 정수 Number가 아니면, undefined를 반환합니다.
numericIndex가 -0_𝔽이거나 numericIndex < -0_𝔽이면, undefined를 반환합니다.
stringData를 string.[[StringData]]로 둡니다.
단언: stringData는 String입니다.
length를 stringData의 길이로 둡니다.
ℝ(numericIndex) ≥ length이면, undefined를 반환합니다.
resultString을 stringData의 ℝ(numericIndex)부터 ℝ(numericIndex) + 1까지의 부분 문자열로 둡니다.
PropertyDescriptor { [[Value]]: resultString, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: false }를 반환합니다.

10.4.4 arguments 특수 객체

대부분의 ECMAScript 함수는 자신의 코드에서 arguments 객체를 사용할 수 있도록 합니다. 함수 정의의 특성에 따라 해당 arguments 객체는 일반 객체 또는 arguments 특수 객체입니다. arguments 특수 객체는 배열 인덱스 프로퍼티가 연결된 ECMAScript 함수 호출의 형식 매개변수 바인딩에 매핑되는 특수 객체입니다.

객체의 내부 메서드가 다음 구현을 사용하고 여기에서 명시되지 않은 메서드는 10.1에 있는 정의를 사용하면 해당 객체는 arguments 특수 객체입니다. 이러한 메서드는 CreateMappedArgumentsObject에서 설치됩니다.

참고 1

CreateUnmappedArgumentsObject는 이 절에 포함되어 있지만 arguments 특수 객체가 아니라 일반 객체를 생성합니다.

arguments 특수 객체에는 일반 객체와 동일한 내부 슬롯이 있습니다. 또한 [[ParameterMap]] 내부 슬롯도 있습니다. 일반 arguments 객체에도 [[ParameterMap]] 내부 슬롯이 있으며 그 값은 항상 undefined입니다. 일반 arguments 객체에서 [[ParameterMap]] 내부 슬롯은 Object.prototype.toString(20.1.3.6)이 이를 arguments 객체로 식별하기 위해서만 사용합니다.

참고 2

arguments 특수 객체에서 숫자 이름 값이 대응하는 함수 객체의 형식 매개변수 수보다 작은 정수 인덱스 데이터 프로퍼티는 처음에는 함수 실행 컨텍스트의 대응하는 인수 바인딩과 값을 공유합니다. 이는 프로퍼티를 변경하면 대응하는 인수 바인딩의 값도 변경되고 그 반대도 성립함을 의미합니다. 이러한 프로퍼티를 삭제한 다음 다시 정의하거나 프로퍼티를 접근자 프로퍼티로 변경하면 이 대응 관계가 끊어집니다. arguments 객체가 일반 객체이면 해당 프로퍼티 값은 단순히 함수에 전달된 인수의 복사본이며 프로퍼티 값과 형식 매개변수 값 사이에 동적인 연결이 없습니다.

참고 3

ParameterMap 객체와 그 프로퍼티 값은 arguments 객체와 인수 바인딩 사이의 대응 관계를 명시하기 위한 장치로 사용됩니다. ParameterMap 객체와 그 프로퍼티 값인 객체는 ECMAScript 코드에서 직접 관찰할 수 없습니다. ECMAScript 구현체는 명시된 의미론을 구현하기 위해 이러한 객체를 실제로 생성하거나 사용할 필요가 없습니다.

참고 4

일반 arguments 객체는 접근 시 TypeError 예외를 던지는 "callee"라는 이름의 구성 불가능한 접근자 프로퍼티를 정의합니다. "callee" 프로퍼티는 일부 종류의 비엄격 함수에 대해서만 생성되는 arguments 특수 객체에서는 더 구체적인 의미를 갖습니다. 일반 변형에서 이 프로퍼티를 정의하는 이유는 적합한 ECMAScript 구현체가 다른 방식으로 이를 정의하지 않도록 보장하기 위해서입니다.

참고 5

arguments 특수 객체의 ECMAScript 구현체에는 역사적으로 "caller"라는 이름의 접근자 프로퍼티가 포함되어 있었습니다. ECMAScript 2017 이전에는 이 명세가 일반 arguments 객체에서 예외를 던지는 "caller" 프로퍼티의 정의를 포함했습니다. 구현체가 더 이상 이 확장을 포함하지 않으므로 ECMAScript 2017에서는 예외를 던지는 "caller" 접근자에 대한 요구 사항을 삭제했습니다.

10.4.4.1 `[[GetOwnProperty]]` ( `propertyKey` )

an arguments exotic object args의 내부 메서드 [[GetOwnProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: (프로퍼티 서술자 또는 undefined)). 호출되면 다음 단계를 수행한다.

propertyDesc를 OrdinaryGetOwnProperty(args, propertyKey)로 둡니다.
propertyDesc가 undefined이면, undefined를 반환합니다.
map을 args.[[ParameterMap]]으로 둡니다.
isMapped를 ! HasOwnProperty(map, propertyKey)로 둡니다.
isMapped가 true이면, 다음을 수행합니다.
1. propertyDesc.[[Value]]를 ! Get(map, propertyKey)으로 설정합니다.
propertyDesc를 반환합니다.

10.4.4.2 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

an arguments exotic object args의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

map을 args.[[ParameterMap]]으로 둡니다.
isMapped를 ! HasOwnProperty(map, propertyKey)로 둡니다.
newArgDesc를 propertyDesc로 둡니다.
isMapped가 true이고 IsDataDescriptor(propertyDesc)가 true이면, 다음을 수행합니다.
1. propertyDesc에 [[Value]] 필드가 없고, propertyDesc에 [[Writable]] 필드가 있으며, propertyDesc.[[Writable]]이 false이면, 다음을 수행합니다.
  1. newArgDesc를 propertyDesc의 복사본으로 설정합니다.
  2. newArgDesc.[[Value]]를 ! Get(map, propertyKey)으로 설정합니다.
allowed를 ! OrdinaryDefineOwnProperty(args, propertyKey, newArgDesc)로 둡니다.
allowed가 false이면, false를 반환합니다.
isMapped가 true이면, 다음을 수행합니다.
1. IsAccessorDescriptor(propertyDesc)가 true이면, 다음을 수행합니다.
  1. ! map.[[Delete]](propertyKey)를 수행합니다.
2. 그렇지 않으면,
  1. propertyDesc에 [[Value]] 필드가 있으면, 다음을 수행합니다.
    1. 단언: arguments 객체가 매핑하는 형식 매개변수는 항상 쓰기 가능하므로 다음 Set은 성공합니다.
    2. ! Set(map, propertyKey, propertyDesc.[[Value]], false)를 수행합니다.
  2. propertyDesc에 [[Writable]] 필드가 있고 propertyDesc.[[Writable]]이 false이면, 다음을 수행합니다.
    1. ! map.[[Delete]](propertyKey)를 수행합니다.
true를 반환합니다.

10.4.4.3 `[[Get]]` ( `propertyKey`, `receiver` )

an arguments exotic object args의 내부 메서드 [[Get]]. 인수 propertyKey (프로퍼티 키) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

map을 args.[[ParameterMap]]으로 둡니다.
isMapped를 ! HasOwnProperty(map, propertyKey)로 둡니다.
isMapped가 false이면, ? OrdinaryGet(args, propertyKey, receiver)를 반환합니다.
단언: map에는 propertyKey에 대한 형식 매개변수 매핑이 포함되어 있습니다.
! Get(map, propertyKey)을 반환합니다.

10.4.4.4 `[[Set]]` ( `propertyKey`, `value`, `receiver` )

an arguments exotic object args의 내부 메서드 [[Set]]. 인수 propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

SameValue(args, receiver)가 false이면, 다음을 수행합니다.
1. isMapped를 false로 둡니다.
그렇지 않으면,
1. map을 args.[[ParameterMap]]으로 둡니다.
2. isMapped를 ! HasOwnProperty(map, propertyKey)로 둡니다.
isMapped가 true이면, 다음을 수행합니다.
1. 단언: arguments 객체가 매핑하는 형식 매개변수는 항상 쓰기 가능하므로 다음 Set은 성공합니다.
2. ! Set(map, propertyKey, value, false)를 수행합니다.
? OrdinarySet(args, propertyKey, value, receiver)를 반환합니다.

10.4.4.5 `[[Delete]]` ( `propertyKey` )

an arguments exotic object args의 내부 메서드 [[Delete]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

map을 args.[[ParameterMap]]으로 둡니다.
isMapped를 ! HasOwnProperty(map, propertyKey)로 둡니다.
result를 ? OrdinaryDelete(args, propertyKey)로 둡니다.
result가 true이고 isMapped가 true이면, 다음을 수행합니다.
1. ! map.[[Delete]](propertyKey)를 수행합니다.
result를 반환합니다.

10.4.4.6 CreateUnmappedArgumentsObject ( `argList` )

추상 연산 CreateUnmappedArgumentsObject. 인수 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: 일반 객체. 호출되면 다음 단계를 수행한다.

length를 argList의 요소 수로 둡니다.
obj를 OrdinaryObjectCreate(%Object.prototype%, « [[ParameterMap]] »)로 둡니다.
obj.[[ParameterMap]]을 undefined로 설정합니다.
! DefinePropertyOrThrow(obj, "length", PropertyDescriptor { [[Value]]: 𝔽(length), [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
index를 0으로 둡니다.
index < length인 동안 다음을 반복합니다.
1. value를 argList[index]로 둡니다.
2. ! CreateDataPropertyOrThrow(obj, ! ToString(𝔽(index)), value)를 수행합니다.
3. index를 index + 1로 설정합니다.
! DefinePropertyOrThrow(obj, %Symbol.iterator%, PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
! DefinePropertyOrThrow(obj, "callee", PropertyDescriptor { [[Getter]]: %ThrowTypeError%, [[Setter]]: %ThrowTypeError%, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
obj를 반환합니다.

10.4.4.7 CreateMappedArgumentsObject ( `func`, `formals`, `argList`, `envRecord` )

추상 연산 CreateMappedArgumentsObject. 인수 func (ECMAScript 함수 객체), formals (구문 분석 노드), argList (리스트 (요소: ECMAScript 언어 값)) 및 envRecord (Environment 레코드). 반환값: arguments 특수 객체. 호출되면 다음 단계를 수행한다.

단언: formals에는 나머지 매개변수, 바인딩 패턴 또는 이니셜라이저가 포함되어 있지 않습니다. 중복 식별자는 포함할 수 있습니다.
length를 argList의 요소 수로 둡니다.
obj를 MakeBasicObject(« [[Prototype]], [[Extensible]], [[ParameterMap]] »)로 둡니다.
obj.[[GetOwnProperty]]을 10.4.4.1에 명시된 대로 설정합니다.
obj.[[DefineOwnProperty]]을 10.4.4.2에 명시된 대로 설정합니다.
obj.[[Get]]을 10.4.4.3에 명시된 대로 설정합니다.
obj.[[Set]]을 10.4.4.4에 명시된 대로 설정합니다.
obj.[[Delete]]를 10.4.4.5에 명시된 대로 설정합니다.
obj.[[Prototype]]을 %Object.prototype%로 설정합니다.
map을 OrdinaryObjectCreate(null)로 둡니다.
obj.[[ParameterMap]]을 map으로 설정합니다.
paramNames를 formals의 BoundNames로 둡니다.
paramCount를 paramNames의 요소 수로 둡니다.
index를 0으로 둡니다.
index < length인 동안 다음을 반복합니다.
1. value를 argList[index]로 둡니다.
2. ! CreateDataPropertyOrThrow(obj, ! ToString(𝔽(index)), value)를 수행합니다.
3. index를 index + 1로 설정합니다.
! DefinePropertyOrThrow(obj, "length", PropertyDescriptor { [[Value]]: 𝔽(length), [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
mappedNames를 새로운 빈 List로 둡니다.
index를 paramCount - 1로 설정합니다.
index ≥ 0인 동안 다음을 반복합니다.
1. name을 paramNames[index]로 둡니다.
2. mappedNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
  1. name을 mappedNames에 추가합니다.
  2. index < length이면, 다음을 수행합니다.
    1. getter를 MakeArgGetter(name, envRecord)로 둡니다.
    2. setter를 MakeArgSetter(name, envRecord)로 둡니다.
    3. ! map.[[DefineOwnProperty]](! ToString(𝔽(index)), PropertyDescriptor { [[Setter]]: setter, [[Getter]]: getter, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
3. index를 index - 1로 설정합니다.
! DefinePropertyOrThrow(obj, %Symbol.iterator%, PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
! DefinePropertyOrThrow(obj, "callee", PropertyDescriptor { [[Value]]: func, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })를 수행합니다.
obj를 반환합니다.

10.4.4.7.1 MakeArgGetter ( `name`, `envRecord` )

추상 연산 MakeArgGetter. 인수 name (String) 및 envRecord (Environment 레코드). 반환값: 함수 객체. 실행될 때 envRecord에서 name에 바인딩된 값을 반환하는 내장 함수 객체를 생성합니다. 호출되면 다음 단계를 수행한다.

getterClosure를 매개변수가 없고 name 및 envRecord를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. NormalCompletion(! envRecord.GetBindingValue(name, false))을 반환합니다.
getter를 CreateBuiltinFunction(getterClosure, 0, "", « »)로 둡니다.
참고: ECMAScript 코드에서 getter에 직접 접근할 수는 없습니다.
getter를 반환합니다.

10.4.4.7.2 MakeArgSetter ( `name`, `envRecord` )

추상 연산 MakeArgSetter. 인수 name (String) 및 envRecord (Environment 레코드). 반환값: 함수 객체. 실행될 때 envRecord에서 name에 바인딩된 값을 설정하는 내장 함수 객체를 생성합니다. 호출되면 다음 단계를 수행한다.

setterClosure를 매개변수 (value)를 갖고 name 및 envRecord를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. NormalCompletion(! envRecord.SetMutableBinding(name, value, false))을 반환합니다.
setter를 CreateBuiltinFunction(setterClosure, 1, "", « »)로 둡니다.
참고: ECMAScript 코드에서 setter에 직접 접근할 수는 없습니다.
setter를 반환합니다.

10.4.5 TypedArray 특수 객체

TypedArray는 정규 숫자 문자열인 프로퍼티 키를 특별하게 처리하는 특수 객체입니다. 범위 내의 정수 인덱스인 부분집합을 사용하여 균일한 타입의 요소를 인덱싱하고, 나머지는 프로토타입 체인을 순회하지 않고 존재하지 않도록 하는 불변 조건을 강제합니다.

참고

임의의 Number n에 대한 ToString(n)이 정규 숫자 문자열이므로 구현체는 실제로 문자열 변환을 수행하지 않고 Number를 TypedArray의 프로퍼티 키로 취급할 수 있습니다.

TypedArray에는 일반 객체와 동일한 내부 슬롯이 있으며 추가로 [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]] 및 [[ArrayLength]] 내부 슬롯이 있습니다.

객체의 [[PreventExtensions]], [[GetOwnProperty]], [[HasProperty]], [[DefineOwnProperty]], [[Get]], [[Set]], [[Delete]] 및 [[OwnPropertyKeys]] 내부 메서드가 이 절의 정의를 사용하고, 그 밖의 필수 내부 메서드가 10.1에 있는 정의를 사용하면 해당 객체는 TypedArray입니다. 이러한 메서드는 TypedArrayCreate에서 설치됩니다.

10.4.5.1 `[[PreventExtensions]]` ( )

a TypedArray obj의 내부 메서드 [[PreventExtensions]]. 인수 없음. 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

참고: 6.1.7.3에 명시된 확장 가능성과 관련된 불변 조건은 obj가 프로퍼티를 얻을 수 있거나(또는 잃었다가 다시 얻을 수 있으면) 이 메서드가 true를 반환하는 것을 허용하지 않습니다. 이러한 상황은 기반 버퍼의 크기가 조정될 때 정수 인덱스 이름의 프로퍼티에서 발생할 수 있습니다.
IsTypedArrayFixedLength(obj)가 false이면, false를 반환합니다.
OrdinaryPreventExtensions(obj)를 반환합니다.

10.4.5.2 `[[GetOwnProperty]]` ( `propertyKey` )

a TypedArray obj의 내부 메서드 [[GetOwnProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: (프로퍼티 서술자 또는 undefined)). 호출되면 다음 단계를 수행한다.

propertyKey가 String이면, 다음을 수행합니다.
1. numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
2. numericIndex가 undefined가 아니면, 다음을 수행합니다.
  1. value를 TypedArrayGetElement(obj, numericIndex)로 둡니다.
  2. value가 undefined이면, undefined를 반환합니다.
  3. PropertyDescriptor { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true }를 반환합니다.
OrdinaryGetOwnProperty(obj, propertyKey)를 반환합니다.

10.4.5.3 `[[HasProperty]]` ( `propertyKey` )

a TypedArray obj의 내부 메서드 [[HasProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 String이면, 다음을 수행합니다.
1. numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
2. numericIndex가 undefined가 아니면, IsValidIntegerIndex(obj, numericIndex)를 반환합니다.
? OrdinaryHasProperty(obj, propertyKey)를 반환합니다.

10.4.5.4 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

a TypedArray obj의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 String이면, 다음을 수행합니다.
1. numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
2. numericIndex가 undefined가 아니면, 다음을 수행합니다.
  1. IsValidIntegerIndex(obj, numericIndex)가 false이면, false를 반환합니다.
  2. propertyDesc에 [[Configurable]] 필드가 있고 propertyDesc.[[Configurable]]이 false이면, false를 반환합니다.
  3. propertyDesc에 [[Enumerable]] 필드가 있고 propertyDesc.[[Enumerable]]이 false이면, false를 반환합니다.
  4. IsAccessorDescriptor(propertyDesc)가 true이면, false를 반환합니다.
  5. propertyDesc에 [[Writable]] 필드가 있고 propertyDesc.[[Writable]]이 false이면, false를 반환합니다.
  6. propertyDesc에 [[Value]] 필드가 있으면 ? TypedArraySetElement(obj, numericIndex, propertyDesc.[[Value]])를 수행합니다.
  7. true를 반환합니다.
! OrdinaryDefineOwnProperty(obj, propertyKey, propertyDesc)를 반환합니다.

10.4.5.5 `[[Get]]` ( `propertyKey`, `receiver` )

a TypedArray obj의 내부 메서드 [[Get]]. 인수 propertyKey (프로퍼티 키) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 String이면, 다음을 수행합니다.
1. numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
2. numericIndex가 undefined가 아니면, 다음을 수행합니다.
  1. TypedArrayGetElement(obj, numericIndex)를 반환합니다.
? OrdinaryGet(obj, propertyKey, receiver)를 반환합니다.

10.4.5.6 `[[Set]]` ( `propertyKey`, `value`, `receiver` )

a TypedArray obj의 내부 메서드 [[Set]]. 인수 propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 String이면, 다음을 수행합니다.
1. numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
2. numericIndex가 undefined가 아니면, 다음을 수행합니다.
  1. SameValue(obj, receiver)가 true이면, 다음을 수행합니다.
    1. ? TypedArraySetElement(obj, numericIndex, value)를 수행합니다.
    2. true를 반환합니다.
  2. IsValidIntegerIndex(obj, numericIndex)가 false이면, true를 반환합니다.
? OrdinarySet(obj, propertyKey, value, receiver)를 반환합니다.

10.4.5.7 `[[Delete]]` ( `propertyKey` )

a TypedArray obj의 내부 메서드 [[Delete]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

propertyKey가 String이면, 다음을 수행합니다.
1. numericIndex를 CanonicalNumericIndexString(propertyKey)으로 둡니다.
2. numericIndex가 undefined가 아니면, 다음을 수행합니다.
  1. IsValidIntegerIndex(obj, numericIndex)가 false이면, true를 반환합니다.
  2. false를 반환합니다.
! OrdinaryDelete(obj, propertyKey)를 반환합니다.

10.4.5.8 `[[OwnPropertyKeys]]` ( )

a TypedArray obj의 내부 메서드 [[OwnPropertyKeys]]. 인수 없음. 반환값: 정상 완료 (값: 리스트 (요소: 프로퍼티 키)). 호출되면 다음 단계를 수행한다.

taRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
keys를 새로운 빈 List로 둡니다.
IsTypedArrayOutOfBounds(taRecord)가 false이면, 다음을 수행합니다.
1. length를 TypedArrayLength(taRecord)로 둡니다.
2. 0 ≤ i < length를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
  1. ! ToString(𝔽(i))을 keys에 추가합니다.
String이고 정수 인덱스가 아닌 obj의 각 자체 프로퍼티 키 propertyKey에 대해 프로퍼티 생성 시간 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
Symbol인 obj의 각 자체 프로퍼티 키 propertyKey에 대해 프로퍼티 생성 시간 오름차순으로 다음을 수행합니다.
1. propertyKey를 keys에 추가합니다.
keys를 반환합니다.

10.4.5.9 버퍼 감시 Record가 있는 TypedArray

TypedArray With Buffer Witness Record는 TypedArray와 조회하는 버퍼의 캐시된 바이트 길이를 함께 캡슐화하는 데 사용하는 Record입니다. 조회하는 버퍼가 확장 가능한 SharedArrayBuffer인 경우 바이트 길이 데이터 블록에 대해 하나의 ReadSharedMemory 이벤트만 발생하도록 보장하는 데 사용됩니다.

TypedArray With Buffer Witness Record에는 표 28에 나열된 필드가 있습니다.

표 28: TypedArray With Buffer Witness Record 필드

필드 이름	값	의미
`[[Object]]`	TypedArray	버퍼의 바이트 길이가 로드되는 TypedArray입니다.
`[[CachedBufferByteLength]]`	음이 아닌 정수 또는 detached	Record가 생성될 당시 객체의 `[[ViewedArrayBuffer]]` 바이트 길이입니다.

10.4.5.10 MakeTypedArrayWithBufferWitnessRecord ( `obj`, `order` )

추상 연산 MakeTypedArrayWithBufferWitnessRecord. 인수 obj (TypedArray) 및 order ((seq-cst 또는 unordered)). 반환값: TypedArray With Buffer Witness 레코드. 호출되면 다음 단계를 수행한다.

buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
IsDetachedBuffer(buffer)가 true이면, 다음을 수행합니다.
1. byteLength를 detached로 둡니다.
그렇지 않으면,
1. byteLength를 ArrayBufferByteLength(buffer, order)로 둡니다.
TypedArray With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }를 반환합니다.

10.4.5.11 TypedArrayCreate ( `proto` )

추상 연산 TypedArrayCreate. 인수 proto (Object). 반환값: TypedArray. 새로운 TypedArray의 생성을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

internalSlotsList를 « [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] »로 둡니다.
ta를 MakeBasicObject(internalSlotsList)로 둡니다.
ta.[[PreventExtensions]]를 10.4.5.1에 명시된 대로 설정합니다.
ta.[[GetOwnProperty]]을 10.4.5.2에 명시된 대로 설정합니다.
ta.[[HasProperty]]를 10.4.5.3에 명시된 대로 설정합니다.
ta.[[DefineOwnProperty]]을 10.4.5.4에 명시된 대로 설정합니다.
ta.[[Get]]을 10.4.5.5에 명시된 대로 설정합니다.
ta.[[Set]]을 10.4.5.6에 명시된 대로 설정합니다.
ta.[[Delete]]를 10.4.5.7에 명시된 대로 설정합니다.
ta.[[OwnPropertyKeys]]를 10.4.5.8에 명시된 대로 설정합니다.
ta.[[Prototype]]을 proto로 설정합니다.
ta를 반환합니다.

10.4.5.12 TypedArrayByteLength ( `taRecord` )

추상 연산 TypedArrayByteLength. 인수 taRecord (TypedArray With Buffer Witness 레코드). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

단언: IsTypedArrayOutOfBounds(taRecord)는 false입니다.
obj를 taRecord.[[Object]]로 둡니다.
obj.[[ByteLength]]가 auto가 아니면, obj.[[ByteLength]]를 반환합니다.
length를 TypedArrayLength(taRecord)로 둡니다.
elementSize를 TypedArrayElementSize(obj)로 둡니다.
참고: 기반 버퍼가 정수 배수가 아닌 크기로 조정된 경우에도 반환되는 바이트 길이는 항상 elementSize의 정수 배수입니다.
length × elementSize를 반환합니다.

10.4.5.13 TypedArrayLength ( `taRecord` )

추상 연산 TypedArrayLength. 인수 taRecord (TypedArray With Buffer Witness 레코드). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

단언: IsTypedArrayOutOfBounds(taRecord)는 false입니다.
obj를 taRecord.[[Object]]로 둡니다.
obj.[[ArrayLength]]가 auto가 아니면, obj.[[ArrayLength]]를 반환합니다.
단언: IsFixedLengthArrayBuffer(obj.[[ViewedArrayBuffer]])는 false입니다.
byteOffset을 obj.[[ByteOffset]]으로 둡니다.
elementSize를 TypedArrayElementSize(obj)로 둡니다.
byteLength를 taRecord.[[CachedBufferByteLength]]로 둡니다.
단언: byteLength는 detached가 아닙니다.
floor((byteLength - byteOffset) / elementSize)를 반환합니다.

10.4.5.14 IsTypedArrayOutOfBounds ( `taRecord` )

추상 연산 IsTypedArrayOutOfBounds. 인수 taRecord (TypedArray With Buffer Witness 레코드). 반환값: Boolean. 객체의 숫자 프로퍼티 중 하나라도 기반 버퍼의 범위에 포함되지 않는 인덱스의 값을 참조하는지 검사합니다. 호출되면 다음 단계를 수행한다.

obj를 taRecord.[[Object]]로 둡니다.
bufferByteLength를 taRecord.[[CachedBufferByteLength]]로 둡니다.
IsDetachedBuffer(obj.[[ViewedArrayBuffer]])가 true이면, 다음을 수행합니다.
1. 단언: bufferByteLength는 detached입니다.
2. true를 반환합니다.
단언: bufferByteLength는 음이 아닌 정수입니다.
byteOffsetStart를 obj.[[ByteOffset]]으로 둡니다.
obj.[[ArrayLength]]가 auto이면, 다음을 수행합니다.
1. byteOffsetEnd를 bufferByteLength로 둡니다.
그렇지 않으면,
1. elementSize를 TypedArrayElementSize(obj)로 둡니다.
2. arrayByteLength를 obj.[[ArrayLength]] × elementSize로 둡니다.
3. byteOffsetEnd를 byteOffsetStart + arrayByteLength로 둡니다.
참고: [[ByteOffset]]이 bufferByteLength인 길이 0의 TypedArray는 범위를 벗어난 것으로 간주하지 않습니다.
byteOffsetStart > bufferByteLength이거나 byteOffsetEnd > bufferByteLength이면, true를 반환합니다.
false를 반환합니다.

10.4.5.15 IsTypedArrayFixedLength ( `obj` )

추상 연산 IsTypedArrayFixedLength. 인수 obj (TypedArray). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

obj.[[ArrayLength]]가 auto이면, false를 반환합니다.
buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
IsFixedLengthArrayBuffer(buffer)가 false이고 IsSharedArrayBuffer(buffer)가 false이면, false를 반환합니다.
true를 반환합니다.

10.4.5.16 IsValidIntegerIndex ( `obj`, `index` )

추상 연산 IsValidIntegerIndex. 인수 obj (TypedArray) 및 index (Number). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

IsDetachedBuffer(obj.[[ViewedArrayBuffer]])가 true이면, false를 반환합니다.
index가 정수 Number가 아니면, false를 반환합니다.
index가 -0_𝔽이거나 index < -0_𝔽이면, false를 반환합니다.
taRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, unordered)로 둡니다.
참고: obj의 기반 버퍼가 확장 가능한 SharedArrayBuffer인 경우 범위 검사는 동기화 연산이 아닙니다.
IsTypedArrayOutOfBounds(taRecord)가 true이면, false를 반환합니다.
length를 TypedArrayLength(taRecord)로 둡니다.
ℝ(index) ≥ length이면, false를 반환합니다.
true를 반환합니다.

10.4.5.17 TypedArrayGetElement ( `obj`, `index` )

추상 연산 TypedArrayGetElement. 인수 obj (TypedArray) 및 index (Number). 반환값: (Number, BigInt 또는 undefined). 호출되면 다음 단계를 수행한다.

IsValidIntegerIndex(obj, index)가 false이면, undefined를 반환합니다.
offset을 obj.[[ByteOffset]]으로 둡니다.
elementSize를 TypedArrayElementSize(obj)로 둡니다.
byteIndexInBuffer를 (ℝ(index) × elementSize) + offset으로 둡니다.
elementType을 TypedArrayElementType(obj)으로 둡니다.
GetValueFromBuffer(obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, true, unordered)를 반환합니다.

10.4.5.18 TypedArraySetElement ( `obj`, `index`, `value` )

추상 연산 TypedArraySetElement. 인수 obj (TypedArray), index (Number) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

obj.[[ContentType]]이 bigint이면 number를 ? ToBigInt(value)로 둡니다.
그렇지 않으면 number를 ? ToNumber(value)로 둡니다.
IsValidIntegerIndex(obj, index)가 true이면, 다음을 수행합니다.
1. offset을 obj.[[ByteOffset]]으로 둡니다.
2. elementSize를 TypedArrayElementSize(obj)로 둡니다.
3. byteIndexInBuffer를 (ℝ(index) × elementSize) + offset으로 둡니다.
4. elementType을 TypedArrayElementType(obj)으로 둡니다.
5. SetValueInBuffer(obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, number, true, unordered)를 수행합니다.
unused를 반환합니다.

참고

이 연산은 항상 성공하는 것처럼 보이지만 TypedArray 끝을 넘어 쓰려고 하거나 분리된 ArrayBuffer를 기반으로 하는 TypedArray에 쓰려고 하면 아무 효과도 없습니다.

10.4.5.19 IsArrayBufferViewOutOfBounds ( `obj` )

추상 연산 IsArrayBufferViewOutOfBounds. 인수 obj ((TypedArray 또는 DataView)). 반환값: Boolean. TypedArray의 숫자 프로퍼티 중 하나 또는 DataView 객체의 메서드 중 하나가 기반 데이터 블록의 범위에 포함되지 않는 인덱스의 값을 참조할 수 있는지를 검사합니다. 이 추상 연산은 상위 명세의 편의를 위해 존재합니다. 호출되면 다음 단계를 수행한다.

obj에 [[DataView]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. viewRecord를 MakeDataViewWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
2. IsViewOutOfBounds(viewRecord)를 반환합니다.
taRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsTypedArrayOutOfBounds(taRecord)를 반환합니다.

10.4.6 모듈 네임스페이스 특수 객체

모듈 네임스페이스 특수 객체는 ECMAScript Module에서 내보낸 바인딩을 노출하는 특수 객체입니다(16.2.3 참조). 모듈 네임스페이스 특수 객체의 String 키 자체 프로퍼티와 Module에서 내보낸 바인딩 이름 사이에는 일대일 대응 관계가 있습니다. 내보낸 바인딩에는 export * 내보내기 항목을 사용하여 간접적으로 내보낸 모든 바인딩이 포함됩니다. String 값을 갖는 각 자체 프로퍼티 키는 대응하는 내보낸 바인딩 이름의 StringValue입니다. 이것이 모듈 네임스페이스 특수 객체의 유일한 String 키 프로퍼티입니다. 이러한 각 프로퍼티는 속성 { [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: false }를 갖습니다. 모듈 네임스페이스 특수 객체는 확장 가능하지 않습니다.

객체의 [[GetPrototypeOf]], [[SetPrototypeOf]], [[IsExtensible]], [[PreventExtensions]], [[GetOwnProperty]], [[DefineOwnProperty]], [[HasProperty]], [[Get]], [[Set]], [[Delete]] 및 [[OwnPropertyKeys]] 내부 메서드가 이 절의 정의를 사용하고, 그 밖의 필수 내부 메서드가 10.1에 있는 정의를 사용하면 해당 객체는 모듈 네임스페이스 특수 객체입니다. 이러한 메서드는 ModuleNamespaceCreate에서 설치됩니다.

모듈 네임스페이스 특수 객체에는 표 29에 정의된 내부 슬롯이 있습니다.

표 29: 모듈 네임스페이스 특수 객체의 내부 슬롯

내부 슬롯	타입	설명
`[[Module]]`	Module Record	이 네임스페이스가 내보내기를 노출하는 Module Record입니다.
`[[Exports]]`	String의 List	이 객체의 자체 프로퍼티로 노출되는 내보낸 이름의 String 값을 요소로 갖는 List입니다. 목록은 사전식 코드 단위 순서에 따라 정렬됩니다.

10.4.6.1 `[[GetPrototypeOf]]` ( )

a module namespace exotic object의 내부 메서드 [[GetPrototypeOf]]. 인수 없음. 반환값: 정상 완료 (값: null). 호출되면 다음 단계를 수행한다.

null을 반환합니다.

10.4.6.2 `[[SetPrototypeOf]]` ( `proto` )

a module namespace exotic object obj의 내부 메서드 [[SetPrototypeOf]]. 인수 proto ((Object 또는 null)). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

! SetImmutablePrototype(obj, proto)를 반환합니다.

10.4.6.3 `[[IsExtensible]]` ( )

a module namespace exotic object의 내부 메서드 [[IsExtensible]]. 인수 없음. 반환값: 정상 완료 (값: false). 호출되면 다음 단계를 수행한다.

false를 반환합니다.

10.4.6.4 `[[PreventExtensions]]` ( )

a module namespace exotic object의 내부 메서드 [[PreventExtensions]]. 인수 없음. 반환값: 정상 완료 (값: true). 호출되면 다음 단계를 수행한다.

true를 반환합니다.

10.4.6.5 `[[GetOwnProperty]]` ( `propertyKey` )

a module namespace exotic object obj의 내부 메서드 [[GetOwnProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: (프로퍼티 서술자 또는 undefined)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 Symbol이면, OrdinaryGetOwnProperty(obj, propertyKey)를 반환합니다.
exports를 obj.[[Exports]]로 둡니다.
exports에 propertyKey가 포함되어 있지 않으면, undefined를 반환합니다.
value를 ? obj.[[Get]](propertyKey, obj)로 둡니다.
PropertyDescriptor { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: false }를 반환합니다.

10.4.6.6 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

a module namespace exotic object obj의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 Symbol이면, ! OrdinaryDefineOwnProperty(obj, propertyKey, propertyDesc)를 반환합니다.
current를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
current가 undefined이면, false를 반환합니다.
propertyDesc에 [[Configurable]] 필드가 있고 propertyDesc.[[Configurable]]이 true이면, false를 반환합니다.
propertyDesc에 [[Enumerable]] 필드가 있고 propertyDesc.[[Enumerable]]이 false이면, false를 반환합니다.
IsAccessorDescriptor(propertyDesc)가 true이면, false를 반환합니다.
propertyDesc에 [[Writable]] 필드가 있고 propertyDesc.[[Writable]]이 false이면, false를 반환합니다.
propertyDesc에 [[Value]] 필드가 있으면, SameValue(propertyDesc.[[Value]], current.[[Value]])를 반환합니다.
true를 반환합니다.

10.4.6.7 `[[HasProperty]]` ( `propertyKey` )

a module namespace exotic object obj의 내부 메서드 [[HasProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

propertyKey가 Symbol이면, ! OrdinaryHasProperty(obj, propertyKey)를 반환합니다.
exports를 obj.[[Exports]]로 둡니다.
exports에 propertyKey가 포함되어 있으면, true를 반환합니다.
false를 반환합니다.

10.4.6.8 `[[Get]]` ( `propertyKey`, `receiver` )

a module namespace exotic object obj의 내부 메서드 [[Get]]. 인수 propertyKey (프로퍼티 키) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

propertyKey가 Symbol이면, 다음을 수행합니다.
1. ! OrdinaryGet(obj, propertyKey, receiver)를 반환합니다.
exports를 obj.[[Exports]]로 둡니다.
exports에 propertyKey가 포함되어 있지 않으면, undefined를 반환합니다.
module을 obj.[[Module]]로 둡니다.
binding을 module.ResolveExport(propertyKey)로 둡니다.
단언: binding은 ResolvedBinding Record입니다.
targetModule을 binding.[[Module]]로 둡니다.
단언: targetModule은 undefined가 아닙니다.
binding.[[BindingName]]이 namespace이면, 다음을 수행합니다.
1. GetModuleNamespace(targetModule)를 반환합니다.
targetEnv를 targetModule.[[Environment]]로 둡니다.
targetEnv가 empty이면, ReferenceError 예외를 던집니다.
? targetEnv.GetBindingValue(binding.[[BindingName]], true)를 반환합니다.

참고

ResolveExport는 부작용이 없습니다. 이 연산을 특정 exportName, resolveSet 인수 쌍으로 호출할 때마다 동일한 결과를 반환해야 합니다. 구현체는 각 모듈 네임스페이스 특수 객체의 [[Exports]]에 대한 ResolveExport 결과를 미리 계산하거나 캐시하도록 선택할 수 있습니다.

10.4.6.9 `[[Set]]` ( `propertyKey`, `value`, `receiver` )

a module namespace exotic object의 내부 메서드 [[Set]]. 인수 propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 receiver (ECMAScript 언어 값). 반환값: 정상 완료 (값: false). 호출되면 다음 단계를 수행한다.

false를 반환합니다.

10.4.6.10 `[[Delete]]` ( `propertyKey` )

a module namespace exotic object obj의 내부 메서드 [[Delete]]. 인수 propertyKey (프로퍼티 키). 반환값: 정상 완료 (값: Boolean). 호출되면 다음 단계를 수행한다.

propertyKey가 Symbol이면, 다음을 수행합니다.
1. ! OrdinaryDelete(obj, propertyKey)를 반환합니다.
exports를 obj.[[Exports]]로 둡니다.
exports에 propertyKey가 포함되어 있으면, false를 반환합니다.
true를 반환합니다.

10.4.6.11 `[[OwnPropertyKeys]]` ( )

a module namespace exotic object obj의 내부 메서드 [[OwnPropertyKeys]]. 인수 없음. 반환값: 정상 완료 (값: 리스트 (요소: 프로퍼티 키)). 호출되면 다음 단계를 수행한다.

exports를 obj.[[Exports]]로 둡니다.
symbolKeys를 OrdinaryOwnPropertyKeys(obj)로 둡니다.
exports와 symbolKeys의 목록 연결을 반환합니다.

10.4.6.12 ModuleNamespaceCreate ( `module`, `exports` )

추상 연산 ModuleNamespaceCreate. 인수 module (Module 레코드) 및 exports (리스트 (요소: String)). 반환값: module namespace 특수 객체. 새로운 모듈 네임스페이스 특수 객체의 생성을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

단언: module.[[Namespace]]는 empty입니다.
internalSlotsList를 표 29에 나열된 내부 슬롯으로 둡니다.
namespace를 MakeBasicObject(internalSlotsList)로 둡니다.
namespace의 필수 내부 메서드를 10.4.6에 명시된 정의로 설정합니다.
namespace.[[Module]]을 module로 설정합니다.
sortedExports를 exports의 요소를 사전식 코드 단위 순서로 정렬한 요소를 갖는 List로 둡니다.
namespace.[[Exports]]를 sortedExports로 설정합니다.
28.3의 정의에 대응하는 namespace의 자체 프로퍼티를 생성합니다.
module.[[Namespace]]를 namespace로 설정합니다.
namespace를 반환합니다.

10.4.7 변경 불가능한 프로토타입 특수 객체

변경 불가능한 프로토타입 특수 객체는 초기화된 후 변경되지 않는 [[Prototype]] 내부 슬롯을 갖는 특수 객체입니다.

객체의 [[SetPrototypeOf]] 내부 메서드가 다음 구현을 사용하면 해당 객체는 변경 불가능한 프로토타입 특수 객체입니다. (그 밖의 필수 내부 메서드는 해당 변경 불가능한 프로토타입 특수 객체의 구체적인 종류에 따라 어떤 구현이든 사용할 수 있습니다.)

참고

다른 특수 객체와 달리 변경 불가능한 프로토타입 특수 객체에는 전용 생성 추상 연산이 제공되지 않습니다. 이는 %Object.prototype%과 호스트 환경에서만 사용되며, 호스트 환경에서는 관련 객체가 다른 방식으로도 특수 객체일 수 있어 자체적인 전용 생성 연산이 필요하기 때문입니다.

10.4.7.1 `[[SetPrototypeOf]]` ( `proto` )

an immutable prototype exotic object obj의 내부 메서드 [[SetPrototypeOf]]. 인수 proto ((Object 또는 null)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? SetImmutablePrototype(obj, proto)를 반환합니다.

10.4.7.2 SetImmutablePrototype ( `obj`, `proto` )

추상 연산 SetImmutablePrototype. 인수 obj (Object) 및 proto ((Object 또는 null)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

current를 ? obj.[[GetPrototypeOf]]()로 둡니다.
SameValue(proto, current)가 true이면, true를 반환합니다.
false를 반환합니다.

10.5 Proxy 객체 내부 메서드와 내부 슬롯

Proxy 객체는 필수 내부 메서드의 일부가 ECMAScript 코드를 사용하여 구현되는 특수 객체입니다. 모든 Proxy 객체에는 [[ProxyHandler]]라는 내부 슬롯이 있습니다. [[ProxyHandler]]의 값은 프록시의 핸들러 객체라고 하는 객체 또는 null입니다. 핸들러 객체의 메서드(표 30 참조)는 Proxy 객체의 하나 이상의 내부 메서드 구현을 확장하는 데 사용할 수 있습니다. 모든 Proxy 객체에는 [[ProxyTarget]]이라는 내부 슬롯도 있으며, 그 값은 객체 또는 null입니다. 이 객체를 프록시의 대상 객체라고 합니다.

객체의 필수 내부 메서드(해당하는 경우 [[Call]] 및 [[Construct]] 포함)가 이 절의 정의를 사용하면 해당 객체는 Proxy 특수 객체입니다. 이러한 내부 메서드는 ProxyCreate에서 설치됩니다.

표 30: Proxy 핸들러 메서드

내부 메서드	핸들러 메서드
`[[GetPrototypeOf]]`	`getPrototypeOf`
`[[SetPrototypeOf]]`	`setPrototypeOf`
`[[IsExtensible]]`	`isExtensible`
`[[PreventExtensions]]`	`preventExtensions`
`[[GetOwnProperty]]`	`getOwnPropertyDescriptor`
`[[DefineOwnProperty]]`	`defineProperty`
`[[HasProperty]]`	`has`
`[[Get]]`	`get`
`[[Set]]`	`set`
`[[Delete]]`	`deleteProperty`
`[[OwnPropertyKeys]]`	`ownKeys`
`[[Call]]`	`apply`
`[[Construct]]`	`construct`

Proxy 객체 내부 메서드의 구현을 제공하기 위해 핸들러 메서드를 호출하면 프록시의 대상 객체가 매개변수로 핸들러 메서드에 전달됩니다. 프록시의 핸들러 객체가 모든 필수 내부 메서드에 대응하는 메서드를 반드시 갖는 것은 아닙니다. 핸들러 객체에 내부 트랩에 대응하는 메서드가 없으면 프록시에서 내부 메서드를 호출할 때 프록시의 대상 객체에서 대응하는 내부 메서드를 호출합니다.

Proxy 객체의 [[ProxyHandler]] 및 [[ProxyTarget]] 내부 슬롯은 객체가 생성될 때 항상 초기화되며 일반적으로 수정할 수 없습니다. 일부 Proxy 객체는 나중에 해제할 수 있는 방식으로 생성됩니다. 프록시가 해제되면 [[ProxyHandler]] 및 [[ProxyTarget]] 내부 슬롯이 null로 설정되며, 이후 해당 Proxy 객체에서 내부 메서드를 호출하면 TypeError 예외가 던져집니다.

Proxy 객체는 임의의 ECMAScript 코드가 내부 메서드 구현을 제공할 수 있게 하므로, 핸들러 메서드가 6.1.7.3에 정의된 불변 조건을 위반하는 Proxy 객체를 정의할 수 있습니다. 6.1.7.3에 정의된 일부 내부 메서드 불변 조건은 필수 무결성 불변 조건입니다. 이러한 불변 조건은 이 절에 명시된 Proxy 객체 내부 메서드가 명시적으로 강제합니다. ECMAScript 구현체는 가능한 모든 불변 조건 위반 상황에서도 견고해야 합니다.

다음 알고리즘 설명에서는 obj가 ECMAScript Proxy 객체이고, propertyKey가 프로퍼티 키 값이며, value가 임의의 ECMAScript 언어 값이고, propertyDesc가 Property Descriptor Record라고 가정합니다.

10.5.1 `[[GetPrototypeOf]]` ( )

a Proxy exotic object obj의 내부 메서드 [[GetPrototypeOf]]. 인수 없음. 반환값: (정상 완료 (값: (Object 또는 null)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "getPrototypeOf")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[GetPrototypeOf]]()를 반환합니다.
handlerProto를 ? Call(trap, handler, « target »)로 둡니다.
handlerProto가 Object도 아니고 null도 아니면, TypeError 예외를 던집니다.
extensibleTarget을 ? IsExtensible(target)로 둡니다.
extensibleTarget이 true이면, handlerProto를 반환합니다.
targetProto를 ? target.[[GetPrototypeOf]]()로 둡니다.
SameValue(handlerProto, targetProto)가 false이면, TypeError 예외를 던집니다.
handlerProto를 반환합니다.

참고

Proxy 객체의 [[GetPrototypeOf]]는 다음 불변 조건을 강제합니다:

[[GetPrototypeOf]]의 결과는 Object 또는 null이어야 합니다.
대상 객체가 확장 가능하지 않으면 Proxy 객체에 적용한 [[GetPrototypeOf]]는 Proxy 객체의 대상 객체에 적용한 [[GetPrototypeOf]]와 같은 값을 반환해야 합니다.

10.5.2 `[[SetPrototypeOf]]` ( `proto` )

a Proxy exotic object obj의 내부 메서드 [[SetPrototypeOf]]. 인수 proto ((Object 또는 null)). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "setPrototypeOf")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[SetPrototypeOf]](proto)를 반환합니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target, proto »))로 둡니다.
boolTrapResult가 false이면, false를 반환합니다.
extensibleTarget을 ? IsExtensible(target)로 둡니다.
extensibleTarget이 true이면, true를 반환합니다.
targetProto를 ? target.[[GetPrototypeOf]]()로 둡니다.
SameValue(proto, targetProto)가 false이면, TypeError 예외를 던집니다.
true를 반환합니다.

참고

Proxy 객체의 [[SetPrototypeOf]]는 다음 불변 조건을 강제합니다:

[[SetPrototypeOf]]의 결과는 Boolean 값입니다.
대상 객체가 확장 가능하지 않으면 인수 값은 대상 객체에 적용한 [[GetPrototypeOf]]의 결과와 같아야 합니다.

10.5.3 `[[IsExtensible]]` ( )

a Proxy exotic object obj의 내부 메서드 [[IsExtensible]]. 인수 없음. 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "isExtensible")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? IsExtensible(target)을 반환합니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target »))로 둡니다.
targetResult를 ? IsExtensible(target)로 둡니다.
boolTrapResult가 targetResult와 다르면, TypeError 예외를 던집니다.
boolTrapResult를 반환합니다.

참고

Proxy 객체의 [[IsExtensible]]은 다음 불변 조건을 강제합니다:

[[IsExtensible]]의 결과는 Boolean 값입니다.
Proxy 객체에 적용한 [[IsExtensible]]은 동일한 인수로 Proxy 객체의 대상 객체에 적용한 [[IsExtensible]]과 같은 값을 반환해야 합니다.

10.5.4 `[[PreventExtensions]]` ( )

a Proxy exotic object obj의 내부 메서드 [[PreventExtensions]]. 인수 없음. 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "preventExtensions")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[PreventExtensions]]()를 반환합니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target »))로 둡니다.
boolTrapResult가 true이면, 다음을 수행합니다.
1. extensibleTarget을 ? IsExtensible(target)로 둡니다.
2. extensibleTarget이 true이면, TypeError 예외를 던집니다.
boolTrapResult를 반환합니다.

참고

Proxy 객체의 [[PreventExtensions]]는 다음 불변 조건을 강제합니다:

[[PreventExtensions]]의 결과는 Boolean 값입니다.
Proxy 객체에 적용한 [[PreventExtensions]]는 Proxy 객체의 대상 객체에 적용한 [[IsExtensible]]이 false일 때만 true를 반환합니다.

10.5.5 `[[GetOwnProperty]]` ( `propertyKey` )

a Proxy exotic object obj의 내부 메서드 [[GetOwnProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: (프로퍼티 서술자 또는 undefined)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "getOwnPropertyDescriptor")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[GetOwnProperty]](propertyKey)를 반환합니다.
trapResultObj를 ? Call(trap, handler, « target, propertyKey »)로 둡니다.
trapResultObj가 Object도 아니고 undefined도 아니면, TypeError 예외를 던집니다.
targetDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
trapResultObj가 undefined이면, 다음을 수행합니다.
1. targetDesc가 undefined이면, undefined를 반환합니다.
2. targetDesc.[[Configurable]]이 false이면, TypeError 예외를 던집니다.
3. extensibleTarget을 ? IsExtensible(target)로 둡니다.
4. extensibleTarget이 false이면, TypeError 예외를 던집니다.
5. undefined를 반환합니다.
extensibleTarget을 ? IsExtensible(target)로 둡니다.
resultDesc를 ? ToPropertyDescriptor(trapResultObj)로 둡니다.
CompletePropertyDescriptor(resultDesc)를 수행합니다.
valid를 IsCompatiblePropertyDescriptor(extensibleTarget, resultDesc, targetDesc)로 둡니다.
valid가 false이면, TypeError 예외를 던집니다.
resultDesc.[[Configurable]]이 false이면, 다음을 수행합니다.
1. targetDesc가 undefined이거나 targetDesc.[[Configurable]]이 true이면, 다음을 수행합니다.
  1. TypeError 예외를 던집니다.
2. resultDesc에 [[Writable]] 필드가 있고 resultDesc.[[Writable]]이 false이면, 다음을 수행합니다.
  1. 단언: targetDesc에는 [[Writable]] 필드가 있습니다.
  2. targetDesc.[[Writable]]이 true이면, TypeError 예외를 던집니다.
resultDesc를 반환합니다.

참고

Proxy 객체의 [[GetOwnProperty]]는 다음 불변 조건을 강제합니다:

[[GetOwnProperty]]의 결과는 Property Descriptor 또는 undefined여야 합니다.
대상 객체의 구성 불가능한 자체 프로퍼티로 존재하는 프로퍼티를 존재하지 않는 것으로 보고할 수 없습니다.
확장 불가능한 대상 객체의 자체 프로퍼티로 존재하는 프로퍼티를 존재하지 않는 것으로 보고할 수 없습니다.
대상 객체의 자체 프로퍼티로 존재하지 않고 대상 객체가 확장 가능하지 않으면 프로퍼티를 존재하는 것으로 보고할 수 없습니다.
대상 객체의 구성 불가능한 자체 프로퍼티로 존재하지 않는 한 프로퍼티를 구성 불가능한 것으로 보고할 수 없습니다.
대상 객체의 구성 불가능하고 쓰기 불가능한 자체 프로퍼티로 존재하지 않는 한 프로퍼티를 구성 불가능하면서 동시에 쓰기 불가능한 것으로 보고할 수 없습니다.

10.5.6 `[[DefineOwnProperty]]` ( `propertyKey`, `propertyDesc` )

a Proxy exotic object obj의 내부 메서드 [[DefineOwnProperty]]. 인수 propertyKey (프로퍼티 키) 및 propertyDesc (프로퍼티 서술자). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "defineProperty")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[DefineOwnProperty]](propertyKey, propertyDesc)를 반환합니다.
propertyDescObj를 FromPropertyDescriptor(propertyDesc)로 둡니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target, propertyKey, propertyDescObj »))로 둡니다.
boolTrapResult가 false이면, false를 반환합니다.
targetDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
extensibleTarget을 ? IsExtensible(target)로 둡니다.
propertyDesc에 [[Configurable]] 필드가 있고 propertyDesc.[[Configurable]]이 false이면, 다음을 수행합니다.
1. settingConfigurableFalse를 true로 둡니다.
그렇지 않으면,
1. settingConfigurableFalse를 false로 둡니다.
targetDesc가 undefined이면, 다음을 수행합니다.
1. extensibleTarget이 false이면, TypeError 예외를 던집니다.
2. settingConfigurableFalse가 true이면, TypeError 예외를 던집니다.
그렇지 않으면,
1. IsCompatiblePropertyDescriptor(extensibleTarget, propertyDesc, targetDesc)가 false이면, TypeError 예외를 던집니다.
2. settingConfigurableFalse가 true이고 targetDesc.[[Configurable]]이 true이면, TypeError 예외를 던집니다.
3. IsDataDescriptor(targetDesc)가 true이고, targetDesc.[[Configurable]]이 false이며, targetDesc.[[Writable]]이 true이면, 다음을 수행합니다.
  1. propertyDesc에 [[Writable]] 필드가 있고 propertyDesc.[[Writable]]이 false이면, TypeError 예외를 던집니다.
true를 반환합니다.

참고

Proxy 객체의 [[DefineOwnProperty]]는 다음 불변 조건을 강제합니다:

[[DefineOwnProperty]]의 결과는 Boolean 값입니다.
대상 객체가 확장 가능하지 않으면 프로퍼티를 추가할 수 없습니다.
대상 객체에 대응하는 구성 불가능한 자체 프로퍼티가 존재하지 않는 한 프로퍼티를 구성 불가능하게 만들 수 없습니다.
대상 객체에 대응하는 구성 불가능하고 쓰기 불가능한 자체 프로퍼티가 존재하지 않는 한 구성 불가능한 프로퍼티를 쓰기 불가능하게 만들 수 없습니다.
프로퍼티에 대응하는 대상 객체 프로퍼티가 있으면 해당 프로퍼티의 Property Descriptor를 [[DefineOwnProperty]]을 사용하여 대상 객체에 적용할 때 예외를 던지지 않습니다.

10.5.7 `[[HasProperty]]` ( `propertyKey` )

a Proxy exotic object obj의 내부 메서드 [[HasProperty]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "has")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[HasProperty]](propertyKey)를 반환합니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target, propertyKey »))로 둡니다.
boolTrapResult가 false이면, 다음을 수행합니다.
1. targetDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
2. targetDesc가 undefined가 아니면, 다음을 수행합니다.
  1. targetDesc.[[Configurable]]이 false이면, TypeError 예외를 던집니다.
  2. extensibleTarget을 ? IsExtensible(target)로 둡니다.
  3. extensibleTarget이 false이면, TypeError 예외를 던집니다.
boolTrapResult를 반환합니다.

참고

Proxy 객체의 [[HasProperty]]는 다음 불변 조건을 강제합니다:

[[HasProperty]]의 결과는 Boolean 값입니다.
대상 객체의 구성 불가능한 자체 프로퍼티로 존재하는 프로퍼티를 존재하지 않는 것으로 보고할 수 없습니다.
대상 객체의 자체 프로퍼티로 존재하고 대상 객체가 확장 가능하지 않으면 프로퍼티를 존재하지 않는 것으로 보고할 수 없습니다.

10.5.8 `[[Get]]` ( `propertyKey`, `receiver` )

a Proxy exotic object obj의 내부 메서드 [[Get]]. 인수 propertyKey (프로퍼티 키) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "get")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[Get]](propertyKey, receiver)를 반환합니다.
trapResult를 ? Call(trap, handler, « target, propertyKey, receiver »)로 둡니다.
targetDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
targetDesc가 undefined가 아니고 targetDesc.[[Configurable]]이 false이면, 다음을 수행합니다.
1. IsDataDescriptor(targetDesc)가 true이고 targetDesc.[[Writable]]이 false이면, 다음을 수행합니다.
  1. SameValue(trapResult, targetDesc.[[Value]])가 false이면, TypeError 예외를 던집니다.
2. IsAccessorDescriptor(targetDesc)가 true이고 targetDesc.[[Getter]]가 undefined이면, 다음을 수행합니다.
  1. trapResult가 undefined가 아니면, TypeError 예외를 던집니다.
trapResult를 반환합니다.

참고

Proxy 객체의 [[Get]]은 다음 불변 조건을 강제합니다:

대상 객체의 대응하는 프로퍼티가 쓰기 불가능하고 구성 불가능한 자체 데이터 프로퍼티이면 프로퍼티에 대해 보고하는 값은 대상 객체의 대응하는 프로퍼티 값과 같아야 합니다.
대상 객체의 대응하는 프로퍼티가 [[Getter]] 속성으로 undefined를 갖는 구성 불가능한 자체 접근자 프로퍼티이면 프로퍼티에 대해 보고하는 값은 undefined여야 합니다.

10.5.9 `[[Set]]` ( `propertyKey`, `value`, `receiver` )

a Proxy exotic object obj의 내부 메서드 [[Set]]. 인수 propertyKey (프로퍼티 키), value (ECMAScript 언어 값) 및 receiver (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "set")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[Set]](propertyKey, value, receiver)를 반환합니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target, propertyKey, value, receiver »))로 둡니다.
boolTrapResult가 false이면, false를 반환합니다.
targetDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
targetDesc가 undefined가 아니고 targetDesc.[[Configurable]]이 false이면, 다음을 수행합니다.
1. IsDataDescriptor(targetDesc)가 true이고 targetDesc.[[Writable]]이 false이면, 다음을 수행합니다.
  1. SameValue(value, targetDesc.[[Value]])가 false이면, TypeError 예외를 던집니다.
2. IsAccessorDescriptor(targetDesc)가 true이면, 다음을 수행합니다.
  1. targetDesc.[[Setter]]가 undefined이면, TypeError 예외를 던집니다.
true를 반환합니다.

참고

Proxy 객체의 [[Set]]은 다음 불변 조건을 강제합니다:

[[Set]]의 결과는 Boolean 값입니다.
대응하는 대상 객체 프로퍼티가 쓰기 불가능하고 구성 불가능한 자체 데이터 프로퍼티이면 프로퍼티 값을 해당 대상 객체 프로퍼티의 값과 다른 값으로 변경할 수 없습니다.
대응하는 대상 객체 프로퍼티가 [[Setter]] 속성으로 undefined를 갖는 구성 불가능한 자체 접근자 프로퍼티이면 프로퍼티 값을 설정할 수 없습니다.

10.5.10 `[[Delete]]` ( `propertyKey` )

a Proxy exotic object obj의 내부 메서드 [[Delete]]. 인수 propertyKey (프로퍼티 키). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "deleteProperty")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[Delete]](propertyKey)를 반환합니다.
boolTrapResult를 ToBoolean(? Call(trap, handler, « target, propertyKey »))로 둡니다.
boolTrapResult가 false이면, false를 반환합니다.
targetDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
targetDesc가 undefined이면, true를 반환합니다.
targetDesc.[[Configurable]]이 false이면, TypeError 예외를 던집니다.
extensibleTarget을 ? IsExtensible(target)로 둡니다.
extensibleTarget이 false이면, TypeError 예외를 던집니다.
true를 반환합니다.

참고

Proxy 객체의 [[Delete]]는 다음 불변 조건을 강제합니다:

[[Delete]]의 결과는 Boolean 값입니다.
대상 객체의 구성 불가능한 자체 프로퍼티로 존재하는 프로퍼티를 삭제된 것으로 보고할 수 없습니다.
대상 객체의 자체 프로퍼티로 존재하고 대상 객체가 확장 불가능하면 프로퍼티를 삭제된 것으로 보고할 수 없습니다.

10.5.11 `[[OwnPropertyKeys]]` ( )

a Proxy exotic object obj의 내부 메서드 [[OwnPropertyKeys]]. 인수 없음. 반환값: (정상 완료 (값: 리스트 (요소: 프로퍼티 키)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "ownKeys")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? target.[[OwnPropertyKeys]]()를 반환합니다.
trapResultArray를 ? Call(trap, handler, « target »)로 둡니다.
trapResult를 ? CreateListFromArrayLike(trapResultArray, property-key)로 둡니다.
trapResult에 중복 항목이 하나라도 있으면, TypeError 예외를 던집니다.
extensibleTarget을 ? IsExtensible(target)로 둡니다.
targetKeys를 ? target.[[OwnPropertyKeys]]()로 둡니다.
단언: targetKeys는 프로퍼티 키의 List입니다.
단언: targetKeys에는 중복 항목이 없습니다.
targetConfigurableKeys를 새로운 빈 List로 둡니다.
targetNonconfigurableKeys를 새로운 빈 List로 둡니다.
targetKeys의 각 요소 key에 대해 다음을 수행합니다.
1. propertyDesc를 ? target.[[GetOwnProperty]](key)로 둡니다.
2. propertyDesc가 undefined가 아니고 propertyDesc.[[Configurable]]이 false이면, 다음을 수행합니다.
  1. key를 targetNonconfigurableKeys에 추가합니다.
3. 그렇지 않으면,
  1. key를 targetConfigurableKeys에 추가합니다.
extensibleTarget이 true이고 targetNonconfigurableKeys가 비어 있으면, 다음을 수행합니다.
1. trapResult를 반환합니다.
uncheckedResultKeys를 trapResult의 요소를 요소로 갖는 List로 둡니다.
targetNonconfigurableKeys의 각 요소 key에 대해 다음을 수행합니다.
1. uncheckedResultKeys에 key가 포함되어 있지 않으면, TypeError 예외를 던집니다.
2. uncheckedResultKeys에서 key를 제거합니다.
extensibleTarget이 true이면, trapResult를 반환합니다.
targetConfigurableKeys의 각 요소 key에 대해 다음을 수행합니다.
1. uncheckedResultKeys에 key가 포함되어 있지 않으면, TypeError 예외를 던집니다.
2. uncheckedResultKeys에서 key를 제거합니다.
uncheckedResultKeys가 비어 있지 않으면, TypeError 예외를 던집니다.
trapResult를 반환합니다.

참고

Proxy 객체의 [[OwnPropertyKeys]]는 다음 불변 조건을 강제합니다:

[[OwnPropertyKeys]]의 결과는 List입니다.
반환된 List에는 중복 항목이 없습니다.
반환된 List의 각 요소는 프로퍼티 키입니다.
결과 List에는 대상 객체의 모든 구성 불가능한 자체 프로퍼티 키가 포함되어야 합니다.
대상 객체가 확장 가능하지 않으면 결과 List에는 대상 객체의 모든 자체 프로퍼티 키가 포함되어야 하며 다른 값은 포함되어서는 안 됩니다.

10.5.12 `[[Call]]` ( `thisArg`, `argList` )

a Proxy exotic object obj의 내부 메서드 [[Call]]. 인수 thisArg (ECMAScript 언어 값) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "apply")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? Call(target, thisArg, argList)를 반환합니다.
argArray를 CreateArrayFromList(argList)로 둡니다.
? Call(trap, handler, « target, thisArg, argArray »)를 반환합니다.

참고

Proxy 특수 객체는 [[ProxyTarget]] 내부 슬롯의 초기값이 [[Call]] 내부 메서드를 갖는 객체인 경우에만 [[Call]] 내부 메서드를 갖습니다.

10.5.13 `[[Construct]]` ( `argList`, `newTarget` )

a Proxy exotic object obj의 내부 메서드 [[Construct]]. 인수 argList (리스트 (요소: ECMAScript 언어 값)) 및 newTarget (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? ValidateNonRevokedProxy(obj)를 수행합니다.
target을 obj.[[ProxyTarget]]으로 둡니다.
단언: IsConstructor(target)은 true입니다.
handler를 obj.[[ProxyHandler]]로 둡니다.
단언: handler는 Object입니다.
trap을 ? GetMethod(handler, "construct")로 둡니다.
trap이 undefined이면, 다음을 수행합니다.
1. ? Construct(target, argList, newTarget)를 반환합니다.
argArray를 CreateArrayFromList(argList)로 둡니다.
newObj를 ? Call(trap, handler, « target, argArray, newTarget »)로 둡니다.
newObj가 Object가 아니면, TypeError 예외를 던집니다.
newObj를 반환합니다.

참고 1

Proxy 특수 객체는 [[ProxyTarget]] 내부 슬롯의 초기값이 [[Construct]] 내부 메서드를 갖는 객체인 경우에만 [[Construct]] 내부 메서드를 갖습니다.

참고 2

Proxy 객체의 [[Construct]]는 다음 불변 조건을 강제합니다:

[[Construct]]의 결과는 Object여야 합니다.

10.5.14 ValidateNonRevokedProxy ( `proxy` )

추상 연산 ValidateNonRevokedProxy. 인수 proxy (Proxy 특수 객체). 반환값: (정상 완료 (값: unused) 또는 throw 완료). proxy가 해제된 경우 TypeError 예외를 던집니다. 호출되면 다음 단계를 수행한다.

proxy.[[ProxyTarget]]이 null이면, TypeError 예외를 던집니다.
단언: proxy.[[ProxyHandler]]는 null이 아닙니다.
unused를 반환합니다.

10.5.15 ProxyCreate ( `target`, `handler` )

추상 연산 ProxyCreate. 인수 target (ECMAScript 언어 값) 및 handler (ECMAScript 언어 값). 반환값: (정상 완료 (값: Proxy 특수 객체) 또는 throw 완료). 새로운 Proxy 객체의 생성을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

target이 Object가 아니면 TypeError 예외를 던집니다.
handler가 Object가 아니면 TypeError 예외를 던집니다.
proxy를 MakeBasicObject(« [[ProxyHandler]], [[ProxyTarget]] »)로 둡니다.
proxy의 필수 내부 메서드 중 [[Call]] 및 [[Construct]]를 제외한 메서드를 10.5에 지정된 정의로 설정합니다.
IsCallable(target)이 true이면, 다음을 수행합니다.
1. proxy.[[Call]]을 10.5.12에 지정된 대로 설정합니다.
2. IsConstructor(target)가 true이면, 다음을 수행합니다.
  1. proxy.[[Construct]]를 10.5.13에 지정된 대로 설정합니다.
proxy.[[ProxyTarget]]을 target으로 설정합니다.
proxy.[[ProxyHandler]]를 handler로 설정합니다.
proxy를 반환합니다.

11 ECMAScript 언어: 소스 텍스트

11.1 소스 텍스트

구문

SourceCharacter

any Unicode code point

ECMAScript 소스 텍스트는 유니코드 코드 포인트의 시퀀스입니다. 서로게이트 코드 포인트를 포함하여 U+0000부터 U+10FFFF까지의 모든 유니코드 코드 포인트 값은 ECMAScript 문법에서 허용되는 위치의 ECMAScript 소스 텍스트에 나타날 수 있습니다. ECMAScript 소스 텍스트를 저장하고 교환하는 데 실제로 사용되는 인코딩은 이 명세와 관련이 없습니다. 외부 소스 텍스트 인코딩과 관계없이 적합한 ECMAScript 구현체는 소스 텍스트를 각 SourceCharacter가 하나의 유니코드 코드 포인트인 동등한 SourceCharacter 값의 시퀀스인 것처럼 처리합니다. 적합한 ECMAScript 구현체는 소스 텍스트를 정규화하거나 소스 텍스트를 정규화하는 것처럼 동작할 필요가 없습니다.

결합 문자 시퀀스의 구성 요소는 사용자가 전체 시퀀스를 하나의 문자로 생각할 수 있더라도 개별 유니코드 코드 포인트로 처리됩니다.

참고

문자열 리터럴, 정규 표현식 리터럴, 템플릿 리터럴 및 식별자에서는 유니코드 코드 포인트의 숫자 값을 명시적으로 표현하는 유니코드 이스케이프 시퀀스를 사용하여 모든 유니코드 코드 포인트를 표현할 수도 있습니다. 주석 안에서는 이러한 이스케이프 시퀀스가 실질적으로 주석의 일부로서 무시됩니다.

ECMAScript는 유니코드 이스케이프 시퀀스의 동작에서 Java 프로그래밍 언어와 다릅니다. 예를 들어 Java 프로그램에서 유니코드 이스케이프 시퀀스 \u000A가 한 줄 주석 안에 나타나면 줄 종결자로 해석되며(유니코드 코드 포인트 U+000A는 LINE FEED (LF)입니다), 따라서 다음 코드 포인트는 주석의 일부가 아닙니다. 마찬가지로 Java 프로그램의 문자열 리터럴 안에 유니코드 이스케이프 시퀀스 \u000A가 나타나면 역시 줄 종결자로 해석되며 문자열 리터럴 안에서는 허용되지 않습니다. 따라서 문자열 리터럴 값의 일부로 LINE FEED (LF)를 포함하려면 \u000A 대신 \n을 작성해야 합니다. ECMAScript 프로그램에서는 주석 안에 나타나는 유니코드 이스케이프 시퀀스를 절대로 해석하지 않으므로 주석 종료에 영향을 줄 수 없습니다. 마찬가지로 ECMAScript 프로그램의 문자열 리터럴 안에 나타나는 유니코드 이스케이프 시퀀스는 항상 리터럴에 기여하며 줄 종결자 또는 문자열 리터럴을 종료할 수 있는 코드 포인트로 해석되지 않습니다.

11.1.1 Static Semantics: UTF16EncodeCodePoint ( `codePoint` )

추상 연산 UTF16EncodeCodePoint. 인수 codePoint (유니코드 코드 포인트). 반환값: String. 호출되면 다음 단계를 수행한다.

단언: 0 ≤ codePoint ≤ 0x10FFFF입니다.
codePoint ≤ 0xFFFF이면, 숫자 값이 codePoint인 코드 단위로 구성된 String 값을 반환합니다.
cu1을 숫자 값이 floor((codePoint - 0x10000) / 0x400) + 0xD800인 코드 단위로 둡니다.
cu2를 숫자 값이 ((codePoint - 0x10000) modulo 0x400) + 0xDC00인 코드 단위로 둡니다.
cu1과 cu2의 문자열 연결을 반환합니다.

11.1.2 Static Semantics: CodePointsToString ( `text` )

추상 연산 CodePointsToString. 인수 text (a sequence of Unicode code points). 반환값: String. 6.1.4에 설명된 대로 text를 String 값으로 변환합니다. 호출되면 다음 단계를 수행한다.

result를 빈 String으로 둡니다.
text의 각 코드 포인트 codePoint에 대해 다음을 수행합니다.
1. result를 result와 UTF16EncodeCodePoint(codePoint)의 문자열 연결로 설정합니다.
result를 반환합니다.

11.1.3 Static Semantics: UTF16SurrogatePairToCodePoint ( `lead`, `trail` )

추상 연산 UTF16SurrogatePairToCodePoint. 인수 lead (코드 단위) 및 trail (코드 단위). 반환값: 코드 포인트. UTF-16 서로게이트 쌍을 구성하는 두 코드 단위를 하나의 코드 포인트로 변환합니다. 호출되면 다음 단계를 수행한다.

단언: lead는 선행 서로게이트이고 trail은 후행 서로게이트입니다.
codePoint를 (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000으로 둡니다.
코드 포인트 codePoint를 반환합니다.

11.1.4 Static Semantics: CodePointAt ( `string`, `position` )

추상 연산 CodePointAt. 인수 string (String) 및 position (음이 아닌 정수). 반환값: 레코드 (필드: [[CodePoint]] (코드 포인트), [[CodeUnitCount]] (양의 정수), [[IsUnpairedSurrogate]] (Boolean)). 6.1.4에 설명된 대로 string을 UTF-16으로 인코딩된 코드 포인트의 시퀀스로 해석하고 인덱스 position의 코드 단위에서 시작하는 하나의 코드 포인트를 읽습니다. 호출되면 다음 단계를 수행한다.

size를 string의 길이로 둡니다.
단언: position ≥ 0이고 position < size입니다.
first를 string 내 인덱스 position의 코드 단위로 둡니다.
codePoint를 숫자 값이 first의 숫자 값인 코드 포인트로 둡니다.
first가 선행 서로게이트도 후행 서로게이트도 아니면, 다음을 수행합니다.
1. Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]: false }를 반환합니다.
first가 후행 서로게이트이거나 position + 1 = size이면, 다음을 수행합니다.
1. Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]: true }를 반환합니다.
second를 string 내 인덱스 position + 1의 코드 단위로 둡니다.
second가 후행 서로게이트가 아니면, 다음을 수행합니다.
1. Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]: true }를 반환합니다.
codePoint를 UTF16SurrogatePairToCodePoint(first, second)로 설정합니다.
Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]: false }를 반환합니다.

11.1.5 Static Semantics: StringToCodePoints ( `string` )

추상 연산 StringToCodePoints. 인수 string (String). 반환값: 리스트 (요소: 코드 포인트). 6.1.4에 설명된 대로 string을 UTF-16으로 인코딩된 유니코드 텍스트로 해석하여 얻은 유니코드 코드 포인트의 시퀀스를 반환합니다. 호출되면 다음 단계를 수행한다.

codePoints를 새로운 빈 List로 둡니다.
size를 string의 길이로 둡니다.
position을 0으로 둡니다.
position < size인 동안 다음을 반복합니다.
1. codePoint를 CodePointAt(string, position)으로 둡니다.
2. codePoint.[[CodePoint]]를 codePoints에 추가합니다.
3. position을 position + codePoint.[[CodeUnitCount]]로 설정합니다.
codePoints를 반환합니다.

11.1.6 Static Semantics: ParseText ( `sourceText`, `goalSymbol` )

추상 연산 ParseText. 인수 sourceText ((String 또는 a sequence of Unicode code points)) 및 goalSymbol (a nonterminal in one of the ECMAScript grammars). 반환값: (구문 분석 노드 또는 a non-empty List of SyntaxError objects). 호출되면 다음 단계를 수행한다.

sourceText가 String이면 sourceText를 StringToCodePoints(sourceText)로 설정합니다.
goalSymbol을 목표 기호로 사용하여 sourceText의 파싱을 시도하고 파싱 결과에서 모든 조기 오류 조건을 분석합니다. 구현체는 구현체 정의 방식으로 파싱과 조기 오류 감지를 서로 교차하여 수행할 수 있습니다.
파싱에 성공하고 조기 오류가 발견되지 않았으면 파싱 결과로 생성된 파스 트리의 루트에 있는 Parse Node(goalSymbol의 인스턴스)를 반환합니다.
파싱 오류 및/또는 조기 오류를 나타내는 하나 이상의 SyntaxError 객체의 List를 반환합니다. 파싱 오류 또는 조기 오류가 둘 이상 존재하면 목록에 포함되는 오류 객체의 수와 순서는 구현체 정의이지만 최소 하나는 존재해야 합니다.

참고 1

특정 지점에 조기 오류가 있고 그보다 뒤 지점에 구문 오류도 있는 텍스트를 생각해 보시기 바랍니다. 파싱 패스를 수행한 뒤 조기 오류 패스를 수행하는 구현체는 구문 오류를 보고하고 조기 오류 패스로 진행하지 않을 수 있습니다. 두 작업을 서로 교차하여 수행하는 구현체는 조기 오류를 보고하고 구문 오류를 찾기 위한 작업을 진행하지 않을 수 있습니다. 세 번째 구현체는 두 오류를 모두 보고할 수 있습니다. 이러한 동작은 모두 적합합니다.

참고 2

17 절도 참조하시기 바랍니다.

11.2 소스 코드의 타입

ECMAScript 코드에는 네 가지 타입이 있습니다:

전역 코드는 ECMAScript Script로 취급되는 소스 텍스트입니다. 특정 Script의 전역 코드에는 FunctionDeclaration, FunctionExpression, GeneratorDeclaration, GeneratorExpression, AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncGeneratorDeclaration, AsyncGeneratorExpression, MethodDefinition, ArrowFunction, AsyncArrowFunction, ClassDeclaration 또는 ClassExpression의 일부로 파싱되는 소스 텍스트는 포함되지 않습니다.
Eval 코드는 내장 eval 함수에 제공되는 소스 텍스트입니다. 더 정확히 말하면 내장 eval 함수의 매개변수가 String이면 ECMAScript Script로 취급됩니다. 특정 eval 호출의 eval 코드는 해당 Script의 전역 코드 부분입니다.
함수 코드는 ECMAScript 함수 객체의 [[ECMAScriptCode]] 및 [[FormalParameters]] 내부 슬롯(10.2 참조)의 값을 제공하기 위해 파싱되는 소스 텍스트입니다. 특정 ECMAScript 함수의 함수 코드에는 중첩된 FunctionDeclaration, FunctionExpression, GeneratorDeclaration, GeneratorExpression, AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncGeneratorDeclaration, AsyncGeneratorExpression, MethodDefinition, ArrowFunction, AsyncArrowFunction, ClassDeclaration 또는 ClassExpression의 함수 코드로 파싱되는 소스 텍스트는 포함되지 않습니다.

또한 위에서 언급한 소스 텍스트가 다음과 같이 파싱되면:
- FunctionDeclaration 또는 FunctionExpression의 FormalParameters와 FunctionBody,
- GeneratorDeclaration 또는 GeneratorExpression의 FormalParameters와 GeneratorBody,
- AsyncFunctionDeclaration 또는 AsyncFunctionExpression의 FormalParameters와 AsyncFunctionBody, 또는
- AsyncGeneratorDeclaration 또는 AsyncGeneratorExpression의 FormalParameters와 AsyncGeneratorBody,
해당 선언 또는 표현식의 BindingIdentifier(있는 경우)와 일치하는 소스 텍스트도 대응하는 함수의 함수 코드에 포함됩니다.
모듈 코드는 ModuleBody로 제공되는 코드인 소스 텍스트입니다. 이는 모듈이 초기화될 때 직접 평가되는 코드입니다. 특정 모듈의 모듈 코드에는 중첩된 FunctionDeclaration, FunctionExpression, GeneratorDeclaration, GeneratorExpression, AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncGeneratorDeclaration, AsyncGeneratorExpression, MethodDefinition, ArrowFunction, AsyncArrowFunction, ClassDeclaration 또는 ClassExpression의 일부로 파싱되는 소스 텍스트는 포함되지 않습니다.

참고 1

함수 코드는 일반적으로 함수 정의(15.2), 화살표 함수 정의(15.3), 메서드 정의(15.4), 제너레이터 함수 정의(15.5), 비동기 함수 정의(15.8), 비동기 제너레이터 함수 정의(15.6) 및 비동기 화살표 함수(15.9)의 본문으로 제공됩니다. 함수 코드는 Function 생성자(20.2.1.1), GeneratorFunction 생성자(27.6.1.1), AsyncFunction 생성자(27.10.1.1) 및 AsyncGeneratorFunction 생성자(27.7.1.1)의 인수에서도 파생됩니다.

참고 2

함수 코드에 BindingIdentifier를 포함하는 실질적인 효과는 둘러싸는 코드가 엄격 모드 코드가 아니더라도 본문에 Use Strict 지시문가 포함된 함수의 이름인 BindingIdentifier에 엄격 모드 코드의 조기 오류가 적용된다는 것입니다.

11.2.1 지시문 프롤로그와 Use Strict 지시문

지시문 프롤로그는 FunctionBody, ScriptBody 또는 ModuleBody의 처음 StatementListItem 또는 ModuleItem으로 나타나는 ExpressionStatement 중 각 ExpressionStatement가 전체적으로 StringLiteral 토큰과 그 뒤의 세미콜론으로만 구성된 가장 긴 시퀀스입니다. 세미콜론은 명시적으로 나타나거나 자동 세미콜론 삽입(12.10)에 의해 삽입될 수 있습니다. 지시문 프롤로그는 빈 시퀀스일 수 있습니다.

Use Strict 지시문은 지시문 프롤로그 안에서 StringLiteral이 정확한 코드 포인트 시퀀스 "use strict" 또는 'use strict' 중 하나인 ExpressionStatement입니다. Use Strict 지시문에는 EscapeSequence 또는 LineContinuation을 포함할 수 없습니다.

지시문 프롤로그에는 둘 이상의 Use Strict 지시문이 포함될 수 있습니다. 그러나 이 경우 구현체는 경고를 표시할 수 있습니다.

참고

지시문 프롤로그의 ExpressionStatement는 이를 포함하는 생성 규칙을 평가하는 동안 정상적으로 평가됩니다. 구현체는 Use Strict 지시문이 아니면서 지시문 프롤로그에 나타나는 ExpressionStatement에 구현체별 의미를 정의할 수 있습니다. 적절한 알림 메커니즘이 존재하는 경우 구현체는 지시문 프롤로그에서 Use Strict 지시문이 아니며 구현체가 정의한 의미도 없는 ExpressionStatement를 발견하면 경고를 표시해야 합니다.

11.2.2 엄격 모드 코드

ECMAScript 구문 단위는 제한 없는 모드 또는 엄격 모드 구문과 의미론(4.3.2)을 사용하여 처리할 수 있습니다. 다음 상황에서 코드는 엄격 모드 코드로 해석됩니다:

전역 코드가 Use Strict 지시문을 포함하는 지시문 프롤로그로 시작하면 엄격 모드 코드입니다.
모듈 코드는 항상 엄격 모드 코드입니다.
ClassDeclaration 또는 ClassExpression의 모든 부분은 엄격 모드 코드입니다.
Eval 코드가 Use Strict 지시문을 포함하는 지시문 프롤로그로 시작하거나 eval 호출이 엄격 모드 코드에 포함된 직접 eval이면 엄격 모드 코드입니다.
연결된 FunctionDeclaration, FunctionExpression, GeneratorDeclaration, GeneratorExpression, AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncGeneratorDeclaration, AsyncGeneratorExpression, MethodDefinition, ArrowFunction 또는 AsyncArrowFunction이 엄격 모드 코드에 포함되어 있거나 함수의 [[ECMAScriptCode]] 내부 슬롯 값을 생성하는 코드가 Use Strict 지시문을 포함하는 지시문 프롤로그로 시작하면 함수 코드는 엄격 모드 코드입니다.
내장 Function, Generator, AsyncFunction 및 AsyncGenerator 생성자에 인수로 제공되는 함수 코드는 마지막 인수가 String이고 이를 처리했을 때 Use Strict 지시문을 포함하는 지시문 프롤로그로 시작하는 FunctionBody이면 엄격 모드 코드입니다.

엄격 모드 코드가 아닌 ECMAScript 코드를 비엄격 코드라고 합니다.

11.2.2.1 Static Semantics: IsStrict ( `parseNode` )

추상 연산 IsStrict. 인수 parseNode (구문 분석 노드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

parseNode와 일치하는 소스 텍스트가 엄격 모드 코드이면, true를 반환합니다.
false를 반환합니다.

11.2.3 비ECMAScript 함수

ECMAScript 구현체는 ECMAScript 소스 텍스트가 아닌 호스트 정의 형식의 실행 가능 코드로 평가 동작이 표현되는 함수 특수 객체의 평가를 지원할 수 있습니다. 함수 객체가 ECMAScript 코드 안에서 정의되었는지 또는 내장 함수인지는 이러한 함수 객체를 호출하거나 이러한 함수 객체에 의해 호출되는 ECMAScript 코드의 관점에서는 관찰할 수 없습니다.

12 ECMAScript 언어: 어휘 문법

ECMAScript Script 또는 Module의 소스 텍스트는 먼저 토큰, 줄 종결자, 주석 또는 공백인 입력 요소의 시퀀스로 변환됩니다. 소스 텍스트는 왼쪽에서 오른쪽으로 스캔되며, 가능한 가장 긴 코드 포인트 시퀀스를 다음 입력 요소로 반복해서 취합니다.

어휘 입력 요소를 식별하는 방식이 해당 입력 요소를 소비하는 구문 문법 문맥에 따라 달라지는 상황이 여러 가지 있습니다. 따라서 어휘 문법에는 여러 목표 기호가 필요합니다. InputElementHashbangOrRegExp 목표는 Script 또는 Module의 시작 부분에서 사용됩니다. InputElementRegExpOrTemplateTail 목표는 RegularExpressionLiteral, TemplateMiddle 또는 TemplateTail이 허용되는 구문 문법 문맥에서 사용됩니다. InputElementRegExp 목표 기호는 RegularExpressionLiteral은 허용되지만 TemplateMiddle과 TemplateTail은 모두 허용되지 않는 모든 구문 문법 문맥에서 사용됩니다. InputElementTemplateTail 목표는 TemplateMiddle 또는 TemplateTail은 허용되지만 RegularExpressionLiteral은 허용되지 않는 모든 구문 문법 문맥에서 사용됩니다. 그 밖의 모든 문맥에서는 InputElementDiv를 어휘 목표 기호로 사용합니다.

참고

여러 어휘 목표를 사용하면 자동 세미콜론 삽입에 영향을 주는 어휘적 모호성이 발생하지 않습니다. 예를 들어 선행 나눗셈 또는 나눗셈 할당과 선행 RegularExpressionLiteral이 모두 허용되는 구문 문법 문맥은 없습니다. 세미콜론 삽입(12.10 참조)은 이에 영향을 주지 않습니다. 다음과 같은 예에서:

a = b
/hi/g.exec(c).map(d);

LineTerminator 뒤의 첫 번째 비공백, 비주석 코드 포인트가 U+002F (SOLIDUS)이고 구문 문맥이 나눗셈 또는 나눗셈 할당을 허용하면 LineTerminator에 세미콜론을 삽입하지 않습니다. 즉, 위 예제는 다음과 동일하게 해석됩니다:

a = b / hi / g.exec(c).map(d);

구문

RegularExpressionLiteral

InputElementRegExpOrTemplateTail

RegularExpressionLiteral

TemplateSubstitutionTail

InputElementTemplateTail

TemplateSubstitutionTail

InputElementHashbangOrRegExp

RegularExpressionLiteral

12.1 유니코드 형식 제어 문자

유니코드 형식 제어 문자(즉, LEFT-TO-RIGHT MARK 또는 RIGHT-TO-LEFT MARK와 같은 유니코드 문자 데이터베이스의 “Cf” 범주에 속하는 문자)는 마크업 언어와 같은 상위 수준 프로토콜이 없는 경우 일정 범위의 텍스트 형식을 제어하는 데 사용하는 제어 코드입니다.

소스 텍스트에서 형식 제어 문자를 허용하면 편집과 표시가 편리해집니다. 모든 형식 제어 문자는 주석과 문자열 리터럴, 템플릿 리터럴 및 정규 표현식 리터럴 안에서 사용할 수 있습니다.

U+FEFF (ZERO WIDTH NO-BREAK SPACE)는 주로 텍스트 시작 부분에서 해당 텍스트가 유니코드임을 표시하고 텍스트의 인코딩과 바이트 순서를 감지할 수 있도록 하는 데 사용하는 형식 제어 문자입니다. 이러한 목적으로 사용하는 <ZWNBSP> 문자는 파일 연결 등의 결과로 텍스트 시작 부분 이후에도 나타날 수 있습니다. ECMAScript 소스 텍스트에서 <ZWNBSP> 코드 포인트는 주석, 문자열 리터럴, 템플릿 리터럴 및 정규 표현식 리터럴 바깥에서는 공백 문자로 취급됩니다(12.2 참조).

12.2 공백

공백 코드 포인트는 소스 텍스트의 가독성을 높이고 토큰(더 이상 나눌 수 없는 어휘 단위)을 서로 분리하는 데 사용되지만 그 밖에는 중요하지 않습니다. 공백 코드 포인트는 임의의 두 토큰 사이와 입력의 시작 또는 끝에 나타날 수 있습니다. 공백 코드 포인트는 StringLiteral, RegularExpressionLiteral, Template 또는 TemplateSubstitutionTail 안에 나타날 수 있으며, 이 경우 리터럴 값의 일부를 구성하는 의미 있는 코드 포인트로 간주됩니다. Comment 안에도 나타날 수 있지만 그 밖의 다른 종류의 토큰 안에는 나타날 수 없습니다.

ECMAScript 공백 코드 포인트는 표 31에 나열되어 있습니다.

표 31: 공백 코드 포인트

코드 포인트	이름	약어
`U+0009`	CHARACTER TABULATION	<TAB>
`U+000B`	LINE TABULATION	<VT>
`U+000C`	FORM FEED (FF)	<FF>
`U+FEFF`	ZERO WIDTH NO-BREAK SPACE	<ZWNBSP>
일반 범주 “Space_Separator”의 모든 코드 포인트		<USP>

참고 1

U+0020 (SPACE) 및 U+00A0 (NO-BREAK SPACE) 코드 포인트는 <USP>의 일부입니다.

참고 2

표 31에 나열된 코드 포인트를 제외하면 ECMAScript WhiteSpace는 유니코드 “White_Space” 프로퍼티를 갖지만 일반 범주 “Space_Separator” (“Zs”)로 분류되지 않는 모든 코드 포인트를 의도적으로 제외합니다.

구문

WhiteSpace

<TAB>

<VT>

<FF>

<USP>

12.3 줄 종결자

공백 코드 포인트와 마찬가지로 줄 종결자 코드 포인트는 소스 텍스트의 가독성을 높이고 토큰(더 이상 나눌 수 없는 어휘 단위)을 서로 분리하는 데 사용됩니다. 그러나 공백 코드 포인트와 달리 줄 종결자는 구문 문법의 동작에 일부 영향을 줍니다. 일반적으로 줄 종결자는 임의의 두 토큰 사이에 나타날 수 있지만 구문 문법에 의해 금지되는 위치도 일부 있습니다. 줄 종결자는 자동 세미콜론 삽입 과정(12.10)에도 영향을 줍니다. 줄 종결자는 StringLiteral, Template 또는 TemplateSubstitutionTail을 제외한 어떤 토큰 안에도 나타날 수 없습니다. <LF> 및 <CR> 줄 종결자는 LineContinuation의 일부인 경우를 제외하면 StringLiteral 토큰 안에 나타날 수 없습니다.

줄 종결자는 MultiLineComment 안에 나타날 수 있지만 SingleLineComment 안에는 나타날 수 없습니다.

줄 종결자는 정규 표현식의 \s 클래스와 일치하는 공백 코드 포인트 집합에 포함됩니다.

ECMAScript 줄 종결자 코드 포인트는 표 32에 나열되어 있습니다.

표 32: 줄 종결자 코드 포인트

코드 포인트	유니코드 이름	약어
`U+000A`	LINE FEED (LF)	<LF>
`U+000D`	CARRIAGE RETURN (CR)	<CR>
`U+2028`	LINE SEPARATOR	<LS>
`U+2029`	PARAGRAPH SEPARATOR	<PS>

표 32에 있는 유니코드 코드 포인트만 줄 종결자로 취급됩니다. 그 밖의 개행 또는 줄바꿈 유니코드 코드 포인트는 줄 종결자로 취급되지 않지만 표 31에 나열된 요구 사항을 충족하면 공백으로 취급됩니다.

구문

LineTerminator

<LF>

<CR>

<LS>

<PS>

LineTerminatorSequence

<LF>

<CR>

[lookahead ≠ <LF>]

<LS>

<PS>

<CR>

<LF>

참고

생성 규칙 LineTerminatorSequence :: <CR> <LF> 은 진단에서 줄 번호를 보고할 때와 같이 전체가 하나의 줄 종결자로 동작해야 하는 코드 포인트 시퀀스와 일치합니다.

12.4 주석

주석은 한 줄 또는 여러 줄일 수 있습니다. 여러 줄 주석은 중첩할 수 없습니다.

한 줄 주석에는 LineTerminator 코드 포인트를 제외한 모든 유니코드 코드 포인트가 포함될 수 있고, 토큰은 항상 가능한 한 길게 취한다는 일반 규칙이 있으므로 한 줄 주석은 항상 // 표시부터 줄 끝까지의 모든 코드 포인트로 구성됩니다. 그러나 줄 끝의 LineTerminator는 한 줄 주석의 일부로 간주되지 않습니다. 이는 어휘 문법에서 별도로 인식되며 구문 문법의 입력 요소 스트림 일부가 됩니다. 이 점은 매우 중요합니다. 한 줄 주석의 존재 여부가 자동 세미콜론 삽입 과정(12.10 참조)에 영향을 주지 않음을 의미하기 때문입니다.

주석은 공백처럼 동작하며 버려집니다. 단, MultiLineComment에 줄 종결자 코드 포인트가 포함되어 있으면 구문 문법으로 파싱할 때 전체 주석을 LineTerminator로 간주합니다.

구문

MultiLineCommentChars

opt

MultiLineCommentChars

MultiLineNotAsteriskChar

MultiLineCommentChars

opt

PostAsteriskCommentChars

opt

PostAsteriskCommentChars

MultiLineNotForwardSlashOrAsteriskChar

MultiLineCommentChars

opt

PostAsteriskCommentChars

opt

MultiLineNotAsteriskChar

SourceCharacter

but not *

MultiLineNotForwardSlashOrAsteriskChar

SourceCharacter

but not one of / or *

SingleLineComment

SingleLineCommentChars

opt

SingleLineCommentChars

SingleLineCommentChar

SingleLineCommentChars

opt

SingleLineCommentChar

SourceCharacter

but not LineTerminator

이 절의 여러 생성 규칙에는 B.1.1 절에서 대체 정의가 제공됩니다.

12.5 Hashbang 주석

Hashbang 주석은 위치에 민감하며 다른 종류의 주석과 마찬가지로 구문 문법의 입력 요소 스트림에서 제거됩니다.

구문

HashbangComment

SingleLineCommentChars

opt

12.6 토큰

구문

참고

DivPunctuator, RegularExpressionLiteral, RightBracePunctuator 및 TemplateSubstitutionTail 생성 규칙은 CommonToken 생성 규칙에 포함되지 않은 추가 토큰을 파생합니다.

12.7 이름과 키워드

IdentifierName과 ReservedWord는 유니코드 표준 부속서 #31, Identifier and Pattern Syntax에 제시된 기본 식별자 구문을 약간 수정하여 해석하는 토큰입니다. ReservedWord는 IdentifierName의 열거된 부분집합입니다. 구문 문법은 Identifier를 ReservedWord가 아닌 IdentifierName으로 정의합니다. 유니코드 식별자 문법은 유니코드 표준에서 명시한 문자 프로퍼티를 기반으로 합니다. 최신 버전의 유니코드 표준에서 지정된 범주에 속하는 유니코드 코드 포인트는 모든 적합한 ECMAScript 구현체에서 해당 범주에 속하는 것으로 취급해야 합니다. ECMAScript 구현체는 이후 버전의 유니코드 표준에서 정의된 식별자 코드 포인트를 인식할 수 있습니다.

참고 1

이 표준은 특정 코드 포인트의 추가를 명시합니다. U+0024 (DOLLAR SIGN) 및 U+005F (LOW LINE)은 IdentifierName의 어느 위치에서든 허용됩니다.

구문

UnicodeEscapeSequence

IdentifierPart

IdentifierPartChar

UnicodeEscapeSequence

one of

any Unicode code point with the Unicode property “ID_Start”

UnicodeIDContinue

any Unicode code point with the Unicode property “ID_Continue”

비단말 기호 UnicodeEscapeSequence의 정의는 12.9.4에 제시되어 있습니다.

참고 2

비단말 기호 IdentifierPart는 UnicodeIDContinue를 통해 _를 파생합니다.

참고 3

유니코드 프로퍼티 “ID_Start” 및 “ID_Continue”을 갖는 코드 포인트 집합에는 각각 유니코드 프로퍼티 “Other_ID_Start” 및 “Other_ID_Continue”을 갖는 코드 포인트가 포함됩니다.

12.7.1 식별자 이름

IdentifierName에서는 유니코드 이스케이프 시퀀스가 허용되며, 해당 시퀀스는 UnicodeEscapeSequence의 IdentifierCodePoint와 같은 하나의 유니코드 코드 포인트에 기여합니다. UnicodeEscapeSequence 앞의 \는 어떤 코드 포인트에도 기여하지 않습니다. UnicodeEscapeSequence를 사용하여 그렇지 않았다면 유효하지 않았을 코드 포인트를 IdentifierName에 기여할 수는 없습니다. 다시 말해 \ UnicodeEscapeSequence 시퀀스를 그것이 기여하는 SourceCharacter로 교체하더라도 그 결과는 원래 IdentifierName과 정확히 동일한 SourceCharacter 요소 시퀀스를 갖는 유효한 IdentifierName이어야 합니다. 이 명세에서 IdentifierName을 해석할 때는 특정 코드 포인트를 기여하는 데 이스케이프 시퀀스가 사용되었는지 여부와 관계없이 실제 코드 포인트를 기반으로 합니다.

유니코드 표준에 따라 정규적으로 동등한 두 IdentifierName이라도 각 UnicodeEscapeSequence를 교체한 후 정확히 동일한 코드 포인트 시퀀스로 표현되지 않으면 같지 않습니다.

12.7.1.1 Static Semantics: 조기 오류

IdentifierStart

UnicodeEscapeSequence

UnicodeEscapeSequence의 IdentifierCodePoint가 IdentifierStartChar 어휘 문법 생성 규칙과 일치하는 유니코드 코드 포인트가 아니면 Syntax Error입니다.

IdentifierPart

UnicodeEscapeSequence

UnicodeEscapeSequence의 IdentifierCodePoint가 IdentifierPartChar 어휘 문법 생성 규칙과 일치하는 유니코드 코드 포인트가 아니면 Syntax Error입니다.

12.7.1.2 Static Semantics: IdentifierCodePoints

구문 지향 연산 IdentifierCodePoints. 인수 없음. 반환값: 리스트 (요소: 코드 포인트). 다음 생성 규칙별로 정의된다.

IdentifierName

IdentifierStart

codePoint를 IdentifierStart의 IdentifierCodePoint로 둡니다.
« codePoint »를 반환합니다.

IdentifierName

IdentifierPart

codePoints를 파생된 IdentifierName의 IdentifierCodePoints로 둡니다.
codePoint를 IdentifierPart의 IdentifierCodePoint로 둡니다.
codePoints와 « codePoint »의 목록 연결을 반환합니다.

12.7.1.3 Static Semantics: IdentifierCodePoint

구문 지향 연산 IdentifierCodePoint. 인수 없음. 반환값: 코드 포인트. 다음 생성 규칙별로 정의된다.

IdentifierStart

IdentifierStartChar

IdentifierStartChar와 일치하는 코드 포인트를 반환합니다.

IdentifierPart

IdentifierPartChar

IdentifierPartChar와 일치하는 코드 포인트를 반환합니다.

UnicodeEscapeSequence

Hex4Digits

숫자 값이 Hex4Digits의 MV인 코드 포인트를 반환합니다.

UnicodeEscapeSequence

CodePoint

}

숫자 값이 CodePoint의 MV인 코드 포인트를 반환합니다.

12.7.2 키워드와 예약어

키워드는 IdentifierName과 일치하면서 구문적 용도도 갖는 토큰입니다. 즉, 일부 구문 생성 규칙에서 fixed width 글꼴의 리터럴로 나타납니다. ECMAScript의 키워드에는 if, while, async, await 등이 있습니다.

예약어는 식별자로 사용할 수 없는 IdentifierName입니다. 많은 키워드가 예약어이지만 그렇지 않은 키워드도 있으며, 특정 문맥에서만 예약되는 키워드도 있습니다. if와 while은 예약어입니다. await는 async 함수와 모듈 안에서만 예약됩니다. async는 예약되지 않으며 변수 이름이나 문 레이블로 제한 없이 사용할 수 있습니다.

이 명세는 문법 생성 규칙과 조기 오류 규칙을 조합하여 어떤 이름이 유효한 식별자이고 어떤 이름이 예약어인지 명시합니다. 아래 ReservedWord 목록의 모든 토큰은 await와 yield를 제외하면 무조건 예약됩니다. await와 yield의 예외는 매개변수화된 구문 생성 규칙을 사용하여 13.1에 명시되어 있습니다. 마지막으로 여러 조기 오류 규칙이 유효한 식별자의 집합을 제한합니다. 13.1.1, 14.3.1.1, 14.7.5.1 및 15.7.1를 참조하시기 바랍니다. 요약하면 식별자 이름에는 다음 다섯 범주가 있습니다:

Math, window, toString, _처럼 항상 식별자로 허용되며 키워드는 아닌 이름;
아래에 나열된 ReservedWord 중 await와 yield를 제외하고 절대로 식별자로 허용되지 않는 이름;
문맥에 따라 식별자로 허용되는 이름, 즉 await와 yield;
엄격 모드 코드에서 문맥에 따라 식별자로 허용되지 않는 이름: let, static, implements, interface, package, private, protected, public;
항상 식별자로 허용되지만 Identifier가 허용되지 않는 특정 구문 생성 규칙의 위치에서 키워드로도 나타나는 이름: as, async, from, get, meta, of, set, target.

조건부 키워드 또는 문맥적 키워드라는 용어는 마지막 세 범주에 속하여 일부 문맥에서는 식별자로, 다른 문맥에서는 키워드로 사용할 수 있는 키워드를 가리키는 데 사용되기도 합니다.

구문

ReservedWord

one of

await

break

case

catch

class

const

continue

debugger

default

delete

else

enum

export

extends

false

finally

for

function

import

instanceof

new

null

return

super

switch

this

throw

true

try

typeof

var

void

while

with

yield

참고 1

5.1.5에 따라 문법의 키워드는 특정 SourceCharacter 요소의 리터럴 시퀀스와 일치합니다. 키워드 안의 코드 포인트를 \ UnicodeEscapeSequence로 표현할 수 없습니다.

IdentifierName에는 \ UnicodeEscapeSequence가 포함될 수 있지만 els\u{65}라고 작성하여 “else”라는 이름의 변수를 선언할 수는 없습니다. 13.1.1의 조기 오류 규칙은 예약어와 동일한 StringValue를 갖는 식별자를 배제합니다.

참고 2

enum은 현재 이 명세에서 키워드로 사용되지 않습니다. 이는 향후 언어 확장에서 키워드로 사용하기 위해 따로 예약해 둔 미래 예약어입니다.

마찬가지로 implements, interface, package, private, protected, public은 엄격 모드 코드에서 미래 예약어입니다.

참고 3

arguments와 eval이라는 이름은 키워드가 아니지만 엄격 모드 코드에서는 일부 제한을 받습니다. 13.1.1, 8.6.4, 15.2.1, 15.5.1, 15.6.1 및 15.8.1를 참조하시기 바랍니다.

12.8 구두점

구문

Punctuator

OptionalChainingPunctuator

OtherPunctuator

OptionalChainingPunctuator

[lookahead ∉ DecimalDigit]

OtherPunctuator

one of

{

(

)

[

]

...

;

===

!==

>>>

**=

<<=

>>=

>>>=

&&=

||=

??=

DivPunctuator

RightBracePunctuator

}

12.9 리터럴

12.9.1 Null 리터럴

구문

NullLiteral

null

12.9.2 Boolean 리터럴

구문

BooleanLiteral

true

false

12.9.3 숫자 리터럴

구문

NumericLiteralSeparator

NumericLiteral

DecimalLiteral

DecimalBigIntegerLiteral

NonDecimalIntegerLiteral

[+Sep]

NonDecimalIntegerLiteral

[+Sep]

BigIntLiteralSuffix

LegacyOctalIntegerLiteral

DecimalBigIntegerLiteral

BigIntLiteralSuffix

NonZeroDigit

DecimalDigits

[+Sep]

opt

BigIntLiteralSuffix

NonZeroDigit

NumericLiteralSeparator

DecimalDigits

[+Sep]

BigIntLiteralSuffix

NonDecimalIntegerLiteral

[Sep]

[?Sep]

[?Sep]

[?Sep]

DecimalIntegerLiteral

DecimalDigits

[+Sep]

opt

ExponentPart

[+Sep]

opt

DecimalDigits

[+Sep]

ExponentPart

[+Sep]

opt

DecimalIntegerLiteral

ExponentPart

[+Sep]

opt

DecimalIntegerLiteral

DecimalDigit

NonZeroDigit

NumericLiteralSeparator

opt

DecimalDigits

[+Sep]

NonOctalDecimalIntegerLiteral

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

one of

one of

[Sep]

[?Sep]

one of

[Sep]

[?Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

one of

[Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

OctalDigit

LegacyOctalIntegerLiteral

OctalDigit

LegacyOctalIntegerLiteral

OctalDigit

NonOctalDecimalIntegerLiteral

LegacyOctalLikeDecimalDigits

opt

NonOctalDigit

NonOctalDecimalIntegerLiteral

DecimalDigit

LegacyOctalLikeDecimalDigits

OctalDigit

LegacyOctalLikeDecimalDigits

one of

one of

[Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

HexDigit

one of

NumericLiteral 바로 뒤에 오는 SourceCharacter는 IdentifierStart 또는 DecimalDigit이어서는 안 됩니다.

참고

예를 들어 3in은 오류이며 두 입력 요소 3과 in이 아닙니다.

12.9.3.1 Static Semantics: 조기 오류

NumericLiteral

LegacyOctalIntegerLiteral

DecimalIntegerLiteral

NonOctalDecimalIntegerLiteral

IsStrict(this production)이 true이면 Syntax Error입니다.

참고

비엄격 코드에서 이 구문은 Legacy입니다.

12.9.3.2 Static Semantics: MV

숫자 리터럴은 Number 타입 또는 BigInt 타입의 값을 나타냅니다.

DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits 의 MV는 DecimalIntegerLiteral의 MV + (DecimalDigits의 MV × 10^-n)이며, 여기서 n은 NumericLiteralSeparator의 모든 출현을 제외한 DecimalDigits의 코드 포인트 수입니다.
DecimalLiteral :: DecimalIntegerLiteral . ExponentPart 의 MV는 DecimalIntegerLiteral의 MV × 10^e이며, 여기서 e는 ExponentPart의 MV입니다.
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits ExponentPart 의 MV는 (DecimalIntegerLiteral의 MV + (DecimalDigits의 MV × 10^-n)) × 10^e이며, 여기서 n은 NumericLiteralSeparator의 모든 출현을 제외한 DecimalDigits의 코드 포인트 수이고 e는 ExponentPart의 MV입니다.
DecimalLiteral :: . DecimalDigits 의 MV는 DecimalDigits의 MV × 10^-n이며, 여기서 n은 NumericLiteralSeparator의 모든 출현을 제외한 DecimalDigits의 코드 포인트 수입니다.
DecimalLiteral :: . DecimalDigits ExponentPart 의 MV는 DecimalDigits의 MV × 10^{e - n}이며, 여기서 n은 NumericLiteralSeparator의 모든 출현을 제외한 DecimalDigits의 코드 포인트 수이고, e는 ExponentPart의 MV입니다.
DecimalLiteral :: DecimalIntegerLiteral ExponentPart 의 MV는 DecimalIntegerLiteral의 MV × 10^e이며, 여기서 e는 ExponentPart의 MV입니다.
DecimalIntegerLiteral :: 0 의 MV는 0입니다.
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparatoropt DecimalDigits 의 MV는 (NonZeroDigit의 MV × 10ⁿ) + DecimalDigits의 MV이며, 여기서 n은 NumericLiteralSeparator의 모든 출현을 제외한 DecimalDigits의 코드 포인트 수입니다.
DecimalDigits :: DecimalDigits DecimalDigit 의 MV는 (DecimalDigits의 MV × 10) + DecimalDigit의 MV입니다.
DecimalDigits :: DecimalDigits NumericLiteralSeparator DecimalDigit 의 MV는 (DecimalDigits의 MV × 10) + DecimalDigit의 MV입니다.
ExponentPart :: ExponentIndicator SignedInteger 의 MV는 SignedInteger의 MV입니다.
SignedInteger :: - DecimalDigits 의 MV는 DecimalDigits의 MV에 음의 부호를 붙인 값입니다.
DecimalDigit :: 0 또는 HexDigit :: 0 또는 OctalDigit :: 0 또는 LegacyOctalEscapeSequence :: 0 또는 BinaryDigit :: 0 의 MV는 0입니다.
DecimalDigit :: 1 또는 NonZeroDigit :: 1 또는 HexDigit :: 1 또는 OctalDigit :: 1 또는 BinaryDigit :: 1 의 MV는 1입니다.
DecimalDigit :: 2 또는 NonZeroDigit :: 2 또는 HexDigit :: 2 또는 OctalDigit :: 2 의 MV는 2입니다.
DecimalDigit :: 3 또는 NonZeroDigit :: 3 또는 HexDigit :: 3 또는 OctalDigit :: 3 의 MV는 3입니다.
DecimalDigit :: 4 또는 NonZeroDigit :: 4 또는 HexDigit :: 4 또는 OctalDigit :: 4 의 MV는 4입니다.
DecimalDigit :: 5 또는 NonZeroDigit :: 5 또는 HexDigit :: 5 또는 OctalDigit :: 5 의 MV는 5입니다.
DecimalDigit :: 6 또는 NonZeroDigit :: 6 또는 HexDigit :: 6 또는 OctalDigit :: 6 의 MV는 6입니다.
DecimalDigit :: 7 또는 NonZeroDigit :: 7 또는 HexDigit :: 7 또는 OctalDigit :: 7 의 MV는 7입니다.
DecimalDigit :: 8 또는 NonZeroDigit :: 8 또는 NonOctalDigit :: 8 또는 HexDigit :: 8 의 MV는 8입니다.
DecimalDigit :: 9 또는 NonZeroDigit :: 9 또는 NonOctalDigit :: 9 또는 HexDigit :: 9 의 MV는 9입니다.
HexDigit :: a 또는 HexDigit :: A 의 MV는 10입니다.
HexDigit :: b 또는 HexDigit :: B 의 MV는 11입니다.
HexDigit :: c 또는 HexDigit :: C 의 MV는 12입니다.
HexDigit :: d 또는 HexDigit :: D 의 MV는 13입니다.
HexDigit :: e 또는 HexDigit :: E 의 MV는 14입니다.
HexDigit :: f 또는 HexDigit :: F 의 MV는 15입니다.
BinaryDigits :: BinaryDigits BinaryDigit 의 MV는 (BinaryDigits의 MV × 2) + BinaryDigit의 MV입니다.
BinaryDigits :: BinaryDigits NumericLiteralSeparator BinaryDigit 의 MV는 (BinaryDigits의 MV × 2) + BinaryDigit의 MV입니다.
OctalDigits :: OctalDigits OctalDigit 의 MV는 (OctalDigits의 MV × 8) + OctalDigit의 MV입니다.
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit 의 MV는 (OctalDigits의 MV × 8) + OctalDigit의 MV입니다.
LegacyOctalIntegerLiteral :: LegacyOctalIntegerLiteral OctalDigit 의 MV는 (LegacyOctalIntegerLiteral의 MV × 8) + OctalDigit의 MV입니다.
NonOctalDecimalIntegerLiteral :: 0 LegacyOctalLikeDecimalDigits NonOctalDigit 의 MV는 (LegacyOctalLikeDecimalDigits의 MV × 10) + NonOctalDigit의 MV입니다.
NonOctalDecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral DecimalDigit 의 MV는 (NonOctalDecimalIntegerLiteral의 MV × 10) + DecimalDigit의 MV입니다.
LegacyOctalLikeDecimalDigits :: LegacyOctalLikeDecimalDigits OctalDigit 의 MV는 (LegacyOctalLikeDecimalDigits의 MV × 10) + OctalDigit의 MV입니다.
HexDigits :: HexDigits HexDigit 의 MV는 (HexDigits의 MV × 16) + HexDigit의 MV입니다.
HexDigits :: HexDigits NumericLiteralSeparator HexDigit 의 MV는 (HexDigits의 MV × 16) + HexDigit의 MV입니다.

12.9.3.3 Static Semantics: NumericValue

구문 지향 연산 NumericValue. 인수 없음. 반환값: (Number 또는 BigInt). 다음 생성 규칙별로 정의된다.

NumericLiteral

DecimalLiteral

RoundMVResult(DecimalLiteral의 MV)를 반환합니다.

NumericLiteral

NonDecimalIntegerLiteral

𝔽(NonDecimalIntegerLiteral의 MV)를 반환합니다.

NumericLiteral

LegacyOctalIntegerLiteral

𝔽(LegacyOctalIntegerLiteral의 MV)를 반환합니다.

NumericLiteral

NonDecimalIntegerLiteral

BigIntLiteralSuffix

NonDecimalIntegerLiteral의 MV에 대한 BigInt 값을 반환합니다.

DecimalBigIntegerLiteral

BigIntLiteralSuffix

0_ℤ을 반환합니다.

DecimalBigIntegerLiteral

NonZeroDigit

BigIntLiteralSuffix

NonZeroDigit의 MV에 대한 BigInt 값을 반환합니다.

DecimalBigIntegerLiteral

NumericLiteralSeparator

DecimalDigits

BigIntLiteralSuffix

n을 NumericLiteralSeparator의 모든 출현을 제외한 DecimalDigits의 코드 포인트 수로 설정합니다.
mv를 (NonZeroDigit의 MV × 10ⁿ) + DecimalDigits의 MV로 설정합니다.
ℤ(mv)를 반환합니다.

12.9.4 String 리터럴

참고 1

문자열 리터럴은 작은따옴표 또는 큰따옴표로 둘러싸인 0개 이상의 유니코드 코드 포인트입니다. 유니코드 코드 포인트는 이스케이프 시퀀스로 나타낼 수도 있습니다. 닫는 따옴표 코드 포인트, U+005C (REVERSE SOLIDUS), U+000D (CARRIAGE RETURN), U+000A (LINE FEED)를 제외한 모든 코드 포인트는 문자열 리터럴에 그대로 나타날 수 있습니다. 모든 코드 포인트는 이스케이프 시퀀스의 형태로 나타날 수 있습니다. 문자열 리터럴은 ECMAScript String 값으로 평가됩니다. 이러한 String 값을 생성할 때 유니코드 코드 포인트는 11.1.1에 정의된 대로 UTF-16으로 인코딩됩니다. 기본 다국어 평면에 속하는 코드 포인트는 문자열의 하나의 코드 단위 요소로 인코딩됩니다. 그 밖의 모든 코드 포인트는 문자열의 두 코드 단위 요소로 인코딩됩니다.

구문

StringLiteral

DoubleStringCharacters

opt

SingleStringCharacters

opt

DoubleStringCharacters

DoubleStringCharacter

DoubleStringCharacters

opt

SingleStringCharacters

SingleStringCharacter

SingleStringCharacters

opt

DoubleStringCharacter

SourceCharacter

but not one of " or \ or LineTerminator

<LS>

<PS>

EscapeSequence

LineContinuation

SingleStringCharacter

SourceCharacter

but not one of ' or \ or LineTerminator

<LS>

<PS>

EscapeSequence

LineContinuation

LineTerminatorSequence

EscapeSequence

CharacterEscapeSequence

[lookahead ∉ DecimalDigit]

LegacyOctalEscapeSequence

NonOctalDecimalEscapeSequence

HexEscapeSequence

UnicodeEscapeSequence

CharacterEscapeSequence

SingleEscapeCharacter

NonEscapeCharacter

SingleEscapeCharacter

one of

NonEscapeCharacter

SourceCharacter

but not one of EscapeCharacter or LineTerminator

EscapeCharacter

SingleEscapeCharacter

DecimalDigit

LegacyOctalEscapeSequence

[lookahead ∈ { 8, 9 }]

NonZeroOctalDigit

[lookahead ∉ OctalDigit]

ZeroToThree

OctalDigit

[lookahead ∉ OctalDigit]

but not 0

one of

one of

NonOctalDecimalEscapeSequence

one of

HexEscapeSequence

HexDigit

UnicodeEscapeSequence

}

비단말 기호 HexDigit의 정의는 12.9.3에 제시되어 있습니다. SourceCharacter는 11.1에 정의되어 있습니다.

참고 2

<LF> 및 <CR>은 빈 코드 포인트 시퀀스를 생성하기 위한 LineContinuation의 일부인 경우를 제외하면 문자열 리터럴에 나타날 수 없습니다. 문자열 리터럴의 String 값에 이들을 포함하는 올바른 방법은 \n 또는 \u000A와 같은 이스케이프 시퀀스를 사용하는 것입니다.

12.9.4.1 Static Semantics: 조기 오류

EscapeSequence

LegacyOctalEscapeSequence

NonOctalDecimalEscapeSequence

IsStrict(this production)이 true이면 Syntax Error입니다.

참고 1

비엄격 코드에서 이 구문은 Legacy입니다.

참고 2

문자열 리터럴이 둘러싸는 코드를 엄격 모드로 만드는 Use Strict 지시문보다 앞에 나타날 수 있으며, 구현체는 이러한 리터럴에 위 규칙을 적용하도록 주의해야 합니다. 예를 들어 다음 소스 텍스트에는 Syntax Error가 포함되어 있습니다:

function invalid() { "\7"; "use strict"; }

12.9.4.2 Static Semantics: SV

구문 지향 연산 SV. 인수 없음. 반환값: String.

문자열 리터럴은 String 타입의 값을 나타냅니다. SV는 문자열 리터럴의 여러 부분에 재귀적으로 적용하여 문자열 리터럴의 String 값을 생성합니다. 이 과정의 일부로 문자열 리터럴 안의 일부 유니코드 코드 포인트는 아래 또는 12.9.3에 설명된 대로 수학적 값을 갖는 것으로 해석됩니다.

StringLiteral :: " " 의 SV는 빈 String입니다.
StringLiteral :: ' ' 의 SV는 빈 String입니다.
DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharacters 의 SV는 DoubleStringCharacter의 SV와 DoubleStringCharacters의 SV의 문자열 연결입니다.
SingleStringCharacters :: SingleStringCharacter SingleStringCharacters 의 SV는 SingleStringCharacter의 SV와 SingleStringCharacters의 SV의 문자열 연결입니다.
DoubleStringCharacter :: SourceCharacter but not one of " or \ or LineTerminator 의 SV는 SourceCharacter와 일치하는 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
DoubleStringCharacter :: <LS> 의 SV는 코드 단위 0x2028 (LINE SEPARATOR)로 구성된 String 값입니다.
DoubleStringCharacter :: <PS> 의 SV는 코드 단위 0x2029 (PARAGRAPH SEPARATOR)로 구성된 String 값입니다.
DoubleStringCharacter :: LineContinuation 의 SV는 빈 String입니다.
SingleStringCharacter :: SourceCharacter but not one of ' or \ or LineTerminator 의 SV는 SourceCharacter와 일치하는 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
SingleStringCharacter :: <LS> 의 SV는 코드 단위 0x2028 (LINE SEPARATOR)로 구성된 String 값입니다.
SingleStringCharacter :: <PS> 의 SV는 코드 단위 0x2029 (PARAGRAPH SEPARATOR)로 구성된 String 값입니다.
SingleStringCharacter :: LineContinuation 의 SV는 빈 String입니다.
EscapeSequence :: 0 의 SV는 코드 단위 0x0000 (NULL)로 구성된 String 값입니다.
CharacterEscapeSequence :: SingleEscapeCharacter 의 SV는 표 33에 따라 SingleEscapeCharacter가 결정하는 숫자 값을 갖는 코드 단위로 구성된 String 값입니다.

표 33: String 단일 문자 이스케이프 시퀀스

이스케이프 시퀀스	코드 단위 값	유니코드 문자 이름	기호
`\b`	`0x0008`	BACKSPACE	<BS>
`\t`	`0x0009`	CHARACTER TABULATION	<HT>
`\n`	`0x000A`	LINE FEED (LF)	<LF>
`\v`	`0x000B`	LINE TABULATION	<VT>
`\f`	`0x000C`	FORM FEED (FF)	<FF>
`\r`	`0x000D`	CARRIAGE RETURN (CR)	<CR>
`\"`	`0x0022`	QUOTATION MARK	`"`
`\'`	`0x0027`	APOSTROPHE	`'`
`\\`	`0x005C`	REVERSE SOLIDUS	`\`

NonEscapeCharacter :: SourceCharacter but not one of EscapeCharacter or LineTerminator 의 SV는 SourceCharacter와 일치하는 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
EscapeSequence :: LegacyOctalEscapeSequence 의 SV는 숫자 값이 LegacyOctalEscapeSequence의 MV인 코드 단위로 구성된 String 값입니다.
NonOctalDecimalEscapeSequence :: 8 의 SV는 코드 단위 0x0038 (DIGIT EIGHT)로 구성된 String 값입니다.
NonOctalDecimalEscapeSequence :: 9 의 SV는 코드 단위 0x0039 (DIGIT NINE)로 구성된 String 값입니다.
HexEscapeSequence :: x HexDigit HexDigit 의 SV는 숫자 값이 HexEscapeSequence의 MV인 코드 단위로 구성된 String 값입니다.
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit 의 SV는 숫자 값이 Hex4Digits의 MV인 코드 단위로 구성된 String 값입니다.
UnicodeEscapeSequence :: u{ CodePoint } 의 SV는 CodePoint의 MV에 UTF16EncodeCodePoint를 수행한 결과입니다.
TemplateEscapeSequence :: 0 의 SV는 코드 단위 0x0000 (NULL)로 구성된 String 값입니다.

12.9.4.3 Static Semantics: MV

LegacyOctalEscapeSequence :: ZeroToThree OctalDigit 의 MV는 (ZeroToThree의 MV × 8) + OctalDigit의 MV입니다.
LegacyOctalEscapeSequence :: FourToSeven OctalDigit 의 MV는 (FourToSeven의 MV × 8) + OctalDigit의 MV입니다.
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit OctalDigit 의 MV는 (ZeroToThree의 MV × 64) + (첫 번째 OctalDigit의 MV × 8) + 두 번째 OctalDigit의 MV입니다.
ZeroToThree :: 0 의 MV는 0입니다.
ZeroToThree :: 1 의 MV는 1입니다.
ZeroToThree :: 2 의 MV는 2입니다.
ZeroToThree :: 3 의 MV는 3입니다.
FourToSeven :: 4 의 MV는 4입니다.
FourToSeven :: 5 의 MV는 5입니다.
FourToSeven :: 6 의 MV는 6입니다.
FourToSeven :: 7 의 MV는 7입니다.
HexEscapeSequence :: x HexDigit HexDigit 의 MV는 (첫 번째 HexDigit의 MV × 16) + 두 번째 HexDigit의 MV입니다.
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit 의 MV는 (0x1000 × 첫 번째 HexDigit의 MV) + (0x100 × 두 번째 HexDigit의 MV) + (0x10 × 세 번째 HexDigit의 MV) + 네 번째 HexDigit의 MV입니다.

12.9.5 정규 표현식 리터럴

참고 1

정규 표현식 리터럴은 리터럴을 평가할 때마다 RegExp 객체(22.2 참조)로 변환되는 입력 요소입니다. 프로그램 안의 두 정규 표현식 리터럴은 두 리터럴의 내용이 동일하더라도 서로 ===로 비교했을 때 절대로 같은 것으로 평가되지 않는 정규 표현식 객체가 됩니다. RegExp 객체는 런타임에 new RegExp를 사용하거나 RegExp 생성자를 함수로 호출하여 생성할 수도 있습니다(22.2.4 참조).

아래 생성 규칙은 정규 표현식 리터럴의 구문을 설명하며 입력 요소 스캐너가 정규 표현식 리터럴의 끝을 찾는 데 사용합니다. 이후 RegularExpressionBody와 RegularExpressionFlags를 구성하는 소스 텍스트는 더 엄격한 ECMAScript 정규 표현식 문법(22.2.1)을 사용하여 다시 파싱됩니다.

구현체는 22.2.1에 정의된 ECMAScript 정규 표현식 문법을 확장할 수 있지만 아래 정의된 RegularExpressionBody 및 RegularExpressionFlags 생성 규칙이나 이 생성 규칙에서 사용하는 생성 규칙을 확장해서는 안 됩니다.

구문

RegularExpressionLiteral

RegularExpressionBody

RegularExpressionFlags

RegularExpressionBody

RegularExpressionFirstChar

RegularExpressionChars

[empty]

RegularExpressionChars

RegularExpressionChar

RegularExpressionFirstChar

RegularExpressionNonTerminator

but not one of * or \ or / or [

RegularExpressionBackslashSequence

RegularExpressionClass

RegularExpressionChar

RegularExpressionNonTerminator

but not one of \ or / or [

RegularExpressionBackslashSequence

RegularExpressionClass

RegularExpressionBackslashSequence

RegularExpressionNonTerminator

SourceCharacter

but not LineTerminator

RegularExpressionClass

[

RegularExpressionClassChars

]

RegularExpressionClassChars

[empty]

RegularExpressionClassChars

RegularExpressionClassChar

RegularExpressionNonTerminator

but not one of ] or \

RegularExpressionBackslashSequence

RegularExpressionFlags

[empty]

RegularExpressionFlags

IdentifierPartChar

참고 2

정규 표현식 리터럴은 비어 있을 수 없습니다. 빈 정규 표현식 리터럴을 나타내는 대신 코드 단위 시퀀스 //는 한 줄 주석을 시작합니다. 빈 정규 표현식을 지정하려면 /(?:)/을 사용하시기 바랍니다.

12.9.5.1 Static Semantics: BodyText

구문 지향 연산 BodyText. 인수 없음. 반환값: 소스 텍스트. 다음 생성 규칙별로 정의된다.

RegularExpressionLiteral

RegularExpressionBody

RegularExpressionFlags

RegularExpressionBody로 인식된 소스 텍스트를 반환합니다.

12.9.5.2 Static Semantics: FlagText

구문 지향 연산 FlagText. 인수 없음. 반환값: 소스 텍스트. 다음 생성 규칙별로 정의된다.

RegularExpressionLiteral

RegularExpressionBody

RegularExpressionFlags

RegularExpressionFlags로 인식된 소스 텍스트를 반환합니다.

12.9.6 템플릿 리터럴 어휘 구성 요소

구문

Template

NoSubstitutionTemplate

TemplateHead

NoSubstitutionTemplate

TemplateCharacters

opt

TemplateHead

TemplateCharacters

opt

TemplateSubstitutionTail

}

opt

}

opt

opt

[lookahead ≠ {]

TemplateEscapeSequence

NotEscapeSequence

LineContinuation

LineTerminatorSequence

SourceCharacter

but not one of ` or \ or $ or LineTerminator

TemplateEscapeSequence

CharacterEscapeSequence

[lookahead ∉ DecimalDigit]

HexEscapeSequence

UnicodeEscapeSequence

NotEscapeSequence

DecimalDigit

but not 0

[lookahead ∉ HexDigit]

HexDigit

[lookahead ∉ HexDigit]

[lookahead ≠ {]

HexDigit

[lookahead ∉ HexDigit]

HexDigit

[lookahead ∉ HexDigit]

HexDigit

[lookahead ∉ HexDigit]

{

[lookahead ∉ HexDigit]

{

NotCodePoint

[lookahead ∉ HexDigit]

{

CodePoint

[lookahead ∉ HexDigit]

[lookahead ≠ }]

NotCodePoint

HexDigits

[~Sep]

but only if the MV of HexDigits > 0x10FFFF

CodePoint

HexDigits

[~Sep]

but only if the MV of HexDigits ≤ 0x10FFFF

참고

TemplateSubstitutionTail은 InputElementTemplateTail 대체 어휘 목표에서 사용됩니다.

12.9.6.1 Static Semantics: TV

구문 지향 연산 TV. 인수 없음. 반환값: (String 또는 undefined). 템플릿 리터럴 구성 요소는 TV에 의해 String 타입의 값으로 해석됩니다. TV는 템플릿 객체의 인덱스 구성 요소(일반적으로 템플릿 값이라고 부릅니다)를 구성하는 데 사용됩니다. TV에서는 이스케이프 시퀀스를 해당 이스케이프 시퀀스가 나타내는 유니코드 코드 포인트의 UTF-16 코드 단위로 교체합니다.

NoSubstitutionTemplate :: ` ` 의 TV는 빈 String입니다.
TemplateHead :: ` ${ 의 TV는 빈 String입니다.
TemplateMiddle :: } ${ 의 TV는 빈 String입니다.
TemplateTail :: } ` 의 TV는 빈 String입니다.
TemplateCharacters :: TemplateCharacter TemplateCharacters 의 TV는 TemplateCharacter의 TV가 undefined이거나 TemplateCharacters의 TV가 undefined이면 undefined입니다. 그렇지 않으면 TemplateCharacter의 TV와 TemplateCharacters의 TV의 문자열 연결입니다.
TemplateCharacter :: SourceCharacter but not one of ` or \ or $ or LineTerminator 의 TV는 SourceCharacter와 일치하는 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
TemplateCharacter :: $ 의 TV는 코드 단위 0x0024 (DOLLAR SIGN)로 구성된 String 값입니다.
TemplateCharacter :: \ TemplateEscapeSequence 의 TV는 TemplateEscapeSequence의 SV입니다.
TemplateCharacter :: \ NotEscapeSequence 의 TV는 undefined입니다.
TemplateCharacter :: LineTerminatorSequence 의 TV는 LineTerminatorSequence의 TRV입니다.
LineContinuation :: \ LineTerminatorSequence 의 TV는 빈 String입니다.

12.9.6.2 Static Semantics: TRV

구문 지향 연산 TRV. 인수 없음. 반환값: String. 템플릿 리터럴 구성 요소는 TRV에 의해 String 타입의 값으로 해석됩니다. TRV는 템플릿 객체의 원시 구성 요소(일반적으로 템플릿 원시 값이라고 부릅니다)를 구성하는 데 사용됩니다. TRV는 TV와 유사하지만 TRV에서는 이스케이프 시퀀스를 리터럴에 나타난 그대로 해석한다는 차이가 있습니다.

NoSubstitutionTemplate :: ` ` 의 TRV는 빈 String입니다.
TemplateHead :: ` ${ 의 TRV는 빈 String입니다.
TemplateMiddle :: } ${ 의 TRV는 빈 String입니다.
TemplateTail :: } ` 의 TRV는 빈 String입니다.
TemplateCharacters :: TemplateCharacter TemplateCharacters 의 TRV는 TemplateCharacter의 TRV와 TemplateCharacters의 TRV의 문자열 연결입니다.
TemplateCharacter :: SourceCharacter but not one of ` or \ or $ or LineTerminator 의 TRV는 SourceCharacter와 일치하는 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
TemplateCharacter :: $ 의 TRV는 코드 단위 0x0024 (DOLLAR SIGN)로 구성된 String 값입니다.
TemplateCharacter :: \ TemplateEscapeSequence 의 TRV는 코드 단위 0x005C (REVERSE SOLIDUS)와 TemplateEscapeSequence의 TRV의 문자열 연결입니다.
TemplateCharacter :: \ NotEscapeSequence 의 TRV는 코드 단위 0x005C (REVERSE SOLIDUS)와 NotEscapeSequence의 TRV의 문자열 연결입니다.
TemplateEscapeSequence :: 0 의 TRV는 코드 단위 0x0030 (DIGIT ZERO)으로 구성된 String 값입니다.
NotEscapeSequence :: 0 DecimalDigit 의 TRV는 코드 단위 0x0030 (DIGIT ZERO)과 DecimalDigit의 TRV의 문자열 연결입니다.
NotEscapeSequence :: x [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0078 (LATIN SMALL LETTER X)로 구성된 String 값입니다.
NotEscapeSequence :: x HexDigit [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0078 (LATIN SMALL LETTER X)과 HexDigit의 TRV의 문자열 연결입니다.
NotEscapeSequence :: u [lookahead ∉ HexDigit] [lookahead ≠ {] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U)로 구성된 String 값입니다.
NotEscapeSequence :: u HexDigit [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U)와 HexDigit의 TRV의 문자열 연결입니다.
NotEscapeSequence :: u HexDigit HexDigit [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U), 첫 번째 HexDigit의 TRV 및 두 번째 HexDigit의 TRV의 문자열 연결입니다.
NotEscapeSequence :: u HexDigit HexDigit HexDigit [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U), 첫 번째 HexDigit의 TRV, 두 번째 HexDigit의 TRV 및 세 번째 HexDigit의 TRV의 문자열 연결입니다.
NotEscapeSequence :: u { [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U)와 코드 단위 0x007B (LEFT CURLY BRACKET)의 문자열 연결입니다.
NotEscapeSequence :: u { NotCodePoint [lookahead ∉ HexDigit] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U), 코드 단위 0x007B (LEFT CURLY BRACKET) 및 NotCodePoint의 TRV의 문자열 연결입니다.
NotEscapeSequence :: u { CodePoint [lookahead ∉ HexDigit] [lookahead ≠ }] 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U), 코드 단위 0x007B (LEFT CURLY BRACKET) 및 CodePoint의 TRV의 문자열 연결입니다.
DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 의 TRV는 이 생성 규칙과 일치하는 하나의 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
CharacterEscapeSequence :: NonEscapeCharacter 의 TRV는 NonEscapeCharacter의 SV입니다.
SingleEscapeCharacter :: one of ' " \ b f n r t v 의 TRV는 이 생성 규칙과 일치하는 하나의 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
HexEscapeSequence :: x HexDigit HexDigit 의 TRV는 코드 단위 0x0078 (LATIN SMALL LETTER X), 첫 번째 HexDigit의 TRV 및 두 번째 HexDigit의 TRV의 문자열 연결입니다.
UnicodeEscapeSequence :: u Hex4Digits 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U)와 Hex4Digits의 TRV의 문자열 연결입니다.
UnicodeEscapeSequence :: u{ CodePoint } 의 TRV는 코드 단위 0x0075 (LATIN SMALL LETTER U), 코드 단위 0x007B (LEFT CURLY BRACKET), CodePoint의 TRV 및 코드 단위 0x007D (RIGHT CURLY BRACKET)의 문자열 연결입니다.
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit 의 TRV는 첫 번째 HexDigit의 TRV, 두 번째 HexDigit의 TRV, 세 번째 HexDigit의 TRV 및 네 번째 HexDigit의 TRV의 문자열 연결입니다.
HexDigits :: HexDigits HexDigit 의 TRV는 HexDigits의 TRV와 HexDigit의 TRV의 문자열 연결입니다.
HexDigit :: one of 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F 의 TRV는 이 생성 규칙과 일치하는 하나의 코드 포인트에 UTF16EncodeCodePoint를 수행한 결과입니다.
LineContinuation :: \ LineTerminatorSequence 의 TRV는 코드 단위 0x005C (REVERSE SOLIDUS)와 LineTerminatorSequence의 TRV의 문자열 연결입니다.
LineTerminatorSequence :: <LF> 의 TRV는 코드 단위 0x000A (LINE FEED)로 구성된 String 값입니다.
LineTerminatorSequence :: <CR> 의 TRV는 코드 단위 0x000A (LINE FEED)로 구성된 String 값입니다.
LineTerminatorSequence :: <LS> 의 TRV는 코드 단위 0x2028 (LINE SEPARATOR)로 구성된 String 값입니다.
LineTerminatorSequence :: <PS> 의 TRV는 코드 단위 0x2029 (PARAGRAPH SEPARATOR)로 구성된 String 값입니다.
LineTerminatorSequence :: <CR> <LF> 의 TRV는 코드 단위 0x000A (LINE FEED)로 구성된 String 값입니다.

참고

TV는 LineContinuation의 코드 단위를 제외하지만 TRV는 이를 포함합니다. <CR><LF> 및 <CR> LineTerminatorSequence는 TV와 TRV 모두에서 <LF>로 정규화됩니다. <CR> 또는 <CR><LF> 시퀀스를 포함하려면 명시적인 TemplateEscapeSequence가 필요합니다.

12.10 자동 세미콜론 삽입

대부분의 ECMAScript 문과 선언은 세미콜론으로 끝나야 합니다. 이러한 세미콜론은 항상 소스 텍스트에 명시적으로 나타날 수 있습니다. 그러나 편의를 위해 특정 상황에서는 소스 텍스트에서 이러한 세미콜론을 생략할 수 있습니다. 이러한 상황은 해당 위치에서 소스 코드 토큰 스트림에 세미콜론이 자동으로 삽입된다고 설명합니다.

12.10.1 자동 세미콜론 삽입 규칙

다음 규칙에서 “토큰”은 12 절에 설명된 현재 어휘 목표 기호를 사용하여 결정된 실제로 인식된 어휘 토큰을 의미합니다.

세미콜론 삽입에는 세 가지 기본 규칙이 있습니다:

소스 텍스트를 왼쪽에서 오른쪽으로 파싱하는 동안 문법의 어떤 생성 규칙에서도 허용되지 않는 토큰(문제 토큰이라고 합니다)을 만났을 때 다음 조건 중 하나 이상이 참이면 문제 토큰 앞에 세미콜론이 자동으로 삽입됩니다:
- 문제 토큰과 이전 토큰 사이에 최소 하나의 LineTerminator가 있습니다.
- 문제 토큰이 }입니다.
- 이전 토큰이 )이고 삽입된 세미콜론이 do-while 문(14.7.2)을 종료하는 세미콜론으로 파싱됩니다.
소스 텍스트를 왼쪽에서 오른쪽으로 파싱하는 동안 입력 토큰 스트림의 끝에 도달했고 파서가 입력 토큰 스트림을 목표 비단말 기호의 단일 인스턴스로 파싱할 수 없으면 입력 스트림 끝에 세미콜론이 자동으로 삽입됩니다.
소스 텍스트를 왼쪽에서 오른쪽으로 파싱하는 동안 문법의 어떤 생성 규칙에서는 허용되는 토큰을 만났지만 해당 생성 규칙이 제한된 생성 규칙이고 그 토큰이 제한된 생성 규칙 안에서 주석 “[no LineTerminator here]” 바로 뒤의 단말 또는 비단말에 대한 첫 번째 토큰이 되며(따라서 이러한 토큰을 제한 토큰이라고 합니다), 제한 토큰과 이전 토큰 사이에 최소 하나의 LineTerminator가 있으면 제한 토큰 앞에 세미콜론이 자동으로 삽입됩니다.

그러나 앞의 규칙에는 이를 우선하는 추가 조건이 있습니다. 삽입된 세미콜론이 빈 문으로 파싱되거나 for 문의 헤더에 있는 두 세미콜론 중 하나가 되는 경우(14.7.4 참조)에는 세미콜론을 절대로 자동으로 삽입하지 않습니다.

참고

문법에서 제한된 생성 규칙은 다음뿐입니다:

UpdateExpression

[Yield, Await]

LeftHandSideExpression

[?Yield, ?Await]

[no LineTerminator here]

LeftHandSideExpression

[?Yield, ?Await]

[no LineTerminator here]

UsingDeclaration

[In, Yield, Await]

using

[no LineTerminator here]

BindingList

[?In, ?Yield, ?Await, ~Pattern]

;

ContinueStatement

[Yield, Await]

continue

;

continue

[no LineTerminator here]

LabelIdentifier

[?Yield, ?Await]

;

BreakStatement

[Yield, Await]

break

;

break

[no LineTerminator here]

LabelIdentifier

[?Yield, ?Await]

;

ReturnStatement

[Yield, Await]

return

;

return

[no LineTerminator here]

Expression

[+In, ?Yield, ?Await]

;

ThrowStatement

[Yield, Await]

throw

[no LineTerminator here]

Expression

[+In, ?Yield, ?Await]

;

YieldExpression

[In, Await]

yield

[no LineTerminator here]

AssignmentExpression

[?In, +Yield, ?Await]

yield

[no LineTerminator here]

AssignmentExpression

[?In, +Yield, ?Await]

ArrowFunction

[In, Yield, Await]

ArrowParameters

[?Yield, ?Await]

[no LineTerminator here]

ConciseBody

[?In]

AsyncFunctionDeclaration

[Yield, Await, Default]

async

[no LineTerminator here]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

[+Default]

async

[no LineTerminator here]

function

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncFunctionExpression

async

[no LineTerminator here]

function

BindingIdentifier

[~Yield, +Await]

opt

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncMethod

[Yield, Await]

async

[no LineTerminator here]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncGeneratorDeclaration

[Yield, Await, Default]

async

[no LineTerminator here]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

[+Default]

async

[no LineTerminator here]

function

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression

async

[no LineTerminator here]

function

BindingIdentifier

[+Yield, +Await]

opt

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorMethod

[Yield, Await]

async

[no LineTerminator here]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncArrowFunction

[In, Yield, Await]

async

[no LineTerminator here]

AsyncArrowBindingIdentifier

[?Yield]

[no LineTerminator here]

AsyncConciseBody

[?In]

CoverCallExpressionAndAsyncArrowHead

[?Yield, ?Await]

[no LineTerminator here]

AsyncConciseBody

[?In]

AsyncArrowHead

async

[no LineTerminator here]

ArrowFormalParameters

[~Yield, +Await]

이러한 제한된 생성 규칙의 실질적인 효과는 다음과 같습니다:

파서가 후위 연산자로 취급할 위치에서 ++ 또는 -- 토큰을 만났고 이전 토큰과 ++ 또는 -- 토큰 사이에 최소 하나의 LineTerminator가 있으면 ++ 또는 -- 토큰 앞에 세미콜론이 자동으로 삽입됩니다.
using 토큰을 만났고 IdentifierName 토큰 전에 LineTerminator를 만나면 using 토큰 뒤에 세미콜론이 자동으로 삽입됩니다.
continue, break, return, throw 또는 yield 토큰을 만났고 다음 토큰 전에 LineTerminator를 만나면 continue, break, return, throw 또는 yield 토큰 뒤에 세미콜론이 자동으로 삽입됩니다.
화살표 함수의 매개변수 뒤에서 => 토큰 전에 LineTerminator가 나타나면 세미콜론이 자동으로 삽입되고 구두점으로 인해 구문 오류가 발생합니다.
async 토큰 뒤에서 function, IdentifierName 또는 ( 토큰 전에 LineTerminator가 나타나면 세미콜론이 자동으로 삽입되고 async 토큰은 뒤따르는 토큰과 같은 표현식 또는 클래스 요소의 일부로 취급되지 않습니다.
async 토큰 뒤에서 * 토큰 전에 LineTerminator가 나타나면 세미콜론이 자동으로 삽입되고 구두점으로 인해 구문 오류가 발생합니다.

이에 따라 ECMAScript 프로그래머에게 실질적으로 권장되는 사항은 다음과 같습니다:

후위 ++ 또는 -- 연산자는 피연산자와 같은 줄에 두어야 합니다.
using 선언의 BindingList는 using 토큰과 같은 줄에서 시작해야 합니다.
return 또는 throw 문의 Expression이나 yield 표현식의 AssignmentExpression은 return, throw 또는 yield 토큰과 같은 줄에서 시작해야 합니다.
break 또는 continue 문의 LabelIdentifier는 break 또는 continue 토큰과 같은 줄에 있어야 합니다.
화살표 함수 매개변수의 끝과 =>는 같은 줄에 있어야 합니다.
비동기 함수 또는 메서드 앞의 async 토큰은 바로 뒤의 토큰과 같은 줄에 있어야 합니다.

12.10.2 자동 세미콜론 삽입의 예

이 절은 비규범적입니다.

다음 소스

{ 1 2 } 3

는 자동 세미콜론 삽입 규칙을 적용해도 ECMAScript 문법에서 유효한 문장이 아닙니다. 반면 다음 소스

{ 1
2 } 3

역시 유효한 ECMAScript 문장은 아니지만 자동 세미콜론 삽입에 의해 다음과 같이 변환됩니다:

{ 1
;2 ;} 3;

이는 유효한 ECMAScript 문장입니다.

다음 소스

for (a; b
)

는 유효한 ECMAScript 문장이 아니며 세미콜론이 for 문의 헤더에 필요하므로 자동 세미콜론 삽입에 의해 변경되지 않습니다. 자동 세미콜론 삽입은 for 문의 헤더에 있는 두 세미콜론 중 하나를 절대로 삽입하지 않습니다.

다음 소스

return
a + b

는 자동 세미콜론 삽입에 의해 다음과 같이 변환됩니다:

return;
a + b;

참고 1

LineTerminator가 표현식 a + b와 토큰 return을 분리하므로 표현식 a + b는 return 문이 반환할 값으로 취급되지 않습니다.

다음 소스

a = b
++c

는 자동 세미콜론 삽입에 의해 다음과 같이 변환됩니다:

a = b;
++c;

참고 2

b와 ++ 사이에 LineTerminator가 있으므로 토큰 ++는 변수 b에 적용되는 후위 연산자로 취급되지 않습니다.

다음 소스

if (a > b)
else c = d

는 유효한 ECMAScript 문장이 아니며 해당 지점에서 문법의 어떤 생성 규칙도 적용되지 않지만 자동으로 삽입된 세미콜론이 빈 문으로 파싱되므로 else 토큰 앞에 자동 세미콜론을 삽입해도 변경되지 않습니다.

다음 소스

a = b + c
(d + e).print()

는 자동 세미콜론 삽입에 의해 변환되지 않습니다. 두 번째 줄을 시작하는 괄호로 둘러싸인 표현식을 함수 호출의 인수 목록으로 해석할 수 있기 때문입니다:

a = b + c(d + e).print()

할당문이 여는 괄호로 시작해야 하는 경우 프로그래머는 자동 세미콜론 삽입에 의존하는 대신 이전 문의 끝에 명시적인 세미콜론을 작성하는 것이 좋습니다.

12.10.3 자동 세미콜론 삽입의 흥미로운 사례

이 절은 비규범적입니다.

ECMAScript 프로그램은 자동 세미콜론 삽입에 의존하여 세미콜론을 거의 사용하지 않는 스타일로 작성할 수 있습니다. 위에서 설명했듯이 모든 개행에 세미콜론이 삽입되는 것은 아니며 자동 세미콜론 삽입은 줄 종결자를 사이에 둔 여러 토큰에 의존할 수 있습니다.

ECMAScript에 새로운 구문 기능이 추가되면 추가 문법 생성 규칙이 도입될 수 있으며, 이로 인해 앞에서 자동 세미콜론 삽입에 의존하던 줄이 파싱될 때 다른 문법 생성 규칙으로 변경될 수 있습니다.

이 절에서는 앞에 있는 소스 텍스트에 따라 세미콜론이 삽입될 수도 있고 삽입되지 않을 수도 있는 위치의 자동 세미콜론 삽입을 흥미로운 사례로 간주합니다. 이 절의 나머지 부분에서는 이 버전의 ECMAScript에서 자동 세미콜론 삽입의 여러 흥미로운 사례를 설명합니다.

12.10.3.1 Statement List에서 자동 세미콜론 삽입의 흥미로운 사례

StatementList에서는 많은 StatementListItem이 세미콜론으로 끝나며, 이러한 세미콜론은 자동 세미콜론 삽입을 사용하여 생략할 수 있습니다. 위 규칙의 결과로 표현식을 끝내는 줄의 끝에서는 다음 줄이 다음 중 하나로 시작하면 세미콜론이 필요합니다:

여는 괄호((). 세미콜론이 없으면 두 줄을 함께 CallExpression으로 취급합니다.
여는 대괄호([). 세미콜론이 없으면 두 줄을 함께 ArrayLiteral 또는 ArrayAssignmentPattern이 아니라 프로퍼티 접근으로 취급합니다.
템플릿 리터럴(`). 세미콜론이 없으면 두 줄을 함께 이전 표현식을 MemberExpression로 하는 태그된 Template(13.3.11)로 해석합니다.
단항 + 또는 -. 세미콜론이 없으면 두 줄을 함께 대응하는 이항 연산자의 사용으로 해석합니다.
RegExp 리터럴. 세미콜론이 없으면 예를 들어 RegExp에 플래그가 있는 경우 두 줄을 대신 / MultiplicativeOperator로 파싱할 수 있습니다.

12.10.3.2 자동 세미콜론 삽입과 “[no LineTerminator here]” 사례

이 절은 비규범적입니다.

ECMAScript에는 “[no LineTerminator here]”를 포함하는 문법 생성 규칙이 있습니다. 이러한 생성 규칙은 때때로 문법에서 선택적 피연산자를 제공하는 수단입니다. 이러한 위치에 LineTerminator를 도입하면 선택적 피연산자가 없는 문법 생성 규칙을 사용하게 되어 소스 텍스트의 문법 생성 규칙이 변경됩니다.

이 절의 나머지 부분에서는 이 버전의 ECMAScript에서 “[no LineTerminator here]”를 사용하는 여러 생성 규칙을 설명합니다.

12.10.3.2.1 선택적 피연산자와 “[no LineTerminator here]”를 갖는 문법 생성 규칙 목록

UpdateExpression.
ContinueStatement.
BreakStatement.
ReturnStatement.
YieldExpression.
함수 정의(15.2)와 관련된 비동기 함수 정의(15.8)

13 ECMAScript 언어: 표현식

13.1 식별자

구문

IdentifierReference

[Yield, Await]

Identifier

[~Yield]

yield

[~Await]

await

BindingIdentifier

[Yield, Await]

Identifier

yield

await

LabelIdentifier

[Yield, Await]

Identifier

[~Yield]

yield

[~Await]

await

Identifier

IdentifierName

but not ReservedWord

참고

yield와 await는 다음과 같은 경우 자동 세미콜론 삽입을 금지하기 위해 문법에서는 BindingIdentifier로 허용되고 아래의 정적 의미론에서 금지됩니다.

let
await 0;

13.1.1 Static Semantics: 조기 오류

BindingIdentifier

Identifier

IsStrict(this production)이 true이고 Identifier의 StringValue가 "arguments" 또는 "eval"이면 Syntax Error입니다.

IdentifierReference

yield

BindingIdentifier

yield

LabelIdentifier

yield

IsStrict(this production)이 true이면 Syntax Error입니다.

IdentifierReference

await

BindingIdentifier

await

LabelIdentifier

await

구문 문법의 목표 기호가 Module이면 Syntax Error입니다.

BindingIdentifier

[Yield, Await]

yield

이 생성 규칙에 _[Yield] 매개변수가 있으면 Syntax Error입니다.

BindingIdentifier

[Yield, Await]

await

이 생성 규칙에 _[Await] 매개변수가 있으면 Syntax Error입니다.

[Yield, Await]

[Yield, Await]

[Yield, Await]

이 생성 규칙에 _[Yield] 매개변수가 있고 Identifier의 StringValue가 "yield"이면 Syntax Error입니다.
이 생성 규칙에 _[Await] 매개변수가 있고 Identifier의 StringValue가 "await"이면 Syntax Error입니다.

Identifier

IdentifierName

but not ReservedWord

IsStrict(this phrase)가 true이고 IdentifierName의 StringValue가 "implements", "interface", "let", "package", "private", "protected", "public", "static" 또는 "yield" 중 하나이면 Syntax Error입니다.
구문 문법의 목표 기호가 Module이고 IdentifierName의 StringValue가 "await"이면 Syntax Error입니다.
IdentifierName의 StringValue가 yield 또는 await를 제외한 ReservedWord의 StringValue 중 하나이면 Syntax Error입니다.

참고

IdentifierName의 StringValue는 IdentifierName 안의 모든 유니코드 이스케이프 시퀀스를 정규화하므로, 이러한 이스케이프를 사용하여 코드 포인트 시퀀스가 ReservedWord와 같은 Identifier를 작성할 수 없습니다.

13.1.2 Static Semantics: StringValue

구문 지향 연산 StringValue. 인수 없음. 반환값: String. 다음 생성 규칙별로 정의된다.

nameUnescaped를 IdentifierName의 IdentifierCodePoints로 둡니다.
CodePointsToString(nameUnescaped)을 반환합니다.

IdentifierReference

yield

BindingIdentifier

yield

LabelIdentifier

yield

"yield"를 반환합니다.

IdentifierReference

await

BindingIdentifier

await

LabelIdentifier

await

"await"를 반환합니다.

Identifier

IdentifierName

but not ReservedWord

IdentifierName의 StringValue를 반환합니다.

PrivateIdentifier

IdentifierName

0x0023 (NUMBER SIGN)과 IdentifierName의 StringValue의 문자열 연결을 반환합니다.

ModuleExportName

StringLiteral

StringLiteral의 SV를 반환합니다.

13.1.3 Runtime Semantics: 평가

IdentifierReference

Identifier

? ResolveBinding(Identifier의 StringValue)을 반환합니다.

IdentifierReference

yield

? ResolveBinding("yield")를 반환합니다.

IdentifierReference

await

? ResolveBinding("await")를 반환합니다.

참고 1

IdentifierReference를 평가한 결과는 항상 Reference 타입의 값입니다.

참고 2

비엄격 코드에서는 키워드 yield를 식별자로 사용할 수 있습니다. IdentifierReference를 평가하면 yield가 Identifier인 것처럼 그 바인딩을 해석합니다. 조기 오류 제한은 이러한 평가가 비엄격 코드에서만 발생할 수 있도록 보장합니다.

13.2 기본 표현식

구문

PrimaryExpression

[Yield, Await]

this

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

AsyncFunctionExpression

AsyncGeneratorExpression

RegularExpressionLiteral

TemplateLiteral

[?Yield, ?Await, ~Tagged]

CoverParenthesizedExpressionAndArrowParameterList

[?Yield, ?Await]

CoverParenthesizedExpressionAndArrowParameterList

[Yield, Await]

(

)

(

Expression

[+In, ?Yield, ?Await]

opt

)

(

...

BindingIdentifier

[?Yield, ?Await]

)

(

...

BindingPattern

[?Yield, ?Await]

)

(

Expression

[+In, ?Yield, ?Await]

...

BindingIdentifier

[?Yield, ?Await]

)

(

Expression

[+In, ?Yield, ?Await]

...

BindingPattern

[?Yield, ?Await]

)

보충 구문

다음 생성 규칙의 인스턴스를 처리할 때
PrimaryExpression[Yield, Await] : CoverParenthesizedExpressionAndArrowParameterList[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList의 해석은 다음 문법을 사용하여 구체화됩니다:

ParenthesizedExpression

[Yield, Await]

(

Expression

[+In, ?Yield, ?Await]

)

13.2.1 `this` 키워드

13.2.1.1 Runtime Semantics: 평가

PrimaryExpression

this

? ResolveThisBinding()을 반환합니다.

13.2.2 식별자 참조

IdentifierReference에 대해서는 13.1를 참조하시기 바랍니다.

13.2.3 리터럴

구문

13.2.3.1 Runtime Semantics: 평가

Literal

NullLiteral

null을 반환합니다.

Literal

BooleanLiteral

BooleanLiteral이 토큰 false이면 false를 반환합니다.
BooleanLiteral이 토큰 true이면 true를 반환합니다.

Literal

NumericLiteral

12.9.3에 정의된 NumericLiteral의 NumericValue를 반환합니다.

Literal

StringLiteral

12.9.4.2에 정의된 StringLiteral의 SV를 반환합니다.

13.2.4 Array 이니셜라이저

참고

ArrayLiteral은 대괄호 안에 배열 요소를 나타내는 0개 이상의 표현식 목록을 사용하여 Array의 초기화를 설명하는 표현식입니다. 요소가 반드시 리터럴일 필요는 없으며 배열 이니셜라이저가 평가될 때마다 평가됩니다.

Array 요소는 요소 목록의 시작, 중간 또는 끝에서 생략될 수 있습니다. 요소 목록에서 쉼표 앞에 AssignmentExpression이 없는 경우(즉, 목록 시작의 쉼표 또는 다른 쉼표 뒤의 쉼표) 누락된 배열 요소는 Array의 길이에 기여하고 뒤따르는 요소의 인덱스를 증가시킵니다. 생략된 배열 요소는 정의되지 않습니다. 배열 끝에서 요소가 생략된 경우 그 요소는 Array의 길이에 기여하지 않습니다.

구문

ArrayLiteral

[Yield, Await]

[

Elision

opt

]

[

ElementList

[?Yield, ?Await]

]

[

ElementList

[?Yield, ?Await]

Elision

opt

]

ElementList

[Yield, Await]

Elision

opt

AssignmentExpression

[+In, ?Yield, ?Await]

opt

[?Yield, ?Await]

[?Yield, ?Await]

opt

[+In, ?Yield, ?Await]

[?Yield, ?Await]

opt

[?Yield, ?Await]

[Yield, Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

13.2.4.1 Runtime Semantics: ArrayAccumulation

구문 지향 연산 ArrayAccumulation. 인수 array (Array) 및 nextIndex (정수). 반환값: (정상 완료 (값: 정수) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

Elision

length를 nextIndex + 1로 둡니다.
? Set(array, "length", 𝔽(length), true)를 수행합니다.
참고: 위 단계는 length가 2³² - 1을 초과하면 예외를 던집니다.
length를 반환합니다.

Elision

인수 array 및 (nextIndex + 1)을 사용한 Elision의 ? ArrayAccumulation을 반환합니다.

ElementList

Elision

opt

AssignmentExpression

Elision이 존재하면, 다음을 수행합니다.
1. nextIndex를 인수 array 및 nextIndex를 사용한 Elision의 ? ArrayAccumulation으로 설정합니다.
initResult를 AssignmentExpression의 ? Evaluation으로 둡니다.
initValue를 ? GetValue(initResult)로 둡니다.
! CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), initValue)를 수행합니다.
nextIndex + 1을 반환합니다.

ElementList

Elision

opt

SpreadElement

Elision이 존재하면, 다음을 수행합니다.
1. nextIndex를 인수 array 및 nextIndex를 사용한 Elision의 ? ArrayAccumulation으로 설정합니다.
인수 array 및 nextIndex를 사용한 SpreadElement의 ? ArrayAccumulation을 반환합니다.

ElementList

Elision

opt

AssignmentExpression

nextIndex를 인수 array 및 nextIndex를 사용한 파생된 ElementList의 ? ArrayAccumulation으로 설정합니다.
Elision이 존재하면, 다음을 수행합니다.
1. nextIndex를 인수 array 및 nextIndex를 사용한 Elision의 ? ArrayAccumulation으로 설정합니다.
initResult를 AssignmentExpression의 ? Evaluation으로 둡니다.
initValue를 ? GetValue(initResult)로 둡니다.
! CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), initValue)를 수행합니다.
nextIndex + 1을 반환합니다.

ElementList

Elision

opt

SpreadElement

nextIndex를 인수 array 및 nextIndex를 사용한 파생된 ElementList의 ? ArrayAccumulation으로 설정합니다.
Elision이 존재하면, 다음을 수행합니다.
1. nextIndex를 인수 array 및 nextIndex를 사용한 Elision의 ? ArrayAccumulation으로 설정합니다.
인수 array 및 nextIndex를 사용한 SpreadElement의 ? ArrayAccumulation을 반환합니다.

SpreadElement

...

AssignmentExpression

spreadRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
spreadObj를 ? GetValue(spreadRef)로 둡니다.
iteratorRecord를 ? GetIterator(spreadObj, sync)로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면 nextIndex를 반환합니다.
3. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), next)를 수행합니다.
4. nextIndex를 nextIndex + 1로 설정합니다.

참고

표준 내장 Array 프로토타입 객체가 [[Set]]을 사용한 새로운 자체 프로퍼티 생성을 방해하는 방식으로 수정되었더라도 배열에 자체 프로퍼티가 정의되도록 보장하기 위해 CreateDataPropertyOrThrow를 사용합니다.

13.2.4.2 Runtime Semantics: 평가

ArrayLiteral

[

Elision

opt

]

array를 ! ArrayCreate(0)으로 둡니다.
Elision이 존재하면, 다음을 수행합니다.
1. 인수 array 및 0을 사용한 Elision의 ? ArrayAccumulation을 수행합니다.
array를 반환합니다.

ArrayLiteral

[

ElementList

]

array를 ! ArrayCreate(0)으로 둡니다.
인수 array 및 0을 사용한 ElementList의 ? ArrayAccumulation을 수행합니다.
array를 반환합니다.

ArrayLiteral

[

ElementList

Elision

opt

]

array를 ! ArrayCreate(0)으로 둡니다.
nextIndex를 인수 array 및 0을 사용한 ElementList의 ? ArrayAccumulation으로 둡니다.
Elision이 존재하면, 다음을 수행합니다.
1. 인수 array 및 nextIndex를 사용한 Elision의 ? ArrayAccumulation을 수행합니다.
array를 반환합니다.

13.2.5 Object 이니셜라이저

참고 1

객체 이니셜라이저는 리터럴과 유사한 형식으로 작성되어 Object의 초기화를 설명하는 표현식입니다. 중괄호 안에 프로퍼티 키와 연결된 값의 쌍을 0개 이상 나열합니다. 값은 반드시 리터럴일 필요가 없으며 객체 이니셜라이저가 평가될 때마다 평가됩니다.

구문

ObjectLiteral

[Yield, Await]

{

}

{

PropertyDefinitionList

[?Yield, ?Await]

opt

}

PropertyDefinitionList

[Yield, Await]

PropertyDefinition

[?Yield, ?Await]

PropertyDefinitionList

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

MethodDefinition

[?Yield, ?Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[

AssignmentExpression

[+In, ?Yield, ?Await]

]

CoverInitializedName

[Yield, Await]

IdentifierReference

[?Yield, ?Await]

Initializer

[+In, ?Yield, ?Await]

Initializer

[In, Yield, Await]

AssignmentExpression

[?In, ?Yield, ?Await]

참고 2

MethodDefinition은 15.4에 정의되어 있습니다.

참고 3

CoverInitializedName의 의미는 다음 절을 참조하시기 바랍니다.

13.2.5.1 Static Semantics: 조기 오류

ObjectLiteral

{

PropertyDefinitionList

opt

}

PropertyDefinitionList의 PropertyNameList에 "__proto__"에 대한 중복 항목이 있고 그중 적어도 두 항목이 PropertyDefinition : PropertyName : AssignmentExpression 형식의 생성 규칙에서 얻어진 경우 Syntax Error입니다. 이 ObjectLiteral이 ParseJSON을 위해 파싱되는 Script 안에 포함되어 있으면 이 규칙을 적용하지 않습니다(ParseJSON의 3 단계 참조).

참고 1

PropertyNameList가 반환하는 List에는 ComputedPropertyName을 사용하여 정의된 프로퍼티 이름이 포함되지 않습니다.

PropertyDefinition

MethodDefinition

MethodDefinition의 HasDirectSuper가 true이면 Syntax Error입니다.
MethodDefinition의 PrivateBoundIdentifiers가 비어 있지 않으면 Syntax Error입니다.

PropertyDefinition

CoverInitializedName

이 생성 규칙과 일치하는 소스 텍스트가 하나라도 있으면 Syntax Error입니다.

참고 2

이 명세의 다른 위치에는 특정 상황에서 LeftHandSideExpression이 AssignmentPattern을 포괄해야 한다고 요구하는 조기 오류 규칙이 있습니다. 따라서 ObjectLiteral은 ObjectAssignmentPattern의 커버 문법 역할을 합니다. CoverInitializedName 생성 규칙은 AssignmentProperty를 완전히 포괄하는 데 필요하지만 실제 객체 이니셜라이저 안에서는 유효하지 않습니다.

구체적으로 실제 ObjectLiteral이 예상되는 문맥에서는 위 조기 오류 규칙이 CoverInitializedName 사용을 방지합니다. 그러나 ObjectLiteral이 커버 문법으로 사용되는 경우 “포괄해야 한다”의 의미론에 따라 ObjectLiteral 안의 Parse Node에는 조기 오류 규칙이 적용되지 않으므로 CoverInitializedName이 허용됩니다.

예를 들어 다음을 생각해 보시기 바랍니다:

let o = {f = 1};

{f = 1}은 CoverInitializedName을 갖는 ObjectLiteral로 파싱되며 이 조기 오류 규칙에 의해 Syntax Error가 발생합니다.

반대로 다음을 생각해 보시기 바랍니다:

({f = 1} = {f: 2});

여기에서도 {f = 1}은 처음에는 CoverInitializedName을 갖는 ObjectLiteral로 파싱되지만 AssignmentExpression의 LeftHandSideExpression이므로 AssignmentPattern을 포괄해야 합니다. 따라서 ObjectLiteral과 CoverInitializedName에는 조기 오류 규칙이 적용되지 않습니다. 대신 {f = 1}은 AssignmentProperty를 갖는 ObjectAssignmentPattern으로 다시 파싱되며 Syntax Error가 없습니다.

13.2.5.2 Static Semantics: IsComputedPropertyKey

구문 지향 연산 IsComputedPropertyKey. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

PropertyName

LiteralPropertyName

false를 반환합니다.

PropertyName

ComputedPropertyName

true를 반환합니다.

13.2.5.3 Static Semantics: PropertyDefinitionNodes

구문 지향 연산 PropertyDefinitionNodes. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

ObjectLiteral

{

}

새로운 빈 List를 반환합니다.

PropertyDefinitionList

PropertyDefinition

« PropertyDefinition »을 반환합니다.

PropertyDefinitionList

PropertyDefinition

head를 파생된 PropertyDefinitionList의 PropertyDefinitionNodes로 둡니다.
head와 « PropertyDefinition »의 목록 연결을 반환합니다.

13.2.5.4 Static Semantics: PropertyNameList

구문 지향 연산 PropertyNameList. 인수 없음. 반환값: 리스트 (요소: String). 다음 생성 규칙별로 정의된다.

PropertyDefinitionList

PropertyDefinition

propertyName을 PropertyDefinition의 PropName으로 둡니다.
propertyName이 empty이면 새로운 빈 List를 반환합니다.
« propertyName »을 반환합니다.

PropertyDefinitionList

PropertyDefinition

list를 PropertyDefinitionList의 PropertyNameList로 둡니다.
propertyName을 PropertyDefinition의 PropName으로 둡니다.
propertyName이 empty이면 list를 반환합니다.
list와 « propertyName »의 목록 연결을 반환합니다.

13.2.5.5 Runtime Semantics: 평가

ObjectLiteral

{

}

OrdinaryObjectCreate(%Object.prototype%)를 반환합니다.

ObjectLiteral

{

PropertyDefinitionList

opt

}

obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
인수 obj를 사용한 PropertyDefinitionList의 ? PropertyDefinitionEvaluation을 수행합니다.
obj를 반환합니다.

LiteralPropertyName

IdentifierName

IdentifierName의 StringValue를 반환합니다.

LiteralPropertyName

StringLiteral

StringLiteral의 SV를 반환합니다.

LiteralPropertyName

NumericLiteral

number를 NumericLiteral의 NumericValue로 둡니다.
! ToString(number)을 반환합니다.

ComputedPropertyName

[

AssignmentExpression

]

exprValue를 AssignmentExpression의 ? Evaluation으로 둡니다.
propertyName을 ? GetValue(exprValue)로 둡니다.
? ToPropertyKey(propertyName)를 반환합니다.

13.2.5.6 Runtime Semantics: PropertyDefinitionEvaluation

구문 지향 연산 PropertyDefinitionEvaluation. 인수 obj (Object). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

PropertyDefinitionList

PropertyDefinition

인수 obj를 사용한 PropertyDefinitionList의 ? PropertyDefinitionEvaluation을 수행합니다.
인수 obj를 사용한 PropertyDefinition의 ? PropertyDefinitionEvaluation을 수행합니다.
unused를 반환합니다.

PropertyDefinition

...

AssignmentExpression

exprValue를 AssignmentExpression의 ? Evaluation으로 둡니다.
fromValue를 ? GetValue(exprValue)로 둡니다.
excludedNames를 새로운 빈 List로 둡니다.
? CopyDataProperties(obj, fromValue, excludedNames)를 수행합니다.
unused를 반환합니다.

PropertyDefinition

IdentifierReference

propertyName을 IdentifierReference의 StringValue로 둡니다.
exprValue를 IdentifierReference의 ? Evaluation으로 둡니다.
propertyValue를 ? GetValue(exprValue)로 둡니다.
단언: obj는 구성 불가능한 프로퍼티가 없는 일반 확장 가능 객체입니다.
! CreateDataPropertyOrThrow(obj, propertyName, propertyValue)를 수행합니다.
unused를 반환합니다.

PropertyDefinition

PropertyName

AssignmentExpression

propertyKey를 PropertyName의 ? Evaluation으로 둡니다.
이 PropertyDefinition이 ParseJSON을 위해 평가되는 Script 안에 포함되어 있으면(ParseJSON의 6 단계 참조), 다음을 수행합니다.
1. isProtoSetter를 false로 둡니다.
그렇지 않고 propertyKey가 "__proto__"이며 PropertyName의 IsComputedPropertyKey가 false이면, 다음을 수행합니다.
1. isProtoSetter를 true로 둡니다.
그렇지 않으면,
1. isProtoSetter를 false로 둡니다.
IsAnonymousFunctionDefinition(AssignmentExpression)이 true이고 isProtoSetter가 false이면, 다음을 수행합니다.
1. propertyValue를 인수 propertyKey를 사용한 AssignmentExpression의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. exprValueRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
2. propertyValue를 ? GetValue(exprValueRef)로 둡니다.
isProtoSetter가 true이면, 다음을 수행합니다.
1. propertyValue가 Object이거나 propertyValue가 null이면, 다음을 수행합니다.
  1. ! obj.[[SetPrototypeOf]](propertyValue)를 수행합니다.
2. unused를 반환합니다.
단언: obj는 구성 불가능한 프로퍼티가 없는 일반 확장 가능 객체입니다.
! CreateDataPropertyOrThrow(obj, propertyKey, propertyValue)를 수행합니다.
unused를 반환합니다.

PropertyDefinition

MethodDefinition

result를 인수 obj 및 true를 사용한 MethodDefinition의 ? MethodDefinitionEvaluation으로 둡니다.
단언: result는 empty입니다.
unused를 반환합니다.

13.2.6 함수 정의 표현식

PrimaryExpression : FunctionExpression 에 대해서는 15.2를 참조하시기 바랍니다.

PrimaryExpression : GeneratorExpression 에 대해서는 15.5를 참조하시기 바랍니다.

PrimaryExpression : ClassExpression 에 대해서는 15.7를 참조하시기 바랍니다.

PrimaryExpression : AsyncFunctionExpression 에 대해서는 15.8를 참조하시기 바랍니다.

PrimaryExpression : AsyncGeneratorExpression 에 대해서는 15.6를 참조하시기 바랍니다.

13.2.7 정규 표현식 리터럴

구문

12.9.5를 참조하시기 바랍니다.

13.2.7.1 Static Semantics: 조기 오류

PrimaryExpression

RegularExpressionLiteral

IsValidRegularExpressionLiteral(RegularExpressionLiteral)이 false이면 Syntax Error입니다.

13.2.7.2 Static Semantics: IsValidRegularExpressionLiteral ( `literal` )

추상 연산 IsValidRegularExpressionLiteral. 인수 literal (a RegularExpressionLiteral Parse Node). 반환값: Boolean. 인수가 유효한 정규 표현식 리터럴인지 결정합니다. 호출되면 다음 단계를 수행한다.

flags를 literal의 FlagText로 둡니다.
flags에 d, g, i, m, s, u, v, y 이외의 코드 포인트가 하나라도 포함되어 있으면 false를 반환합니다.
flags에 같은 코드 포인트가 두 번 이상 포함되어 있으면 false를 반환합니다.
flags에 u가 포함되어 있으면 u를 true로 둡니다. 그렇지 않으면 u를 false로 둡니다.
flags에 v가 포함되어 있으면 v를 true로 둡니다. 그렇지 않으면 v를 false로 둡니다.
patternText를 literal의 BodyText로 둡니다.
u가 false이고 v가 false이면, 다음을 수행합니다.
1. stringValue를 CodePointsToString(patternText)으로 둡니다.
2. patternText를 stringValue의 각 16비트 요소를 유니코드 BMP 코드 포인트로 해석하여 얻은 코드 포인트 시퀀스로 설정합니다. 요소에는 UTF-16 디코딩을 적용하지 않습니다.
parseResult를 ParsePattern(patternText, u, v)로 둡니다.
parseResult가 Parse Node이면 true를 반환합니다.
false를 반환합니다.

13.2.7.3 Runtime Semantics: 평가

PrimaryExpression

RegularExpressionLiteral

pattern을 CodePointsToString(RegularExpressionLiteral의 BodyText)으로 둡니다.
flags를 CodePointsToString(RegularExpressionLiteral의 FlagText)로 둡니다.
! RegExpCreate(pattern, flags)를 반환합니다.

13.2.8 템플릿 리터럴

구문

TemplateLiteral

[Yield, Await, Tagged]

NoSubstitutionTemplate

[?Yield, ?Await]

[Yield, Await]

[+In, ?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[+In, ?Yield, ?Await]

TemplateMiddleList

[?Yield, ?Await]

TemplateMiddle

Expression

[+In, ?Yield, ?Await]

13.2.8.1 Static Semantics: 조기 오류

TemplateLiteral

[Yield, Await, Tagged]

NoSubstitutionTemplate

_[Tagged] 매개변수가 설정되지 않았고 인수 cooked를 사용한 TemplateLiteral의 TemplateStrings에 undefined가 포함되어 있으면 Syntax Error입니다.

TemplateLiteral

[Yield, Await, Tagged]

SubstitutionTemplate

[?Yield, ?Await]

_[Tagged] 매개변수가 설정되지 않았고 인수 cooked를 사용한 TemplateLiteral의 TemplateStrings에 undefined가 포함되어 있으면 Syntax Error입니다.
인수 cooked를 사용한 TemplateLiteral의 TemplateStrings에 있는 요소 수가 2³² 이상이면 Syntax Error입니다.

13.2.8.2 Static Semantics: TemplateStrings

구문 지향 연산 TemplateStrings. 인수 escapes ((raw 또는 cooked)). 반환값: 리스트 (요소: (String 또는 undefined)). 다음 생성 규칙별로 정의된다.

TemplateLiteral

NoSubstitutionTemplate

« TemplateString(NoSubstitutionTemplate, escapes) »를 반환합니다.

head를 « TemplateString(TemplateHead, escapes) »로 둡니다.
tail을 인수 escapes를 사용한 TemplateSpans의 TemplateStrings로 둡니다.
head와 tail의 목록 연결을 반환합니다.

TemplateSpans

TemplateTail

« TemplateString(TemplateTail, escapes) »를 반환합니다.

TemplateSpans

TemplateMiddleList

TemplateTail

middle을 인수 escapes를 사용한 TemplateMiddleList의 TemplateStrings로 둡니다.
tail을 « TemplateString(TemplateTail, escapes) »로 둡니다.
middle과 tail의 목록 연결을 반환합니다.

TemplateMiddleList

TemplateMiddle

Expression

« TemplateString(TemplateMiddle, escapes) »를 반환합니다.

TemplateMiddleList

TemplateMiddle

Expression

front를 인수 escapes를 사용한 TemplateMiddleList의 TemplateStrings로 둡니다.
last를 « TemplateString(TemplateMiddle, escapes) »로 둡니다.
front와 last의 목록 연결을 반환합니다.

13.2.8.3 Static Semantics: TemplateString ( `templateToken`, `escapes` )

추상 연산 TemplateString. 인수 templateToken ((a NoSubstitutionTemplate Parse Node, a TemplateHead Parse Node, a TemplateMiddle Parse Node 또는 a TemplateTail Parse Node)) 및 escapes ((raw 또는 cooked)). 반환값: (String 또는 undefined). 호출되면 다음 단계를 수행한다.

escapes가 raw이면 templateToken의 TRV를 반환합니다.
templateToken의 TV를 반환합니다.

참고

이 연산은 escapes가 raw이고 templateToken에 NotEscapeSequence가 포함되어 있으면 undefined를 반환합니다. 그 밖의 모든 경우에는 String을 반환합니다.

13.2.8.4 GetTemplateObject ( `templateLiteral` )

추상 연산 GetTemplateObject. 인수 templateLiteral (구문 분석 노드). 반환값: Array. 호출되면 다음 단계를 수행한다.

realm을 현재 Realm Record로 둡니다.
templateRegistry를 realm.[[TemplateMap]]으로 둡니다.
templateRegistry의 각 요소 element에 대해 다음을 수행합니다.
1. element.[[Site]]가 templateLiteral과 같은 Parse Node이면, 다음을 수행합니다.
  1. element.[[Array]]를 반환합니다.
rawStrings를 인수 raw를 사용한 templateLiteral의 TemplateStrings로 둡니다.
단언: rawStrings는 String의 List입니다.
cookedStrings를 인수 cooked를 사용한 templateLiteral의 TemplateStrings로 둡니다.
count를 List cookedStrings의 요소 수로 둡니다.
단언: count ≤ 2³² - 1입니다.
template을 ! ArrayCreate(count)로 둡니다.
rawObj를 ! ArrayCreate(count)로 둡니다.
index를 0으로 둡니다.
index < count인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(index))으로 둡니다.
2. cookedValue를 cookedStrings[index]로 둡니다.
3. ! DefinePropertyOrThrow(template, propertyKey, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: false })를 수행합니다.
4. rawValue를 String 값 rawStrings[index]로 둡니다.
5. ! DefinePropertyOrThrow(rawObj, propertyKey, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: false })를 수행합니다.
6. index를 index + 1로 설정합니다.
! SetIntegrityLevel(rawObj, frozen)을 수행합니다.
! DefinePropertyOrThrow(template, "raw", PropertyDescriptor { [[Value]]: rawObj, [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
! SetIntegrityLevel(template, frozen)을 수행합니다.
Record { [[Site]]: templateLiteral, [[Array]]: template }를 realm.[[TemplateMap]]에 추가합니다.
template을 반환합니다.

참고 1

템플릿 객체 생성은 비정상 완료를 발생시킬 수 없습니다.

참고 2

realm의 프로그램 코드에 있는 각 TemplateLiteral은 태그된 Template(13.2.8.6)을 평가할 때 사용하는 고유한 템플릿 객체와 연결됩니다. 템플릿 객체는 동결되며 특정 태그된 Template을 평가할 때마다 동일한 템플릿 객체를 사용합니다. 템플릿 객체를 TemplateLiteral을 처음 평가할 때 지연 생성할지 아니면 최초 평가 전에 미리 생성할지는 ECMAScript 코드에서 관찰할 수 없는 구현 선택입니다.

참고 3

이 명세의 향후 판에서는 템플릿 객체의 열거 불가능한 추가 프로퍼티를 정의할 수 있습니다.

13.2.8.5 Runtime Semantics: SubstitutionEvaluation

구문 지향 연산 SubstitutionEvaluation. 인수 없음. 반환값: (정상 완료 (값: 리스트 (요소: ECMAScript 언어 값)) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

TemplateSpans

TemplateTail

새로운 빈 List를 반환합니다.

TemplateSpans

TemplateMiddleList

TemplateTail

TemplateMiddleList의 ? SubstitutionEvaluation을 반환합니다.

TemplateMiddleList

TemplateMiddle

Expression

subRef를 Expression의 ? Evaluation으로 둡니다.
sub를 ? GetValue(subRef)로 둡니다.
« sub »를 반환합니다.

TemplateMiddleList

TemplateMiddle

Expression

preceding을 TemplateMiddleList의 ? SubstitutionEvaluation으로 둡니다.
nextRef를 Expression의 ? Evaluation으로 둡니다.
next를 ? GetValue(nextRef)로 둡니다.
preceding과 « next »의 목록 연결을 반환합니다.

13.2.8.6 Runtime Semantics: 평가

TemplateLiteral

NoSubstitutionTemplate

12.9.6에 정의된 NoSubstitutionTemplate의 TV를 반환합니다.

head를 12.9.6에 정의된 TemplateHead의 TV로 둡니다.
subRef를 Expression의 ? Evaluation으로 둡니다.
sub를 ? GetValue(subRef)로 둡니다.
middle을 ? ToString(sub)으로 둡니다.
tail을 TemplateSpans의 ? Evaluation으로 둡니다.
head, middle 및 tail의 문자열 연결을 반환합니다.

참고 1

Expression 값에 적용되는 문자열 변환 의미론은 + 연산자보다 String.prototype.concat과 유사합니다.

TemplateSpans

TemplateTail

12.9.6에 정의된 TemplateTail의 TV를 반환합니다.

TemplateSpans

TemplateMiddleList

TemplateTail

head를 TemplateMiddleList의 ? Evaluation으로 둡니다.
tail을 12.9.6에 정의된 TemplateTail의 TV로 둡니다.
head와 tail의 문자열 연결을 반환합니다.

TemplateMiddleList

TemplateMiddle

Expression

head를 12.9.6에 정의된 TemplateMiddle의 TV로 둡니다.
subRef를 Expression의 ? Evaluation으로 둡니다.
sub를 ? GetValue(subRef)로 둡니다.
middle을 ? ToString(sub)으로 둡니다.
head와 middle의 문자열 연결을 반환합니다.

참고 2

Expression 값에 적용되는 문자열 변환 의미론은 + 연산자보다 String.prototype.concat과 유사합니다.

TemplateMiddleList

TemplateMiddle

Expression

rest를 TemplateMiddleList의 ? Evaluation으로 둡니다.
middle을 12.9.6에 정의된 TemplateMiddle의 TV로 둡니다.
subRef를 Expression의 ? Evaluation으로 둡니다.
sub를 ? GetValue(subRef)로 둡니다.
last를 ? ToString(sub)으로 둡니다.
rest, middle 및 last의 문자열 연결을 반환합니다.

참고 3

Expression 값에 적용되는 문자열 변환 의미론은 + 연산자보다 String.prototype.concat과 유사합니다.

13.2.9 그룹화 연산자

13.2.9.1 Static Semantics: 조기 오류

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

CoverParenthesizedExpressionAndArrowParameterList는 ParenthesizedExpression을 포괄해야 합니다.

13.2.9.2 Runtime Semantics: 평가

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

expr을 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ParenthesizedExpression로 둡니다.
expr의 ? Evaluation을 반환합니다.

ParenthesizedExpression

(

Expression

)

Expression의 ? Evaluation을 반환합니다. 이는 Reference 타입일 수 있습니다.

참고

이 알고리즘은 Expression의 Evaluation에 GetValue를 적용하지 않습니다. 주된 이유는 delete 및 typeof와 같은 연산자를 괄호로 둘러싸인 표현식에 적용할 수 있도록 하기 위해서입니다.

13.3 좌변 표현식

구문

MemberExpression

[Yield, Await]

PrimaryExpression

[?Yield, ?Await]

MemberExpression

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, +Tagged]

[?Yield, ?Await]

new

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

super

[

Expression

[+In, ?Yield, ?Await]

]

super

new

target

ImportMeta

import

meta

NewExpression

[Yield, Await]

MemberExpression

[?Yield, ?Await]

new

NewExpression

[?Yield, ?Await]

CallExpression

[Yield, Await]

CoverCallExpressionAndAsyncArrowHead

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, +Tagged]

CallExpression

[?Yield, ?Await]

PrivateIdentifier

SuperCall

[Yield, Await]

super

Arguments

[?Yield, ?Await]

ImportCall

[Yield, Await]

import

(

AssignmentExpression

[+In, ?Yield, ?Await]

opt

)

import

(

AssignmentExpression

[+In, ?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

opt

)

Arguments

[Yield, Await]

(

)

(

ArgumentList

[?Yield, ?Await]

opt

)

ArgumentList

[Yield, Await]

AssignmentExpression

[+In, ?Yield, ?Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

ArgumentList

[?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

ArgumentList

[?Yield, ?Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

IdentifierName

TemplateLiteral

[?Yield, ?Await, +Tagged]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, +Tagged]

OptionalChain

[?Yield, ?Await]

PrivateIdentifier

LeftHandSideExpression

[Yield, Await]

NewExpression

[?Yield, ?Await]

CallExpression

[?Yield, ?Await]

OptionalExpression

[?Yield, ?Await]

보충 구문

다음 생성 규칙의 인스턴스를 처리할 때
CallExpression : CoverCallExpressionAndAsyncArrowHead
CoverCallExpressionAndAsyncArrowHead의 해석은 다음 문법을 사용하여 구체화됩니다:

CallMemberExpression

[Yield, Await]

MemberExpression

[?Yield, ?Await]

Arguments

[?Yield, ?Await]

13.3.1 정적 의미론

13.3.1.1 Static Semantics: 조기 오류

이 생성 규칙과 일치하는 소스 텍스트가 하나라도 있으면 Syntax Error입니다.

참고

이 생성 규칙은 자동 세미콜론 삽입 규칙(12.10)이 다음 코드에 적용되는 것을 방지하기 위해 존재합니다:

a?.b
`c`

즉, 이를 두 개의 유효한 문으로 해석하지 않도록 합니다. 목적은 선택적 체인이 없는 유사한 코드와 일관성을 유지하는 것입니다:

a.b
`c`

이는 유효한 문이며 자동 세미콜론 삽입이 적용되지 않습니다.

ImportMeta

import

meta

구문 목표 기호가 Module이 아니면 Syntax Error입니다.

13.3.2 프로퍼티 접근자

참고

프로퍼티에는 다음과 같은 점 표기법을 사용하여 이름으로 접근할 수 있습니다:

.

.

또는 다음과 같은 대괄호 표기법을 사용합니다:

[

]

[

]

점 표기법은 다음 구문 변환으로 설명할 수 있습니다:

MemberExpression

.

IdentifierName

의 동작은 다음과 동일합니다.

MemberExpression

[ <identifier-name-string> ]

마찬가지로

CallExpression

.

IdentifierName

의 동작은 다음과 동일합니다.

CallExpression

[ <identifier-name-string> ]

여기서 <identifier-name-string>은 IdentifierName의 StringValue입니다.

13.3.2.1 Runtime Semantics: 평가

MemberExpression

[

Expression

]

baseRef를 MemberExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
strict를 IsStrict(this MemberExpression)로 둡니다.
? EvaluatePropertyAccessWithExpressionKey(baseValue, Expression, strict)를 반환합니다.

MemberExpression

IdentifierName

baseRef를 MemberExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
strict를 IsStrict(this MemberExpression)로 둡니다.
EvaluatePropertyAccessWithIdentifierKey(baseValue, IdentifierName, strict)를 반환합니다.

MemberExpression

PrivateIdentifier

baseRef를 MemberExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
fieldNameString을 PrivateIdentifier의 StringValue로 둡니다.
MakePrivateReference(baseValue, fieldNameString)를 반환합니다.

CallExpression

[

Expression

]

baseRef를 CallExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
strict를 IsStrict(this CallExpression)로 둡니다.
? EvaluatePropertyAccessWithExpressionKey(baseValue, Expression, strict)를 반환합니다.

CallExpression

IdentifierName

baseRef를 CallExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
strict를 IsStrict(this CallExpression)로 둡니다.
EvaluatePropertyAccessWithIdentifierKey(baseValue, IdentifierName, strict)를 반환합니다.

CallExpression

PrivateIdentifier

baseRef를 CallExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
fieldNameString을 PrivateIdentifier의 StringValue로 둡니다.
MakePrivateReference(baseValue, fieldNameString)를 반환합니다.

13.3.3 EvaluatePropertyAccessWithExpressionKey ( `baseValue`, `expr`, `strict` )

추상 연산 EvaluatePropertyAccessWithExpressionKey. 인수 baseValue (ECMAScript 언어 값), expr (an Expression Parse Node) 및 strict (Boolean). 반환값: (정상 완료 (값: Reference 레코드) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

propertyNameRef를 expr의 ? Evaluation으로 둡니다.
propertyNameValue를 ? GetValue(propertyNameRef)로 둡니다.
참고: 대부분의 경우 이 단계 직후 propertyNameValue에 ToPropertyKey를 수행합니다. 그러나 a[b] = c의 경우에는 c를 평가한 후까지 수행하지 않습니다.
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameValue, [[Strict]]: strict, [[ThisValue]]: empty }를 반환합니다.

13.3.4 EvaluatePropertyAccessWithIdentifierKey ( `baseValue`, `identifierName`, `strict` )

추상 연산 EvaluatePropertyAccessWithIdentifierKey. 인수 baseValue (ECMAScript 언어 값), identifierName (an IdentifierName Parse Node) 및 strict (Boolean). 반환값: Reference 레코드. 호출되면 다음 단계를 수행한다.

propertyNameString을 identifierName의 StringValue로 둡니다.
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]: empty }를 반환합니다.

13.3.5 `new` 연산자

13.3.5.1 Runtime Semantics: 평가

NewExpression

new

NewExpression

? EvaluateNew(NewExpression, empty)을 반환합니다.

MemberExpression

new

MemberExpression

Arguments

? EvaluateNew(MemberExpression, Arguments)를 반환합니다.

13.3.5.1.1 EvaluateNew ( `constructExpr`, `argumentsNode` )

추상 연산 EvaluateNew. 인수 constructExpr ((a NewExpression Parse Node 또는 a MemberExpression Parse Node)) 및 argumentsNode ((empty 또는 an Arguments Parse Node)). 반환값: (정상 완료 (값: Object) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

ref를 constructExpr의 ? Evaluation으로 둡니다.
ctor를 ? GetValue(ref)로 둡니다.
argumentsNode가 empty이면, 다음을 수행합니다.
1. argList를 새로운 빈 List로 둡니다.
그렇지 않으면,
1. argList를 argumentsNode의 ? ArgumentListEvaluation으로 둡니다.
IsConstructor(ctor)가 false이면 TypeError 예외를 던집니다.
? Construct(ctor, argList)를 반환합니다.

13.3.6 함수 호출

13.3.6.1 Runtime Semantics: 평가

CallExpression

CoverCallExpressionAndAsyncArrowHead

expr을 CoverCallExpressionAndAsyncArrowHead가 포괄하는 CallMemberExpression로 둡니다.
memberExpr을 expr의 MemberExpression로 둡니다.
args를 expr의 Arguments로 둡니다.
ref를 memberExpr의 ? Evaluation으로 둡니다.
func를 ? GetValue(ref)로 둡니다.
ref가 Reference Record이고 IsPropertyReference(ref)가 false이며 ref.[[ReferencedName]]이 "eval"이면, 다음을 수행합니다.
1. SameValue(func, %eval%)가 true이면, 다음을 수행합니다.
  1. argList를 args의 ? ArgumentListEvaluation으로 둡니다.
  2. argList에 요소가 없으면 undefined를 반환합니다.
  3. evalArg를 argList의 첫 번째 요소로 둡니다.
  4. IsStrict(this CallExpression)가 true이면 strictCaller를 true로 둡니다. 그렇지 않으면 strictCaller를 false로 둡니다.
  5. ? PerformEval(evalArg, strictCaller, true)를 반환합니다.
thisCall을 이 CallExpression로 둡니다.
tailCall을 IsInTailPosition(thisCall)으로 둡니다.
? EvaluateCall(func, ref, args, tailCall)을 반환합니다.

6.a.v 단계를 실행하는 CallExpression 평가는 직접 eval입니다.

CallExpression

Arguments

ref를 CallExpression의 ? Evaluation으로 둡니다.
func를 ? GetValue(ref)로 둡니다.
thisCall을 이 CallExpression로 둡니다.
tailCall을 IsInTailPosition(thisCall)으로 둡니다.
? EvaluateCall(func, ref, Arguments, tailCall)을 반환합니다.

13.3.6.2 EvaluateCall ( `func`, `thisValueRef`, `argumentListNode`, `tailPosition` )

추상 연산 EvaluateCall. 인수 func (ECMAScript 언어 값), thisValueRef ((ECMAScript 언어 값 또는 Reference 레코드)), argumentListNode (구문 분석 노드) 및 tailPosition (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

thisValueRef가 Reference Record이면, 다음을 수행합니다.
1. IsPropertyReference(thisValueRef)가 true이면, 다음을 수행합니다.
  1. thisValue를 GetThisValue(thisValueRef)로 둡니다.
2. 그렇지 않으면,
  1. refEnv를 thisValueRef.[[Base]]로 둡니다.
  2. 단언: refEnv는 Environment Record입니다.
  3. thisValue를 refEnv.WithBaseObject()로 둡니다.
그렇지 않으면,
1. thisValue를 undefined로 둡니다.
argList를 argumentListNode의 ? ArgumentListEvaluation으로 둡니다.
func가 Object가 아니면 TypeError 예외를 던집니다.
IsCallable(func)이 false이면 TypeError 예외를 던집니다.
tailPosition이 true이면 PrepareForTailCall()을 수행합니다.
? Call(func, thisValue, argList)을 반환합니다.

13.3.7 `super` 키워드

13.3.7.1 Runtime Semantics: 평가

SuperProperty

super

[

Expression

]

envRecord를 GetThisEnvironment()로 둡니다.
actualThis를 ? envRecord.GetThisBinding()으로 둡니다.
propertyNameRef를 Expression의 ? Evaluation으로 둡니다.
propertyNameValue를 ? GetValue(propertyNameRef)로 둡니다.
strict를 IsStrict(this SuperProperty)로 둡니다.
참고: 대부분의 경우 이 단계 직후 propertyNameValue에 ToPropertyKey를 수행합니다. 그러나 super[b] = c의 경우에는 c를 평가한 후까지 수행하지 않습니다.
MakeSuperPropertyReference(actualThis, propertyNameValue, strict)를 반환합니다.

SuperProperty

super

IdentifierName

envRecord를 GetThisEnvironment()로 둡니다.
actualThis를 ? envRecord.GetThisBinding()으로 둡니다.
propertyKey를 IdentifierName의 StringValue로 둡니다.
strict를 IsStrict(this SuperProperty)로 둡니다.
MakeSuperPropertyReference(actualThis, propertyKey, strict)를 반환합니다.

SuperCall

super

Arguments

newTarget을 GetNewTarget()으로 둡니다.
단언: newTarget은 constructor입니다.
superCtor를 GetSuperConstructor()로 둡니다.
argList를 Arguments의 ? ArgumentListEvaluation으로 둡니다.
IsConstructor(superCtor)가 false이면 TypeError 예외를 던집니다.
result를 ? Construct(superCtor, argList, newTarget)로 둡니다.
thisER을 GetThisEnvironment()로 둡니다.
단언: thisER은 Function Environment Record입니다.
? BindThisValue(thisER, result)를 수행합니다.
funcObj를 thisER.[[FunctionObject]]로 둡니다.
단언: funcObj는 ECMAScript 함수 객체입니다.
? InitializeInstanceElements(result, funcObj)를 수행합니다.
result를 반환합니다.

13.3.7.2 GetSuperConstructor ( )

추상 연산 GetSuperConstructor. 인수 없음. 반환값: (Object 또는 null). 호출되면 다음 단계를 수행한다.

envRecord를 GetThisEnvironment()로 둡니다.
단언: envRecord는 Function Environment Record입니다.
activeFunc를 envRecord.[[FunctionObject]]로 둡니다.
단언: activeFunc는 ECMAScript 함수 객체입니다.
superCtor를 ! activeFunc.[[GetPrototypeOf]]()로 둡니다.
superCtor를 반환합니다.

13.3.7.3 MakeSuperPropertyReference ( `actualThis`, `propertyKey`, `strict` )

추상 연산 MakeSuperPropertyReference. 인수 actualThis (ECMAScript 언어 값), propertyKey (ECMAScript 언어 값) 및 strict (Boolean). 반환값: Super Reference 레코드. 호출되면 다음 단계를 수행한다.

envRecord를 GetThisEnvironment()로 둡니다.
단언: envRecord.HasSuperBinding()은 true입니다.
단언: envRecord는 Function Environment Record입니다.
baseValue를 GetSuperBase(envRecord)로 둡니다.
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis }를 반환합니다.

13.3.8 인수 목록

참고

인수 목록을 평가하면 값의 List가 생성됩니다.

13.3.8.1 Runtime Semantics: ArgumentListEvaluation

구문 지향 연산 ArgumentListEvaluation. 인수 없음. 반환값: (정상 완료 (값: 리스트 (요소: ECMAScript 언어 값)) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

Arguments

(

)

새로운 빈 List를 반환합니다.

ArgumentList

AssignmentExpression

ref를 AssignmentExpression의 ? Evaluation으로 둡니다.
arg를 ? GetValue(ref)로 둡니다.
« arg »를 반환합니다.

ArgumentList

...

AssignmentExpression

list를 새로운 빈 List로 둡니다.
spreadRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
spreadObj를 ? GetValue(spreadRef)로 둡니다.
iteratorRecord를 ? GetIterator(spreadObj, sync)로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면 list를 반환합니다.
3. next를 list에 추가합니다.

ArgumentList

AssignmentExpression

precedingArgs를 ArgumentList의 ? ArgumentListEvaluation으로 둡니다.
ref를 AssignmentExpression의 ? Evaluation으로 둡니다.
arg를 ? GetValue(ref)로 둡니다.
precedingArgs와 « arg »의 목록 연결을 반환합니다.

ArgumentList

...

AssignmentExpression

precedingArgs를 ArgumentList의 ? ArgumentListEvaluation으로 둡니다.
spreadRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
iteratorRecord를 ? GetIterator(? GetValue(spreadRef), sync)로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면 precedingArgs를 반환합니다.
3. next를 precedingArgs에 추가합니다.

TemplateLiteral

NoSubstitutionTemplate

templateLiteral을 이 TemplateLiteral로 둡니다.
siteObj를 GetTemplateObject(templateLiteral)로 둡니다.
« siteObj »를 반환합니다.

TemplateLiteral

SubstitutionTemplate

templateLiteral을 이 TemplateLiteral로 둡니다.
siteObj를 GetTemplateObject(templateLiteral)로 둡니다.
remaining을 SubstitutionTemplate의 ? ArgumentListEvaluation으로 둡니다.
« siteObj »와 remaining의 목록 연결을 반환합니다.

firstSubRef를 Expression의 ? Evaluation으로 둡니다.
firstSub를 ? GetValue(firstSubRef)로 둡니다.
restSub를 TemplateSpans의 ? SubstitutionEvaluation으로 둡니다.
단언: restSub는 비어 있을 수도 있는 List입니다.
« firstSub »와 restSub의 목록 연결을 반환합니다.

13.3.9 선택적 체인

참고

선택적 체인은 하나 이상의 프로퍼티 접근 및 함수 호출로 구성된 체인이며, 그 첫 번째 항목은 토큰 ?.로 시작합니다.

13.3.9.1 Runtime Semantics: 평가

OptionalExpression

MemberExpression

OptionalChain

baseRef를 MemberExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
baseValue가 undefined 또는 null이면, 다음을 수행합니다.
1. undefined를 반환합니다.
인수 baseValue 및 baseRef를 사용한 OptionalChain의 ? ChainEvaluation을 반환합니다.

OptionalExpression

CallExpression

OptionalChain

baseRef를 CallExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
baseValue가 undefined 또는 null이면, 다음을 수행합니다.
1. undefined를 반환합니다.
인수 baseValue 및 baseRef를 사용한 OptionalChain의 ? ChainEvaluation을 반환합니다.

OptionalExpression

OptionalChain

baseRef를 OptionalExpression의 ? Evaluation으로 둡니다.
baseValue를 ? GetValue(baseRef)로 둡니다.
baseValue가 undefined 또는 null이면, 다음을 수행합니다.
1. undefined를 반환합니다.
인수 baseValue 및 baseRef를 사용한 OptionalChain의 ? ChainEvaluation을 반환합니다.

13.3.9.2 Runtime Semantics: ChainEvaluation

구문 지향 연산 ChainEvaluation. 인수 baseValue (ECMAScript 언어 값) 및 baseRef ((ECMAScript 언어 값 또는 Reference 레코드)). 반환값: (정상 완료 (값: (ECMAScript 언어 값 또는 Reference 레코드)) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

OptionalChain

Arguments

thisChain을 이 OptionalChain로 둡니다.
tailCall을 IsInTailPosition(thisChain)으로 둡니다.
? EvaluateCall(baseValue, baseRef, Arguments, tailCall)을 반환합니다.

OptionalChain

[

Expression

]

strict를 IsStrict(this OptionalChain)로 둡니다.
? EvaluatePropertyAccessWithExpressionKey(baseValue, Expression, strict)를 반환합니다.

OptionalChain

IdentifierName

strict를 IsStrict(this OptionalChain)로 둡니다.
EvaluatePropertyAccessWithIdentifierKey(baseValue, IdentifierName, strict)를 반환합니다.

OptionalChain

PrivateIdentifier

fieldNameString을 PrivateIdentifier의 StringValue로 둡니다.
MakePrivateReference(baseValue, fieldNameString)를 반환합니다.

OptionalChain

Arguments

optionalChain을 OptionalChain로 둡니다.
newRef를 인수 baseValue 및 baseRef를 사용한 optionalChain의 ? ChainEvaluation으로 둡니다.
newValue를 ? GetValue(newRef)로 둡니다.
thisChain을 이 OptionalChain로 둡니다.
tailCall을 IsInTailPosition(thisChain)으로 둡니다.
? EvaluateCall(newValue, newRef, Arguments, tailCall)을 반환합니다.

OptionalChain

[

Expression

]

optionalChain을 OptionalChain로 둡니다.
newRef를 인수 baseValue 및 baseRef를 사용한 optionalChain의 ? ChainEvaluation으로 둡니다.
newValue를 ? GetValue(newRef)로 둡니다.
strict를 IsStrict(this OptionalChain)로 둡니다.
? EvaluatePropertyAccessWithExpressionKey(newValue, Expression, strict)를 반환합니다.

OptionalChain

IdentifierName

optionalChain을 OptionalChain로 둡니다.
newRef를 인수 baseValue 및 baseRef를 사용한 optionalChain의 ? ChainEvaluation으로 둡니다.
newValue를 ? GetValue(newRef)로 둡니다.
strict를 IsStrict(this OptionalChain)로 둡니다.
EvaluatePropertyAccessWithIdentifierKey(newValue, IdentifierName, strict)를 반환합니다.

OptionalChain

PrivateIdentifier

optionalChain을 OptionalChain로 둡니다.
newRef를 인수 baseValue 및 baseRef를 사용한 optionalChain의 ? ChainEvaluation으로 둡니다.
newValue를 ? GetValue(newRef)로 둡니다.
fieldNameString을 PrivateIdentifier의 StringValue로 둡니다.
MakePrivateReference(newValue, fieldNameString)를 반환합니다.

13.3.10 Import 호출

13.3.10.1 Runtime Semantics: 평가

ImportCall

import

(

AssignmentExpression

opt

)

? EvaluateImportCall(AssignmentExpression)을 반환합니다.

ImportCall

import

(

AssignmentExpression

opt

)

? EvaluateImportCall(첫 번째 AssignmentExpression, 두 번째 AssignmentExpression)을 반환합니다.

13.3.10.2 EvaluateImportCall ( `specifierExpr` [ , `optionsExpr` ] )

추상 연산 EvaluateImportCall. 인수 specifierExpr (구문 분석 노드) 및 선택적 인수 optionsExpr (구문 분석 노드). 반환값: (정상 완료 (값: Promise) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

referrer를 GetActiveScriptOrModule()로 둡니다.
referrer가 null이면 referrer를 현재 Realm Record로 설정합니다.
specifierRef를 specifierExpr의 ? Evaluation으로 둡니다.
specifier를 ? GetValue(specifierRef)로 둡니다.
optionsExpr이 존재하면, 다음을 수행합니다.
1. optionsRef를 optionsExpr의 ? Evaluation으로 둡니다.
2. options를 ? GetValue(optionsRef)로 둡니다.
그렇지 않으면,
1. options를 undefined로 둡니다.
promiseCapability를 ! NewPromiseCapability(%Promise%)로 둡니다.
specifierString을 Completion(ToString(specifier))으로 둡니다.
IfAbruptRejectPromise(specifierString, promiseCapability).
attrs를 새로운 빈 List로 둡니다.
options가 undefined가 아니면, 다음을 수행합니다.
1. options가 Object가 아니면, 다음을 수행합니다.
  1. ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
  2. promiseCapability.[[Promise]]를 반환합니다.
2. attrsObj를 Completion(Get(options, "with"))로 둡니다.
3. IfAbruptRejectPromise(attrsObj, promiseCapability).
4. attrsObj가 undefined가 아니면, 다음을 수행합니다.
  1. attrsObj가 Object가 아니면, 다음을 수행합니다.
    1. ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
    2. promiseCapability.[[Promise]]를 반환합니다.
  2. entries를 Completion(EnumerableOwnProperties(attrsObj, key+value))로 둡니다.
  3. IfAbruptRejectPromise(entries, promiseCapability).
  4. entries의 각 요소 entry에 대해 다음을 수행합니다.
    1. key를 ! Get(entry, "0")으로 둡니다.
    2. value를 ! Get(entry, "1")로 둡니다.
    3. key가 String이면, 다음을 수행합니다.
      1. value가 String이 아니면, 다음을 수행합니다.
        ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
        promiseCapability.[[Promise]]를 반환합니다.
      2. ImportAttribute Record { [[Key]]: key, [[Value]]: value }를 attrs에 추가합니다.
5. AllImportAttributesSupported(attrs)가 false이면, 다음을 수행합니다.
  1. ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
  2. promiseCapability.[[Promise]]를 반환합니다.
6. 각 [[Key]] 필드의 값을 UTF-16 코드 단위 값의 시퀀스로 취급하여 해당 [[Key]] 필드의 사전식 순서에 따라 attrs를 정렬합니다. 참고: 호스트가 속성이 열거되는 순서를 기반으로 동작을 변경하는 것이 금지되어 있다는 점에서만 이 정렬을 관찰할 수 있습니다.
moduleRequest를 새로운 ModuleRequest Record { [[Specifier]]: specifierString, [[Attributes]]: attrs }로 둡니다.
HostLoadImportedModule(referrer, moduleRequest, empty, promiseCapability)을 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

13.3.10.3 ContinueDynamicImport ( `promiseCapability`, `moduleCompletion` )

추상 연산 ContinueDynamicImport. 인수 promiseCapability (PromiseCapability 레코드) 및 moduleCompletion ((정상 완료 (값: Module 레코드) 또는 throw 완료)). 반환값: unused. import() 호출로 처음 시작된 동적 가져오기 과정을 완료하고, 해당 호출이 반환한 Promise를 적절히 이행하거나 거부합니다. 호출되면 다음 단계를 수행한다.

moduleCompletion이 비정상 완료이면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « moduleCompletion.[[Value]] »)를 수행합니다.
2. unused를 반환합니다.
module을 moduleCompletion.[[Value]]로 둡니다.
loadPromise를 module.LoadRequestedModules()로 둡니다.
rejectedClosure를 매개변수 (reason)를 갖고 promiseCapability을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. ! Call(promiseCapability.[[Reject]], undefined, « reason »)를 수행합니다.
2. NormalCompletion(undefined)을 반환합니다.
onRejected를 CreateBuiltinFunction(rejectedClosure, 1, "", « »)로 둡니다.
linkAndEvaluateClosure를 매개변수가 없고 module, promiseCapability 및 onRejected를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. link를 Completion(module.Link())으로 둡니다.
2. link가 비정상 완료이면, 다음을 수행합니다.
  1. ! Call(promiseCapability.[[Reject]], undefined, « link.[[Value]] »)를 수행합니다.
  2. NormalCompletion(undefined)을 반환합니다.
3. evaluatePromise를 module.Evaluate()로 둡니다.
4. fulfilledClosure를 매개변수가 없고 module 및 promiseCapability을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. namespace를 GetModuleNamespace(module)로 둡니다.
  2. ! Call(promiseCapability.[[Resolve]], undefined, « namespace »)를 수행합니다.
  3. NormalCompletion(undefined)을 반환합니다.
5. onFulfilled를 CreateBuiltinFunction(fulfilledClosure, 0, "", « »)로 둡니다.
6. PerformPromiseThen(evaluatePromise, onFulfilled, onRejected)을 수행합니다.
7. unused를 반환합니다.
linkAndEvaluate를 CreateBuiltinFunction(linkAndEvaluateClosure, 0, "", « »)로 둡니다.
PerformPromiseThen(loadPromise, linkAndEvaluate, onRejected)을 수행합니다.
unused를 반환합니다.

13.3.11 태그된 템플릿

참고

태그된 템플릿은 호출의 인수가 TemplateLiteral(13.2.8)에서 파생되는 함수 호출입니다. 실제 인수에는 템플릿 객체(13.2.8.4)와 TemplateLiteral 안에 삽입된 표현식을 평가하여 생성된 값이 포함됩니다.

13.3.11.1 Runtime Semantics: 평가

MemberExpression

TemplateLiteral

tagRef를 MemberExpression의 ? Evaluation으로 둡니다.
tagFunc를 ? GetValue(tagRef)로 둡니다.
thisCall을 이 MemberExpression로 둡니다.
tailCall을 IsInTailPosition(thisCall)으로 둡니다.
? EvaluateCall(tagFunc, tagRef, TemplateLiteral, tailCall)을 반환합니다.

CallExpression

TemplateLiteral

tagRef를 CallExpression의 ? Evaluation으로 둡니다.
tagFunc를 ? GetValue(tagRef)로 둡니다.
thisCall을 이 CallExpression로 둡니다.
tailCall을 IsInTailPosition(thisCall)으로 둡니다.
? EvaluateCall(tagFunc, tagRef, TemplateLiteral, tailCall)을 반환합니다.

13.3.12 메타 프로퍼티

13.3.12.1 Runtime Semantics: 평가

NewTarget

new

target

GetNewTarget()을 반환합니다.

ImportMeta

import

meta

module을 GetActiveScriptOrModule()로 둡니다.
단언: module은 Source Text Module Record입니다.
importMeta를 module.[[ImportMeta]]로 둡니다.
importMeta가 empty이면, 다음을 수행합니다.
1. importMeta를 OrdinaryObjectCreate(null)로 설정합니다.
2. importMetaValues를 HostGetImportMetaProperties(module)로 둡니다.
3. importMetaValues의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
  1. ! CreateDataPropertyOrThrow(importMeta, entry.[[Key]], entry.[[Value]])를 수행합니다.
4. HostFinalizeImportMeta(importMeta, module)를 수행합니다.
5. module.[[ImportMeta]]를 importMeta로 설정합니다.
6. importMeta를 반환합니다.
단언: importMeta는 Object입니다.
importMeta를 반환합니다.

13.3.12.1.1 HostGetImportMetaProperties ( `moduleRecord` )

호스트 정의 추상 연산 HostGetImportMetaProperties. 인수 moduleRecord (Module 레코드). 반환값: 리스트 (요소: 레코드 (필드: [[Key]] (프로퍼티 키), [[Value]] (ECMAScript 언어 값))). 호스트가 import.meta에서 반환하는 객체에 사용할 프로퍼티 키와 값을 제공할 수 있도록 합니다.

HostGetImportMetaProperties의 기본 구현은 새로운 빈 List를 반환합니다.

13.3.12.1.2 HostFinalizeImportMeta ( `importMeta`, `moduleRecord` )

호스트 정의 추상 연산 HostFinalizeImportMeta. 인수 importMeta (Object) 및 moduleRecord (Module 레코드). 반환값: unused. 호스트가 import.meta에서 반환하는 객체를 준비하기 위해 모든 특수 연산을 수행할 수 있도록 합니다.

대부분의 호스트는 HostGetImportMetaProperties만 정의하고 HostFinalizeImportMeta는 기본 동작 그대로 둘 수 있습니다. 그러나 HostFinalizeImportMeta는 객체가 ECMAScript 코드에 노출되기 전에 이를 직접 조작해야 하는 호스트를 위한 “탈출구”를 제공합니다.

HostFinalizeImportMeta의 기본 구현은 unused를 반환합니다.

13.4 갱신 표현식

구문

UpdateExpression

[Yield, Await]

LeftHandSideExpression

[?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

[no LineTerminator here]

LeftHandSideExpression

[?Yield, ?Await]

[no LineTerminator here]

UnaryExpression

[?Yield, ?Await]

UnaryExpression

[?Yield, ?Await]

13.4.1 Static Semantics: 조기 오류

UpdateExpression

LeftHandSideExpression

LeftHandSideExpression의 AssignmentTargetType이 invalid이면 조기 Syntax Error입니다.

UpdateExpression

UnaryExpression

UnaryExpression의 AssignmentTargetType이 invalid이면 조기 Syntax Error입니다.

13.4.2 후위 증가 연산자

13.4.2.1 Runtime Semantics: 평가

UpdateExpression

LeftHandSideExpression

lhs를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
LeftHandSideExpression의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
oldValue를 ? ToNumeric(? GetValue(lhs))로 둡니다.
oldValue가 Number이면, 다음을 수행합니다.
1. newValue를 Number::add(oldValue, 1_𝔽)로 둡니다.
그렇지 않으면,
1. 단언: oldValue는 BigInt입니다.
2. newValue를 BigInt::add(oldValue, 1_ℤ)로 둡니다.
? PutValue(lhs, newValue)를 수행합니다.
oldValue를 반환합니다.

13.4.3 후위 감소 연산자

13.4.3.1 Runtime Semantics: 평가

UpdateExpression

LeftHandSideExpression

lhs를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
LeftHandSideExpression의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
oldValue를 ? ToNumeric(? GetValue(lhs))로 둡니다.
oldValue가 Number이면, 다음을 수행합니다.
1. newValue를 Number::subtract(oldValue, 1_𝔽)로 둡니다.
그렇지 않으면,
1. 단언: oldValue는 BigInt입니다.
2. newValue를 BigInt::subtract(oldValue, 1_ℤ)로 둡니다.
? PutValue(lhs, newValue)를 수행합니다.
oldValue를 반환합니다.

13.4.4 전위 증가 연산자

13.4.4.1 Runtime Semantics: 평가

UpdateExpression

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
UnaryExpression의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
oldValue를 ? ToNumeric(? GetValue(expr))로 둡니다.
oldValue가 Number이면, 다음을 수행합니다.
1. newValue를 Number::add(oldValue, 1_𝔽)로 둡니다.
그렇지 않으면,
1. 단언: oldValue는 BigInt입니다.
2. newValue를 BigInt::add(oldValue, 1_ℤ)로 둡니다.
? PutValue(expr, newValue)를 수행합니다.
newValue를 반환합니다.

13.4.5 전위 감소 연산자

13.4.5.1 Runtime Semantics: 평가

UpdateExpression

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
UnaryExpression의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
oldValue를 ? ToNumeric(? GetValue(expr))로 둡니다.
oldValue가 Number이면, 다음을 수행합니다.
1. newValue를 Number::subtract(oldValue, 1_𝔽)로 둡니다.
그렇지 않으면,
1. 단언: oldValue는 BigInt입니다.
2. newValue를 BigInt::subtract(oldValue, 1_ℤ)로 둡니다.
? PutValue(expr, newValue)를 수행합니다.
newValue를 반환합니다.

13.5 단항 연산자

구문

UnaryExpression

[Yield, Await]

UpdateExpression

[?Yield, ?Await]

delete

UnaryExpression

[?Yield, ?Await]

void

UnaryExpression

[?Yield, ?Await]

typeof

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[+Await]

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[?Yield]

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[Yield]

await

UnaryExpression

[?Yield, +Await]

보충 구문

다음 생성 규칙의 인스턴스를 처리할 때
UnaryExpression : CoverAwaitExpressionAndAwaitUsingDeclarationHead
CoverAwaitExpressionAndAwaitUsingDeclarationHead의 해석은 다음 문법을 사용하여 구체화됩니다:

AwaitExpression

[Yield]

await

UnaryExpression

[?Yield, +Await]

13.5.1 `delete` 연산자

13.5.1.1 Static Semantics: 조기 오류

UnaryExpression

delete

UnaryExpression

IsStrict(the UnaryExpression)가 true이고 파생된 UnaryExpression이 PrimaryExpression : IdentifierReference , MemberExpression : MemberExpression . PrivateIdentifier , CallExpression : CallExpression . PrivateIdentifier , OptionalChain : ?. PrivateIdentifier 또는 OptionalChain : OptionalChain . PrivateIdentifier 이면 Syntax Error입니다.
파생된 UnaryExpression이
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
이고 CoverParenthesizedExpressionAndArrowParameterList가 최종적으로 UnaryExpression 대신 사용했을 때 이 규칙에 따라 Syntax Error를 생성하는 구를 파생하면 Syntax Error입니다. 이 규칙은 재귀적으로 적용됩니다.

참고

마지막 규칙은 첫 번째 규칙을 재귀적으로 적용하기 때문에 delete (((foo)))와 같은 표현식이 조기 오류를 생성함을 의미합니다.

13.5.1.2 Runtime Semantics: 평가

UnaryExpression

delete

UnaryExpression

ref를 UnaryExpression의 ? Evaluation으로 둡니다.
ref가 Reference Record가 아니면 true를 반환합니다.
IsUnresolvableReference(ref)가 true이면, 다음을 수행합니다.
1. 단언: ref.[[Strict]]은 false입니다.
2. true를 반환합니다.
IsPropertyReference(ref)가 true이면, 다음을 수행합니다.
1. 단언: IsPrivateReference(ref)는 false입니다.
2. IsSuperReference(ref)가 true이면 ReferenceError 예외를 던집니다.
3. baseObj를 ? ToObject(ref.[[Base]])로 둡니다.
4. ref.[[ReferencedName]]이 프로퍼티 키가 아니면, 다음을 수행합니다.
  1. ref.[[ReferencedName]]을 ? ToPropertyKey(ref.[[ReferencedName]])로 설정합니다.
5. deleteStatus를 ? baseObj.[[Delete]](ref.[[ReferencedName]])로 둡니다.
6. deleteStatus가 false이고 ref.[[Strict]]이 true이면 TypeError 예외를 던집니다.
7. deleteStatus를 반환합니다.
base를 ref.[[Base]]로 둡니다.
단언: base는 Environment Record입니다.
? base.DeleteBinding(ref.[[ReferencedName]])을 반환합니다.

참고 1

delete 연산자가 엄격 모드 코드 안에 나타날 때 그 UnaryExpression이 변수, 함수 인수 또는 함수 이름에 대한 직접 참조이면 SyntaxError 예외가 던져집니다. 또한 delete 연산자가 엄격 모드 코드 안에 나타나고 삭제할 프로퍼티의 속성이 { [[Configurable]]: false }이거나 다른 이유로 삭제할 수 없으면 TypeError 예외가 던져집니다.

참고 2

4.c 단계에서 생성될 수 있는 객체는 위 추상 연산과 일반 객체 [[Delete]] 내부 메서드 바깥에서는 접근할 수 없습니다. 구현체는 실제로 해당 객체를 생성하지 않도록 선택할 수 있습니다.

13.5.2 `void` 연산자

13.5.2.1 Runtime Semantics: 평가

UnaryExpression

void

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
? GetValue(expr)를 수행합니다.
undefined를 반환합니다.

참고

값을 사용하지 않더라도 관찰 가능한 부작용이 있을 수 있으므로 GetValue를 호출해야 합니다.

13.5.3 `typeof` 연산자

13.5.3.1 Runtime Semantics: 평가

UnaryExpression

typeof

UnaryExpression

value를 UnaryExpression의 ? Evaluation으로 둡니다.
value가 Reference Record이면, 다음을 수행합니다.
1. IsUnresolvableReference(value)가 true이면 "undefined"를 반환합니다.
value를 ? GetValue(value)로 설정합니다.
value가 undefined이면 "undefined"를 반환합니다.
value가 null이면 "object"를 반환합니다.
value가 String이면 "string"을 반환합니다.
value가 Symbol이면 "symbol"을 반환합니다.
value가 Boolean이면 "boolean"을 반환합니다.
value가 Number이면 "number"를 반환합니다.
value가 BigInt이면 "bigint"를 반환합니다.
단언: value는 Object입니다.
Normative Optional
호스트가 웹 브라우저이거나 그 밖의 방식으로 [[IsHTMLDDA]] 내부 슬롯을 지원하면, 다음을 수행합니다.
1. value에 [[IsHTMLDDA]] 내부 슬롯이 있으면 "undefined"를 반환합니다.
value에 [[Call]] 내부 메서드가 있으면 "function"을 반환합니다.
"object"를 반환합니다.

13.5.4 단항 `+` 연산자

참고

단항 + 연산자는 피연산자를 Number 타입으로 변환합니다.

13.5.4.1 Runtime Semantics: 평가

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
? ToNumber(? GetValue(expr))를 반환합니다.

13.5.5 단항 `-` 연산자

참고

단항 - 연산자는 피연산자를 숫자 값으로 변환한 다음 부호를 반전합니다. +0_𝔽의 부호를 반전하면 -0_𝔽이 되고, -0_𝔽의 부호를 반전하면 +0_𝔽이 됩니다.

13.5.5.1 Runtime Semantics: 평가

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
oldValue를 ? ToNumeric(? GetValue(expr))로 둡니다.
oldValue가 Number이면 Number::unaryMinus(oldValue)를 반환합니다.
단언: oldValue는 BigInt입니다.
BigInt::unaryMinus(oldValue)를 반환합니다.

13.5.6 비트 NOT 연산자 ( `~` )

13.5.6.1 Runtime Semantics: 평가

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
oldValue를 ? ToNumeric(? GetValue(expr))로 둡니다.
oldValue가 Number이면 Number::bitwiseNOT(oldValue)을 반환합니다.
단언: oldValue는 BigInt입니다.
BigInt::bitwiseNOT(oldValue)을 반환합니다.

13.5.7 논리 NOT 연산자 ( `!` )

13.5.7.1 Runtime Semantics: 평가

UnaryExpression

expr을 UnaryExpression의 ? Evaluation으로 둡니다.
oldValue를 ToBoolean(? GetValue(expr))로 둡니다.
oldValue가 true이면 false를 반환합니다.
true를 반환합니다.

13.6 지수 연산자

구문

ExponentiationExpression

[Yield, Await]

UnaryExpression

[?Yield, ?Await]

UpdateExpression

[?Yield, ?Await]

ExponentiationExpression

[?Yield, ?Await]

13.6.1 Runtime Semantics: 평가

ExponentiationExpression

UpdateExpression

ExponentiationExpression

? EvaluateStringOrNumericBinaryExpression(UpdateExpression, **, ExponentiationExpression)을 반환합니다.

13.7 곱셈 연산자

구문

MultiplicativeExpression

[Yield, Await]

ExponentiationExpression

[?Yield, ?Await]

MultiplicativeExpression

[?Yield, ?Await]

MultiplicativeOperator

ExponentiationExpression

[?Yield, ?Await]

MultiplicativeOperator

one of

참고

* 연산자는 곱셈을 수행하여 피연산자의 곱을 생성합니다.
/ 연산자는 나눗셈을 수행하여 피연산자의 몫을 생성합니다.
% 연산자는 암묵적인 나눗셈에서 피연산자의 나머지를 생성합니다.

13.7.1 Runtime Semantics: 평가

MultiplicativeExpression

MultiplicativeOperator

ExponentiationExpression

opText를 MultiplicativeOperator와 일치하는 소스 텍스트로 둡니다.
? EvaluateStringOrNumericBinaryExpression(MultiplicativeExpression, opText, ExponentiationExpression)을 반환합니다.

13.8 가산 연산자

구문

AdditiveExpression

[Yield, Await]

MultiplicativeExpression

[?Yield, ?Await]

AdditiveExpression

[?Yield, ?Await]

MultiplicativeExpression

[?Yield, ?Await]

AdditiveExpression

[?Yield, ?Await]

MultiplicativeExpression

[?Yield, ?Await]

13.8.1 덧셈 연산자 ( `+` )

참고

덧셈 연산자는 문자열 연결 또는 숫자 덧셈을 수행합니다.

13.8.1.1 Runtime Semantics: 평가

AdditiveExpression

MultiplicativeExpression

? EvaluateStringOrNumericBinaryExpression(AdditiveExpression, +, MultiplicativeExpression)을 반환합니다.

13.8.2 뺄셈 연산자 ( `-` )

참고

- 연산자는 뺄셈을 수행하여 피연산자의 차를 생성합니다.

13.8.2.1 Runtime Semantics: 평가

AdditiveExpression

MultiplicativeExpression

? EvaluateStringOrNumericBinaryExpression(AdditiveExpression, -, MultiplicativeExpression)을 반환합니다.

13.9 비트 시프트 연산자

구문

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

>>>

AdditiveExpression

[?Yield, ?Await]

13.9.1 왼쪽 시프트 연산자 ( `<<` )

참고

왼쪽 피연산자에 대해 오른쪽 피연산자가 지정한 양만큼 비트 단위 왼쪽 시프트 연산을 수행합니다.

13.9.1.1 Runtime Semantics: 평가

ShiftExpression

AdditiveExpression

? EvaluateStringOrNumericBinaryExpression(ShiftExpression, <<, AdditiveExpression)을 반환합니다.

13.9.2 부호 있는 오른쪽 시프트 연산자 ( `>>` )

참고

왼쪽 피연산자에 대해 오른쪽 피연산자가 지정한 양만큼 부호를 채우는 비트 단위 오른쪽 시프트 연산을 수행합니다.

13.9.2.1 Runtime Semantics: 평가

ShiftExpression

AdditiveExpression

? EvaluateStringOrNumericBinaryExpression(ShiftExpression, >>, AdditiveExpression)을 반환합니다.

13.9.3 부호 없는 오른쪽 시프트 연산자 ( `>>>` )

참고

왼쪽 피연산자에 대해 오른쪽 피연산자가 지정한 양만큼 0을 채우는 비트 단위 오른쪽 시프트 연산을 수행합니다.

13.9.3.1 Runtime Semantics: 평가

ShiftExpression

>>>

AdditiveExpression

? EvaluateStringOrNumericBinaryExpression(ShiftExpression, >>>, AdditiveExpression)을 반환합니다.

13.10 관계 연산자

참고 1

관계 연산자를 평가한 결과는 항상 Boolean 타입이며, 연산자가 나타내는 관계가 두 피연산자 사이에서 성립하는지를 나타냅니다.

구문

RelationalExpression

[In, Yield, Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

instanceof

ShiftExpression

[?Yield, ?Await]

[+In]

RelationalExpression

[+In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

[+In]

PrivateIdentifier

ShiftExpression

[?Yield, ?Await]

참고 2

_[In] 문법 매개변수는 관계 표현식의 in 연산자와 for 문의 in 연산자를 혼동하지 않도록 하기 위해 필요합니다.

13.10.1 Runtime Semantics: 평가

RelationalExpression

ShiftExpression

leftRef를 RelationalExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
result를 ? IsLessThan(leftValue, rightValue, true)로 둡니다.
result가 undefined이면 false를 반환합니다.
result를 반환합니다.

RelationalExpression

ShiftExpression

leftRef를 RelationalExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
result를 ? IsLessThan(rightValue, leftValue, false)로 둡니다.
result가 undefined이면 false를 반환합니다.
result를 반환합니다.

RelationalExpression

ShiftExpression

leftRef를 RelationalExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
result를 ? IsLessThan(rightValue, leftValue, false)로 둡니다.
result가 true 또는 undefined이면 false를 반환합니다.
true를 반환합니다.

RelationalExpression

ShiftExpression

leftRef를 RelationalExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
result를 ? IsLessThan(leftValue, rightValue, true)로 둡니다.
result가 true 또는 undefined이면 false를 반환합니다.
true를 반환합니다.

RelationalExpression

instanceof

ShiftExpression

leftRef를 RelationalExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
? InstanceofOperator(leftValue, rightValue)를 반환합니다.

RelationalExpression

ShiftExpression

leftRef를 RelationalExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
rightValue가 Object가 아니면 TypeError 예외를 던집니다.
? HasProperty(rightValue, ? ToPropertyKey(leftValue))를 반환합니다.

RelationalExpression

PrivateIdentifier

ShiftExpression

privateIdentifier를 PrivateIdentifier의 StringValue로 둡니다.
rightRef를 ShiftExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
rightValue가 Object가 아니면 TypeError 예외를 던집니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
단언: privateEnv는 null이 아닙니다.
privateName을 ResolvePrivateIdentifier(privateEnv, privateIdentifier)로 둡니다.
PrivateElementFind(rightValue, privateName)이 empty이면 false를 반환합니다.
true를 반환합니다.

13.10.2 InstanceofOperator ( `value`, `target` )

추상 연산 InstanceofOperator. 인수 value (ECMAScript 언어 값) 및 target (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). target의 %Symbol.hasInstance% 메서드를 참조하거나, 해당 메서드가 없으면 target의 "prototype" 프로퍼티 값이 value의 프로토타입 체인에 존재하는지를 결정하여 value가 target의 인스턴스인지 판별하는 일반 알고리즘을 구현합니다. 호출되면 다음 단계를 수행한다.

target이 Object가 아니면 TypeError 예외를 던집니다.
instOfHandler를 ? GetMethod(target, %Symbol.hasInstance%)로 둡니다.
instOfHandler가 undefined가 아니면, 다음을 수행합니다.
1. ToBoolean(? Call(instOfHandler, target, « value »))을 반환합니다.
IsCallable(target)이 false이면 TypeError 예외를 던집니다.
? OrdinaryHasInstance(target, value)를 반환합니다.

참고

4 및 5 단계는 instanceof 연산자의 의미론을 정의하는 데 %Symbol.hasInstance% 메서드를 사용하지 않았던 이전 ECMAScript 판과의 호환성을 제공합니다. 객체가 %Symbol.hasInstance%를 정의하거나 상속하지 않으면 기본 instanceof 의미론을 사용합니다.

13.11 동등 연산자

참고

동등 연산자를 평가한 결과는 항상 Boolean 타입이며, 연산자가 나타내는 관계가 두 피연산자 사이에서 성립하는지를 나타냅니다.

구문

EqualityExpression

[In, Yield, Await]

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

===

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

!==

RelationalExpression

[?In, ?Yield, ?Await]

13.11.1 Runtime Semantics: 평가

EqualityExpression

RelationalExpression

leftRef를 EqualityExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 RelationalExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
? IsLooselyEqual(rightValue, leftValue)을 반환합니다.

EqualityExpression

RelationalExpression

leftRef를 EqualityExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 RelationalExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
result를 ? IsLooselyEqual(rightValue, leftValue)로 둡니다.
result가 true이면 false를 반환합니다.
true를 반환합니다.

EqualityExpression

===

RelationalExpression

leftRef를 EqualityExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 RelationalExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
IsStrictlyEqual(rightValue, leftValue)을 반환합니다.

EqualityExpression

!==

RelationalExpression

leftRef를 EqualityExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 RelationalExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
result를 IsStrictlyEqual(rightValue, leftValue)로 둡니다.
result가 true이면 false를 반환합니다.
true를 반환합니다.

참고 1

동등 연산자는 다음 불변 조건을 유지합니다:

A != B는 !(A == B)와 동등합니다.
A와 B의 평가 순서를 제외하면 A == B는 B == A와 동등합니다.

참고 2

동등 연산자는 항상 추이적인 것은 아닙니다. 예를 들어 각각 같은 String 값을 나타내는 서로 다른 두 String 객체가 있을 수 있습니다. 각 String 객체는 == 연산자에 의해 해당 String 값과 같다고 간주되지만 두 String 객체는 서로 같지 않습니다. 예:

new String("a") == "a" 및 "a" == new String("a")는 모두 true입니다.
new String("a") == new String("a")는 false입니다.

참고 3

String 비교는 코드 단위 값 시퀀스에 대한 단순 동등성 검사를 사용합니다. 유니코드 명세에 정의된 문자 또는 문자열 동등성과 정렬 순서에 대한 더 복잡하고 의미 지향적인 정의를 사용하려고 시도하지 않습니다. 따라서 유니코드 표준에 따라 정규적으로 같은 String 값도 서로 같지 않은 것으로 판정될 수 있습니다. 사실상 이 알고리즘은 두 String이 이미 정규화된 형식이라고 가정합니다.

13.12 이항 비트 연산자

구문

BitwiseANDExpression

[In, Yield, Await]

EqualityExpression

[?In, ?Yield, ?Await]

BitwiseANDExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

BitwiseXORExpression

[In, Yield, Await]

BitwiseANDExpression

[?In, ?Yield, ?Await]

BitwiseXORExpression

[?In, ?Yield, ?Await]

BitwiseANDExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[In, Yield, Await]

BitwiseXORExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

BitwiseXORExpression

[?In, ?Yield, ?Await]

13.12.1 Runtime Semantics: 평가

BitwiseANDExpression

EqualityExpression

? EvaluateStringOrNumericBinaryExpression(BitwiseANDExpression, &, EqualityExpression)을 반환합니다.

BitwiseXORExpression

BitwiseANDExpression

? EvaluateStringOrNumericBinaryExpression(BitwiseXORExpression, ^, BitwiseANDExpression)을 반환합니다.

BitwiseORExpression

BitwiseXORExpression

? EvaluateStringOrNumericBinaryExpression(BitwiseORExpression, |, BitwiseXORExpression)을 반환합니다.

13.13 이항 논리 연산자

구문

LogicalANDExpression

[In, Yield, Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

LogicalANDExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

LogicalORExpression

[In, Yield, Await]

LogicalANDExpression

[?In, ?Yield, ?Await]

LogicalORExpression

[?In, ?Yield, ?Await]

LogicalANDExpression

[?In, ?Yield, ?Await]

CoalesceExpression

[In, Yield, Await]

CoalesceExpressionHead

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

CoalesceExpressionHead

[In, Yield, Await]

CoalesceExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

ShortCircuitExpression

[In, Yield, Await]

LogicalORExpression

[?In, ?Yield, ?Await]

CoalesceExpression

[?In, ?Yield, ?Await]

참고

&& 또는 || 연산자가 생성하는 값은 반드시 Boolean 타입일 필요는 없습니다. 생성되는 값은 항상 두 피연산자 표현식 중 하나의 값입니다.

13.13.1 Runtime Semantics: 평가

LogicalANDExpression

BitwiseORExpression

leftRef를 LogicalANDExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
ToBoolean(leftValue)이 false이면 leftValue를 반환합니다.
rightRef를 BitwiseORExpression의 ? Evaluation으로 둡니다.
? GetValue(rightRef)를 반환합니다.

LogicalORExpression

LogicalANDExpression

leftRef를 LogicalORExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
ToBoolean(leftValue)이 true이면 leftValue를 반환합니다.
rightRef를 LogicalANDExpression의 ? Evaluation으로 둡니다.
? GetValue(rightRef)를 반환합니다.

CoalesceExpression

CoalesceExpressionHead

BitwiseORExpression

leftRef를 CoalesceExpressionHead의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
leftValue가 undefined도 null도 아니면 leftValue를 반환합니다.
rightRef를 BitwiseORExpression의 ? Evaluation으로 둡니다.
? GetValue(rightRef)를 반환합니다.

13.14 조건 연산자 ( `? :` )

구문

ConditionalExpression

[In, Yield, Await]

ShortCircuitExpression

[?In, ?Yield, ?Await]

ShortCircuitExpression

[?In, ?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

AssignmentExpression

[?In, ?Yield, ?Await]

참고

ECMAScript의 ConditionalExpression 문법은 두 번째 하위 표현식을 Expression로 허용하지만 세 번째 표현식은 ConditionalExpression로 제한하는 C 및 Java의 문법과 약간 다릅니다. ECMAScript에서 이렇게 다른 이유는 조건문의 어느 분기에서도 할당 표현식을 사용할 수 있도록 하고, 가운데 표현식에 쉼표 표현식을 사용하는 혼란스럽고 실용성이 매우 낮은 경우를 제거하기 위해서입니다.

13.14.1 Runtime Semantics: 평가

ConditionalExpression

ShortCircuitExpression

AssignmentExpression

leftRef를 ShortCircuitExpression의 ? Evaluation으로 둡니다.
leftValue를 ToBoolean(? GetValue(leftRef))로 둡니다.
leftValue가 true이면, 다음을 수행합니다.
1. trueRef를 첫 번째 AssignmentExpression의 ? Evaluation으로 둡니다.
2. ? GetValue(trueRef)를 반환합니다.
falseRef를 두 번째 AssignmentExpression의 ? Evaluation으로 둡니다.
? GetValue(falseRef)를 반환합니다.

13.15 할당 연산자

구문

AssignmentExpression

[In, Yield, Await]

ConditionalExpression

[?In, ?Yield, ?Await]

[+Yield]

YieldExpression

[?In, ?Await]

ArrowFunction

[?In, ?Yield, ?Await]

AsyncArrowFunction

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentOperator

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

&&=

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

||=

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

??=

AssignmentExpression

[?In, ?Yield, ?Await]

AssignmentOperator

one of

<<=

>>=

>>>=

**=

13.15.1 Static Semantics: 조기 오류

AssignmentExpression

LeftHandSideExpression

AssignmentExpression

LeftHandSideExpression이 ObjectLiteral 또는 ArrayLiteral이면 LeftHandSideExpression은 AssignmentPattern을 포괄해야 합니다.
LeftHandSideExpression이 ObjectLiteral도 ArrayLiteral도 아니고 LeftHandSideExpression의 AssignmentTargetType이 invalid이면 Syntax Error입니다.

AssignmentExpression

LeftHandSideExpression

AssignmentOperator

AssignmentExpression

LeftHandSideExpression의 AssignmentTargetType이 invalid이면 Syntax Error입니다.

AssignmentExpression

LeftHandSideExpression

&&=

AssignmentExpression

LeftHandSideExpression

||=

AssignmentExpression

LeftHandSideExpression

??=

AssignmentExpression

LeftHandSideExpression의 AssignmentTargetType이 simple이 아니면 Syntax Error입니다.

13.15.2 Runtime Semantics: 평가

AssignmentExpression

LeftHandSideExpression

AssignmentExpression

LeftHandSideExpression이 ObjectLiteral도 ArrayLiteral도 아니면, 다음을 수행합니다.
1. leftRef를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
2. LeftHandSideExpression의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
3. IsAnonymousFunctionDefinition(AssignmentExpression)이 true이고 LeftHandSideExpression의 IsIdentifierRef가 true이면, 다음을 수행합니다.
  1. lhs를 LeftHandSideExpression의 StringValue로 둡니다.
  2. rightValue를 인수 lhs를 사용한 AssignmentExpression의 ? NamedEvaluation으로 둡니다.
4. 그렇지 않으면,
  1. rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
  2. rightValue를 ? GetValue(rightRef)로 둡니다.
5. ? PutValue(leftRef, rightValue)를 수행합니다.
6. rightValue를 반환합니다.
assignmentPattern을 LeftHandSideExpression이 포괄하는 AssignmentPattern으로 둡니다.
rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
인수 rightValue를 사용한 assignmentPattern의 ? DestructuringAssignmentEvaluation을 수행합니다.
rightValue를 반환합니다.

AssignmentExpression

LeftHandSideExpression

AssignmentOperator

AssignmentExpression

leftRef를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
LeftHandSideExpression의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
assignmentOpText를 AssignmentOperator와 일치하는 소스 텍스트로 둡니다.

opText를 다음 표에서 assignmentOpText와 연결된 유니코드 코드 포인트 시퀀스로 둡니다:

`assignmentOpText`	`opText`
`**=`	`**`
`*=`	`*`
`/=`	`/`
`%=`	`%`
`+=`	`+`
`-=`	`-`
`<<=`	`<<`
`>>=`	`>>`
`>>>=`	`>>>`
`&=`	`&`
`^=`	`^`
`\|=`	`\|`

result를 ? ApplyStringOrNumericBinaryOperator(leftValue, opText, rightValue)로 둡니다.
? PutValue(leftRef, result)를 수행합니다.
result를 반환합니다.

AssignmentExpression

LeftHandSideExpression

&&=

AssignmentExpression

leftRef를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
ToBoolean(leftValue)이 false이면 leftValue를 반환합니다.
IsAnonymousFunctionDefinition(AssignmentExpression)이 true이고 LeftHandSideExpression의 IsIdentifierRef가 true이면, 다음을 수행합니다.
1. lhs를 LeftHandSideExpression의 StringValue로 둡니다.
2. rightValue를 인수 lhs를 사용한 AssignmentExpression의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
2. rightValue를 ? GetValue(rightRef)로 둡니다.
? PutValue(leftRef, rightValue)를 수행합니다.
rightValue를 반환합니다.

AssignmentExpression

LeftHandSideExpression

||=

AssignmentExpression

leftRef를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
ToBoolean(leftValue)이 true이면 leftValue를 반환합니다.
IsAnonymousFunctionDefinition(AssignmentExpression)이 true이고 LeftHandSideExpression의 IsIdentifierRef가 true이면, 다음을 수행합니다.
1. lhs를 LeftHandSideExpression의 StringValue로 둡니다.
2. rightValue를 인수 lhs를 사용한 AssignmentExpression의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
2. rightValue를 ? GetValue(rightRef)로 둡니다.
? PutValue(leftRef, rightValue)를 수행합니다.
rightValue를 반환합니다.

AssignmentExpression

LeftHandSideExpression

??=

AssignmentExpression

leftRef를 LeftHandSideExpression의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
leftValue가 undefined도 null도 아니면 leftValue를 반환합니다.
IsAnonymousFunctionDefinition(AssignmentExpression)이 true이고 LeftHandSideExpression의 IsIdentifierRef가 true이면, 다음을 수행합니다.
1. lhs를 LeftHandSideExpression의 StringValue로 둡니다.
2. rightValue를 인수 lhs를 사용한 AssignmentExpression의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
2. rightValue를 ? GetValue(rightRef)로 둡니다.
? PutValue(leftRef, rightValue)를 수행합니다.
rightValue를 반환합니다.

참고

이 표현식이 엄격 모드 코드 안에 나타날 때 1.e, 3, 2, 2, 2 단계의 leftRef가 해석 불가능한 참조이면 런타임 오류입니다. 이 경우 ReferenceError 예외를 던집니다. 또한 9, 6, 6, 6 단계의 leftRef가 속성 값 { [[Writable]]: false }를 갖는 데이터 프로퍼티, 속성 값 { [[Setter]]: undefined }를 갖는 접근자 프로퍼티, 또는 IsExtensible 술어가 false를 반환하는 객체의 존재하지 않는 프로퍼티에 대한 참조이면 런타임 오류입니다. 이러한 경우에는 TypeError 예외를 던집니다.

13.15.3 ApplyStringOrNumericBinaryOperator ( `leftValue`, `opText`, `rightValue` )

추상 연산 ApplyStringOrNumericBinaryOperator. 인수 leftValue (ECMAScript 언어 값), opText ((**, *, /, %, +, -, <<, >>, >>>, &, ^ 또는 |)) 및 rightValue (ECMAScript 언어 값). 반환값: (정상 완료 (값: (String, BigInt 또는 Number)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

opText가 +이면, 다음을 수행합니다.
1. leftPrimitive를 ? ToPrimitive(leftValue)로 둡니다.
2. rightPrimitive를 ? ToPrimitive(rightValue)로 둡니다.
3. leftPrimitive가 String이거나 rightPrimitive가 String이면, 다음을 수행합니다.
  1. leftString을 ? ToString(leftPrimitive)으로 둡니다.
  2. rightString을 ? ToString(rightPrimitive)으로 둡니다.
  3. leftString과 rightString의 문자열 연결을 반환합니다.
4. leftValue를 leftPrimitive로 설정합니다.
5. rightValue를 rightPrimitive로 설정합니다.
참고: 이 시점에서는 숫자 연산이어야 합니다.
leftNumber를 ? ToNumeric(leftValue)로 둡니다.
rightNumber를 ? ToNumeric(rightValue)로 둡니다.
SameType(leftNumber, rightNumber)이 false이면 TypeError 예외를 던집니다.

leftNumber가 BigInt이면, 다음을 수행합니다.

opText가 **이면 ? BigInt::exponentiate(leftNumber, rightNumber)를 반환합니다.
opText가 /이면 ? BigInt::divide(leftNumber, rightNumber)를 반환합니다.
opText가 %이면 ? BigInt::remainder(leftNumber, rightNumber)를 반환합니다.
opText가 >>>이면 ? BigInt::unsignedRightShift(leftNumber, rightNumber)를 반환합니다.

operation을 다음 표에서 opText와 연결된 추상 연산으로 둡니다:

`opText`	`operation`
`*`	BigInt::multiply
`+`	BigInt::add
`-`	BigInt::subtract
`<<`	BigInt::leftShift
`>>`	BigInt::signedRightShift
`&`	BigInt::bitwiseAND
`^`	BigInt::bitwiseXOR
`\|`	BigInt::bitwiseOR

그렇지 않으면,

단언: leftNumber는 Number입니다.

operation을 다음 표에서 opText와 연결된 추상 연산으로 둡니다:

`opText`	`operation`
`**`	Number::exponentiate
`*`	Number::multiply
`/`	Number::divide
`%`	Number::remainder
`+`	Number::add
`-`	Number::subtract
`<<`	Number::leftShift
`>>`	Number::signedRightShift
`>>>`	Number::unsignedRightShift
`&`	Number::bitwiseAND
`^`	Number::bitwiseXOR
`\|`	Number::bitwiseOR

operation(leftNumber, rightNumber)을 반환합니다.

참고 1

1.a 및 1.b 단계의 ToPrimitive 호출에는 hint가 제공되지 않습니다. Date를 제외한 모든 표준 객체는 hint가 없는 경우를 number가 제공된 것처럼 처리하며, Date는 hint가 없는 경우를 string이 제공된 것처럼 처리합니다. 특수 객체는 hint가 없는 경우를 다른 방식으로 처리할 수 있습니다.

참고 2

1.c 단계는 logical-and 연산 대신 logical-or 연산을 사용한다는 점에서 IsLessThan 알고리즘의 3 단계와 다릅니다.

13.15.4 EvaluateStringOrNumericBinaryExpression ( `leftOperand`, `opText`, `rightOperand` )

추상 연산 EvaluateStringOrNumericBinaryExpression. 인수 leftOperand (구문 분석 노드), opText ((**, *, /, %, +, -, <<, >>, >>>, &, ^ 또는 |)) 및 rightOperand (구문 분석 노드). 반환값: (정상 완료 (값: (String, BigInt 또는 Number)) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

leftRef를 leftOperand의 ? Evaluation으로 둡니다.
leftValue를 ? GetValue(leftRef)로 둡니다.
rightRef를 rightOperand의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rightRef)로 둡니다.
? ApplyStringOrNumericBinaryOperator(leftValue, opText, rightValue)를 반환합니다.

13.15.5 구조 분해 할당

보충 구문

특정 상황에서 다음 생성 규칙의 인스턴스를 처리할 때
AssignmentExpression : LeftHandSideExpression = AssignmentExpression
LeftHandSideExpression의 해석은 다음 문법을 사용하여 구체화됩니다:

AssignmentPattern

[Yield, Await]

ObjectAssignmentPattern

[?Yield, ?Await]

ArrayAssignmentPattern

[?Yield, ?Await]

ObjectAssignmentPattern

[Yield, Await]

{

}

{

AssignmentRestProperty

[?Yield, ?Await]

}

{

AssignmentPropertyList

[?Yield, ?Await]

opt

}

{

AssignmentPropertyList

[?Yield, ?Await]

AssignmentRestProperty

[?Yield, ?Await]

}

ArrayAssignmentPattern

[Yield, Await]

[

Elision

opt

AssignmentRestElement

[?Yield, ?Await]

opt

]

[

AssignmentElementList

[?Yield, ?Await]

]

[

AssignmentElementList

[?Yield, ?Await]

Elision

opt

AssignmentRestElement

[?Yield, ?Await]

opt

]

AssignmentRestProperty

[Yield, Await]

...

DestructuringAssignmentTarget

[?Yield, ?Await]

AssignmentPropertyList

[Yield, Await]

AssignmentProperty

[?Yield, ?Await]

AssignmentPropertyList

[?Yield, ?Await]

AssignmentProperty

[?Yield, ?Await]

AssignmentElementList

[Yield, Await]

AssignmentElisionElement

[?Yield, ?Await]

AssignmentElementList

[?Yield, ?Await]

AssignmentElisionElement

[?Yield, ?Await]

AssignmentElisionElement

[Yield, Await]

opt

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

opt

PropertyName

[?Yield, ?Await]

AssignmentElement

[?Yield, ?Await]

AssignmentElement

[Yield, Await]

DestructuringAssignmentTarget

[?Yield, ?Await]

Initializer

[+In, ?Yield, ?Await]

opt

AssignmentRestElement

[Yield, Await]

...

DestructuringAssignmentTarget

[?Yield, ?Await]

DestructuringAssignmentTarget

[Yield, Await]

LeftHandSideExpression

[?Yield, ?Await]

13.15.5.1 Static Semantics: 조기 오류

AssignmentProperty

IdentifierReference

Initializer

opt

IdentifierReference의 AssignmentTargetType이 simple이 아니면 Syntax Error입니다.

AssignmentRestProperty

...

DestructuringAssignmentTarget

DestructuringAssignmentTarget이 ArrayLiteral 또는 ObjectLiteral이면 Syntax Error입니다.

DestructuringAssignmentTarget

LeftHandSideExpression

LeftHandSideExpression이 ObjectLiteral 또는 ArrayLiteral이면 LeftHandSideExpression은 AssignmentPattern을 포괄해야 합니다.
LeftHandSideExpression이 ObjectLiteral도 ArrayLiteral도 아니고 LeftHandSideExpression의 AssignmentTargetType이 simple이 아니면 Syntax Error입니다.

13.15.5.2 Runtime Semantics: DestructuringAssignmentEvaluation

구문 지향 연산 DestructuringAssignmentEvaluation. 인수 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

ObjectAssignmentPattern

{

}

? RequireObjectCoercible(value)를 수행합니다.
unused를 반환합니다.

ObjectAssignmentPattern

{

AssignmentPropertyList

opt

}

? RequireObjectCoercible(value)를 수행합니다.
인수 value를 사용한 AssignmentPropertyList의 ? PropertyDestructuringAssignmentEvaluation을 수행합니다.
unused를 반환합니다.

ObjectAssignmentPattern

{

AssignmentRestProperty

}

? RequireObjectCoercible(value)를 수행합니다.
excludedNames를 새로운 빈 List로 둡니다.
인수 value 및 excludedNames를 사용한 AssignmentRestProperty의 ? RestDestructuringAssignmentEvaluation을 반환합니다.

ObjectAssignmentPattern

{

AssignmentPropertyList

AssignmentRestProperty

}

? RequireObjectCoercible(value)를 수행합니다.
excludedNames를 인수 value를 사용한 AssignmentPropertyList의 ? PropertyDestructuringAssignmentEvaluation으로 둡니다.
인수 value 및 excludedNames를 사용한 AssignmentRestProperty의 ? RestDestructuringAssignmentEvaluation을 반환합니다.

ArrayAssignmentPattern

[

]

iteratorRecord를 ? GetIterator(value, sync)로 둡니다.
? IteratorClose(iteratorRecord, NormalCompletion(unused))를 반환합니다.

ArrayAssignmentPattern

[

Elision

]

iteratorRecord를 ? GetIterator(value, sync)로 둡니다.
result를 Completion(인수 iteratorRecord를 사용한 Elision의 IteratorDestructuringAssignmentEvaluation)로 둡니다.
iteratorRecord.[[Done]]이 false이면 ? IteratorClose(iteratorRecord, result)를 반환합니다.
result를 반환합니다.

ArrayAssignmentPattern

[

Elision

opt

AssignmentRestElement

]

iteratorRecord를 ? GetIterator(value, sync)로 둡니다.
Elision이 존재하면, 다음을 수행합니다.
1. status를 Completion(인수 iteratorRecord를 사용한 Elision의 IteratorDestructuringAssignmentEvaluation)로 둡니다.
2. status가 비정상 완료이면, 다음을 수행합니다.
  1. 단언: iteratorRecord.[[Done]]은 true입니다.
  2. ? status를 반환합니다.
result를 Completion(인수 iteratorRecord를 사용한 AssignmentRestElement의 IteratorDestructuringAssignmentEvaluation)로 둡니다.
iteratorRecord.[[Done]]이 false이면 ? IteratorClose(iteratorRecord, result)를 반환합니다.
result를 반환합니다.

ArrayAssignmentPattern

[

AssignmentElementList

]

iteratorRecord를 ? GetIterator(value, sync)로 둡니다.
result를 Completion(인수 iteratorRecord를 사용한 AssignmentElementList의 IteratorDestructuringAssignmentEvaluation)로 둡니다.
iteratorRecord.[[Done]]이 false이면 ? IteratorClose(iteratorRecord, result)를 반환합니다.
result를 반환합니다.

ArrayAssignmentPattern

[

AssignmentElementList

Elision

opt

AssignmentRestElement

opt

]

iteratorRecord를 ? GetIterator(value, sync)로 둡니다.
status를 Completion(인수 iteratorRecord를 사용한 AssignmentElementList의 IteratorDestructuringAssignmentEvaluation)로 둡니다.
status가 비정상 완료이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]이 false이면 ? IteratorClose(iteratorRecord, status)를 반환합니다.
2. ? status를 반환합니다.
Elision이 존재하면, 다음을 수행합니다.
1. status를 Completion(인수 iteratorRecord를 사용한 Elision의 IteratorDestructuringAssignmentEvaluation)으로 설정합니다.
2. status가 비정상 완료이면, 다음을 수행합니다.
  1. 단언: iteratorRecord.[[Done]]은 true입니다.
  2. ? status를 반환합니다.
AssignmentRestElement가 존재하면, 다음을 수행합니다.
1. status를 Completion(인수 iteratorRecord를 사용한 AssignmentRestElement의 IteratorDestructuringAssignmentEvaluation)으로 설정합니다.
iteratorRecord.[[Done]]이 false이면 ? IteratorClose(iteratorRecord, status)를 반환합니다.
? status를 반환합니다.

13.15.5.3 Runtime Semantics: PropertyDestructuringAssignmentEvaluation

구문 지향 연산 PropertyDestructuringAssignmentEvaluation. 인수 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: 리스트 (요소: 프로퍼티 키)) 또는 중도 완료). 구조 분해된 모든 프로퍼티 키의 목록을 수집합니다. 다음 생성 규칙별로 정의된다.

AssignmentPropertyList

AssignmentProperty

propertyNames를 인수 value를 사용한 AssignmentPropertyList의 ? PropertyDestructuringAssignmentEvaluation으로 둡니다.
nextNames를 인수 value를 사용한 AssignmentProperty의 ? PropertyDestructuringAssignmentEvaluation으로 둡니다.
propertyNames와 nextNames의 목록 연결을 반환합니다.

AssignmentProperty

IdentifierReference

Initializer

opt

propertyName을 IdentifierReference의 StringValue로 둡니다.
leftRef를 ? ResolveBinding(propertyName)으로 둡니다.
value를 ? GetV(value, propertyName)로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. IsAnonymousFunctionDefinition(Initializer)이 true이면, 다음을 수행합니다.
  1. value를 인수 propertyName을 사용한 Initializer의 ? NamedEvaluation으로 설정합니다.
2. 그렇지 않으면,
  1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
  2. value를 ? GetValue(defaultValue)로 설정합니다.
? PutValue(leftRef, value)를 수행합니다.
« propertyName »을 반환합니다.

AssignmentProperty

PropertyName

AssignmentElement

name을 PropertyName의 ? Evaluation으로 둡니다.
인수 value 및 name을 사용한 AssignmentElement의 ? KeyedDestructuringAssignmentEvaluation을 수행합니다.
« name »을 반환합니다.

13.15.5.4 Runtime Semantics: RestDestructuringAssignmentEvaluation

구문 지향 연산 RestDestructuringAssignmentEvaluation. 인수 value (ECMAScript 언어 값) 및 excludedNames (리스트 (요소: 프로퍼티 키)). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

AssignmentRestProperty

...

DestructuringAssignmentTarget

leftRef를 DestructuringAssignmentTarget의 ? Evaluation으로 둡니다.
restObj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
? CopyDataProperties(restObj, value, excludedNames)를 수행합니다.
? PutValue(leftRef, restObj)를 반환합니다.

13.15.5.5 Runtime Semantics: IteratorDestructuringAssignmentEvaluation

구문 지향 연산 IteratorDestructuringAssignmentEvaluation. 인수 iteratorRecord (Iterator 레코드). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

AssignmentElementList

AssignmentElisionElement

인수 iteratorRecord를 사용한 AssignmentElisionElement의 ? IteratorDestructuringAssignmentEvaluation을 반환합니다.

AssignmentElementList

AssignmentElisionElement

인수 iteratorRecord를 사용한 AssignmentElementList의 ? IteratorDestructuringAssignmentEvaluation을 수행합니다.
인수 iteratorRecord를 사용한 AssignmentElisionElement의 ? IteratorDestructuringAssignmentEvaluation을 반환합니다.

AssignmentElisionElement

AssignmentElement

인수 iteratorRecord를 사용한 AssignmentElement의 ? IteratorDestructuringAssignmentEvaluation을 반환합니다.

AssignmentElisionElement

Elision

AssignmentElement

인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 수행합니다.
인수 iteratorRecord를 사용한 AssignmentElement의 ? IteratorDestructuringAssignmentEvaluation을 반환합니다.

Elision

iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
1. ? IteratorStep(iteratorRecord)을 수행합니다.
unused를 반환합니다.

Elision

인수 iteratorRecord를 사용한 Elision의 ? IteratorDestructuringAssignmentEvaluation을 수행합니다.
iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
1. ? IteratorStep(iteratorRecord)을 수행합니다.
unused를 반환합니다.

AssignmentElement

DestructuringAssignmentTarget

Initializer

opt

DestructuringAssignmentTarget이 ObjectLiteral도 ArrayLiteral도 아니면, 다음을 수행합니다.
1. leftRef를 DestructuringAssignmentTarget의 ? Evaluation으로 둡니다.
value를 undefined로 둡니다.
iteratorRecord.[[Done]]이 false이면, 다음을 수행합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. value를 next로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. IsAnonymousFunctionDefinition(Initializer)이 true이고 DestructuringAssignmentTarget의 IsIdentifierRef가 true이면, 다음을 수행합니다.
  1. target을 DestructuringAssignmentTarget의 StringValue로 둡니다.
  2. value를 인수 target을 사용한 Initializer의 ? NamedEvaluation으로 설정합니다.
2. 그렇지 않으면,
  1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
  2. value를 ? GetValue(defaultValue)로 설정합니다.
DestructuringAssignmentTarget이 ObjectLiteral 또는 ArrayLiteral이면, 다음을 수행합니다.
1. nestedAssignmentPattern을 DestructuringAssignmentTarget이 포괄하는 AssignmentPattern으로 둡니다.
2. 인수 value를 사용한 nestedAssignmentPattern의 ? DestructuringAssignmentEvaluation을 반환합니다.
? PutValue(leftRef, value)를 반환합니다.

참고

구조 분해 패턴이 아닌 DestructuringAssignmentTarget을 반복자에 접근하거나 Initializer를 평가하기 전에 평가하여 왼쪽에서 오른쪽으로의 평가 순서를 유지합니다.

AssignmentRestElement

...

DestructuringAssignmentTarget

DestructuringAssignmentTarget이 ObjectLiteral도 ArrayLiteral도 아니면, 다음을 수행합니다.
1. leftRef를 DestructuringAssignmentTarget의 ? Evaluation으로 둡니다.
array를 ! ArrayCreate(0)으로 둡니다.
n을 0으로 둡니다.
iteratorRecord.[[Done]]이 false인 동안 다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(n)), next)를 수행합니다.
  2. n을 n + 1로 설정합니다.
DestructuringAssignmentTarget이 ObjectLiteral도 ArrayLiteral도 아니면, 다음을 수행합니다.
1. ? PutValue(leftRef, array)를 반환합니다.
nestedAssignmentPattern을 DestructuringAssignmentTarget이 포괄하는 AssignmentPattern으로 둡니다.
인수 array를 사용한 nestedAssignmentPattern의 ? DestructuringAssignmentEvaluation을 반환합니다.

13.15.5.6 Runtime Semantics: KeyedDestructuringAssignmentEvaluation

구문 지향 연산 KeyedDestructuringAssignmentEvaluation. 인수 value (ECMAScript 언어 값) 및 propertyName (프로퍼티 키). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

AssignmentElement

DestructuringAssignmentTarget

Initializer

opt

DestructuringAssignmentTarget이 ObjectLiteral도 ArrayLiteral도 아니면, 다음을 수행합니다.
1. leftRef를 DestructuringAssignmentTarget의 ? Evaluation으로 둡니다.
value를 ? GetV(value, propertyName)로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. IsAnonymousFunctionDefinition(Initializer)이 true이고 DestructuringAssignmentTarget의 IsIdentifierRef가 true이면, 다음을 수행합니다.
  1. target을 DestructuringAssignmentTarget의 StringValue로 둡니다.
  2. rhsValue를 인수 target을 사용한 Initializer의 ? NamedEvaluation으로 둡니다.
2. 그렇지 않으면,
  1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
  2. rhsValue를 ? GetValue(defaultValue)로 둡니다.
그렇지 않으면,
1. rhsValue를 value로 둡니다.
DestructuringAssignmentTarget이 ObjectLiteral 또는 ArrayLiteral이면, 다음을 수행합니다.
1. assignmentPattern을 DestructuringAssignmentTarget이 포괄하는 AssignmentPattern으로 둡니다.
2. 인수 rhsValue를 사용한 assignmentPattern의 ? DestructuringAssignmentEvaluation을 반환합니다.
? PutValue(leftRef, rhsValue)를 반환합니다.

13.16 쉼표 연산자 ( `,` )

구문

Expression

[In, Yield, Await]

AssignmentExpression

[?In, ?Yield, ?Await]

Expression

[?In, ?Yield, ?Await]

AssignmentExpression

[?In, ?Yield, ?Await]

13.16.1 Runtime Semantics: 평가

Expression

AssignmentExpression

leftRef를 Expression의 ? Evaluation으로 둡니다.
? GetValue(leftRef)를 수행합니다.
rightRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
? GetValue(rightRef)를 반환합니다.

참고

값을 사용하지 않더라도 관찰 가능한 부작용이 있을 수 있으므로 GetValue를 호출해야 합니다.

14 ECMAScript 언어: 문과 선언

구문

Statement

[Yield, Await, Return]

BlockStatement

[?Yield, ?Await, ?Return]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, ?Return]

BreakableStatement

[?Yield, ?Await, ?Return]

ContinueStatement

[?Yield, ?Await]

BreakStatement

[?Yield, ?Await]

[+Return]

ReturnStatement

[?Yield, ?Await]

WithStatement

[?Yield, ?Await, ?Return]

LabelledStatement

[?Yield, ?Await, ?Return]

ThrowStatement

[?Yield, ?Await]

TryStatement

[?Yield, ?Await, ?Return]

DebuggerStatement

Declaration

[Yield, Await]

HoistableDeclaration

[?Yield, ?Await, ~Default]

ClassDeclaration

[?Yield, ?Await, ~Default]

LexicalDeclaration

[+In, ?Yield, ?Await]

HoistableDeclaration

[Yield, Await, Default]

FunctionDeclaration

[?Yield, ?Await, ?Default]

GeneratorDeclaration

[?Yield, ?Await, ?Default]

AsyncFunctionDeclaration

[?Yield, ?Await, ?Default]

AsyncGeneratorDeclaration

[?Yield, ?Await, ?Default]

BreakableStatement

[Yield, Await, Return]

IterationStatement

[?Yield, ?Await, ?Return]

SwitchStatement

[?Yield, ?Await, ?Return]

14.1 문 의미론

14.1.1 Runtime Semantics: 평가

HoistableDeclaration

GeneratorDeclaration

AsyncFunctionDeclaration

AsyncGeneratorDeclaration

empty를 반환합니다.

HoistableDeclaration

FunctionDeclaration

FunctionDeclaration의 ? Evaluation을 반환합니다.

BreakableStatement

IterationStatement

SwitchStatement

newLabelSet을 새로운 빈 List로 둡니다.
인수 newLabelSet을 사용한 이 BreakableStatement의 ? LabelledEvaluation을 반환합니다.

14.2 블록

구문

BlockStatement

[Yield, Await, Return]

Block

[?Yield, ?Await, ?Return]

Block

[Yield, Await, Return]

{

StatementList

[?Yield, ?Await, ?Return]

opt

}

StatementList

[Yield, Await, Return]

StatementListItem

[?Yield, ?Await, ?Return]

StatementList

[?Yield, ?Await, ?Return]

StatementListItem

[?Yield, ?Await, ?Return]

StatementListItem

[Yield, Await, Return]

Statement

[?Yield, ?Await, ?Return]

Declaration

[?Yield, ?Await]

14.2.1 Static Semantics: 조기 오류

Block

{

StatementList

}

StatementList의 LexicallyDeclaredNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다. 단, 호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하고 다음 두 조건이 모두 참이면 예외입니다:
- IsStrict(this production)이 false입니다.
- 중복 항목은 FunctionDeclaration에 의해서만 바인딩됩니다.
StatementList의 LexicallyDeclaredNames의 어떤 요소라도 StatementList의 VarDeclaredNames에도 나타나면 Syntax Error입니다.

14.2.2 Runtime Semantics: 평가

Block

{

}

empty를 반환합니다.

Block

{

StatementList

}

oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
blockEnv를 NewDeclarativeEnvironment(oldEnv)로 둡니다.
BlockDeclarationInstantiation(StatementList, blockEnv)을 수행합니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 blockEnv로 설정합니다.
blockValue를 Completion(StatementList의 Evaluation)으로 둡니다.
blockValue를 Completion(DisposeResources(blockEnv.[[DisposableResourceStack]], blockValue))으로 설정합니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
? blockValue를 반환합니다.

참고 1

제어가 어떤 방식으로 Block을 벗어나더라도 LexicalEnvironment는 항상 이전 상태로 복원됩니다.

StatementList

StatementListItem

sl을 StatementList의 ? Evaluation으로 둡니다.
s를 Completion(StatementListItem의 Evaluation)으로 둡니다.
? UpdateEmpty(s, sl)을 반환합니다.

참고 2

StatementList의 값은 StatementList에서 값을 생성하는 마지막 항목의 값입니다. 예를 들어 다음 eval 함수 호출은 모두 값 1을 반환합니다:

eval("1;;;;;")
eval("1;{}")
eval("1;var a;")

14.2.3 BlockDeclarationInstantiation ( `code`, `envRecord` )

추상 연산 BlockDeclarationInstantiation. 인수 code (구문 분석 노드) 및 envRecord (Declarative Environment 레코드). 반환값: unused. code는 블록 본문에 대응하는 Parse Node입니다. envRecord는 바인딩을 생성할 Environment Record입니다.

참고

Block 또는 CaseBlock이 평가될 때 새로운 Declarative Environment Record가 생성되고 블록 안에서 선언된 각 블록 스코프 변수, 상수, 함수 또는 클래스에 대한 바인딩이 해당 Environment Record에 인스턴스화됩니다.

호출되면 다음 단계를 수행합니다:

decls를 code의 LexicallyScopedDeclarations로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
decls의 각 요소 decl에 대해 다음을 수행합니다.
1. decl의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
  1. decl의 IsConstantDeclaration이 true이면, 다음을 수행합니다.
    1. ! envRecord.CreateImmutableBinding(name, true)를 수행합니다.
  2. 그렇지 않으면,
    1. Normative Optional
      호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하면, 다음을 수행합니다.
      1. ! envRecord.HasBinding(name)이 false이면, 다음을 수행합니다.
        ! envRecord.CreateMutableBinding(name, false)를 수행합니다.
    2. 그렇지 않으면,
      1. ! envRecord.CreateMutableBinding(name, false)를 수행합니다.
2. decl이 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration 또는 AsyncGeneratorDeclaration 중 하나이면, 다음을 수행합니다.
  1. funcName을 decl의 BoundNames의 유일한 요소로 둡니다.
  2. funcObj를 인수 envRecord 및 privateEnv를 사용한 decl의 InstantiateFunctionObject로 둡니다.
  3. Normative Optional
    호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하면, 다음을 수행합니다.
    1. envRecord에서 funcName에 대한 바인딩이 초기화되지 않은 바인딩이면, 다음을 수행합니다.
      1. ! envRecord.InitializeBinding(funcName, funcObj)를 수행합니다.
    2. 그렇지 않으면,
      1. 단언: decl은 FunctionDeclaration입니다.
      2. ! envRecord.SetMutableBinding(funcName, funcObj, false)를 수행합니다.
  4. 그렇지 않으면,
    1. ! envRecord.InitializeBinding(funcName, funcObj)를 수행합니다.
unused를 반환합니다.

14.3 선언과 Variable 문

14.3.1 Let, Const, Using 및 Await Using 선언

참고

let, const, using 및 await using 선언은 실행 중인 실행 컨텍스트의 LexicalEnvironment를 스코프로 하는 변수를 정의합니다. 변수는 이를 포함하는 Environment Record가 인스턴스화될 때 생성되지만 변수의 LexicalBinding이 평가되기 전까지는 어떤 방식으로도 접근할 수 없습니다. Initializer를 갖는 LexicalBinding이 정의한 변수에는 변수가 생성될 때가 아니라 LexicalBinding이 평가될 때 해당 Initializer의 AssignmentExpression 값이 할당됩니다. let 선언의 LexicalBinding에 Initializer가 없으면 LexicalBinding이 평가될 때 변수에 undefined 값이 할당됩니다.

구문

LexicalDeclaration

[In, Yield, Await]

LetOrConst

BindingList

[?In, ?Yield, ?Await, +Pattern]

;

UsingDeclaration

[?In, ?Yield, ?Await]

[+Await]

AwaitUsingDeclaration

[?In, ?Yield]

LetOrConst

let

const

UsingDeclaration

[In, Yield, Await]

using

[no LineTerminator here]

BindingList

[?In, ?Yield, ?Await, ~Pattern]

;

AwaitUsingDeclaration

[In, Yield]

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[?Yield]

[no LineTerminator here]

BindingList

[?In, ?Yield, +Await, ~Pattern]

;

BindingList

[In, Yield, Await, Pattern]

LexicalBinding

[?In, ?Yield, ?Await, ?Pattern]

BindingList

[?In, ?Yield, ?Await, ?Pattern]

LexicalBinding

[?In, ?Yield, ?Await, ?Pattern]

LexicalBinding

[In, Yield, Await, Pattern]

BindingIdentifier

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

opt

[+Pattern]

BindingPattern

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

보충 구문

다음 생성 규칙의 인스턴스를 처리할 때
AwaitUsingDeclaration : CoverAwaitExpressionAndAwaitUsingDeclarationHead BindingList ;
CoverAwaitExpressionAndAwaitUsingDeclarationHead의 해석은 다음 문법을 사용하여 구체화됩니다:

AwaitUsingDeclarationHead

await

[no LineTerminator here]

using

14.3.1.1 Static Semantics: 조기 오류

LexicalDeclaration

LetOrConst

BindingList

;

BindingList의 BoundNames에 "let"이 포함되어 있으면 Syntax Error입니다.
BindingList의 BoundNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.

UsingDeclaration

using

BindingList

;

BindingList의 BoundNames에 "let"이 포함되어 있으면 Syntax Error입니다.
BindingList의 BoundNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.

AwaitUsingDeclaration

CoverAwaitExpressionAndAwaitUsingDeclarationHead

BindingList

;

CoverAwaitExpressionAndAwaitUsingDeclarationHead는 AwaitUsingDeclarationHead를 포괄해야 합니다.
BindingList의 BoundNames에 "let"이 포함되어 있으면 Syntax Error입니다.
BindingList의 BoundNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.

LexicalBinding

BindingIdentifier

Initializer

opt

Initializer가 존재하지 않고 이 LexicalBinding을 포함하는 LexicalDeclaration의 IsConstantDeclaration이 true이면 Syntax Error입니다.

14.3.1.2 Runtime Semantics: 평가

LexicalDeclaration

LetOrConst

BindingList

;

인수 normal을 사용한 BindingList의 ? BindingEvaluation을 수행합니다.
empty를 반환합니다.

UsingDeclaration

using

BindingList

;

인수 sync-dispose를 사용한 BindingList의 ? BindingEvaluation을 수행합니다.
empty를 반환합니다.

AwaitUsingDeclaration

CoverAwaitExpressionAndAwaitUsingDeclarationHead

BindingList

;

인수 async-dispose를 사용한 BindingList의 ? BindingEvaluation을 수행합니다.
empty를 반환합니다.

14.3.1.3 Runtime Semantics: BindingEvaluation

구문 지향 연산 BindingEvaluation. 인수 kind ((normal, sync-dispose 또는 async-dispose)). 반환값: (정상 완료 (값: unused) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

BindingList

LexicalBinding

인수 kind를 사용한 파생된 BindingList의 ? BindingEvaluation을 수행합니다.
인수 kind를 사용한 LexicalBinding의 ? BindingEvaluation을 반환합니다.

LexicalBinding

BindingIdentifier

단언: kind는 normal입니다.
lhs를 ! ResolveBinding(BindingIdentifier의 StringValue)으로 둡니다.
! InitializeReferencedBinding(lhs, undefined)를 수행합니다.
unused를 반환합니다.

참고

정적 의미론 규칙은 이 형태의 LexicalBinding이 const, using 또는 await using 선언에서 절대로 발생하지 않도록 보장합니다.

LexicalBinding

BindingIdentifier

Initializer

name을 BindingIdentifier의 StringValue로 둡니다.
lhs를 ! ResolveBinding(name)으로 둡니다.
IsAnonymousFunctionDefinition(Initializer)이 true이면, 다음을 수행합니다.
1. value를 인수 name을 사용한 Initializer의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rhs를 Initializer의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(rhs)로 둡니다.
kind가 normal이 아니면, 다음을 수행합니다.
1. 단언: IsUnresolvableReference(lhs)는 false입니다.
2. base를 lhs.[[Base]]로 둡니다.
3. 단언: base는 Declarative Environment Record입니다.
4. ? AddDisposableResource(base.[[DisposableResourceStack]], value, kind)를 수행합니다.
? InitializeReferencedBinding(lhs, value)를 수행합니다.
unused를 반환합니다.

LexicalBinding

BindingPattern

Initializer

단언: kind는 normal입니다.
rhs를 Initializer의 ? Evaluation으로 둡니다.
value를 ? GetValue(rhs)로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
인수 value 및 envRecord를 사용한 BindingPattern의 ? BindingInitialization을 반환합니다.

14.3.2 Variable 문

참고

var 문은 실행 중인 실행 컨텍스트의 VariableEnvironment를 스코프로 하는 변수를 선언합니다. var 변수는 이를 포함하는 Environment Record가 인스턴스화될 때 생성되고 생성 시 undefined로 초기화됩니다. 어떤 VariableEnvironment의 스코프 안에서도 동일한 BindingIdentifier가 둘 이상의 VariableDeclaration에 나타날 수 있지만, 이러한 선언은 전체적으로 하나의 변수만 정의합니다. Initializer를 갖는 VariableDeclaration이 정의한 변수에는 변수가 생성될 때가 아니라 VariableDeclaration이 실행될 때 해당 Initializer의 AssignmentExpression 값이 할당됩니다.

구문

VariableStatement

[Yield, Await]

var

VariableDeclarationList

[+In, ?Yield, ?Await]

;

VariableDeclarationList

[In, Yield, Await]

VariableDeclaration

[?In, ?Yield, ?Await]

VariableDeclarationList

[?In, ?Yield, ?Await]

VariableDeclaration

[?In, ?Yield, ?Await]

VariableDeclaration

[In, Yield, Await]

BindingIdentifier

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

opt

BindingPattern

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

14.3.2.1 Runtime Semantics: 평가

VariableStatement

var

VariableDeclarationList

;

VariableDeclarationList의 ? Evaluation을 수행합니다.
empty를 반환합니다.

VariableDeclarationList

VariableDeclaration

VariableDeclarationList의 ? Evaluation을 수행합니다.
VariableDeclaration의 ? Evaluation을 반환합니다.

VariableDeclaration

BindingIdentifier

empty를 반환합니다.

VariableDeclaration

BindingIdentifier

Initializer

name을 BindingIdentifier의 StringValue로 둡니다.
lhs를 ? ResolveBinding(name)으로 둡니다.
IsAnonymousFunctionDefinition(Initializer)이 true이면, 다음을 수행합니다.
1. value를 인수 name을 사용한 Initializer의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rhs를 Initializer의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(rhs)로 둡니다.
? PutValue(lhs, value)를 수행합니다.
empty를 반환합니다.

참고

VariableDeclaration이 with 문 안에 중첩되어 있고 VariableDeclaration의 BindingIdentifier가 with 문의 Object Environment Record의 바인딩 객체 프로퍼티 이름과 같으면, 5 단계는 Identifier의 VariableEnvironment 바인딩에 할당하는 대신 해당 프로퍼티에 value를 할당합니다.

VariableDeclaration

BindingPattern

Initializer

rhs를 Initializer의 ? Evaluation으로 둡니다.
rightValue를 ? GetValue(rhs)로 둡니다.
인수 rightValue 및 undefined를 사용한 BindingPattern의 ? BindingInitialization을 반환합니다.

14.3.3 구조 분해 바인딩 패턴

구문

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

{

}

{

BindingRestProperty

[?Yield, ?Await]

}

{

BindingPropertyList

[?Yield, ?Await]

opt

}

{

BindingPropertyList

[?Yield, ?Await]

BindingRestProperty

[?Yield, ?Await]

}

ArrayBindingPattern

[Yield, Await]

[

Elision

opt

BindingRestElement

[?Yield, ?Await]

opt

]

[

BindingElementList

[?Yield, ?Await]

]

[

BindingElementList

[?Yield, ?Await]

Elision

opt

BindingRestElement

[?Yield, ?Await]

opt

]

BindingRestProperty

[Yield, Await]

...

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

BindingElisionElement

[?Yield, ?Await]

BindingElementList

[?Yield, ?Await]

BindingElisionElement

[?Yield, ?Await]

BindingElisionElement

[Yield, Await]

opt

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

opt

SingleNameBinding

[Yield, Await]

BindingIdentifier

[?Yield, ?Await]

Initializer

[+In, ?Yield, ?Await]

opt

BindingRestElement

[Yield, Await]

...

BindingIdentifier

[?Yield, ?Await]

...

BindingPattern

[?Yield, ?Await]

14.3.3.1 Runtime Semantics: PropertyBindingInitialization

구문 지향 연산 PropertyBindingInitialization. 인수 value (ECMAScript 언어 값) 및 envRecord (Environment Record 또는 undefined). 반환값: 프로퍼티 키의 List를 포함하는 정상 완료 또는 비정상 완료. 바인딩된 모든 프로퍼티 이름의 목록을 수집합니다. 다음 생성 규칙별로 정의된다.

BindingPropertyList

BindingProperty

boundNames를 인수 value 및 envRecord를 사용한 BindingPropertyList의 ? PropertyBindingInitialization으로 둡니다.
nextNames를 인수 value 및 envRecord를 사용한 BindingProperty의 ? PropertyBindingInitialization으로 둡니다.
boundNames와 nextNames의 목록 연결을 반환합니다.

BindingProperty

SingleNameBinding

name을 SingleNameBinding의 BoundNames의 유일한 요소로 둡니다.
인수 value, envRecord 및 name을 사용한 SingleNameBinding의 ? KeyedBindingInitialization을 수행합니다.
« name »을 반환합니다.

BindingProperty

PropertyName

BindingElement

propertyKey를 PropertyName의 ? Evaluation으로 둡니다.
인수 value, envRecord 및 propertyKey를 사용한 BindingElement의 ? KeyedBindingInitialization을 수행합니다.
« propertyKey »를 반환합니다.

14.3.3.2 Runtime Semantics: RestBindingInitialization

구문 지향 연산 RestBindingInitialization. 인수 value (ECMAScript 언어 값), envRecord (Environment Record 또는 undefined) 및 excludedNames (프로퍼티 키의 List). 반환값: unused를 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

BindingRestProperty

...

BindingIdentifier

lhs를 ? ResolveBinding(BindingIdentifier의 StringValue, envRecord)으로 둡니다.
restObj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
? CopyDataProperties(restObj, value, excludedNames)를 수행합니다.
envRecord가 undefined이면 ? PutValue(lhs, restObj)를 반환합니다.
? InitializeReferencedBinding(lhs, restObj)을 반환합니다.

14.3.3.3 Runtime Semantics: KeyedBindingInitialization

구문 지향 연산 KeyedBindingInitialization. 인수 value (ECMAScript 언어 값), envRecord (Environment Record 또는 undefined) 및 propertyName (프로퍼티 키). 반환값: unused를 포함하는 정상 완료 또는 비정상 완료.

참고

envRecord에 undefined를 전달하면 초기화 값을 할당하는 데 PutValue 연산을 사용해야 함을 나타냅니다. 이는 비엄격 함수의 형식 매개변수 목록에서 발생합니다. 이 경우 같은 이름을 갖는 여러 매개변수의 가능성을 처리하기 위해 형식 매개변수 바인딩을 미리 초기화합니다.

다음 생성 규칙별로 정의된다.

BindingElement

BindingPattern

Initializer

opt

value를 ? GetV(value, propertyName)로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(defaultValue)로 설정합니다.
인수 value 및 envRecord를 사용한 BindingPattern의 ? BindingInitialization을 반환합니다.

SingleNameBinding

BindingIdentifier

Initializer

opt

name을 BindingIdentifier의 StringValue로 둡니다.
lhs를 ? ResolveBinding(name, envRecord)으로 둡니다.
value를 ? GetV(value, propertyName)로 설정합니다.
Initializer가 존재하고 value가 undefined이면, 다음을 수행합니다.
1. IsAnonymousFunctionDefinition(Initializer)이 true이면, 다음을 수행합니다.
  1. value를 인수 name을 사용한 Initializer의 ? NamedEvaluation으로 설정합니다.
2. 그렇지 않으면,
  1. defaultValue를 Initializer의 ? Evaluation으로 둡니다.
  2. value를 ? GetValue(defaultValue)로 설정합니다.
envRecord가 undefined이면 ? PutValue(lhs, value)를 반환합니다.
? InitializeReferencedBinding(lhs, value)를 반환합니다.

14.4 빈 문

구문

EmptyStatement

;

14.4.1 Runtime Semantics: 평가

EmptyStatement

;

empty를 반환합니다.

14.5 표현식 문

구문

ExpressionStatement

[Yield, Await]

[lookahead ∉ { {, function, async

[no LineTerminator here]

function, class, let [ }]

Expression

[+In, ?Yield, ?Await]

;

참고

ExpressionStatement은 U+007B (LEFT CURLY BRACKET)로 시작할 수 없습니다. 그렇게 하면 Block과 모호해질 수 있기 때문입니다. ExpressionStatement은 function 또는 class 키워드로 시작할 수 없습니다. 그렇게 하면 FunctionDeclaration, GeneratorDeclaration 또는 ClassDeclaration과 모호해지기 때문입니다. ExpressionStatement은 async function으로 시작할 수 없습니다. 그렇게 하면 AsyncFunctionDeclaration 또는 AsyncGeneratorDeclaration과 모호해지기 때문입니다. ExpressionStatement은 두 토큰 시퀀스 let [로 시작할 수 없습니다. 그렇게 하면 첫 번째 LexicalBinding이 ArrayBindingPattern인 let LexicalDeclaration과 모호해지기 때문입니다.

14.5.1 Runtime Semantics: 평가

ExpressionStatement

Expression

;

exprRef를 Expression의 ? Evaluation으로 둡니다.
? GetValue(exprRef)를 반환합니다.

14.6 `if` 문

구문

IfStatement

[Yield, Await, Return]

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

else

Statement

[?Yield, ?Await, ?Return]

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[lookahead ≠ else]

참고

lookahead 제한 [lookahead ≠ else]는 고전적인 “dangling else” 문제를 일반적인 방식으로 해결합니다. 즉, 연결할 if를 선택하는 것이 그 밖에는 모호할 때 else는 후보 if 중 가장 가까운(가장 안쪽의) if와 연결됩니다.

14.6.1 Static Semantics: 조기 오류

(

)

else

IsLabelledFunction(첫 번째 Statement)이 true이면 Syntax Error입니다.
IsLabelledFunction(두 번째 Statement)이 true이면 Syntax Error입니다.

IfStatement

(

Expression

)

Statement

IsLabelledFunction(Statement)이 true이면 Syntax Error입니다.

참고

B.3.1에 명시된 확장을 구현한 경우에만 이 규칙을 적용할 필요가 있습니다.

14.6.2 Runtime Semantics: 평가

(

)

else

exprRef를 Expression의 ? Evaluation으로 둡니다.
exprValue를 ToBoolean(? GetValue(exprRef))로 둡니다.
exprValue가 true이면, 다음을 수행합니다.
1. stmtCompletion을 Completion(첫 번째 Statement의 Evaluation)으로 둡니다.
그렇지 않으면,
1. stmtCompletion을 Completion(두 번째 Statement의 Evaluation)으로 둡니다.
? UpdateEmpty(stmtCompletion, undefined)를 반환합니다.

IfStatement

(

Expression

)

Statement

exprRef를 Expression의 ? Evaluation으로 둡니다.
exprValue를 ToBoolean(? GetValue(exprRef))로 둡니다.
exprValue가 false이면 undefined를 반환합니다.
stmtCompletion을 Completion(Statement의 Evaluation)으로 둡니다.
? UpdateEmpty(stmtCompletion, undefined)를 반환합니다.

14.7 반복문

구문

IterationStatement

[Yield, Await, Return]

DoWhileStatement

[?Yield, ?Await, ?Return]

WhileStatement

[?Yield, ?Await, ?Return]

ForStatement

[?Yield, ?Await, ?Return]

ForInOfStatement

[?Yield, ?Await, ?Return]

14.7.1 의미론

14.7.1.1 LoopContinues ( `completion`, `labelSet` )

추상 연산 LoopContinues. 인수 completion (Completion 레코드) 및 labelSet (String의 List). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

completion이 정상 완료이면 true를 반환합니다.
completion이 continue 완료가 아니면 false를 반환합니다.
completion.[[Target]]이 empty이면 true를 반환합니다.
labelSet에 completion.[[Target]]이 포함되어 있으면 true를 반환합니다.
false를 반환합니다.

참고

IterationStatement의 Statement 부분 안에서는 ContinueStatement을 사용하여 새로운 반복을 시작할 수 있습니다.

14.7.1.2 Runtime Semantics: LoopEvaluation

구문 지향 연산 LoopEvaluation. 인수 labelSet (String의 List). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

IterationStatement

DoWhileStatement

인수 labelSet을 사용한 DoWhileStatement의 ? DoWhileLoopEvaluation을 반환합니다.

IterationStatement

WhileStatement

인수 labelSet을 사용한 WhileStatement의 ? WhileLoopEvaluation을 반환합니다.

IterationStatement

ForStatement

인수 labelSet을 사용한 ForStatement의 ? ForLoopEvaluation을 반환합니다.

IterationStatement

ForInOfStatement

인수 labelSet을 사용한 ForInOfStatement의 ? ForInOfLoopEvaluation을 반환합니다.

14.7.2 `do`-`while` 문

구문

DoWhileStatement

[Yield, Await, Return]

Statement

[?Yield, ?Await, ?Return]

while

(

Expression

[+In, ?Yield, ?Await]

)

;

14.7.2.1 Static Semantics: 조기 오류

DoWhileStatement

Statement

while

(

Expression

)

;

IsLabelledFunction(Statement)이 true이면 Syntax Error입니다.

참고

B.3.1에 명시된 확장을 구현한 경우에만 이 규칙을 적용할 필요가 있습니다.

14.7.2.2 Runtime Semantics: DoWhileLoopEvaluation

구문 지향 연산 DoWhileLoopEvaluation. 인수 labelSet (String의 List). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

DoWhileStatement

Statement

while

(

Expression

)

;

iterationResult를 undefined로 둡니다.
다음을 반복합니다.
1. stmtResult를 Completion(Statement의 Evaluation)으로 둡니다.
2. LoopContinues(stmtResult, labelSet)가 false이면 ? UpdateEmpty(stmtResult, iterationResult)를 반환합니다.
3. stmtResult.[[Value]]가 empty가 아니면 iterationResult를 stmtResult.[[Value]]로 설정합니다.
4. exprRef를 Expression의 ? Evaluation으로 둡니다.
5. exprValue를 ? GetValue(exprRef)로 둡니다.
6. ToBoolean(exprValue)이 false이면 iterationResult를 반환합니다.

14.7.3 `while` 문

구문

WhileStatement

[Yield, Await, Return]

while

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

14.7.3.1 Static Semantics: 조기 오류

WhileStatement

while

(

Expression

)

Statement

IsLabelledFunction(Statement)이 true이면 Syntax Error입니다.

참고

B.3.1에 명시된 확장을 구현한 경우에만 이 규칙을 적용할 필요가 있습니다.

14.7.3.2 Runtime Semantics: WhileLoopEvaluation

구문 지향 연산 WhileLoopEvaluation. 인수 labelSet (String의 List). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

WhileStatement

while

(

Expression

)

Statement

iterationResult를 undefined로 둡니다.
다음을 반복합니다.
1. exprRef를 Expression의 ? Evaluation으로 둡니다.
2. exprValue를 ? GetValue(exprRef)로 둡니다.
3. ToBoolean(exprValue)이 false이면 iterationResult를 반환합니다.
4. stmtResult를 Completion(Statement의 Evaluation)으로 둡니다.
5. LoopContinues(stmtResult, labelSet)가 false이면 ? UpdateEmpty(stmtResult, iterationResult)를 반환합니다.
6. stmtResult.[[Value]]가 empty가 아니면 iterationResult를 stmtResult.[[Value]]로 설정합니다.

14.7.4 `for` 문

구문

ForStatement

[Yield, Await, Return]

for

(

[lookahead ≠ let []

Expression

[~In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

)

Statement

[?Yield, ?Await, ?Return]

for

(

var

VariableDeclarationList

[~In, ?Yield, ?Await]

;

Expression

[+In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

)

Statement

[?Yield, ?Await, ?Return]

for

(

LexicalDeclaration

[~In, ?Yield, ?Await]

Expression

[+In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

)

Statement

[?Yield, ?Await, ?Return]

14.7.4.1 Static Semantics: 조기 오류

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

IsLabelledFunction(Statement)이 true이면 Syntax Error입니다.

참고

B.3.1에 명시된 확장을 구현한 경우에만 이 규칙을 적용할 필요가 있습니다.

ForStatement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

LexicalDeclaration의 BoundNames의 어떤 요소라도 Statement의 VarDeclaredNames에도 나타나면 Syntax Error입니다.

14.7.4.2 Runtime Semantics: ForLoopEvaluation

구문 지향 연산 ForLoopEvaluation. 인수 labelSet (String의 List). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

첫 번째 Expression이 존재하면, 다음을 수행합니다.
1. exprRef를 첫 번째 Expression의 ? Evaluation으로 둡니다.
2. ? GetValue(exprRef)를 수행합니다.
두 번째 Expression이 존재하면 test를 두 번째 Expression로 둡니다. 그렇지 않으면 test를 empty로 둡니다.
세 번째 Expression이 존재하면 increment를 세 번째 Expression로 둡니다. 그렇지 않으면 increment를 empty로 둡니다.
? ForBodyEvaluation(test, increment, Statement, « », labelSet)을 반환합니다.

ForStatement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

VariableDeclarationList의 ? Evaluation을 수행합니다.
첫 번째 Expression이 존재하면 test를 첫 번째 Expression로 둡니다. 그렇지 않으면 test를 empty로 둡니다.
두 번째 Expression이 존재하면 increment를 두 번째 Expression로 둡니다. 그렇지 않으면 increment를 empty로 둡니다.
? ForBodyEvaluation(test, increment, Statement, « », labelSet)을 반환합니다.

ForStatement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
loopEnv를 NewDeclarativeEnvironment(oldEnv)로 둡니다.
isConst를 LexicalDeclaration의 IsConstantDeclaration으로 둡니다.
boundNames를 LexicalDeclaration의 BoundNames로 둡니다.
boundNames의 각 요소 name에 대해 다음을 수행합니다.
1. isConst가 true이면, 다음을 수행합니다.
  1. ! loopEnv.CreateImmutableBinding(name, true)를 수행합니다.
2. 그렇지 않으면,
  1. ! loopEnv.CreateMutableBinding(name, false)를 수행합니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 loopEnv로 설정합니다.
forDecl을 Completion(LexicalDeclaration의 Evaluation)으로 둡니다.
forDecl이 비정상 완료이면, 다음을 수행합니다.
1. forDecl을 Completion(DisposeResources(loopEnv.[[DisposableResourceStack]], forDecl))으로 설정합니다.
2. 단언: forDecl은 비정상 완료입니다.
3. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
4. ? forDecl을 반환합니다.
isConst가 false이면 perIterationLets를 boundNames로 둡니다. 그렇지 않으면 perIterationLets를 새로운 빈 List로 둡니다.
첫 번째 Expression이 존재하면 test를 첫 번째 Expression로 둡니다. 그렇지 않으면 test를 empty로 둡니다.
두 번째 Expression이 존재하면 increment를 두 번째 Expression로 둡니다. 그렇지 않으면 increment를 empty로 둡니다.
bodyResult를 Completion(ForBodyEvaluation(test, increment, Statement, perIterationLets, labelSet))으로 둡니다.
bodyResult를 Completion(DisposeResources(loopEnv.[[DisposableResourceStack]], bodyResult))으로 설정합니다.
단언: bodyResult가 정상 완료이면 bodyResult.[[Value]]는 empty가 아닙니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
? bodyResult를 반환합니다.

14.7.4.3 ForBodyEvaluation ( `test`, `increment`, `stmt`, `perIterationBindings`, `labelSet` )

추상 연산 ForBodyEvaluation. 인수 test (Expression Parse Node 또는 empty), increment (Expression Parse Node 또는 empty), stmt (Statement Parse Node), perIterationBindings (String의 List) 및 labelSet (String의 List). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 호출되면 다음 단계를 수행한다.

iterationResult를 undefined로 둡니다.
? CreatePerIterationEnvironment(perIterationBindings)를 수행합니다.
다음을 반복합니다.
1. test가 empty가 아니면, 다음을 수행합니다.
  1. testRef를 test의 ? Evaluation으로 둡니다.
  2. testValue를 ? GetValue(testRef)로 둡니다.
  3. ToBoolean(testValue)이 false이면 iterationResult를 반환합니다.
2. result를 Completion(stmt의 Evaluation)으로 둡니다.
3. LoopContinues(result, labelSet)가 false이면 ? UpdateEmpty(result, iterationResult)를 반환합니다.
4. result.[[Value]]가 empty가 아니면 iterationResult를 result.[[Value]]로 설정합니다.
5. ? CreatePerIterationEnvironment(perIterationBindings)를 수행합니다.
6. increment가 empty가 아니면, 다음을 수행합니다.
  1. incrementRef를 increment의 ? Evaluation으로 둡니다.
  2. ? GetValue(incrementRef)를 수행합니다.

14.7.4.4 CreatePerIterationEnvironment ( `perIterationBindings` )

추상 연산 CreatePerIterationEnvironment. 인수 perIterationBindings (String의 List). 반환값: unused를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

perIterationBindings에 요소가 하나라도 있으면, 다음을 수행합니다.
1. lastIterationEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
2. outer를 lastIterationEnv.[[OuterEnv]]로 둡니다.
3. 단언: outer는 null이 아닙니다.
4. thisIterationEnv를 NewDeclarativeEnvironment(outer)로 둡니다.
5. perIterationBindings의 각 요소 name에 대해 다음을 수행합니다.
  1. ! thisIterationEnv.CreateMutableBinding(name, false)를 수행합니다.
  2. lastValue를 ? lastIterationEnv.GetBindingValue(name, true)로 둡니다.
  3. ! thisIterationEnv.InitializeBinding(name, lastValue)를 수행합니다.
6. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 thisIterationEnv로 설정합니다.
unused를 반환합니다.

14.7.5 `for`-`in`, `for`-`of` 및 `for`-`await`-`of` 문

구문

ForInOfStatement

[Yield, Await, Return]

for

(

[lookahead ≠ let []

LeftHandSideExpression

[?Yield, ?Await]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

var

ForBinding

[?Yield, ?Await, +Pattern]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

ForDeclaration

[?Yield, ?Await, ~Using]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

[lookahead ∉ { let, async of }]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

var

ForBinding

[?Yield, ?Await, +Pattern]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

[lookahead ≠ using of]

ForDeclaration

[?Yield, ?Await, +Using]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[+Await]

for

await

(

[lookahead ≠ let]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[+Await]

for

await

(

var

ForBinding

[?Yield, ?Await, +Pattern]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[+Await]

for

await

(

[lookahead ≠ using of]

ForDeclaration

[?Yield, ?Await, +Using]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

ForDeclaration

[Yield, Await, Using]

LetOrConst

ForBinding

[?Yield, ?Await, +Pattern]

[+Using]

using

[no LineTerminator here]

ForBinding

[?Yield, ?Await, ~Pattern]

[+Using, +Await]

await

[no LineTerminator here]

using

[no LineTerminator here]

ForBinding

[?Yield, +Await, ~Pattern]

ForBinding

[Yield, Await, Pattern]

BindingIdentifier

[?Yield, ?Await]

[+Pattern]

BindingPattern

[?Yield, ?Await]

참고

이 절은 부록 B.3.5에 의해 확장됩니다.

14.7.5.1 Static Semantics: 조기 오류

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

var

ForBinding

Expression

)

Statement

for

(

ForDeclaration

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

IsLabelledFunction(Statement)이 true이면 Syntax Error입니다.

참고

B.3.1에 명시된 확장을 구현한 경우에만 이 규칙을 적용할 필요가 있습니다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

LeftHandSideExpression이 ObjectLiteral 또는 ArrayLiteral이면 LeftHandSideExpression은 AssignmentPattern을 포괄해야 합니다.
LeftHandSideExpression이 ObjectLiteral도 ArrayLiteral도 아니고 LeftHandSideExpression의 AssignmentTargetType이 invalid이면 Syntax Error입니다.

ForInOfStatement

for

(

ForDeclaration

Expression

)

Statement

for

(

ForDeclaration

AssignmentExpression

)

Statement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

ForDeclaration의 BoundNames에 "let"이 포함되어 있으면 Syntax Error입니다.
ForDeclaration의 BoundNames의 어떤 요소라도 Statement의 VarDeclaredNames에도 나타나면 Syntax Error입니다.
ForDeclaration의 BoundNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.

14.7.5.2 Static Semantics: IsDestructuring

구문 지향 연산 IsDestructuring. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

MemberExpression

PrimaryExpression

PrimaryExpression이 ObjectLiteral 또는 ArrayLiteral이면 true를 반환합니다.
false를 반환합니다.

[

]

new

new

LeftHandSideExpression

CallExpression

OptionalExpression

false를 반환합니다.

ForDeclaration

LetOrConst

ForBinding

ForBinding의 IsDestructuring을 반환합니다.

ForBinding

BindingIdentifier

false를 반환합니다.

ForBinding

BindingPattern

true를 반환합니다.

참고

이 절은 부록 B.3.5에 의해 확장됩니다.

14.7.5.3 Runtime Semantics: ForDeclarationBindingInitialization

구문 지향 연산 ForDeclarationBindingInitialization. 인수 value (ECMAScript 언어 값) 및 envRecord (Environment 레코드). 반환값: unused를 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

ForDeclaration

LetOrConst

ForBinding

인수 value 및 envRecord를 사용한 ForBinding의 ? BindingInitialization을 반환합니다.

ForDeclaration

using

ForBinding

await

using

ForBinding

SyntaxError 예외를 던집니다.

14.7.5.4 Runtime Semantics: ForDeclarationBindingInstantiation

구문 지향 연산 ForDeclarationBindingInstantiation. 인수 envRecord (Declarative Environment 레코드). 반환값: unused. 다음 생성 규칙별로 정의된다.

ForDeclaration

LetOrConst

ForBinding

ForBinding의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
1. LetOrConst의 IsConstantDeclaration이 true이면, 다음을 수행합니다.
  1. ! envRecord.CreateImmutableBinding(name, true)를 수행합니다.
2. 그렇지 않으면,
  1. ! envRecord.CreateMutableBinding(name, false)를 수행합니다.
unused를 반환합니다.

ForDeclaration

using

ForBinding

await

using

ForBinding

ForBinding의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
1. ! envRecord.CreateImmutableBinding(name, true)를 수행합니다.
unused를 반환합니다.

14.7.5.5 Runtime Semantics: ForInOfLoopEvaluation

구문 지향 연산 ForInOfLoopEvaluation. 인수 labelSet (String의 List). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(« », Expression, enumerate)으로 둡니다.
? ForIn/OfBodyEvaluation(LeftHandSideExpression, Statement, keyResult, enumerate, assignment, labelSet)을 반환합니다.

ForInOfStatement

for

(

var

ForBinding

Expression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(« », Expression, enumerate)으로 둡니다.
? ForIn/OfBodyEvaluation(ForBinding, Statement, keyResult, enumerate, var-binding, labelSet)을 반환합니다.

ForInOfStatement

for

(

ForDeclaration

Expression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(ForDeclaration의 BoundNames, Expression, enumerate)으로 둡니다.
? ForIn/OfBodyEvaluation(ForDeclaration, Statement, keyResult, enumerate, lexical-binding, labelSet)을 반환합니다.

ForInOfStatement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, iterate)으로 둡니다.
? ForIn/OfBodyEvaluation(LeftHandSideExpression, Statement, keyResult, iterate, assignment, labelSet)을 반환합니다.

ForInOfStatement

for

(

var

ForBinding

AssignmentExpression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, iterate)으로 둡니다.
? ForIn/OfBodyEvaluation(ForBinding, Statement, keyResult, iterate, var-binding, labelSet)을 반환합니다.

ForInOfStatement

for

(

ForDeclaration

AssignmentExpression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(ForDeclaration의 BoundNames, AssignmentExpression, iterate)으로 둡니다.
? ForIn/OfBodyEvaluation(ForDeclaration, Statement, keyResult, iterate, lexical-binding, labelSet)을 반환합니다.

ForInOfStatement

for

await

(

LeftHandSideExpression

AssignmentExpression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, async-iterate)으로 둡니다.
? ForIn/OfBodyEvaluation(LeftHandSideExpression, Statement, keyResult, iterate, assignment, labelSet, async)을 반환합니다.

ForInOfStatement

for

await

(

var

ForBinding

AssignmentExpression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, async-iterate)으로 둡니다.
? ForIn/OfBodyEvaluation(ForBinding, Statement, keyResult, iterate, var-binding, labelSet, async)을 반환합니다.

ForInOfStatement

for

await

(

ForDeclaration

AssignmentExpression

)

Statement

keyResult를 ? ForIn/OfHeadEvaluation(ForDeclaration의 BoundNames, AssignmentExpression, async-iterate)으로 둡니다.
? ForIn/OfBodyEvaluation(ForDeclaration, Statement, keyResult, iterate, lexical-binding, labelSet, async)을 반환합니다.

참고

이 절은 부록 B.3.5에 의해 확장됩니다.

14.7.5.6 ForIn/OfHeadEvaluation ( `uninitializedBoundNames`, `expr`, `iterationKind` )

추상 연산 ForIn/OfHeadEvaluation. 인수 uninitializedBoundNames (리스트 (요소: String)), expr ((an Expression Parse Node 또는 an AssignmentExpression Parse Node)) 및 iterationKind ((enumerate, iterate 또는 async-iterate)). 반환값: (정상 완료 (값: Iterator 레코드) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
uninitializedBoundNames가 비어 있지 않으면, 다음을 수행합니다.
1. 단언: uninitializedBoundNames에는 중복 항목이 없습니다.
2. newEnv를 NewDeclarativeEnvironment(oldEnv)로 둡니다.
3. uninitializedBoundNames의 각 String name에 대해 다음을 수행합니다.
  1. ! newEnv.CreateMutableBinding(name, false)를 수행합니다.
4. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 newEnv로 설정합니다.
exprRef를 Completion(expr의 Evaluation)으로 둡니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
exprValue를 ? GetValue(? exprRef)로 둡니다.
iterationKind가 enumerate이면, 다음을 수행합니다.
1. exprValue가 undefined 또는 null이면, 다음을 수행합니다.
  1. Completion Record { [[Type]]: break, [[Value]]: empty, [[Target]]: empty }를 반환합니다.
2. obj를 ! ToObject(exprValue)로 둡니다.
3. iterator를 EnumerateObjectProperties(obj)로 둡니다.
4. nextMethod를 ! GetV(iterator, "next")로 둡니다.
5. Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]: false }를 반환합니다.
단언: iterationKind는 iterate 또는 async-iterate입니다.
iterationKind가 async-iterate이면 iteratorKind를 async로 둡니다.
그렇지 않으면 iteratorKind를 sync로 둡니다.
? GetIterator(exprValue, iteratorKind)를 반환합니다.

14.7.5.7 ForIn/OfBodyEvaluation ( `lhs`, `stmt`, `iteratorRecord`, `iterationKind`, `lhsKind`, `labelSet` [ , `iteratorKind` ] )

추상 연산 ForIn/OfBodyEvaluation. 인수 lhs (구문 분석 노드), stmt (a Statement Parse Node), iteratorRecord (Iterator 레코드), iterationKind ((enumerate 또는 iterate)), lhsKind ((assignment, var-binding 또는 lexical-binding)) 및 labelSet (리스트 (요소: String)) 및 선택적 인수 iteratorKind ((sync 또는 async)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

iteratorKind가 존재하지 않으면 iteratorKind를 sync로 설정합니다.
oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
iterationResult를 undefined로 둡니다.
lhsKind가 lexical-binding이면, 다음을 수행합니다.
1. 단언: lhs는 ForDeclaration입니다.
2. lhs의 IsAwaitUsingDeclaration이 true이면, 다음을 수행합니다.
  1. declKind를 async-dispose로 둡니다.
3. 그렇지 않고 lhs의 IsUsingDeclaration이 true이면, 다음을 수행합니다.
  1. declKind를 sync-dispose로 둡니다.
4. 그렇지 않으면,
  1. declKind를 normal로 둡니다.
그렇지 않으면,
1. declKind를 normal로 둡니다.
destructuring을 lhs의 IsDestructuring으로 둡니다.
destructuring이 true이고 lhsKind가 assignment이면, 다음을 수행합니다.
1. 단언: lhs는 LeftHandSideExpression입니다.
2. assignmentPattern을 lhs가 포괄하는 AssignmentPattern으로 둡니다.
다음을 반복합니다.
1. nextResult를 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])로 둡니다.
2. iteratorKind가 async이면 nextResult를 ? Await(nextResult)로 설정합니다.
3. nextResult가 Object가 아니면 TypeError 예외를 던집니다.
4. done을 ? IteratorComplete(nextResult)로 둡니다.
5. done이 true이면 iterationResult를 반환합니다.
6. nextValue를 ? IteratorValue(nextResult)로 둡니다.
7. lhsKind가 assignment 또는 var-binding이면, 다음을 수행합니다.
  1. destructuring이 true이면, 다음을 수행합니다.
    1. lhsKind가 assignment이면, 다음을 수행합니다.
      1. status를 Completion(인수 nextValue를 사용한 assignmentPattern의 DestructuringAssignmentEvaluation)으로 둡니다.
    2. 그렇지 않으면,
      1. 단언: lhsKind는 var-binding입니다.
      2. 단언: lhs는 ForBinding입니다.
      3. status를 Completion(인수 nextValue 및 undefined를 사용한 lhs의 BindingInitialization)으로 둡니다.
  2. 그렇지 않으면,
    1. lhsRef를 Completion(lhs의 Evaluation)으로 둡니다. (반복해서 평가될 수 있습니다.)
    2. lhsKind가 assignment이고 lhs의 AssignmentTargetType이 web-compat이면 ReferenceError 예외를 던집니다.
    3. lhsRef가 비정상 완료이면, 다음을 수행합니다.
      1. status를 lhsRef로 둡니다.
    4. 그렇지 않으면,
      1. status를 Completion(PutValue(lhsRef.[[Value]], nextValue))으로 둡니다.
  3. iterationEnv를 undefined로 둡니다.
8. 그렇지 않으면,
  1. 단언: lhsKind는 lexical-binding입니다.
  2. 단언: lhs는 ForDeclaration입니다.
  3. iterationEnv를 NewDeclarativeEnvironment(oldEnv)로 둡니다.
  4. 인수 iterationEnv를 사용한 lhs의 ForDeclarationBindingInstantiation을 수행합니다.
  5. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 iterationEnv로 설정합니다.
  6. destructuring이 true이면, 다음을 수행합니다.
    1. status를 Completion(인수 nextValue 및 iterationEnv를 사용한 lhs의 ForDeclarationBindingInitialization)으로 둡니다.
  7. 그렇지 않으면,
    1. 단언: lhs는 하나의 이름을 바인딩합니다.
    2. lhsName을 lhs의 BoundNames의 유일한 요소로 둡니다.
    3. lhsRef를 ! ResolveBinding(lhsName)으로 둡니다.
    4. declKind가 normal이 아니면, 다음을 수행합니다.
      1. 단언: IsUnresolvableReference(lhsRef)는 false입니다.
      2. base를 lhsRef.[[Base]]로 둡니다.
      3. 단언: base는 Declarative Environment Record입니다.
      4. status를 Completion(AddDisposableResource(base.[[DisposableResourceStack]], nextValue, declKind))으로 둡니다.
    5. 그렇지 않으면,
      1. status를 NormalCompletion(unused)으로 둡니다.
    6. status가 정상 완료이면, 다음을 수행합니다.
      1. status를 Completion(InitializeReferencedBinding(lhsRef, nextValue))으로 설정합니다.
9. status가 비정상 완료이면, 다음을 수행합니다.
  1. iterationEnv가 undefined가 아니면, 다음을 수행합니다.
    1. status를 Completion(DisposeResources(iterationEnv.[[DisposableResourceStack]], status))으로 설정합니다.
    2. 단언: status는 비정상 완료입니다.
  2. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
  3. iterationKind가 enumerate이면 ? status를 반환합니다.
  4. 단언: iterationKind는 iterate입니다.
  5. iteratorKind가 async이면 ? AsyncIteratorClose(iteratorRecord, status)를 반환합니다.
  6. ? IteratorClose(iteratorRecord, status)를 반환합니다.
10. result를 Completion(stmt의 Evaluation)으로 둡니다.
11. iterationEnv가 undefined가 아니면, 다음을 수행합니다.
  1. result를 Completion(DisposeResources(iterationEnv.[[DisposableResourceStack]], result))으로 설정합니다.
12. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
13. LoopContinues(result, labelSet)가 false이면, 다음을 수행합니다.
  1. status를 Completion(UpdateEmpty(result, iterationResult))으로 설정합니다.
  2. iterationKind가 enumerate이면 ? status를 반환합니다.
  3. 단언: iterationKind는 iterate입니다.
  4. iteratorKind가 async이면 ? AsyncIteratorClose(iteratorRecord, status)를 반환합니다.
  5. ? IteratorClose(iteratorRecord, status)를 반환합니다.
14. result.[[Value]]가 empty가 아니면 iterationResult를 result.[[Value]]로 설정합니다.

14.7.5.8 Runtime Semantics: 평가

BindingIdentifier

Identifier

yield

await

name을 BindingIdentifier의 StringValue로 둡니다.
? ResolveBinding(name)을 반환합니다.

14.7.5.9 EnumerateObjectProperties ( `obj` )

추상 연산 EnumerateObjectProperties. 인수 obj (Object). 반환값: 반복자 객체. 호출되면 다음 단계를 수행한다.

next 메서드가 obj의 열거 가능한 프로퍼티 중 String 값 키를 모두 순회하는 반복자 객체를 반환합니다. 반복자 객체는 ECMAScript 코드에서 절대로 직접 접근할 수 없습니다. 프로퍼티 열거의 메커니즘과 순서는 명시되지 않지만 아래에 명시된 규칙을 따라야 합니다.

반복자의 throw 및 return 메서드는 null이며 절대로 호출되지 않습니다. 반복자의 next 메서드는 객체 프로퍼티를 처리하여 해당 프로퍼티 키를 반복자 값으로 반환할지 결정합니다. 반환되는 프로퍼티 키에는 Symbol인 키가 포함되지 않습니다. 대상 객체의 프로퍼티는 열거 중에 삭제될 수 있습니다. 반복자의 next 메서드가 처리하기 전에 삭제된 프로퍼티는 무시됩니다. 열거 중 대상 객체에 새로운 프로퍼티가 추가되더라도 현재 진행 중인 열거에서 새로 추가된 프로퍼티가 처리된다는 보장은 없습니다. 어떤 프로퍼티 이름도 하나의 열거에서 반복자의 next 메서드에 의해 두 번 이상 반환되지 않습니다.

대상 객체의 프로퍼티 열거에는 해당 프로토타입, 프로토타입의 프로토타입 등의 프로퍼티를 재귀적으로 열거하는 것도 포함됩니다. 그러나 프로토타입의 프로퍼티가 반복자의 next 메서드에 의해 이미 처리된 프로퍼티와 같은 이름이면 처리하지 않습니다. 프로토타입 객체의 프로퍼티가 이미 처리되었는지를 결정할 때 [[Enumerable]] 속성 값은 고려하지 않습니다. 프로토타입 객체의 열거 가능한 프로퍼티 이름은 해당 프로토타입 객체를 인수로 전달하여 EnumerateObjectProperties를 호출해 얻어야 합니다. EnumerateObjectProperties는 대상 객체의 자체 프로퍼티 키를 [[OwnPropertyKeys]] 내부 메서드를 호출하여 얻어야 합니다. 대상 객체의 프로퍼티 속성은 [[GetOwnProperty]] 내부 메서드를 호출하여 얻어야 합니다.

또한 obj와 그 프로토타입 체인의 모든 객체가 Proxy 특수 객체, TypedArray, 모듈 네임스페이스 특수 객체 또는 구현체가 제공하는 특수 객체가 아닌 경우, 다음 중 하나가 발생하기 전까지 반복자는 CreateForInIterator(obj)가 제공하는 반복자처럼 동작해야 합니다:

obj 또는 그 프로토타입 체인의 객체에 있는 [[Prototype]] 내부 슬롯 값이 변경되는 경우,
obj 또는 그 프로토타입 체인의 객체에서 프로퍼티가 제거되는 경우,
obj의 프로토타입 체인의 객체에 프로퍼티가 추가되는 경우, 또는
obj 또는 그 프로토타입 체인의 객체에 있는 프로퍼티의 [[Enumerable]] 속성 값이 변경되는 경우.

참고 1

ECMAScript 구현체는 14.7.5.10.2.1의 알고리즘을 직접 구현할 필요가 없습니다. 앞 단락의 제약 조건 중 하나가 위반되지 않는 한 해당 알고리즘의 동작과 달라지지 않는 어떤 구현이든 선택할 수 있습니다.

다음은 이러한 규칙을 준수하는 ECMAScript 제너레이터 함수의 참고용 정의입니다:

function* EnumerateObjectProperties(obj) {
  const visited = new Set();
  for (const key of Reflect.ownKeys(obj)) {
    if (typeof key === "symbol") continue;
    const desc = Reflect.getOwnPropertyDescriptor(obj, key);
    if (desc) {
      visited.add(key);
      if (desc.enumerable) yield key;
    }
  }
  const proto = Reflect.getPrototypeOf(obj);
  if (proto === null) return;
  for (const protoKey of EnumerateObjectProperties(proto)) {
    if (!visited.has(protoKey)) yield protoKey;
  }
}

참고 2

구현체가 CreateForInIterator와 동작을 일치시킬 필요가 없는 특수 객체의 목록은 구현체들이 역사적으로 이러한 경우에는 동작이 달랐고 그 밖의 모든 경우에는 일치했기 때문에 선택되었습니다.

14.7.5.10 For-In 반복자 객체

For-In 반복자는 특정 객체에 대한 특정 반복을 나타내는 객체입니다. For-In 반복자 객체는 ECMAScript 코드에서 절대로 직접 접근할 수 없으며 EnumerateObjectProperties의 동작을 설명하기 위해서만 존재합니다.

14.7.5.10.1 CreateForInIterator ( `obj` )

추상 연산 CreateForInIterator. 인수 obj (Object). 반환값: For-In 반복자. obj의 자체 및 상속된 열거 가능한 문자열 프로퍼티를 특정 순서로 반복하는 For-In 반복자 객체를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

iterator를 OrdinaryObjectCreate(%ForInIteratorPrototype%, « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »)로 둡니다.
iterator.[[Object]]을 obj로 설정합니다.
iterator.[[ObjectWasVisited]]를 false로 설정합니다.
iterator.[[VisitedKeys]]를 새로운 빈 List로 설정합니다.
iterator.[[RemainingKeys]]를 새로운 빈 List로 설정합니다.
iterator를 반환합니다.

14.7.5.10.2 %ForInIteratorPrototype% 객체

%ForInIteratorPrototype% 객체는:

모든 For-In 반복자 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
ECMAScript 코드에서 절대로 직접 접근할 수 없습니다.
다음 프로퍼티를 갖습니다:

14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )

iterator를 this 값으로 둡니다.
단언: iterator는 Object입니다.
단언: iterator에는 For-In 반복자 인스턴스의 모든 내부 슬롯(14.7.5.10.3)이 있습니다.
obj를 iterator.[[Object]]로 둡니다.
다음을 반복합니다.
1. iterator.[[ObjectWasVisited]]가 false이면, 다음을 수행합니다.
  1. keys를 ? obj.[[OwnPropertyKeys]]()로 둡니다.
  2. keys의 각 요소 key에 대해 다음을 수행합니다.
    1. key가 String이면, 다음을 수행합니다.
      1. key를 iterator.[[RemainingKeys]]에 추가합니다.
  3. iterator.[[ObjectWasVisited]]를 true로 설정합니다.
2. iterator.[[RemainingKeys]]가 비어 있지 않은 동안 다음을 반복합니다.
  1. key를 iterator.[[RemainingKeys]]의 첫 번째 요소로 둡니다.
  2. iterator.[[RemainingKeys]]에서 첫 번째 요소를 제거합니다.
  3. iterator.[[VisitedKeys]]에 key가 포함되어 있지 않으면, 다음을 수행합니다.
    1. propertyDesc를 ? obj.[[GetOwnProperty]](key)로 둡니다.
    2. propertyDesc가 undefined가 아니면, 다음을 수행합니다.
      1. key를 iterator.[[VisitedKeys]]에 추가합니다.
      2. propertyDesc.[[Enumerable]]이 true이면 CreateIteratorResultObject(key, false)를 반환합니다.
3. obj를 ? obj.[[GetPrototypeOf]]()로 설정합니다.
4. iterator.[[Object]]을 obj로 설정합니다.
5. iterator.[[ObjectWasVisited]]를 false로 설정합니다.
6. obj가 null이면 CreateIteratorResultObject(undefined, true)를 반환합니다.

14.7.5.10.3 For-In 반복자 인스턴스의 프로퍼티

For-In 반복자 인스턴스는 %ForInIteratorPrototype% 내재 객체에서 프로퍼티를 상속하는 일반 객체입니다. For-In 반복자 인스턴스는 처음에 표 34에 나열된 내부 슬롯을 갖도록 생성됩니다.

표 34: For-In 반복자 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[Object]]`	Object	프로퍼티를 반복 중인 Object 값입니다.
`[[ObjectWasVisited]]`	Boolean	반복자가 `[[Object]]`에서 `[[OwnPropertyKeys]]`를 호출했으면 true, 그렇지 않으면 false입니다.
`[[VisitedKeys]]`	String의 List	지금까지 이 반복자가 내보낸 값입니다.
`[[RemainingKeys]]`	String의 List	프로토타입의 프로퍼티를 반복하기 전에(프로토타입이 null이 아닌 경우) 현재 객체에 대해 아직 내보내야 하는 값입니다.

14.8 `continue` 문

구문

ContinueStatement

[Yield, Await]

continue

;

continue

[no LineTerminator here]

LabelIdentifier

[?Yield, ?Await]

;

14.8.1 Static Semantics: 조기 오류

ContinueStatement

continue

;

continue

LabelIdentifier

;

이 ContinueStatement이 IterationStatement 안에 직접 또는 간접적으로 중첩되어 있지 않으면(단, 함수 또는 static 초기화 블록 경계를 넘어서는 안 됩니다) Syntax Error입니다.

14.8.2 Runtime Semantics: 평가

ContinueStatement

continue

;

Completion Record { [[Type]]: continue, [[Value]]: empty, [[Target]]: empty }를 반환합니다.

ContinueStatement

continue

LabelIdentifier

;

label을 LabelIdentifier의 StringValue로 둡니다.
Completion Record { [[Type]]: continue, [[Value]]: empty, [[Target]]: label }를 반환합니다.

14.9 `break` 문

구문

BreakStatement

[Yield, Await]

break

;

break

[no LineTerminator here]

LabelIdentifier

[?Yield, ?Await]

;

14.9.1 Static Semantics: 조기 오류

BreakStatement

break

;

이 BreakStatement이 IterationStatement 또는 SwitchStatement 안에 직접 또는 간접적으로 중첩되어 있지 않으면(단, 함수 또는 static 초기화 블록 경계를 넘어서는 안 됩니다) Syntax Error입니다.

14.9.2 Runtime Semantics: 평가

BreakStatement

break

;

Completion Record { [[Type]]: break, [[Value]]: empty, [[Target]]: empty }를 반환합니다.

BreakStatement

break

LabelIdentifier

;

label을 LabelIdentifier의 StringValue로 둡니다.
Completion Record { [[Type]]: break, [[Value]]: empty, [[Target]]: label }를 반환합니다.

14.10 `return` 문

구문

ReturnStatement

[Yield, Await]

return

;

return

[no LineTerminator here]

Expression

[+In, ?Yield, ?Await]

;

참고

return 문은 함수 실행을 중지시키며 대부분의 경우 호출자에게 값을 반환합니다. Expression을 생략하면 반환 값은 undefined입니다. 그렇지 않으면 반환 값은 Expression의 값입니다. 주변 문맥에 따라 return 문이 실제로 호출자에게 값을 반환하지 않을 수도 있습니다. 예를 들어 try 블록에서 return 문의 Completion Record는 finally 블록을 평가하는 동안 다른 Completion Record로 교체될 수 있습니다.

14.10.1 Runtime Semantics: 평가

ReturnStatement

return

;

ReturnCompletion(undefined)을 반환합니다.

ReturnStatement

return

Expression

;

exprRef를 Expression의 ? Evaluation으로 둡니다.
exprValue를 ? GetValue(exprRef)로 둡니다.
GetGeneratorKind()가 async이면 exprValue를 ? Await(exprValue)로 설정합니다.
ReturnCompletion(exprValue)을 반환합니다.

레거시

14.11 `with` 문

참고 1

새로운 ECMAScript 코드에서는 레거시 with 문의 사용을 권장하지 않습니다. 구조 분해 할당과 같이 엄격 모드 코드와 비엄격 코드 모두에서 허용되는 대안을 고려하시기 바랍니다.

구문

WithStatement

[Yield, Await, Return]

with

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

참고 2

with 문은 계산된 객체에 대한 Object Environment Record를 실행 중인 실행 컨텍스트의 렉시컬 환경에 추가합니다. 그런 다음 이 확장된 렉시컬 환경을 사용하여 문을 실행합니다. 마지막으로 원래 렉시컬 환경을 복원합니다.

14.11.1 Static Semantics: 조기 오류

WithStatement

with

(

Expression

)

Statement

IsStrict(this production)이 true이면 Syntax Error입니다.
IsLabelledFunction(Statement)이 true이면 Syntax Error입니다.

참고

B.3.1에 명시된 확장을 구현한 경우에만 두 번째 규칙을 적용할 필요가 있습니다.

14.11.2 Runtime Semantics: 평가

WithStatement

with

(

Expression

)

Statement

value를 Expression의 ? Evaluation으로 둡니다.
obj를 ? ToObject(? GetValue(value))로 둡니다.
oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
newEnv를 NewObjectEnvironment(obj, true, oldEnv)로 둡니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 newEnv로 설정합니다.
stmtCompletion을 Completion(Statement의 Evaluation)으로 둡니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
? UpdateEmpty(stmtCompletion, undefined)를 반환합니다.

참고

제어가 포함된 Statement을 정상적으로 벗어나든 어떤 형태의 비정상 완료 또는 예외로 벗어나든 LexicalEnvironment는 항상 이전 상태로 복원됩니다.

14.12 `switch` 문

구문

SwitchStatement

[Yield, Await, Return]

switch

(

Expression

[+In, ?Yield, ?Await]

)

CaseBlock

[?Yield, ?Await, ?Return]

CaseBlock

[Yield, Await, Return]

{

CaseClauses

[?Yield, ?Await, ?Return]

opt

}

{

CaseClauses

[?Yield, ?Await, ?Return]

opt

DefaultClause

[?Yield, ?Await, ?Return]

CaseClauses

[?Yield, ?Await, ?Return]

opt

}

CaseClauses

[Yield, Await, Return]

CaseClause

[?Yield, ?Await, ?Return]

CaseClauses

[?Yield, ?Await, ?Return]

CaseClause

[?Yield, ?Await, ?Return]

CaseClause

[Yield, Await, Return]

case

Expression

[+In, ?Yield, ?Await]

StatementList

[?Yield, ?Await, ?Return]

opt

DefaultClause

[Yield, Await, Return]

default

StatementList

[?Yield, ?Await, ?Return]

opt

14.12.1 Static Semantics: 조기 오류

SwitchStatement

switch

(

Expression

)

CaseBlock

CaseBlock의 LexicallyDeclaredNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다. 단, 호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하고 다음 두 조건이 모두 참이면 예외입니다:
- IsStrict(this production)이 false입니다.
- 중복 항목은 FunctionDeclaration에 의해서만 바인딩됩니다.
CaseBlock의 LexicallyDeclaredNames의 어떤 요소라도 CaseBlock의 VarDeclaredNames에도 나타나면 Syntax Error입니다.

CaseClause

case

Expression

StatementList

StatementList의 ContainsUsing이 true이면 Syntax Error입니다.

DefaultClause

default

StatementList

StatementList의 ContainsUsing이 true이면 Syntax Error입니다.

14.12.2 Runtime Semantics: CaseBlockEvaluation

구문 지향 연산 CaseBlockEvaluation. 인수 input (ECMAScript 언어 값). 반환값: ECMAScript 언어 값을 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

CaseBlock

{

}

undefined를 반환합니다.

CaseBlock

{

CaseClauses

}

resultValue를 undefined로 둡니다.
caseClauses를 소스 텍스트 순서로 된 CaseClauses의 CaseClause 항목 List로 둡니다.
found를 false로 둡니다.
caseClauses의 각 CaseClause clause에 대해 다음을 수행합니다.
1. found가 false이면, 다음을 수행합니다.
  1. found를 ? CaseClauseIsSelected(clause, input)로 설정합니다.
2. found가 true이면, 다음을 수행합니다.
  1. completion을 Completion(clause의 Evaluation)으로 둡니다.
  2. completion.[[Value]]가 empty가 아니면 resultValue를 completion.[[Value]]로 설정합니다.
  3. completion이 비정상 완료이면 ? UpdateEmpty(completion, resultValue)를 반환합니다.
resultValue를 반환합니다.

{

opt

opt

}

resultValue를 undefined로 둡니다.
첫 번째 CaseClauses가 존재하면, 다음을 수행합니다.
1. caseClauses를 소스 텍스트 순서로 된 첫 번째 CaseClauses의 CaseClause 항목 List로 둡니다.
그렇지 않으면,
1. caseClauses를 새로운 빈 List로 둡니다.
found를 false로 둡니다.
caseClauses의 각 CaseClause clause에 대해 다음을 수행합니다.
1. found가 false이면, 다음을 수행합니다.
  1. found를 ? CaseClauseIsSelected(clause, input)로 설정합니다.
2. found가 true이면, 다음을 수행합니다.
  1. completion을 Completion(clause의 Evaluation)으로 둡니다.
  2. completion.[[Value]]가 empty가 아니면 resultValue를 completion.[[Value]]로 설정합니다.
  3. completion이 비정상 완료이면 ? UpdateEmpty(completion, resultValue)를 반환합니다.
foundInB를 false로 둡니다.
두 번째 CaseClauses가 존재하면, 다음을 수행합니다.
1. secondCaseClauses를 소스 텍스트 순서로 된 두 번째 CaseClauses의 CaseClause 항목 List로 둡니다.
그렇지 않으면,
1. secondCaseClauses를 새로운 빈 List로 둡니다.
found가 false이면, 다음을 수행합니다.
1. secondCaseClauses의 각 CaseClause clause에 대해 다음을 수행합니다.
  1. foundInB가 false이면, 다음을 수행합니다.
    1. foundInB를 ? CaseClauseIsSelected(clause, input)로 설정합니다.
  2. foundInB가 true이면, 다음을 수행합니다.
    1. completion을 Completion(CaseClause clause의 Evaluation)으로 둡니다.
    2. completion.[[Value]]가 empty가 아니면 resultValue를 completion.[[Value]]로 설정합니다.
    3. completion이 비정상 완료이면 ? UpdateEmpty(completion, resultValue)를 반환합니다.
foundInB가 true이면 resultValue를 반환합니다.
defaultR을 Completion(DefaultClause의 Evaluation)으로 둡니다.
defaultR.[[Value]]가 empty가 아니면 resultValue를 defaultR.[[Value]]로 설정합니다.
defaultR이 비정상 완료이면 ? UpdateEmpty(defaultR, resultValue)를 반환합니다.
참고: 다음은 두 번째 CaseClauses를 다시 완전히 반복하는 것입니다.
secondCaseClauses의 각 CaseClause clause에 대해 다음을 수행합니다.
1. completion을 Completion(CaseClause clause의 Evaluation)으로 둡니다.
2. completion.[[Value]]가 empty가 아니면 resultValue를 completion.[[Value]]로 설정합니다.
3. completion이 비정상 완료이면 ? UpdateEmpty(completion, resultValue)를 반환합니다.
resultValue를 반환합니다.

14.12.3 CaseClauseIsSelected ( `caseClauseNode`, `input` )

추상 연산 CaseClauseIsSelected. 인수 caseClauseNode (CaseClause Parse Node) 및 input (ECMAScript 언어 값). 반환값: Boolean을 포함하는 정상 완료 또는 비정상 완료. caseClauseNode가 input과 일치하는지 결정합니다. 호출되면 다음 단계를 수행한다.

단언: caseClauseNode는 생성 규칙 CaseClause : case Expression : StatementListopt 의 인스턴스입니다.
exprRef를 caseClauseNode의 Expression의 ? Evaluation으로 둡니다.
clauseSelector를 ? GetValue(exprRef)로 둡니다.
IsStrictlyEqual(input, clauseSelector)을 반환합니다.

참고

이 연산은 caseClauseNode의 StatementList(있는 경우)를 실행하지 않습니다. CaseBlock 알고리즘은 이 연산의 반환 값을 사용하여 어느 StatementList부터 실행을 시작할지 결정합니다.

14.12.4 Runtime Semantics: 평가

SwitchStatement

switch

(

Expression

)

CaseBlock

exprRef를 Expression의 ? Evaluation으로 둡니다.
switchValue를 ? GetValue(exprRef)로 둡니다.
oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
blockEnv를 NewDeclarativeEnvironment(oldEnv)로 둡니다.
BlockDeclarationInstantiation(CaseBlock, blockEnv)을 수행합니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 blockEnv로 설정합니다.
blockResult를 Completion(인수 switchValue를 사용한 CaseBlock의 CaseBlockEvaluation)으로 둡니다.
단언: blockEnv.[[DisposableResourceStack]]은 빈 List입니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
blockResult를 반환합니다.

참고

제어가 어떤 방식으로 SwitchStatement을 벗어나더라도 LexicalEnvironment는 항상 이전 상태로 복원됩니다.

CaseClause

case

Expression

empty를 반환합니다.

CaseClause

case

Expression

StatementList

StatementList의 ? Evaluation을 반환합니다.

DefaultClause

default

empty를 반환합니다.

DefaultClause

default

StatementList

StatementList의 ? Evaluation을 반환합니다.

14.13 레이블 문

구문

LabelledStatement

[Yield, Await, Return]

LabelIdentifier

[?Yield, ?Await]

LabelledItem

[?Yield, ?Await, ?Return]

LabelledItem

[Yield, Await, Return]

Statement

[?Yield, ?Await, ?Return]

FunctionDeclaration

[?Yield, ?Await, ~Default]

참고

Statement 앞에는 레이블을 붙일 수 있습니다. 레이블 문은 레이블이 있는 break 및 continue 문과 함께 사용하는 경우에만 사용됩니다. ECMAScript에는 goto 문이 없습니다. Statement은 LabelledStatement의 일부가 될 수 있고, 해당 LabelledStatement 자체도 다시 LabelledStatement의 일부가 될 수 있으며 이런 식으로 계속될 수 있습니다. 이 방식으로 도입된 레이블은 개별 문의 의미론을 설명할 때 통틀어 “현재 레이블 집합”이라고 합니다.

14.13.1 Static Semantics: 조기 오류

LabelledItem

FunctionDeclaration

이 생성 규칙과 일치하는 소스 텍스트가 하나라도 있으면 Syntax Error입니다. 단, 해당 소스 텍스트가 비엄격 코드이고 호스트가 웹 브라우저이거나 그 밖의 방식으로 레이블이 지정된 함수 선언을 지원하면 예외입니다.

14.13.2 Static Semantics: IsLabelledFunction ( `stmt` )

추상 연산 IsLabelledFunction. 인수 stmt (Statement Parse Node). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

stmt가 LabelledStatement이 아니면 false를 반환합니다.
item을 stmt의 LabelledItem으로 둡니다.
item이 LabelledItem : FunctionDeclaration 이면 true를 반환합니다.
subStmt를 item의 Statement으로 둡니다.
IsLabelledFunction(subStmt)을 반환합니다.

14.13.3 Runtime Semantics: 평가

LabelledStatement

LabelIdentifier

LabelledItem

인수 « »을 사용한 이 LabelledStatement의 ? LabelledEvaluation을 반환합니다.

14.13.4 Runtime Semantics: LabelledEvaluation

구문 지향 연산 LabelledEvaluation. 인수 labelSet (String의 List). 반환값: ECMAScript 언어 값 또는 empty를 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

BreakableStatement

IterationStatement

stmtResult를 Completion(인수 labelSet을 사용한 IterationStatement의 LoopEvaluation)으로 둡니다.
stmtResult가 break 완료이면, 다음을 수행합니다.
1. stmtResult.[[Target]]이 empty이면, 다음을 수행합니다.
  1. stmtResult.[[Value]]가 empty이면 stmtResult를 NormalCompletion(undefined)으로 설정합니다.
  2. 그렇지 않으면 stmtResult를 NormalCompletion(stmtResult.[[Value]])으로 설정합니다.
? stmtResult를 반환합니다.

BreakableStatement

SwitchStatement

stmtResult를 Completion(SwitchStatement의 Evaluation)으로 둡니다.
stmtResult가 break 완료이면, 다음을 수행합니다.
1. stmtResult.[[Target]]이 empty이면, 다음을 수행합니다.
  1. stmtResult.[[Value]]가 empty이면 stmtResult를 NormalCompletion(undefined)으로 설정합니다.
  2. 그렇지 않으면 stmtResult를 NormalCompletion(stmtResult.[[Value]])으로 설정합니다.
? stmtResult를 반환합니다.

참고 1

BreakableStatement은 레이블 없는 BreakStatement을 통해 빠져나올 수 있는 문입니다.

LabelledStatement

LabelIdentifier

LabelledItem

label을 LabelIdentifier의 StringValue로 둡니다.
newLabelSet을 labelSet과 « label »의 목록 연결로 둡니다.
stmtResult를 Completion(인수 newLabelSet을 사용한 LabelledItem의 LabelledEvaluation)으로 둡니다.
stmtResult가 break 완료이고 stmtResult.[[Target]]이 label이면, 다음을 수행합니다.
1. stmtResult를 NormalCompletion(stmtResult.[[Value]])으로 설정합니다.
? stmtResult를 반환합니다.

LabelledItem

FunctionDeclaration

FunctionDeclaration의 ? Evaluation을 반환합니다.

Statement의 ? Evaluation을 반환합니다.

참고 2

LabelledEvaluation에 특별한 의미론을 갖는 Statement의 생성 규칙은 BreakableStatement과 LabelledStatement 두 가지뿐입니다.

14.14 `throw` 문

구문

ThrowStatement

[Yield, Await]

throw

[no LineTerminator here]

Expression

[+In, ?Yield, ?Await]

;

14.14.1 Runtime Semantics: 평가

ThrowStatement

throw

Expression

;

exprRef를 Expression의 ? Evaluation으로 둡니다.
exprValue를 ? GetValue(exprRef)로 둡니다.
exprValue를 던집니다.

14.15 `try` 문

구문

TryStatement

[Yield, Await, Return]

try

Block

[?Yield, ?Await, ?Return]

Catch

[?Yield, ?Await, ?Return]

try

Block

[?Yield, ?Await, ?Return]

Finally

[?Yield, ?Await, ?Return]

try

Block

[?Yield, ?Await, ?Return]

Catch

[?Yield, ?Await, ?Return]

Finally

[?Yield, ?Await, ?Return]

Catch

[Yield, Await, Return]

catch

(

CatchParameter

[?Yield, ?Await]

)

Block

[?Yield, ?Await, ?Return]

catch

Block

[?Yield, ?Await, ?Return]

Finally

[Yield, Await, Return]

finally

Block

[?Yield, ?Await, ?Return]

CatchParameter

[Yield, Await]

BindingIdentifier

[?Yield, ?Await]

BindingPattern

[?Yield, ?Await]

참고

try 문은 런타임 오류 또는 throw 문과 같은 예외 상황이 발생할 수 있는 코드 블록을 둘러쌉니다. catch 절은 예외 처리 코드를 제공합니다. catch 절이 예외를 포착하면 해당 CatchParameter는 그 예외에 바인딩됩니다.

14.15.1 Static Semantics: 조기 오류

Catch

catch

(

CatchParameter

)

Block

CatchParameter의 BoundNames에 중복 요소가 하나라도 포함되어 있으면 Syntax Error입니다.
CatchParameter의 BoundNames의 어떤 요소라도 Block의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.
CatchParameter의 BoundNames의 어떤 요소라도 Block의 VarDeclaredNames에도 나타나면 Syntax Error입니다. 단, CatchParameter가 CatchParameter : BindingIdentifier 이고 호스트가 웹 브라우저이거나 그 밖의 방식으로 Catch 블록의 VariableStatement을 지원하면 예외입니다.

14.15.2 Runtime Semantics: CatchClauseEvaluation

구문 지향 연산 CatchClauseEvaluation. 인수 thrownValue (ECMAScript 언어 값). 반환값: ECMAScript 언어 값 또는 empty를 포함하는 정상 완료 또는 비정상 완료. 다음 생성 규칙별로 정의된다.

Catch

catch

(

CatchParameter

)

Block

oldEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
catchEnv를 NewDeclarativeEnvironment(oldEnv)로 둡니다.
CatchParameter의 BoundNames의 각 요소 argName에 대해 다음을 수행합니다.
1. ! catchEnv.CreateMutableBinding(argName, false)를 수행합니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 catchEnv로 설정합니다.
status를 Completion(인수 thrownValue 및 catchEnv를 사용한 CatchParameter의 BindingInitialization)으로 둡니다.
status가 비정상 완료이면, 다음을 수행합니다.
1. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
2. ? status를 반환합니다.
blockCompletion을 Completion(Block의 Evaluation)으로 둡니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 oldEnv로 설정합니다.
? blockCompletion을 반환합니다.

Catch

catch

Block

Block의 ? Evaluation을 반환합니다.

참고

제어가 어떤 방식으로 Block을 벗어나더라도 LexicalEnvironment는 항상 이전 상태로 복원됩니다.

14.15.3 Runtime Semantics: 평가

TryStatement

try

Block

Catch

blockResult를 Completion(Block의 Evaluation)으로 둡니다.
blockResult가 throw 완료이면 catchResult를 Completion(인수 blockResult.[[Value]]를 사용한 Catch의 CatchClauseEvaluation)으로 둡니다.
그렇지 않으면 catchResult를 blockResult로 둡니다.
? UpdateEmpty(catchResult, undefined)를 반환합니다.

TryStatement

try

Block

Finally

blockResult를 Completion(Block의 Evaluation)으로 둡니다.
finallyResult를 Completion(Finally의 Evaluation)으로 둡니다.
finallyResult가 정상 완료이면 finallyResult를 blockResult로 설정합니다.
? UpdateEmpty(finallyResult, undefined)를 반환합니다.

try

blockResult를 Completion(Block의 Evaluation)으로 둡니다.
blockResult가 throw 완료이면 catchResult를 Completion(인수 blockResult.[[Value]]를 사용한 Catch의 CatchClauseEvaluation)으로 둡니다.
그렇지 않으면 catchResult를 blockResult로 둡니다.
finallyResult를 Completion(Finally의 Evaluation)으로 둡니다.
finallyResult가 정상 완료이면 finallyResult를 catchResult로 설정합니다.
? UpdateEmpty(finallyResult, undefined)를 반환합니다.

14.16 `debugger` 문

구문

DebuggerStatement

debugger

;

14.16.1 Runtime Semantics: 평가

참고

DebuggerStatement을 평가하면 디버거에서 실행할 때 구현체가 중단점을 발생시킬 수 있습니다. 디버거가 없거나 활성 상태가 아니면 이 문은 관찰 가능한 효과가 없습니다.

DebuggerStatement

debugger

;

구현체 정의 디버깅 기능을 사용할 수 있고 활성화되어 있으면, 다음을 수행합니다.
1. 구현체 정의 디버깅 동작을 수행합니다.
2. 새로운 구현체 정의 Completion Record를 반환합니다.
empty를 반환합니다.

15 ECMAScript 언어: 함수와 클래스

참고

다양한 ECMAScript 언어 요소는 ECMAScript 함수 객체(10.2)를 생성합니다. 이러한 함수의 평가는 해당 [[Call]] 내부 메서드(10.2.1)의 실행으로 시작합니다.

15.1 매개변수 목록

구문

UniqueFormalParameters

[Yield, Await]

FormalParameters

[?Yield, ?Await]

FormalParameters

[Yield, Await]

[empty]

FunctionRestParameter

[?Yield, ?Await]

FormalParameterList

[?Yield, ?Await]

FormalParameterList

[?Yield, ?Await]

FormalParameterList

[?Yield, ?Await]

FunctionRestParameter

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

FunctionRestParameter

[Yield, Await]

BindingRestElement

[?Yield, ?Await]

FormalParameter

[Yield, Await]

BindingElement

[?Yield, ?Await]

15.1.1 Static Semantics: 조기 오류

UniqueFormalParameters

FormalParameters

FormalParameters의 BoundNames에 중복 요소가 하나라도 포함되어 있으면 Syntax Error입니다.

FormalParameters

FormalParameterList

FormalParameterList의 IsSimpleParameterList가 false이고 FormalParameterList의 BoundNames에 중복 요소가 하나라도 포함되어 있으면 Syntax Error입니다.

참고

FormalParameterList에서 동일한 BindingIdentifier를 여러 번 사용하는 것은 단순 매개변수 목록을 가지며 엄격 모드 코드에서 정의되지 않은 함수에만 허용됩니다.

15.1.2 Static Semantics: ContainsExpression

구문 지향 연산 ContainsExpression. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

ObjectBindingPattern

{

}

{

BindingRestProperty

}

false를 반환합니다.

ObjectBindingPattern

{

BindingPropertyList

BindingRestProperty

}

BindingPropertyList의 ContainsExpression을 반환합니다.

ArrayBindingPattern

[

Elision

opt

]

false를 반환합니다.

ArrayBindingPattern

[

Elision

opt

BindingRestElement

]

BindingRestElement의 ContainsExpression을 반환합니다.

ArrayBindingPattern

[

BindingElementList

Elision

opt

]

BindingElementList의 ContainsExpression을 반환합니다.

[

opt

]

has를 BindingElementList의 ContainsExpression으로 둡니다.
has가 true이면 true를 반환합니다.
BindingRestElement의 ContainsExpression을 반환합니다.

BindingPropertyList

BindingProperty

has를 BindingPropertyList의 ContainsExpression으로 둡니다.
has가 true이면 true를 반환합니다.
BindingProperty의 ContainsExpression을 반환합니다.

BindingElementList

BindingElisionElement

has를 BindingElementList의 ContainsExpression으로 둡니다.
has가 true이면 true를 반환합니다.
BindingElisionElement의 ContainsExpression을 반환합니다.

BindingElisionElement

Elision

opt

BindingElement

BindingElement의 ContainsExpression을 반환합니다.

BindingProperty

PropertyName

BindingElement

has를 PropertyName의 IsComputedPropertyKey로 둡니다.
has가 true이면 true를 반환합니다.
BindingElement의 ContainsExpression을 반환합니다.

BindingElement

BindingPattern

Initializer

true를 반환합니다.

SingleNameBinding

BindingIdentifier

false를 반환합니다.

SingleNameBinding

BindingIdentifier

Initializer

true를 반환합니다.

BindingRestElement

...

BindingIdentifier

false를 반환합니다.

BindingRestElement

...

BindingPattern

BindingPattern의 ContainsExpression을 반환합니다.

FormalParameters

[empty]

false를 반환합니다.

FormalParameters

FormalParameterList

FunctionRestParameter

FormalParameterList의 ContainsExpression이 true이면 true를 반환합니다.
FunctionRestParameter의 ContainsExpression을 반환합니다.

FormalParameterList

FormalParameter

FormalParameterList의 ContainsExpression이 true이면 true를 반환합니다.
FormalParameter의 ContainsExpression을 반환합니다.

ArrowParameters

BindingIdentifier

false를 반환합니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

formals를 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ArrowFormalParameters로 둡니다.
formals의 ContainsExpression을 반환합니다.

AsyncArrowBindingIdentifier

BindingIdentifier

false를 반환합니다.

15.1.3 Static Semantics: IsSimpleParameterList

구문 지향 연산 IsSimpleParameterList. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

BindingElement

BindingPattern

false를 반환합니다.

BindingElement

BindingPattern

Initializer

false를 반환합니다.

SingleNameBinding

BindingIdentifier

true를 반환합니다.

SingleNameBinding

BindingIdentifier

Initializer

false를 반환합니다.

FormalParameters

[empty]

true를 반환합니다.

FormalParameters

FunctionRestParameter

false를 반환합니다.

FormalParameters

FormalParameterList

FunctionRestParameter

false를 반환합니다.

FormalParameterList

FormalParameter

FormalParameterList의 IsSimpleParameterList가 false이면 false를 반환합니다.
FormalParameter의 IsSimpleParameterList를 반환합니다.

FormalParameter

BindingElement

BindingElement의 IsSimpleParameterList를 반환합니다.

ArrowParameters

BindingIdentifier

true를 반환합니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

formals를 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ArrowFormalParameters로 둡니다.
formals의 IsSimpleParameterList를 반환합니다.

AsyncArrowBindingIdentifier

BindingIdentifier

true를 반환합니다.

CoverCallExpressionAndAsyncArrowHead

MemberExpression

Arguments

head를 CoverCallExpressionAndAsyncArrowHead가 포괄하는 AsyncArrowHead로 둡니다.
head의 IsSimpleParameterList를 반환합니다.

15.1.4 Static Semantics: HasInitializer

구문 지향 연산 HasInitializer. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

BindingElement

BindingPattern

false를 반환합니다.

BindingElement

BindingPattern

Initializer

true를 반환합니다.

SingleNameBinding

BindingIdentifier

false를 반환합니다.

SingleNameBinding

BindingIdentifier

Initializer

true를 반환합니다.

FormalParameterList

FormalParameter

FormalParameterList의 HasInitializer가 true이면 true를 반환합니다.
FormalParameter의 HasInitializer를 반환합니다.

15.1.5 Static Semantics: ExpectedArgumentCount

구문 지향 연산 ExpectedArgumentCount. 인수 없음. 반환값: 음이 아닌 정수. 다음 생성 규칙별로 정의된다.

FormalParameters

[empty]

FunctionRestParameter

0을 반환합니다.

FormalParameters

FormalParameterList

FunctionRestParameter

FormalParameterList의 ExpectedArgumentCount를 반환합니다.

참고

FormalParameterList의 ExpectedArgumentCount는 나머지 매개변수 또는 Initializer가 있는 첫 번째 FormalParameter 왼쪽에 있는 FormalParameters의 수입니다. 이니셜라이저가 없는 FormalParameter는 이니셜라이저가 있는 첫 번째 매개변수 뒤에 나타날 수 있지만, 이러한 매개변수는 기본값이 undefined인 선택적 매개변수로 간주됩니다.

FormalParameterList

FormalParameter

FormalParameter의 HasInitializer가 true이면 0을 반환합니다.
1을 반환합니다.

FormalParameterList

FormalParameter

count를 FormalParameterList의 ExpectedArgumentCount로 둡니다.
FormalParameterList의 HasInitializer가 true이거나 FormalParameter의 HasInitializer가 true이면 count를 반환합니다.
count + 1을 반환합니다.

ArrowParameters

BindingIdentifier

1을 반환합니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

formals를 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ArrowFormalParameters로 둡니다.
formals의 ExpectedArgumentCount를 반환합니다.

PropertySetParameterList

FormalParameter

FormalParameter의 HasInitializer가 true이면 0을 반환합니다.
1을 반환합니다.

AsyncArrowBindingIdentifier

BindingIdentifier

1을 반환합니다.

15.2 함수 정의

구문

FunctionDeclaration

[Yield, Await, Default]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

[+Default]

function

(

FormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

FunctionExpression

function

BindingIdentifier

[~Yield, ~Await]

opt

(

FormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

FunctionBody

[Yield, Await]

FunctionStatementList

[?Yield, ?Await]

FunctionStatementList

[Yield, Await]

StatementList

[?Yield, ?Await, +Return]

opt

15.2.1 Static Semantics: 조기 오류

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

FunctionBody

}

FunctionExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

FunctionBody

}

IsStrict(FormalParameters)이 true이면 UniqueFormalParameters : FormalParameters 에 대한 조기 오류 규칙을 적용합니다.
BindingIdentifier가 존재하고 IsStrict(BindingIdentifier)이 true이며 BindingIdentifier의 StringValue가 "eval" 또는 "arguments" 중 하나이면 Syntax Error입니다.
FunctionBody의 FunctionBodyContainsUseStrict가 true이고 FormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
FormalParameters의 BoundNames의 어떤 요소라도 FunctionBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.
FormalParameters Contains SuperProperty가 true이면 Syntax Error입니다.
FunctionBody Contains SuperProperty가 true이면 Syntax Error입니다.
FormalParameters Contains SuperCall이 true이면 Syntax Error입니다.
FunctionBody Contains SuperCall이 true이면 Syntax Error입니다.

참고

FunctionBody의 LexicallyDeclaredNames에는 var 또는 함수 선언을 사용하여 바인딩된 식별자가 포함되지 않습니다.

FunctionBody

FunctionStatementList

FunctionStatementList의 LexicallyDeclaredNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.
FunctionStatementList의 LexicallyDeclaredNames의 어떤 요소라도 FunctionStatementList의 VarDeclaredNames에도 나타나면 Syntax Error입니다.
인수 « »을 사용한 FunctionStatementList의 ContainsDuplicateLabels가 true이면 Syntax Error입니다.
인수 « »을 사용한 FunctionStatementList의 ContainsUndefinedBreakTarget이 true이면 Syntax Error입니다.
인수 « » 및 « »을 사용한 FunctionStatementList의 ContainsUndefinedContinueTarget이 true이면 Syntax Error입니다.

15.2.2 Static Semantics: FunctionBodyContainsUseStrict

구문 지향 연산 FunctionBodyContainsUseStrict. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

FunctionBody

FunctionStatementList

FunctionBody의 Directive Prologue에 Use Strict Directive가 포함되어 있으면 true를 반환합니다.
false를 반환합니다.

15.2.3 Runtime Semantics: EvaluateFunctionBody

구문 지향 연산 EvaluateFunctionBody. 인수 funcObj (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (return 완료 또는 throw 완료). 다음 생성 규칙별로 정의된다.

FunctionBody

FunctionStatementList

? FunctionDeclarationInstantiation(funcObj, argList)을 수행합니다.
FunctionStatementList의 ? Evaluation을 수행합니다.
참고: 이전 단계가 정상 완료를 생성했다면 평가는 FunctionStatementList의 끝을 지나 진행하여 완료된 것입니다.
ReturnCompletion(undefined)을 반환합니다.

15.2.4 Runtime Semantics: InstantiateOrdinaryFunctionObject

구문 지향 연산 InstantiateOrdinaryFunctionObject. 인수 envRecord (Environment 레코드) 및 privateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

name을 BindingIdentifier의 StringValue로 둡니다.
sourceText를 FunctionDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, FormalParameters, FunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
MakeConstructor(closure)를 수행합니다.
closure를 반환합니다.

FunctionDeclaration

function

(

FormalParameters

)

{

FunctionBody

}

sourceText를 FunctionDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, FormalParameters, FunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, "default")를 수행합니다.
MakeConstructor(closure)를 수행합니다.
closure를 반환합니다.

참고

익명 FunctionDeclaration은 export default 선언의 일부로만 나타날 수 있으므로 해당 함수 코드는 항상 엄격 모드 코드입니다.

15.2.5 Runtime Semantics: InstantiateOrdinaryFunctionExpression

구문 지향 연산 InstantiateOrdinaryFunctionExpression. 선택적 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

FunctionExpression

function

(

FormalParameters

)

{

FunctionBody

}

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 FunctionExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, FormalParameters, FunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
MakeConstructor(closure)를 수행합니다.
closure를 반환합니다.

FunctionExpression

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

단언: name은 존재하지 않습니다.
name을 BindingIdentifier의 StringValue로 설정합니다.
outerEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
funcEnv를 NewDeclarativeEnvironment(outerEnv)로 둡니다.
! funcEnv.CreateImmutableBinding(name, false)를 수행합니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 FunctionExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, FormalParameters, FunctionBody, non-lexical-this, funcEnv, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
MakeConstructor(closure)를 수행합니다.
! funcEnv.InitializeBinding(name, closure)를 수행합니다.
closure를 반환합니다.

참고

FunctionExpression의 BindingIdentifier는 함수가 자기 자신을 재귀적으로 호출할 수 있도록 FunctionExpression의 FunctionBody 내부에서 참조할 수 있습니다. 그러나 FunctionDeclaration과 달리 FunctionExpression의 BindingIdentifier는 FunctionExpression을 둘러싸는 스코프에서 참조할 수 없으며 해당 스코프에도 영향을 주지 않습니다.

15.2.6 Runtime Semantics: 평가

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

empty를 반환합니다.

참고 1

대체 의미론은 FunctionDeclarationInstantiation의 32.a.i.2.c 단계, GlobalDeclarationInstantiation의 12.b.ii.2.a.ii.iii 단계, EvalDeclarationInstantiation의 13.b.ii.7.b 단계에서 블록 수준 함수 선언의 웹 레거시 호환성 의미론에 의해 제공됩니다.

FunctionDeclaration

function

(

FormalParameters

)

{

FunctionBody

}

empty를 반환합니다.

FunctionExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

FunctionBody

}

FunctionExpression의 InstantiateOrdinaryFunctionExpression을 반환합니다.

참고 2

FunctionDeclaration 또는 FunctionExpression을 사용하여 정의된 모든 함수에는 해당 함수가 생성자로 사용될 가능성을 허용하기 위해 "prototype" 프로퍼티가 자동으로 생성됩니다.

FunctionStatementList

[empty]

undefined를 반환합니다.

FunctionStatementList

StatementList

result를 Completion(StatementList의 Evaluation)으로 둡니다.
env를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
단언: env는 Declarative Environment Record입니다.
? DisposeResources(env.[[DisposableResourceStack]], result)를 반환합니다.

15.3 화살표 함수 정의

구문

ArrowFunction

[In, Yield, Await]

ArrowParameters

[?Yield, ?Await]

[no LineTerminator here]

ConciseBody

[?In]

ArrowParameters

[Yield, Await]

BindingIdentifier

[?Yield, ?Await]

CoverParenthesizedExpressionAndArrowParameterList

[?Yield, ?Await]

ConciseBody

[In]

[lookahead ≠ {]

ExpressionBody

[?In, ~Await]

{

FunctionBody

[~Yield, ~Await]

}

ExpressionBody

[In, Await]

AssignmentExpression

[?In, ~Yield, ?Await]

보충 구문

다음 생성 규칙의 인스턴스를 처리할 때
ArrowParameters[Yield, Await] : CoverParenthesizedExpressionAndArrowParameterList[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList의 해석은 다음 문법을 사용하여 구체화됩니다:

ArrowFormalParameters

[Yield, Await]

(

UniqueFormalParameters

[?Yield, ?Await]

)

15.3.1 Static Semantics: 조기 오류

ArrowFunction

ArrowParameters

ConciseBody

ArrowParameters Contains YieldExpression이 true이면 Syntax Error입니다.
ArrowParameters Contains AwaitExpression이 true이면 Syntax Error입니다.
ConciseBody의 ConciseBodyContainsUseStrict가 true이고 ArrowParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
ArrowParameters의 BoundNames의 어떤 요소라도 ConciseBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

ArrowParameters

CoverParenthesizedExpressionAndArrowParameterList

CoverParenthesizedExpressionAndArrowParameterList는 ArrowFormalParameters를 포괄해야 합니다.

15.3.2 Static Semantics: ConciseBodyContainsUseStrict

구문 지향 연산 ConciseBodyContainsUseStrict. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

ConciseBody

ExpressionBody

false를 반환합니다.

ConciseBody

{

FunctionBody

}

FunctionBody의 FunctionBodyContainsUseStrict를 반환합니다.

15.3.3 Runtime Semantics: EvaluateConciseBody

구문 지향 연산 EvaluateConciseBody. 인수 funcObj (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (return 완료 또는 throw 완료). 다음 생성 규칙별로 정의된다.

ConciseBody

ExpressionBody

? FunctionDeclarationInstantiation(funcObj, argList)을 수행합니다.
ExpressionBody의 ? Evaluation을 반환합니다.

15.3.4 Runtime Semantics: InstantiateArrowFunctionExpression

구문 지향 연산 InstantiateArrowFunctionExpression. 선택적 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

ArrowFunction

ArrowParameters

ConciseBody

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 ArrowFunction과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, ArrowParameters, ConciseBody, lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
closure를 반환합니다.

참고

ArrowFunction은 arguments, super, this 또는 new.target에 대한 로컬 바인딩을 정의하지 않습니다. ArrowFunction 안에서 arguments, super, this 또는 new.target에 대한 모든 참조는 렉시컬하게 둘러싸는 환경의 바인딩으로 해석되어야 합니다. 일반적으로 이는 바로 둘러싸는 함수의 Function Environment입니다. ArrowFunction이 super에 대한 참조를 포함할 수 있더라도 5 단계에서 생성된 함수 객체에 MakeMethod를 수행하여 메서드로 만들지는 않습니다. super를 참조하는 ArrowFunction은 항상 비-ArrowFunction 안에 포함되며 super를 구현하는 데 필요한 상태는 ArrowFunction의 함수 객체가 캡처하는 envRecord를 통해 접근할 수 있습니다.

15.3.5 Runtime Semantics: 평가

ArrowFunction

ArrowParameters

ConciseBody

ArrowFunction의 InstantiateArrowFunctionExpression을 반환합니다.

ExpressionBody

AssignmentExpression

exprRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
exprValue를 ? GetValue(exprRef)로 둡니다.
ReturnCompletion(exprValue)을 반환합니다.

15.4 메서드 정의

구문

MethodDefinition

[Yield, Await]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

GeneratorMethod

[?Yield, ?Await]

AsyncMethod

[?Yield, ?Await]

AsyncGeneratorMethod

[?Yield, ?Await]

get

ClassElementName

[?Yield, ?Await]

(

)

{

FunctionBody

[~Yield, ~Await]

}

set

ClassElementName

[?Yield, ?Await]

(

PropertySetParameterList

)

{

FunctionBody

[~Yield, ~Await]

}

PropertySetParameterList

FormalParameter

[~Yield, ~Await]

15.4.1 Static Semantics: 조기 오류

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

FunctionBody의 FunctionBodyContainsUseStrict가 true이고 UniqueFormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
UniqueFormalParameters의 BoundNames의 어떤 요소라도 FunctionBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

MethodDefinition

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

PropertySetParameterList의 BoundNames에 중복 요소가 하나라도 포함되어 있으면 Syntax Error입니다.
FunctionBody의 FunctionBodyContainsUseStrict가 true이고 PropertySetParameterList의 IsSimpleParameterList가 false이면 Syntax Error입니다.
PropertySetParameterList의 BoundNames의 어떤 요소라도 FunctionBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

15.4.2 Static Semantics: HasDirectSuper

구문 지향 연산 HasDirectSuper. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

UniqueFormalParameters Contains SuperCall이 true이면 true를 반환합니다.
FunctionBody Contains SuperCall을 반환합니다.

MethodDefinition

get

ClassElementName

(

)

{

FunctionBody

}

FunctionBody Contains SuperCall을 반환합니다.

MethodDefinition

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

PropertySetParameterList Contains SuperCall이 true이면 true를 반환합니다.
FunctionBody Contains SuperCall을 반환합니다.

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

UniqueFormalParameters Contains SuperCall이 true이면 true를 반환합니다.
GeneratorBody Contains SuperCall을 반환합니다.

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

UniqueFormalParameters Contains SuperCall이 true이면 true를 반환합니다.
AsyncGeneratorBody Contains SuperCall을 반환합니다.

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

UniqueFormalParameters Contains SuperCall이 true이면 true를 반환합니다.
AsyncFunctionBody Contains SuperCall을 반환합니다.

15.4.3 Static Semantics: SpecialMethod

구문 지향 연산 SpecialMethod. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

false를 반환합니다.

get

(

)

{

FunctionBody

}

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

true를 반환합니다.

15.4.4 Runtime Semantics: DefineMethod

구문 지향 연산 DefineMethod. 인수 obj (Object) 및 선택적 인수 proto (Object). 반환값: (정상 완료 (값: 레코드 (필드: [[Key]] (프로퍼티 키), [[Closure]] (ECMAScript 함수 객체))) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

propertyKey를 ClassElementName의 ? Evaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
proto가 존재하지 않으면 proto를 %Function.prototype%로 설정합니다.
sourceText를 MethodDefinition과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(proto, sourceText, UniqueFormalParameters, FunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
MakeMethod(closure, obj)을 수행합니다.
Record { [[Key]]: propertyKey, [[Closure]]: closure }를 반환합니다.

15.4.5 Runtime Semantics: MethodDefinitionEvaluation

구문 지향 연산 MethodDefinitionEvaluation. 인수 obj (Object) 및 enumerable (Boolean). 반환값: (정상 완료 (값: (PrivateElement 또는 empty)) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

methodDef를 인수 obj를 사용한 MethodDefinition의 ? DefineMethod로 둡니다.
SetFunctionName(methodDef.[[Closure]], methodDef.[[Key]])을 수행합니다.
? DefineMethodProperty(obj, methodDef.[[Key]], methodDef.[[Closure]], enumerable)을 반환합니다.

MethodDefinition

get

ClassElementName

(

)

{

FunctionBody

}

propertyKey를 ClassElementName의 ? Evaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 MethodDefinition과 일치하는 소스 텍스트로 둡니다.
formalParamList를 생성 규칙 FormalParameters : [empty] 의 인스턴스로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, formalParamList, FunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
MakeMethod(closure, obj)을 수행합니다.
SetFunctionName(closure, propertyKey, "get")을 수행합니다.
propertyKey가 Private Name이면, 다음을 수행합니다.
1. PrivateElement { [[Key]]: propertyKey, [[Kind]]: accessor, [[Getter]]: closure, [[Setter]]: undefined }를 반환합니다.
propertyDesc를 PropertyDescriptor { [[Getter]]: closure, [[Enumerable]]: enumerable, [[Configurable]]: true }로 둡니다.
? DefinePropertyOrThrow(obj, propertyKey, propertyDesc)를 수행합니다.
empty를 반환합니다.

MethodDefinition

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

propertyKey를 ClassElementName의 ? Evaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 MethodDefinition과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, PropertySetParameterList, FunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
MakeMethod(closure, obj)을 수행합니다.
SetFunctionName(closure, propertyKey, "set")을 수행합니다.
propertyKey가 Private Name이면, 다음을 수행합니다.
1. PrivateElement { [[Key]]: propertyKey, [[Kind]]: accessor, [[Getter]]: undefined, [[Setter]]: closure }를 반환합니다.
propertyDesc를 PropertyDescriptor { [[Setter]]: closure, [[Enumerable]]: enumerable, [[Configurable]]: true }로 둡니다.
? DefinePropertyOrThrow(obj, propertyKey, propertyDesc)를 수행합니다.
empty를 반환합니다.

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

propertyKey를 ClassElementName의 ? Evaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 GeneratorMethod와 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceText, UniqueFormalParameters, GeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
MakeMethod(closure, obj)을 수행합니다.
SetFunctionName(closure, propertyKey)을 수행합니다.
proto를 OrdinaryObjectCreate(%GeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
? DefineMethodProperty(obj, propertyKey, closure, enumerable)을 반환합니다.

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

propertyKey를 ClassElementName의 ? Evaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncGeneratorMethod와 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncGeneratorFunction.prototype%, sourceText, UniqueFormalParameters, AsyncGeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
MakeMethod(closure, obj)을 수행합니다.
SetFunctionName(closure, propertyKey)을 수행합니다.
proto를 OrdinaryObjectCreate(%AsyncGeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
? DefineMethodProperty(obj, propertyKey, closure, enumerable)을 반환합니다.

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

propertyKey를 ClassElementName의 ? Evaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncMethod와 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, UniqueFormalParameters, AsyncFunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
MakeMethod(closure, obj)을 수행합니다.
SetFunctionName(closure, propertyKey)을 수행합니다.
? DefineMethodProperty(obj, propertyKey, closure, enumerable)을 반환합니다.

15.5 제너레이터 함수 정의

구문

GeneratorDeclaration

[Yield, Await, Default]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[+Yield, ~Await]

)

{

GeneratorBody

}

[+Default]

function

(

FormalParameters

[+Yield, ~Await]

)

{

GeneratorBody

}

GeneratorExpression

function

BindingIdentifier

[+Yield, ~Await]

opt

(

FormalParameters

[+Yield, ~Await]

)

{

GeneratorBody

}

GeneratorMethod

[Yield, Await]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[+Yield, ~Await]

)

{

}

[+Yield, ~Await]

[In, Await]

yield

[no LineTerminator here]

AssignmentExpression

[?In, +Yield, ?Await]

yield

[no LineTerminator here]

AssignmentExpression

[?In, +Yield, ?Await]

참고 1

yield 바로 뒤의 구문 문맥에서는 InputElementRegExpOrTemplateTail 어휘 목표를 사용해야 합니다.

참고 2

FormalParameters의 일부인 표현식은 결과 Generator가 재개 가능한 상태가 되기 전에 평가되므로 제너레이터 함수의 FormalParameters 안에서는 YieldExpression을 사용할 수 없습니다.

참고 3

Generator와 관련된 추상 연산은 27.8.3에 정의되어 있습니다.

15.5.1 Static Semantics: 조기 오류

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

GeneratorMethod의 HasDirectSuper가 true이면 Syntax Error입니다.
UniqueFormalParameters Contains YieldExpression이 true이면 Syntax Error입니다.
GeneratorBody의 FunctionBodyContainsUseStrict가 true이고 UniqueFormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
UniqueFormalParameters의 BoundNames의 어떤 요소라도 GeneratorBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

GeneratorDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

GeneratorExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

GeneratorBody

}

IsStrict(FormalParameters)이 true이면 UniqueFormalParameters : FormalParameters 에 대한 조기 오류 규칙을 적용합니다.
BindingIdentifier가 존재하고 IsStrict(BindingIdentifier)이 true이며 BindingIdentifier의 StringValue가 "eval" 또는 "arguments" 중 하나이면 Syntax Error입니다.
GeneratorBody의 FunctionBodyContainsUseStrict가 true이고 FormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
FormalParameters의 BoundNames의 어떤 요소라도 GeneratorBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.
FormalParameters Contains YieldExpression이 true이면 Syntax Error입니다.
FormalParameters Contains SuperProperty가 true이면 Syntax Error입니다.
GeneratorBody Contains SuperProperty가 true이면 Syntax Error입니다.
FormalParameters Contains SuperCall이 true이면 Syntax Error입니다.
GeneratorBody Contains SuperCall이 true이면 Syntax Error입니다.

15.5.2 Runtime Semantics: EvaluateGeneratorBody

구문 지향 연산 EvaluateGeneratorBody. 인수 funcObj (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (throw 완료 또는 return 완료). 다음 생성 규칙별로 정의된다.

GeneratorBody

FunctionBody

? FunctionDeclarationInstantiation(funcObj, argList)을 수행합니다.
gen을 ? OrdinaryCreateFromConstructor(funcObj, "%GeneratorPrototype%", « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »)로 둡니다.
gen.[[GeneratorBrand]]를 empty로 설정합니다.
gen.[[GeneratorState]]를 suspended-start로 설정합니다.
GeneratorStart(gen, FunctionBody)를 수행합니다.
ReturnCompletion(gen)을 반환합니다.

15.5.3 Runtime Semantics: InstantiateGeneratorFunctionObject

구문 지향 연산 InstantiateGeneratorFunctionObject. 인수 envRecord (Environment 레코드) 및 privateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

GeneratorDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

GeneratorBody

}

name을 BindingIdentifier의 StringValue로 둡니다.
sourceText를 GeneratorDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceText, FormalParameters, GeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
proto를 OrdinaryObjectCreate(%GeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
closure를 반환합니다.

GeneratorDeclaration

function

(

FormalParameters

)

{

GeneratorBody

}

sourceText를 GeneratorDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceText, FormalParameters, GeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, "default")를 수행합니다.
proto를 OrdinaryObjectCreate(%GeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
closure를 반환합니다.

참고

익명 GeneratorDeclaration은 export default 선언의 일부로만 나타날 수 있으므로 해당 함수 코드는 항상 엄격 모드 코드입니다.

15.5.4 Runtime Semantics: InstantiateGeneratorFunctionExpression

구문 지향 연산 InstantiateGeneratorFunctionExpression. 선택적 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

GeneratorExpression

function

(

FormalParameters

)

{

GeneratorBody

}

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 GeneratorExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceText, FormalParameters, GeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
proto를 OrdinaryObjectCreate(%GeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
closure를 반환합니다.

GeneratorExpression

function

BindingIdentifier

(

FormalParameters

)

{

GeneratorBody

}

단언: name은 존재하지 않습니다.
name을 BindingIdentifier의 StringValue로 설정합니다.
outerEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
funcEnv를 NewDeclarativeEnvironment(outerEnv)로 둡니다.
! funcEnv.CreateImmutableBinding(name, false)를 수행합니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 GeneratorExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceText, FormalParameters, GeneratorBody, non-lexical-this, funcEnv, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
proto를 OrdinaryObjectCreate(%GeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
! funcEnv.InitializeBinding(name, closure)를 수행합니다.
closure를 반환합니다.

참고

GeneratorExpression의 BindingIdentifier는 제너레이터 코드가 자기 자신을 재귀적으로 호출할 수 있도록 GeneratorExpression의 FunctionBody 내부에서 참조할 수 있습니다. 그러나 GeneratorDeclaration과 달리 GeneratorExpression의 BindingIdentifier는 GeneratorExpression을 둘러싸는 스코프에서 참조할 수 없으며 해당 스코프에도 영향을 주지 않습니다.

15.5.5 Runtime Semantics: 평가

GeneratorExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

GeneratorBody

}

GeneratorExpression의 InstantiateGeneratorFunctionExpression을 반환합니다.

YieldExpression

yield

? Yield(undefined)를 반환합니다.

YieldExpression

yield

AssignmentExpression

exprRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
value를 ? GetValue(exprRef)로 둡니다.
? Yield(value)를 반환합니다.

YieldExpression

yield

AssignmentExpression

genKind를 GetGeneratorKind()로 둡니다.
단언: genKind는 sync 또는 async입니다.
exprRef를 AssignmentExpression의 ? Evaluation으로 둡니다.
value를 ? GetValue(exprRef)로 둡니다.
iteratorRecord를 ? GetIterator(value, genKind)로 둡니다.
iterator를 iteratorRecord.[[Iterator]]로 둡니다.
received를 NormalCompletion(undefined)로 둡니다.
다음을 반복합니다.
1. received가 정상 완료이면, 다음을 수행합니다.
  1. innerResult를 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] »)로 둡니다.
  2. genKind가 async이면 innerResult를 ? Await(innerResult)로 설정합니다.
  3. innerResult가 Object가 아니면 TypeError 예외를 던집니다.
  4. done을 ? IteratorComplete(innerResult)로 둡니다.
  5. done이 true이면, 다음을 수행합니다.
    1. ? IteratorValue(innerResult)를 반환합니다.
  6. genKind가 async이면 received를 Completion(AsyncGeneratorYield(? IteratorValue(innerResult)))으로 설정합니다.
  7. 그렇지 않으면 received를 Completion(GeneratorYield(innerResult))으로 설정합니다.
2. 그렇지 않고 received가 throw 완료이면, 다음을 수행합니다.
  1. throw를 ? GetMethod(iterator, "throw")로 둡니다.
  2. throw가 undefined가 아니면, 다음을 수행합니다.
    1. innerResult를 ? Call(throw, iterator, « received.[[Value]] »)로 둡니다.
    2. genKind가 async이면 innerResult를 ? Await(innerResult)로 설정합니다.
    3. 참고: 내부 반복자의 throw 메서드에서 발생한 예외는 전파됩니다. 내부 throw 메서드의 정상 완료는 내부 next와 유사하게 처리됩니다.
    4. innerResult가 Object가 아니면 TypeError 예외를 던집니다.
    5. done을 ? IteratorComplete(innerResult)로 둡니다.
    6. done이 true이면, 다음을 수행합니다.
      1. ? IteratorValue(innerResult)를 반환합니다.
    7. genKind가 async이면 received를 Completion(AsyncGeneratorYield(? IteratorValue(innerResult)))으로 설정합니다.
    8. 그렇지 않으면 received를 Completion(GeneratorYield(innerResult))으로 설정합니다.
  3. 그렇지 않으면,
    1. 참고: iterator에 throw 메서드가 없으면 이 throw는 yield* 반복을 종료합니다. 그러나 먼저 iterator가 정리할 기회를 제공해야 합니다.
    2. closeCompletion을 NormalCompletion(empty)으로 둡니다.
    3. genKind가 async이면 ? AsyncIteratorClose(iteratorRecord, closeCompletion)를 수행합니다.
    4. 그렇지 않으면 ? IteratorClose(iteratorRecord, closeCompletion)를 수행합니다.
    5. 참고: 다음 단계는 yield* 프로토콜 위반, 즉 iterator에 throw 메서드가 없음을 나타내기 위해 TypeError를 던집니다.
    6. TypeError 예외를 던집니다.
3. 그렇지 않으면,
  1. 단언: received는 return 완료입니다.
  2. return을 ? GetMethod(iterator, "return")으로 둡니다.
  3. return이 undefined이면, 다음을 수행합니다.
    1. receivedValue를 received.[[Value]]로 둡니다.
    2. genKind가 async이면, 다음을 수행합니다.
      1. receivedValue를 ? Await(receivedValue)로 설정합니다.
    3. ReturnCompletion(receivedValue)을 반환합니다.
  4. innerReturnResult를 ? Call(return, iterator, « received.[[Value]] »)로 둡니다.
  5. genKind가 async이면 innerReturnResult를 ? Await(innerReturnResult)로 설정합니다.
  6. innerReturnResult가 Object가 아니면 TypeError 예외를 던집니다.
  7. done을 ? IteratorComplete(innerReturnResult)로 둡니다.
  8. done이 true이면, 다음을 수행합니다.
    1. returnedValue를 ? IteratorValue(innerReturnResult)로 둡니다.
    2. ReturnCompletion(returnedValue)을 반환합니다.
  9. genKind가 async이면 received를 Completion(AsyncGeneratorYield(? IteratorValue(innerReturnResult)))으로 설정합니다.
  10. 그렇지 않으면 received를 Completion(GeneratorYield(innerReturnResult))으로 설정합니다.

15.6 비동기 제너레이터 함수 정의

구문

AsyncGeneratorDeclaration

[Yield, Await, Default]

async

[no LineTerminator here]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

[+Default]

async

[no LineTerminator here]

function

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression

async

[no LineTerminator here]

function

BindingIdentifier

[+Yield, +Await]

opt

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorMethod

[Yield, Await]

async

[no LineTerminator here]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorBody

FunctionBody

[+Yield, +Await]

참고 1

FormalParameters의 일부인 표현식은 결과 AsyncGenerator가 재개 가능한 상태가 되기 전에 평가되므로 비동기 제너레이터 함수의 FormalParameters 안에서는 YieldExpression 및 AwaitExpression을 사용할 수 없습니다.

참고 2

AsyncGenerator와 관련된 추상 연산은 27.9.3에 정의되어 있습니다.

15.6.1 Static Semantics: 조기 오류

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

AsyncGeneratorMethod의 HasDirectSuper가 true이면 Syntax Error입니다.
UniqueFormalParameters Contains YieldExpression이 true이면 Syntax Error입니다.
UniqueFormalParameters Contains AwaitExpression이 true이면 Syntax Error입니다.
AsyncGeneratorBody의 FunctionBodyContainsUseStrict가 true이고 UniqueFormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
UniqueFormalParameters의 BoundNames의 어떤 요소라도 AsyncGeneratorBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncGeneratorBody

}

IsStrict(FormalParameters)이 true이면 UniqueFormalParameters : FormalParameters 에 대한 조기 오류 규칙을 적용합니다.
BindingIdentifier가 존재하고 IsStrict(BindingIdentifier)이 true이며 BindingIdentifier의 StringValue가 "eval" 또는 "arguments" 중 하나이면 Syntax Error입니다.
AsyncGeneratorBody의 FunctionBodyContainsUseStrict가 true이고 FormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
FormalParameters의 BoundNames의 어떤 요소라도 AsyncGeneratorBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.
FormalParameters Contains YieldExpression이 true이면 Syntax Error입니다.
FormalParameters Contains AwaitExpression이 true이면 Syntax Error입니다.
FormalParameters Contains SuperProperty가 true이면 Syntax Error입니다.
AsyncGeneratorBody Contains SuperProperty가 true이면 Syntax Error입니다.
FormalParameters Contains SuperCall이 true이면 Syntax Error입니다.
AsyncGeneratorBody Contains SuperCall이 true이면 Syntax Error입니다.

15.6.2 Runtime Semantics: EvaluateAsyncGeneratorBody

구문 지향 연산 EvaluateAsyncGeneratorBody. 인수 funcObj (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (throw 완료 또는 return 완료). 다음 생성 규칙별로 정의된다.

AsyncGeneratorBody

FunctionBody

? FunctionDeclarationInstantiation(funcObj, argList)을 수행합니다.
gen을 ? OrdinaryCreateFromConstructor(funcObj, "%AsyncGeneratorPrototype%", « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »)로 둡니다.
gen.[[GeneratorBrand]]를 empty로 설정합니다.
gen.[[AsyncGeneratorState]]를 suspended-start로 설정합니다.
AsyncGeneratorStart(gen, FunctionBody)를 수행합니다.
ReturnCompletion(gen)을 반환합니다.

15.6.3 Runtime Semantics: InstantiateAsyncGeneratorFunctionObject

구문 지향 연산 InstantiateAsyncGeneratorFunctionObject. 인수 envRecord (Environment 레코드) 및 privateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

name을 BindingIdentifier의 StringValue로 둡니다.
sourceText를 AsyncGeneratorDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncGeneratorFunction.prototype%, sourceText, FormalParameters, AsyncGeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
proto를 OrdinaryObjectCreate(%AsyncGeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
closure를 반환합니다.

AsyncGeneratorDeclaration

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

sourceText를 AsyncGeneratorDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncGeneratorFunction.prototype%, sourceText, FormalParameters, AsyncGeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, "default")를 수행합니다.
proto를 OrdinaryObjectCreate(%AsyncGeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
closure를 반환합니다.

참고

익명 AsyncGeneratorDeclaration은 export default 선언의 일부로만 나타날 수 있습니다.

15.6.4 Runtime Semantics: InstantiateAsyncGeneratorFunctionExpression

구문 지향 연산 InstantiateAsyncGeneratorFunctionExpression. 선택적 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

AsyncGeneratorExpression

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncGeneratorExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncGeneratorFunction.prototype%, sourceText, FormalParameters, AsyncGeneratorBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
proto를 OrdinaryObjectCreate(%AsyncGeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
closure를 반환합니다.

AsyncGeneratorExpression

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

단언: name은 존재하지 않습니다.
name을 BindingIdentifier의 StringValue로 설정합니다.
outerEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
funcEnv를 NewDeclarativeEnvironment(outerEnv)로 둡니다.
! funcEnv.CreateImmutableBinding(name, false)를 수행합니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncGeneratorExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncGeneratorFunction.prototype%, sourceText, FormalParameters, AsyncGeneratorBody, non-lexical-this, funcEnv, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
proto를 OrdinaryObjectCreate(%AsyncGeneratorPrototype%)로 둡니다.
! DefinePropertyOrThrow(closure, "prototype", PropertyDescriptor { [[Value]]: proto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
! funcEnv.InitializeBinding(name, closure)를 수행합니다.
closure를 반환합니다.

참고

AsyncGeneratorExpression의 BindingIdentifier는 제너레이터 코드가 자기 자신을 재귀적으로 호출할 수 있도록 AsyncGeneratorExpression의 AsyncGeneratorBody 내부에서 참조할 수 있습니다. 그러나 AsyncGeneratorDeclaration과 달리 AsyncGeneratorExpression의 BindingIdentifier는 AsyncGeneratorExpression을 둘러싸는 스코프에서 참조할 수 없으며 해당 스코프에도 영향을 주지 않습니다.

15.6.5 Runtime Semantics: 평가

AsyncGeneratorExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression의 InstantiateAsyncGeneratorFunctionExpression을 반환합니다.

15.7 클래스 정의

구문

ClassDeclaration

[Yield, Await, Default]

class

BindingIdentifier

[?Yield, ?Await]

ClassTail

[?Yield, ?Await]

[+Default]

class

ClassTail

[?Yield, ?Await]

ClassExpression

[Yield, Await]

class

BindingIdentifier

[?Yield, ?Await]

opt

ClassTail

[?Yield, ?Await]

ClassTail

[Yield, Await]

ClassHeritage

[?Yield, ?Await]

opt

{

ClassBody

[?Yield, ?Await]

opt

}

ClassHeritage

[Yield, Await]

extends

LeftHandSideExpression

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

static

MethodDefinition

[?Yield, ?Await]

FieldDefinition

[?Yield, ?Await]

;

static

FieldDefinition

[?Yield, ?Await]

;

;

[Yield, Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

opt

[Yield, Await]

[?Yield, ?Await]

static

{

ClassStaticBlockBody

}

ClassStaticBlockBody

ClassStaticBlockStatementList

StatementList

[~Yield, +Await, ~Return]

opt

참고

클래스 정의는 항상 엄격 모드 코드입니다.

15.7.1 Static Semantics: 조기 오류

ClassTail

ClassHeritage

opt

{

ClassBody

}

ClassHeritage가 존재하지 않고 다음 알고리즘이 true를 반환하면 Syntax Error입니다:
1. ctor를 ClassBody의 ConstructorMethod로 둡니다.
2. ctor가 empty이면 false를 반환합니다.
3. ctor의 HasDirectSuper를 반환합니다.

ClassBody

ClassElementList

ClassElementList의 PrototypePropertyNameList에 "constructor"가 두 번 이상 나타나면 Syntax Error입니다.
ClassElementList의 PrivateBoundIdentifiers에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다. 단, 해당 이름이 getter에 한 번, setter에 한 번 사용되고 그 밖의 어떤 항목에서도 사용되지 않으며 getter와 setter가 둘 다 static이거나 둘 다 non-static이면 예외입니다.

ClassElement

MethodDefinition

MethodDefinition의 PropName이 "constructor"가 아니고 MethodDefinition의 HasDirectSuper가 true이면 Syntax Error입니다.
MethodDefinition의 PropName이 "constructor"이고 MethodDefinition의 SpecialMethod가 true이면 Syntax Error입니다.

ClassElement

static

MethodDefinition

MethodDefinition의 HasDirectSuper가 true이면 Syntax Error입니다.
MethodDefinition의 PropName이 "prototype"이면 Syntax Error입니다.

ClassElement

FieldDefinition

;

FieldDefinition의 PropName이 "constructor"이면 Syntax Error입니다.

ClassElement

static

FieldDefinition

;

FieldDefinition의 PropName이 "prototype" 또는 "constructor" 중 하나이면 Syntax Error입니다.

FieldDefinition

ClassElementName

Initializer

opt

Initializer가 존재하고 Initializer의 ContainsArguments가 true이면 Syntax Error입니다.
Initializer가 존재하고 Initializer Contains SuperCall이 true이면 Syntax Error입니다.

ClassElementName

PrivateIdentifier

PrivateIdentifier의 StringValue가 "#constructor"이면 Syntax Error입니다.

ClassStaticBlockBody

ClassStaticBlockStatementList

ClassStaticBlockStatementList의 LexicallyDeclaredNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.
ClassStaticBlockStatementList의 LexicallyDeclaredNames의 어떤 요소라도 ClassStaticBlockStatementList의 VarDeclaredNames에도 나타나면 Syntax Error입니다.
인수 « »을 사용한 ClassStaticBlockStatementList의 ContainsDuplicateLabels가 true이면 Syntax Error입니다.
인수 « »을 사용한 ClassStaticBlockStatementList의 ContainsUndefinedBreakTarget이 true이면 Syntax Error입니다.
인수 « » 및 « »을 사용한 ClassStaticBlockStatementList의 ContainsUndefinedContinueTarget이 true이면 Syntax Error입니다.
ClassStaticBlockStatementList의 ContainsArguments가 true이면 Syntax Error입니다.
ClassStaticBlockStatementList Contains SuperCall이 true이면 Syntax Error입니다.
ClassStaticBlockStatementList Contains await가 true이면 Syntax Error입니다.

15.7.2 Static Semantics: ClassElementKind

구문 지향 연산 ClassElementKind. 인수 없음. 반환값: (constructor-method, non-constructor-method 또는 empty). 다음 생성 규칙별로 정의된다.

ClassElement

MethodDefinition

MethodDefinition의 PropName이 "constructor"이면 constructor-method를 반환합니다.
non-constructor-method를 반환합니다.

ClassElement

static

MethodDefinition

FieldDefinition

;

static

FieldDefinition

;

non-constructor-method를 반환합니다.

ClassElement

ClassStaticBlock

non-constructor-method를 반환합니다.

ClassElement

;

empty를 반환합니다.

15.7.3 Static Semantics: ConstructorMethod

구문 지향 연산 ConstructorMethod. 인수 없음. 반환값: (a ClassElement Parse Node 또는 empty). 다음 생성 규칙별로 정의된다.

ClassElementList

ClassElement

ClassElement의 ClassElementKind가 constructor-method이면 ClassElement를 반환합니다.
empty를 반환합니다.

ClassElementList

ClassElement

head를 ClassElementList의 ConstructorMethod로 둡니다.
head가 empty가 아니면 head를 반환합니다.
ClassElement의 ClassElementKind가 constructor-method이면 ClassElement를 반환합니다.
empty를 반환합니다.

참고

조기 오류 규칙은 이름이 "constructor"인 메서드 정의가 하나만 존재하고 접근자 프로퍼티 또는 제너레이터 정의가 아니도록 보장합니다.

15.7.4 Static Semantics: IsStatic

구문 지향 연산 IsStatic. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

ClassElement

MethodDefinition

false를 반환합니다.

ClassElement

static

MethodDefinition

true를 반환합니다.

ClassElement

FieldDefinition

;

false를 반환합니다.

ClassElement

static

FieldDefinition

;

true를 반환합니다.

ClassElement

ClassStaticBlock

true를 반환합니다.

ClassElement

;

false를 반환합니다.

15.7.5 Static Semantics: NonConstructorElements

구문 지향 연산 NonConstructorElements. 인수 없음. 반환값: 리스트 (요소: ClassElement Parse Nodes). 다음 생성 규칙별로 정의된다.

ClassElementList

ClassElement

ClassElement의 ClassElementKind가 non-constructor-method이면, 다음을 수행합니다.
1. « ClassElement »을 반환합니다.
새로운 빈 List를 반환합니다.

ClassElementList

ClassElement

list를 ClassElementList의 NonConstructorElements로 둡니다.
ClassElement의 ClassElementKind가 non-constructor-method이면, 다음을 수행합니다.
1. ClassElement를 list에 추가합니다.
list를 반환합니다.

15.7.6 Static Semantics: PrototypePropertyNameList

구문 지향 연산 PrototypePropertyNameList. 인수 없음. 반환값: 리스트 (요소: 프로퍼티 키). 다음 생성 규칙별로 정의된다.

ClassElementList

ClassElement

propertyName을 ClassElement의 PropName으로 둡니다.
propertyName이 empty이면 새로운 빈 List를 반환합니다.
ClassElement의 IsStatic이 true이면 새로운 빈 List를 반환합니다.
« propertyName »을 반환합니다.

ClassElementList

ClassElement

list를 ClassElementList의 PrototypePropertyNameList로 둡니다.
propertyName을 ClassElement의 PropName으로 둡니다.
propertyName이 empty이면 list를 반환합니다.
ClassElement의 IsStatic이 true이면 list를 반환합니다.
list와 « propertyName »의 목록 연결을 반환합니다.

15.7.7 Static Semantics: AllPrivateIdentifiersValid

구문 지향 연산 AllPrivateIdentifiersValid. 인수 names (리스트 (요소: String)). 반환값: Boolean.

아래에 나열되지 않은 이 명세의 모든 문법 생성 규칙 대안은 암묵적으로 다음과 같은 AllPrivateIdentifiersValid 기본 정의를 갖습니다:

이 Parse Node의 각 자식 노드 child에 대해 다음을 수행합니다.
1. child가 비단말 기호의 인스턴스이면, 다음을 수행합니다.
  1. 인수 names를 사용한 child의 AllPrivateIdentifiersValid가 false이면 false를 반환합니다.
true를 반환합니다.

MemberExpression

PrivateIdentifier

names에 PrivateIdentifier의 StringValue가 포함되어 있으면, 다음을 수행합니다.
1. 인수 names를 사용한 MemberExpression의 AllPrivateIdentifiersValid를 반환합니다.
false를 반환합니다.

CallExpression

PrivateIdentifier

names에 PrivateIdentifier의 StringValue가 포함되어 있으면, 다음을 수행합니다.
1. 인수 names를 사용한 CallExpression의 AllPrivateIdentifiersValid를 반환합니다.
false를 반환합니다.

OptionalChain

PrivateIdentifier

names에 PrivateIdentifier의 StringValue가 포함되어 있으면 true를 반환합니다.
false를 반환합니다.

OptionalChain

PrivateIdentifier

names에 PrivateIdentifier의 StringValue가 포함되어 있으면, 다음을 수행합니다.
1. 인수 names를 사용한 OptionalChain의 AllPrivateIdentifiersValid를 반환합니다.
false를 반환합니다.

ClassBody

ClassElementList

newNames를 names와 ClassBody의 PrivateBoundIdentifiers의 목록 연결로 둡니다.
인수 newNames를 사용한 ClassElementList의 AllPrivateIdentifiersValid를 반환합니다.

RelationalExpression

PrivateIdentifier

ShiftExpression

names에 PrivateIdentifier의 StringValue가 포함되어 있으면, 다음을 수행합니다.
1. 인수 names를 사용한 ShiftExpression의 AllPrivateIdentifiersValid를 반환합니다.
false를 반환합니다.

15.7.8 Static Semantics: PrivateBoundIdentifiers

구문 지향 연산 PrivateBoundIdentifiers. 인수 없음. 반환값: 리스트 (요소: String). 다음 생성 규칙별로 정의된다.

FieldDefinition

ClassElementName

Initializer

opt

ClassElementName의 PrivateBoundIdentifiers를 반환합니다.

ClassElementName

PrivateIdentifier

유일한 요소가 PrivateIdentifier의 StringValue인 List를 반환합니다.

;

새로운 빈 List를 반환합니다.

ClassElementList

ClassElement

names1을 ClassElementList의 PrivateBoundIdentifiers로 둡니다.
names2를 ClassElement의 PrivateBoundIdentifiers로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

get

ClassElementName

(

)

{

FunctionBody

}

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

ClassElementName의 PrivateBoundIdentifiers를 반환합니다.

15.7.9 Static Semantics: ContainsArguments

구문 지향 연산 ContainsArguments. 인수 없음. 반환값: Boolean.

아래에 나열되지 않은 이 명세의 모든 문법 생성 규칙 대안은 암묵적으로 다음과 같은 ContainsArguments 기본 정의를 갖습니다:

이 Parse Node의 각 자식 노드 child에 대해 다음을 수행합니다.
1. child가 비단말 기호의 인스턴스이면, 다음을 수행합니다.
  1. child의 ContainsArguments가 true이면 true를 반환합니다.
false를 반환합니다.

IdentifierReference

Identifier

Identifier의 StringValue가 "arguments"이면 true를 반환합니다.
false를 반환합니다.

FunctionDeclaration

function

BindingIdentifier

(

FormalParameters

)

{

FunctionBody

}

function

(

FormalParameters

)

{

FunctionBody

}

FunctionExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

}

function

(

)

{

GeneratorBody

}

function

(

FormalParameters

)

{

GeneratorBody

}

GeneratorExpression

function

BindingIdentifier

opt

(

FormalParameters

)

{

GeneratorBody

}

AsyncGeneratorDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncGeneratorBody

}

async

function

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncGeneratorBody

}

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

AsyncFunctionExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncFunctionBody

}

false를 반환합니다.

MethodDefinition

ClassElementName

(

UniqueFormalParameters

)

{

FunctionBody

}

get

ClassElementName

(

)

{

FunctionBody

}

set

ClassElementName

(

PropertySetParameterList

)

{

FunctionBody

}

GeneratorMethod

ClassElementName

(

UniqueFormalParameters

)

{

GeneratorBody

}

AsyncGeneratorMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncGeneratorBody

}

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

ClassElementName의 ContainsArguments를 반환합니다.

15.7.10 Runtime Semantics: ClassFieldDefinitionEvaluation

구문 지향 연산 ClassFieldDefinitionEvaluation. 인수 homeObj (Object). 반환값: (정상 완료 (값: ClassFieldDefinition 레코드) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

FieldDefinition

ClassElementName

Initializer

opt

name을 ClassElementName의 ? Evaluation으로 둡니다.
Initializer가 존재하면, 다음을 수행합니다.
1. formalParamList를 생성 규칙 FormalParameters : [empty] 의 인스턴스로 둡니다.
2. envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
3. privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
4. sourceText를 빈 유니코드 코드 포인트 시퀀스로 둡니다.
5. initializer를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, formalParamList, Initializer, non-lexical-this, envRecord, privateEnv)로 둡니다.
6. MakeMethod(initializer, homeObj)을 수행합니다.
7. initializer.[[ClassFieldInitializerName]]을 name으로 설정합니다.
그렇지 않으면,
1. initializer를 empty로 둡니다.
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer }를 반환합니다.

참고

initializer를 위해 생성된 함수는 ECMAScript 코드에서 절대로 직접 접근할 수 없습니다.

15.7.11 Runtime Semantics: ClassStaticBlockDefinitionEvaluation

구문 지향 연산 ClassStaticBlockDefinitionEvaluation. 인수 homeObj (Object). 반환값: ClassStaticBlockDefinition 레코드. 다음 생성 규칙별로 정의된다.

ClassStaticBlock

static

{

ClassStaticBlockBody

}

lexicalEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 빈 유니코드 코드 포인트 시퀀스로 둡니다.
formalParams를 생성 규칙 FormalParameters : [empty] 의 인스턴스로 둡니다.
bodyFunc를 OrdinaryFunctionCreate(%Function.prototype%, sourceText, formalParams, ClassStaticBlockBody, non-lexical-this, lexicalEnv, privateEnv)로 둡니다.
MakeMethod(bodyFunc, homeObj)을 수행합니다.
ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunc }를 반환합니다.

참고

함수 bodyFunc는 ECMAScript 코드에서 절대로 직접 접근할 수 없습니다.

15.7.12 Runtime Semantics: EvaluateClassStaticBlockBody

구문 지향 연산 EvaluateClassStaticBlockBody. 인수 funcObj (ECMAScript 함수 객체). 반환값: (return 완료 또는 throw 완료). 다음 생성 규칙별로 정의된다.

ClassStaticBlockBody

ClassStaticBlockStatementList

단언: funcObj는 ClassStaticBlockDefinitionEvaluation의 5 단계에서 생성된 합성 함수입니다.
! FunctionDeclarationInstantiation(funcObj, « »)을 수행합니다.
result를 Completion(ClassStaticBlockStatementList의 Evaluation)으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
단언: envRecord는 Declarative Environment Record입니다.
? DisposeResources(envRecord.[[DisposableResourceStack]], result)를 수행합니다.
ReturnCompletion(undefined)을 반환합니다.

15.7.13 Runtime Semantics: ClassElementEvaluation

구문 지향 연산 ClassElementEvaluation. 인수 obj (Object). 반환값: (정상 완료 (값: (ClassFieldDefinition 레코드, ClassStaticBlockDefinition 레코드, PrivateElement 또는 empty)) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

ClassElement

FieldDefinition

;

static

FieldDefinition

;

인수 obj를 사용한 FieldDefinition의 ? ClassFieldDefinitionEvaluation을 반환합니다.

ClassElement

MethodDefinition

static

MethodDefinition

인수 obj 및 false를 사용한 MethodDefinition의 ? MethodDefinitionEvaluation을 반환합니다.

ClassElement

ClassStaticBlock

인수 obj를 사용한 ClassStaticBlock의 ClassStaticBlockDefinitionEvaluation을 반환합니다.

ClassElement

;

empty를 반환합니다.

15.7.14 Runtime Semantics: ClassDefinitionEvaluation

구문 지향 연산 ClassDefinitionEvaluation. 인수 classBinding ((String 또는 undefined)), className ((프로퍼티 키 또는 비공개 이름)) 및 sourceText (ECMAScript 소스 텍스트). 반환값: (정상 완료 (값: 함수 객체) 또는 중도 완료).

참고

명세를 쉽게 작성하기 위해 비공개 메서드와 접근자는 비공개 필드와 함께 클래스 인스턴스의 [[PrivateElements]] 슬롯에 포함됩니다. 그러나 어떤 객체든 특정 클래스에서 정의한 비공개 메서드와 접근자를 모두 가지거나 전혀 가지지 않습니다. 이 기능은 구현체가 각 메서드 또는 접근자를 개별적으로 추적할 필요가 없는 전략을 사용하여 비공개 메서드와 접근자를 구현할 수 있도록 설계되었습니다.

예를 들어 구현체는 인스턴스 비공개 메서드를 대응하는 Private Name과 직접 연결하고, 각 객체에 대해 어떤 클래스 생성자가 해당 객체를 this 값으로 사용하여 실행되었는지를 추적할 수 있습니다. 그러면 객체에서 인스턴스 비공개 메서드를 조회하는 작업은 해당 메서드를 정의한 클래스 생성자가 그 객체를 초기화하는 데 사용되었는지 검사한 다음 Private Name과 연결된 메서드를 반환하는 것으로 구성됩니다.

이는 비공개 필드와 다릅니다. 필드 이니셜라이저는 클래스 인스턴스화 중에 예외를 던질 수 있으므로 개별 객체에는 특정 클래스의 비공개 필드 중 일부만 존재할 수 있으며, 따라서 비공개 필드는 일반적으로 개별적으로 추적해야 합니다.

다음 생성 규칙별로 정의된다.

ClassTail

ClassHeritage

opt

{

ClassBody

opt

}

envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
classEnv를 NewDeclarativeEnvironment(envRecord)로 둡니다.
classBinding이 undefined가 아니면, 다음을 수행합니다.
1. ! classEnv.CreateImmutableBinding(classBinding, true)를 수행합니다.
outerPrivateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
classPrivateEnv를 NewPrivateEnvironment(outerPrivateEnv)로 둡니다.
ClassBody가 존재하면, 다음을 수행합니다.
1. ClassBody의 PrivateBoundIdentifiers에 있는 각 String description에 대해 다음을 수행합니다.
  1. classPrivateEnv.[[Names]]에 privateName.[[Description]]이 description인 Private Name privateName이 포함되어 있으면, 다음을 수행합니다.
    1. 단언: 이는 getter/setter 쌍에 대해서만 가능합니다.
  2. 그렇지 않으면,
    1. name을 [[Description]]이 description인 새로운 Private Name으로 둡니다.
    2. name을 classPrivateEnv.[[Names]]에 추가합니다.
ClassHeritage가 존재하지 않으면, 다음을 수행합니다.
1. protoParent를 %Object.prototype%으로 둡니다.
2. ctorParent를 %Function.prototype%으로 둡니다.
그렇지 않으면,
1. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 classEnv로 설정합니다.
2. 참고: ClassHeritage를 평가할 때 실행 중인 실행 컨텍스트의 PrivateEnvironment는 outerPrivateEnv입니다.
3. superclassRef를 Completion(Evaluation of ClassHeritage)으로 둡니다.
4. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 envRecord로 설정합니다.
5. superclass를 ? GetValue(? superclassRef)로 둡니다.
6. superclass가 null이면, 다음을 수행합니다.
  1. protoParent를 null로 둡니다.
  2. ctorParent를 %Function.prototype%으로 둡니다.
7. 그렇지 않고 IsConstructor(superclass)가 false이면, 다음을 수행합니다.
  1. TypeError 예외를 던집니다.
8. 그렇지 않으면,
  1. protoParent를 ? Get(superclass, "prototype")로 둡니다.
  2. protoParent가 Object가 아니고 protoParent가 null도 아니면 TypeError 예외를 던집니다.
  3. ctorParent를 superclass로 둡니다.
proto를 OrdinaryObjectCreate(protoParent)로 둡니다.
ClassBody가 존재하지 않으면 ctor를 empty로 둡니다.
그렇지 않으면 ctor를 ClassBody의 ConstructorMethod로 둡니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 classEnv로 설정합니다.
실행 중인 실행 컨텍스트의 PrivateEnvironment를 classPrivateEnv로 설정합니다.
ctor가 empty이면, 다음을 수행합니다.
1. defaultCtor를 매개변수가 없고 아무것도 캡처하지 않으며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. args를 [[Call]] 또는 [[Construct]]가 이 함수에 전달한 인수의 List로 둡니다.
  2. NewTarget이 undefined이면 TypeError 예외를 던집니다.
  3. ctorFunc를 활성 함수 객체로 둡니다.
  4. ctorFunc.[[ConstructorKind]]가 derived이면, 다음을 수행합니다.
    1. 참고: 이 분기는 constructor(...args) { super(...args); }와 유사하게 동작합니다. 가장 주목할 만한 차이는 앞서 언급한 ECMAScript 소스 텍스트가 %Array.prototype%의 %Symbol.iterator% 메서드를 관찰 가능하게 호출하는 반면 이 함수는 호출하지 않는다는 점입니다.
    2. func를 ! ctorFunc.[[GetPrototypeOf]]()로 둡니다.
    3. IsConstructor(func)가 false이면 TypeError 예외를 던집니다.
    4. result를 ? Construct(func, args, NewTarget)로 둡니다.
  5. 그렇지 않으면,
    1. 참고: 이 분기는 constructor() {}와 유사하게 동작합니다.
    2. result를 ? OrdinaryCreateFromConstructor(NewTarget, "%Object.prototype%")로 둡니다.
  6. ? InitializeInstanceElements(result, ctorFunc)를 수행합니다.
  7. NormalCompletion(result)을 반환합니다.
2. ctorFunc를 CreateBuiltinFunction(defaultCtor, 0, className, « [[ConstructorKind]], [[SourceText]], [[PrivateMethods]], [[Fields]] », the current Realm Record, ctorParent)로 둡니다.
그렇지 않으면,
1. ctorInfo를 ! DefineMethod of ctor with arguments proto and ctorParent로 둡니다.
2. ctorFunc를 ctorInfo.[[Closure]]로 둡니다.
3. MakeClassConstructor(ctorFunc)를 수행합니다.
4. SetFunctionName(ctorFunc, className)을 수행합니다.
ctorFunc.[[SourceText]]를 sourceText로 설정합니다.
MakeConstructor(ctorFunc, false, proto)를 수행합니다.
ClassHeritage가 존재하면 ctorFunc.[[ConstructorKind]]를 derived로 설정합니다.
! DefineMethodProperty(proto, "constructor", ctorFunc, false)를 수행합니다.
ClassBody가 존재하지 않으면 classElements를 새로운 빈 List로 둡니다.
그렇지 않으면 classElements를 ClassBody의 NonConstructorElements로 둡니다.
instancePrivateMethods를 새로운 빈 List로 둡니다.
staticPrivateMethods를 새로운 빈 List로 둡니다.
instanceFields를 새로운 빈 List로 둡니다.
staticElements를 새로운 빈 List로 둡니다.
classElements의 각 ClassElement classElement에 대해 다음을 수행합니다.
1. classElement의 IsStatic이 false이면, 다음을 수행합니다.
  1. element를 Completion(ClassElementEvaluation of classElement with argument proto)로 둡니다.
2. 그렇지 않으면,
  1. element를 Completion(ClassElementEvaluation of classElement with argument ctorFunc)로 둡니다.
3. element가 abrupt completion이면, 다음을 수행합니다.
  1. 실행 중인 실행 컨텍스트의 LexicalEnvironment를 envRecord로 설정합니다.
  2. 실행 중인 실행 컨텍스트의 PrivateEnvironment를 outerPrivateEnv로 설정합니다.
  3. ? element를 반환합니다.
4. element를 ! element로 설정합니다.
5. element가 PrivateElement이면, 다음을 수행합니다.
  1. 단언: element.[[Kind]]는 method 또는 accessor 중 하나입니다.
  2. classElement의 IsStatic이 false이면 container를 instancePrivateMethods로 둡니다.
  3. 그렇지 않으면 container를 staticPrivateMethods로 둡니다.
  4. container에 existingElement.[[Key]]가 element.[[Key]]인 PrivateElement existingElement가 포함되어 있으면, 다음을 수행합니다.
    1. 단언: element.[[Kind]]와 existingElement.[[Kind]]는 모두 accessor입니다.
    2. element.[[Getter]]가 undefined이면, 다음을 수행합니다.
      1. combined를 PrivateElement { [[Key]]: element.[[Key]], [[Kind]]: accessor, [[Getter]]: existingElement.[[Getter]], [[Setter]]: element.[[Setter]] }로 둡니다.
    3. 그렇지 않으면,
      1. combined를 PrivateElement { [[Key]]: element.[[Key]], [[Kind]]: accessor, [[Getter]]: element.[[Getter]], [[Setter]]: existingElement.[[Setter]] }로 둡니다.
    4. container의 existingElement를 combined로 대체합니다.
  5. 그렇지 않으면,
    1. element를 container에 추가합니다.
6. 그렇지 않고 element가 ClassFieldDefinition Record이면, 다음을 수행합니다.
  1. classElement의 IsStatic이 false이면 element를 instanceFields에 추가합니다.
  2. 그렇지 않으면 element를 staticElements에 추가합니다.
7. 그렇지 않고 element가 ClassStaticBlockDefinition Record이면, 다음을 수행합니다.
  1. element를 staticElements에 추가합니다.
8. 그렇지 않으면,
  1. 단언: element는 empty입니다.
실행 중인 실행 컨텍스트의 LexicalEnvironment를 envRecord로 설정합니다.
classBinding이 undefined가 아니면, 다음을 수행합니다.
1. ! classEnv.InitializeBinding(classBinding, ctorFunc)을 수행합니다.
ctorFunc.[[PrivateMethods]]를 instancePrivateMethods로 설정합니다.
ctorFunc.[[Fields]]를 instanceFields로 설정합니다.
staticPrivateMethods의 각 PrivateElement method에 대해 다음을 수행합니다.
1. ! PrivateMethodOrAccessorAdd(ctorFunc, method)를 수행합니다.
staticElements의 각 요소 elementRecord에 대해 다음을 수행합니다.
1. elementRecord가 ClassFieldDefinition Record이면, 다음을 수행합니다.
  1. result를 Completion(DefineField(ctorFunc, elementRecord))로 둡니다.
2. 그렇지 않으면,
  1. 단언: elementRecord는 ClassStaticBlockDefinition Record입니다.
  2. result를 Completion(Call(elementRecord.[[BodyFunction]], ctorFunc))로 둡니다.
3. result가 abrupt completion이면, 다음을 수행합니다.
  1. 실행 중인 실행 컨텍스트의 PrivateEnvironment를 outerPrivateEnv로 설정합니다.
  2. ? result를 반환합니다.
실행 중인 실행 컨텍스트의 PrivateEnvironment를 outerPrivateEnv로 설정합니다.
ctorFunc를 반환합니다.

15.7.15 Runtime Semantics: BindingClassDeclarationEvaluation

구문 지향 연산 BindingClassDeclarationEvaluation. 인수 없음. 반환값: (정상 완료 (값: 함수 객체) 또는 중도 완료). 다음 생성 규칙별로 정의된다.

ClassDeclaration

class

BindingIdentifier

ClassTail

className을 BindingIdentifier의 StringValue로 둡니다.
sourceText를 ClassDeclaration과 일치하는 소스 텍스트로 둡니다.
value를 인수 className, className 및 sourceText를 사용한 ClassTail의 ? ClassDefinitionEvaluation으로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
? InitializeBoundName(className, value, envRecord)를 수행합니다.
value를 반환합니다.

ClassDeclaration

class

ClassTail

sourceText를 ClassDeclaration과 일치하는 소스 텍스트로 둡니다.
인수 undefined, "default" 및 sourceText를 사용한 ClassTail의 ? ClassDefinitionEvaluation을 반환합니다.

참고

ClassDeclaration : class ClassTail 은 ExportDeclaration의 일부로만 나타나며 그 바인딩 설정은 해당 생성 규칙의 평가 동작의 일부로 처리됩니다. 16.2.3.7를 참조하시기 바랍니다.

15.7.16 Runtime Semantics: 평가

ClassDeclaration

class

BindingIdentifier

ClassTail

이 ClassDeclaration의 ? BindingClassDeclarationEvaluation을 수행합니다.
empty를 반환합니다.

참고

ClassDeclaration : class ClassTail 은 ExportDeclaration의 일부로만 나타나며 절대로 직접 평가되지 않습니다.

ClassExpression

class

ClassTail

sourceText를 ClassExpression과 일치하는 소스 텍스트로 둡니다.
인수 undefined, 빈 String 및 sourceText를 사용한 ClassTail의 ? ClassDefinitionEvaluation을 반환합니다.

ClassExpression

class

BindingIdentifier

ClassTail

className을 BindingIdentifier의 StringValue로 둡니다.
sourceText를 ClassExpression과 일치하는 소스 텍스트로 둡니다.
인수 className, className 및 sourceText를 사용한 ClassTail의 ? ClassDefinitionEvaluation을 반환합니다.

ClassElementName

PrivateIdentifier

privateIdentifier를 PrivateIdentifier의 StringValue로 둡니다.
privateEnvRecord를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
names를 privateEnvRecord.[[Names]]로 둡니다.
단언: names에는 [[Description]]이 privateIdentifier인 Private Name 요소가 정확히 하나 있습니다.
privateName을 names에서 [[Description]]이 privateIdentifier인 Private Name으로 둡니다.
privateName을 반환합니다.

ClassStaticBlockStatementList

[empty]

undefined를 반환합니다.

15.8 비동기 함수 정의

구문

AsyncFunctionDeclaration

[Yield, Await, Default]

async

[no LineTerminator here]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

[+Default]

async

[no LineTerminator here]

function

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncFunctionExpression

async

[no LineTerminator here]

function

BindingIdentifier

[~Yield, +Await]

opt

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncMethod

[Yield, Await]

async

[no LineTerminator here]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[~Yield, +Await]

)

{

}

[~Yield, +Await]

[Yield]

await

UnaryExpression

[?Yield, +Await]

참고 1

_[Await] 매개변수가 존재하면 await는 AwaitExpression의 키워드로 파싱됩니다. 다음 문맥의 최상위에서는 _[Await] 매개변수가 존재하지만 FunctionBody와 같은 비단말 기호에 따라 일부 문맥에서는 매개변수가 존재하지 않을 수 있습니다:

AsyncFunctionBody 안.
AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncGeneratorDeclaration 또는 AsyncGeneratorExpression의 FormalParameters 안. 이 위치의 AwaitExpression은 정적 의미론에 따라 Syntax Error입니다.
Module 안.

Script가 구문 목표 기호이면 _[Await] 매개변수가 존재하지 않을 때 await를 식별자로 파싱할 수 있습니다. 여기에는 다음 문맥이 포함됩니다:

AsyncFunctionBody 또는 AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncGeneratorDeclaration 또는 AsyncGeneratorExpression의 FormalParameters 바깥의 모든 위치.
FunctionExpression, GeneratorExpression 또는 AsyncGeneratorExpression의 BindingIdentifier 안.

참고 2

YieldExpression과 달리 AwaitExpression의 피연산자를 생략하면 Syntax Error입니다. 반드시 무언가를 await해야 합니다.

15.8.1 Static Semantics: 조기 오류

AsyncMethod

async

ClassElementName

(

UniqueFormalParameters

)

{

AsyncFunctionBody

}

AsyncFunctionBody의 FunctionBodyContainsUseStrict가 true이고 UniqueFormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
AsyncMethod의 HasDirectSuper가 true이면 Syntax Error입니다.
UniqueFormalParameters Contains AwaitExpression이 true이면 Syntax Error입니다.
UniqueFormalParameters의 BoundNames의 어떤 요소라도 AsyncFunctionBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

AsyncFunctionExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncFunctionBody

}

AsyncFunctionBody의 FunctionBodyContainsUseStrict가 true이고 FormalParameters의 IsSimpleParameterList가 false이면 Syntax Error입니다.
FormalParameters Contains AwaitExpression이 true이면 Syntax Error입니다.
IsStrict(FormalParameters)이 true이면 UniqueFormalParameters : FormalParameters 에 대한 조기 오류 규칙을 적용합니다.
BindingIdentifier가 존재하고 IsStrict(BindingIdentifier)이 true이며 BindingIdentifier의 StringValue가 "eval" 또는 "arguments" 중 하나이면 Syntax Error입니다.
FormalParameters의 BoundNames의 어떤 요소라도 AsyncFunctionBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.
FormalParameters Contains SuperProperty가 true이면 Syntax Error입니다.
AsyncFunctionBody Contains SuperProperty가 true이면 Syntax Error입니다.
FormalParameters Contains SuperCall이 true이면 Syntax Error입니다.
AsyncFunctionBody Contains SuperCall이 true이면 Syntax Error입니다.

15.8.2 Runtime Semantics: InstantiateAsyncFunctionObject

구문 지향 연산 InstantiateAsyncFunctionObject. 인수 envRecord (Environment 레코드) 및 privateEnv ((PrivateEnvironment 레코드 또는 null)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

AsyncFunctionDeclaration

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

name을 BindingIdentifier의 StringValue로 둡니다.
sourceText를 AsyncFunctionDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, FormalParameters, AsyncFunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
closure를 반환합니다.

AsyncFunctionDeclaration

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

sourceText를 AsyncFunctionDeclaration과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, FormalParameters, AsyncFunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, "default")를 수행합니다.
closure를 반환합니다.

15.8.3 Runtime Semantics: InstantiateAsyncFunctionExpression

구문 지향 연산 InstantiateAsyncFunctionExpression. 선택적 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

AsyncFunctionExpression

async

function

(

FormalParameters

)

{

AsyncFunctionBody

}

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncFunctionExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, FormalParameters, AsyncFunctionBody, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
closure를 반환합니다.

AsyncFunctionExpression

async

function

BindingIdentifier

(

FormalParameters

)

{

AsyncFunctionBody

}

단언: name은 존재하지 않습니다.
name을 BindingIdentifier의 StringValue로 설정합니다.
outerEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
funcEnv를 NewDeclarativeEnvironment(outerEnv)로 둡니다.
! funcEnv.CreateImmutableBinding(name, false)를 수행합니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncFunctionExpression과 일치하는 소스 텍스트로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, FormalParameters, AsyncFunctionBody, non-lexical-this, funcEnv, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
! funcEnv.InitializeBinding(name, closure)를 수행합니다.
closure를 반환합니다.

참고

AsyncFunctionExpression의 BindingIdentifier는 함수가 자기 자신을 재귀적으로 호출할 수 있도록 AsyncFunctionExpression의 AsyncFunctionBody 내부에서 참조할 수 있습니다. 그러나 FunctionDeclaration과 달리 AsyncFunctionExpression의 BindingIdentifier는 AsyncFunctionExpression을 둘러싸는 스코프에서 참조할 수 없으며 해당 스코프에도 영향을 주지 않습니다.

15.8.4 Runtime Semantics: EvaluateAsyncFunctionBody

구문 지향 연산 EvaluateAsyncFunctionBody. 인수 funcObj (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: return 완료. 다음 생성 규칙별로 정의된다.

AsyncFunctionBody

FunctionBody

promiseCapability를 ! NewPromiseCapability(%Promise%)로 둡니다.
completion을 Completion(FunctionDeclarationInstantiation(funcObj, argList))으로 둡니다.
completion이 비정상 완료이면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « completion.[[Value]] »)를 수행합니다.
그렇지 않으면,
1. AsyncFunctionStart(promiseCapability, FunctionBody)를 수행합니다.
ReturnCompletion(promiseCapability.[[Promise]])을 반환합니다.

15.8.5 Runtime Semantics: 평가

AsyncFunctionExpression

async

function

BindingIdentifier

opt

(

FormalParameters

)

{

AsyncFunctionBody

}

AsyncFunctionExpression의 InstantiateAsyncFunctionExpression을 반환합니다.

UnaryExpression

CoverAwaitExpressionAndAwaitUsingDeclarationHead

expr을 CoverAwaitExpressionAndAwaitUsingDeclarationHead가 포괄하는 AwaitExpression로 둡니다.
expr의 ? Evaluation을 반환합니다.

AwaitExpression

await

UnaryExpression

exprRef를 UnaryExpression의 ? Evaluation으로 둡니다.
value를 ? GetValue(exprRef)로 둡니다.
? Await(value)를 반환합니다.

15.9 비동기 화살표 함수 정의

구문

AsyncArrowFunction

[In, Yield, Await]

async

[no LineTerminator here]

AsyncArrowBindingIdentifier

[?Yield]

[no LineTerminator here]

AsyncConciseBody

[?In]

CoverCallExpressionAndAsyncArrowHead

[?Yield, ?Await]

[no LineTerminator here]

AsyncConciseBody

[?In]

AsyncConciseBody

[In]

[lookahead ≠ {]

ExpressionBody

[?In, +Await]

{

AsyncFunctionBody

}

AsyncArrowBindingIdentifier

[Yield]

BindingIdentifier

[?Yield, +Await]

CoverCallExpressionAndAsyncArrowHead

[Yield, Await]

MemberExpression

[?Yield, ?Await]

Arguments

[?Yield, ?Await]

보충 구문

다음 생성 규칙의 인스턴스를 처리할 때
AsyncArrowFunction : CoverCallExpressionAndAsyncArrowHead => AsyncConciseBody
CoverCallExpressionAndAsyncArrowHead의 해석은 다음 문법을 사용하여 구체화됩니다:

AsyncArrowHead

async

[no LineTerminator here]

ArrowFormalParameters

[~Yield, +Await]

15.9.1 Static Semantics: 조기 오류

AsyncArrowFunction

async

AsyncArrowBindingIdentifier

AsyncConciseBody

AsyncArrowBindingIdentifier의 BoundNames의 어떤 요소라도 AsyncConciseBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.

AsyncArrowFunction

CoverCallExpressionAndAsyncArrowHead

AsyncConciseBody

CoverCallExpressionAndAsyncArrowHead는 AsyncArrowHead를 포괄해야 합니다.
CoverCallExpressionAndAsyncArrowHead Contains YieldExpression이 true이면 Syntax Error입니다.
CoverCallExpressionAndAsyncArrowHead Contains AwaitExpression이 true이면 Syntax Error입니다.
CoverCallExpressionAndAsyncArrowHead의 BoundNames의 어떤 요소라도 AsyncConciseBody의 LexicallyDeclaredNames에도 나타나면 Syntax Error입니다.
AsyncConciseBody의 AsyncConciseBodyContainsUseStrict가 true이고 CoverCallExpressionAndAsyncArrowHead의 IsSimpleParameterList가 false이면 Syntax Error입니다.

15.9.2 Static Semantics: AsyncConciseBodyContainsUseStrict

구문 지향 연산 AsyncConciseBodyContainsUseStrict. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

AsyncConciseBody

ExpressionBody

false를 반환합니다.

AsyncConciseBody

{

AsyncFunctionBody

}

AsyncFunctionBody의 FunctionBodyContainsUseStrict를 반환합니다.

15.9.3 Runtime Semantics: EvaluateAsyncConciseBody

구문 지향 연산 EvaluateAsyncConciseBody. 인수 funcObj (ECMAScript 함수 객체) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: return 완료. 다음 생성 규칙별로 정의된다.

AsyncConciseBody

ExpressionBody

promiseCapability를 ! NewPromiseCapability(%Promise%)로 둡니다.
completion을 Completion(FunctionDeclarationInstantiation(funcObj, argList))으로 둡니다.
completion이 비정상 완료이면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « completion.[[Value]] »)를 수행합니다.
그렇지 않으면,
1. AsyncFunctionStart(promiseCapability, ExpressionBody)를 수행합니다.
ReturnCompletion(promiseCapability.[[Promise]])을 반환합니다.

15.9.4 Runtime Semantics: InstantiateAsyncArrowFunctionExpression

구문 지향 연산 InstantiateAsyncArrowFunctionExpression. 선택적 인수 name ((프로퍼티 키 또는 비공개 이름)). 반환값: ECMAScript 함수 객체. 다음 생성 규칙별로 정의된다.

AsyncArrowFunction

async

AsyncArrowBindingIdentifier

AsyncConciseBody

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncArrowFunction과 일치하는 소스 텍스트로 둡니다.
params를 AsyncArrowBindingIdentifier로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, params, AsyncConciseBody, lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
closure를 반환합니다.

AsyncArrowFunction

CoverCallExpressionAndAsyncArrowHead

AsyncConciseBody

name이 존재하지 않으면 name을 빈 String으로 설정합니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
privateEnv를 실행 중인 실행 컨텍스트의 PrivateEnvironment로 둡니다.
sourceText를 AsyncArrowFunction과 일치하는 소스 텍스트로 둡니다.
head를 CoverCallExpressionAndAsyncArrowHead가 포괄하는 AsyncArrowHead로 둡니다.
params를 head의 ArrowFormalParameters로 둡니다.
closure를 OrdinaryFunctionCreate(%AsyncFunction.prototype%, sourceText, params, AsyncConciseBody, lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(closure, name)을 수행합니다.
closure를 반환합니다.

15.9.5 Runtime Semantics: 평가

AsyncArrowFunction

async

AsyncArrowBindingIdentifier

AsyncConciseBody

CoverCallExpressionAndAsyncArrowHead

AsyncConciseBody

AsyncArrowFunction의 InstantiateAsyncArrowFunctionExpression을 반환합니다.

15.10 꼬리 위치 호출

15.10.1 Static Semantics: IsInTailPosition ( `call` )

추상 연산 IsInTailPosition. 인수 call ((a CallExpression Parse Node, a MemberExpression Parse Node 또는 an OptionalChain Parse Node)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

IsStrict(call)이 false이면 false를 반환합니다.
call이 FunctionBody, ConciseBody 또는 AsyncConciseBody 안에 포함되어 있지 않으면 false를 반환합니다.
body를 call을 가장 가깝게 포함하는 FunctionBody, ConciseBody 또는 AsyncConciseBody로 둡니다.
body가 GeneratorBody의 FunctionBody이면 false를 반환합니다.
body가 AsyncFunctionBody의 FunctionBody이면 false를 반환합니다.
body가 AsyncGeneratorBody의 FunctionBody이면 false를 반환합니다.
body가 AsyncConciseBody이면 false를 반환합니다.
인수 call을 사용한 body의 HasCallInTailPosition 결과를 반환합니다.

참고

호출자 컨텍스트 체인을 관찰할 수 있게 하는 일반적인 비표준 언어 확장(10.2.4 참조) 때문에 꼬리 위치 호출은 엄격 모드 코드에서만 정의됩니다.

15.10.2 Static Semantics: HasCallInTailPosition

구문 지향 연산 HasCallInTailPosition. 인수 call ((a CallExpression Parse Node, a MemberExpression Parse Node 또는 an OptionalChain Parse Node)). 반환값: Boolean.

참고 1

call은 특정 소스 텍스트 범위를 나타내는 Parse Node입니다. 다음 알고리즘에서 call을 다른 Parse Node와 비교하는 것은 이들이 동일한 소스 텍스트를 나타내는지 검사하는 것입니다.

참고 2

잠재적인 꼬리 위치 호출 바로 뒤에 해당 호출 결과의 GetValue를 반환하는 동작이 있으면 역시 가능한 꼬리 위치 호출입니다. 함수 호출은 Reference Record를 반환할 수 없으므로 이러한 GetValue 연산은 항상 실제 함수 호출 결과와 동일한 값을 반환합니다.

참고 3

같은 Block, ForStatement, ForInOfStatement, FunctionBody, GeneratorBody, AsyncGeneratorBody, AsyncFunctionBody 또는 ClassStaticBlockBody에서 호출보다 앞에 있는 using 선언 또는 await using 선언은 해당 호출이 가능한 꼬리 위치 호출이 되는 것을 방지합니다.

다음 생성 규칙별로 정의된다.

StatementList

StatementListItem

has를 인수 call을 사용한 파생된 StatementList의 HasCallInTailPosition으로 둡니다.
has가 true이면 true를 반환합니다.
파생된 StatementList의 ContainsUsing이 true이면 false를 반환합니다.
인수 call을 사용한 StatementListItem의 HasCallInTailPosition을 반환합니다.

FunctionStatementList

[empty]

{

}

ReturnStatement

return

;

LabelledItem

FunctionDeclaration

ForInOfStatement

for

(

LeftHandSideExpression

AssignmentExpression

)

Statement

for

(

var

ForBinding

AssignmentExpression

)

Statement

for

(

)

{

}

false를 반환합니다.

(

)

else

has를 인수 call을 사용한 첫 번째 Statement의 HasCallInTailPosition으로 둡니다.
has가 true이면 true를 반환합니다.
인수 call을 사용한 두 번째 Statement의 HasCallInTailPosition을 반환합니다.

(

)

while

(

Expression

)

;

WhileStatement

while

(

Expression

)

Statement

ForStatement

for

(

Expression

opt

;

Expression

opt

;

Expression

opt

)

Statement

for

(

var

VariableDeclarationList

;

Expression

opt

;

Expression

opt

)

Statement

for

(

LexicalDeclaration

Expression

opt

;

Expression

opt

)

Statement

ForInOfStatement

for

(

LeftHandSideExpression

Expression

)

Statement

for

(

var

ForBinding

Expression

)

Statement

for

(

)

with

(

Expression

)

Statement

인수 call을 사용한 Statement의 HasCallInTailPosition을 반환합니다.

LabelledStatement

LabelIdentifier

LabelledItem

인수 call을 사용한 LabelledItem의 HasCallInTailPosition을 반환합니다.

ReturnStatement

return

Expression

;

인수 call을 사용한 Expression의 HasCallInTailPosition을 반환합니다.

SwitchStatement

switch

(

Expression

)

CaseBlock

인수 call을 사용한 CaseBlock의 HasCallInTailPosition을 반환합니다.

{

opt

opt

}

has를 false로 둡니다.
첫 번째 CaseClauses가 존재하면 has를 인수 call을 사용한 첫 번째 CaseClauses의 HasCallInTailPosition으로 설정합니다.
has가 true이면 true를 반환합니다.
has를 인수 call을 사용한 DefaultClause의 HasCallInTailPosition으로 설정합니다.
has가 true이면 true를 반환합니다.
두 번째 CaseClauses가 존재하면 has를 인수 call을 사용한 두 번째 CaseClauses의 HasCallInTailPosition으로 설정합니다.
has를 반환합니다.

CaseClauses

CaseClause

has를 인수 call을 사용한 CaseClauses의 HasCallInTailPosition으로 둡니다.
has가 true이면 true를 반환합니다.
인수 call을 사용한 CaseClause의 HasCallInTailPosition을 반환합니다.

case

opt

default

opt

StatementList가 존재하면 인수 call을 사용한 StatementList의 HasCallInTailPosition을 반환합니다.
false를 반환합니다.

TryStatement

try

Block

Catch

인수 call을 사용한 Catch의 HasCallInTailPosition을 반환합니다.

try

try

인수 call을 사용한 Finally의 HasCallInTailPosition을 반환합니다.

Catch

catch

(

CatchParameter

)

Block

인수 call을 사용한 Block의 HasCallInTailPosition을 반환합니다.

LeftHandSideExpression

AssignmentExpression

LeftHandSideExpression

AssignmentOperator

AssignmentExpression

LeftHandSideExpression

&&=

AssignmentExpression

LeftHandSideExpression

||=

AssignmentExpression

LeftHandSideExpression

??=

===

!==

instanceof

>>>

MultiplicativeExpression

AdditiveExpression

MultiplicativeExpression

MultiplicativeOperator

ExponentiationExpression

UpdateExpression

ExponentiationExpression

UpdateExpression

LeftHandSideExpression

delete

void

typeof

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[

]

new

[

]

new

this

AsyncFunctionExpression

AsyncGeneratorExpression

RegularExpressionLiteral

TemplateLiteral

false를 반환합니다.

인수 call을 사용한 AssignmentExpression의 HasCallInTailPosition을 반환합니다.

ConditionalExpression

ShortCircuitExpression

AssignmentExpression

has를 인수 call을 사용한 첫 번째 AssignmentExpression의 HasCallInTailPosition으로 둡니다.
has가 true이면 true를 반환합니다.
인수 call을 사용한 두 번째 AssignmentExpression의 HasCallInTailPosition을 반환합니다.

LogicalANDExpression

BitwiseORExpression

인수 call을 사용한 BitwiseORExpression의 HasCallInTailPosition을 반환합니다.

LogicalORExpression

LogicalANDExpression

인수 call을 사용한 LogicalANDExpression의 HasCallInTailPosition을 반환합니다.

CoalesceExpression

CoalesceExpressionHead

BitwiseORExpression

인수 call을 사용한 BitwiseORExpression의 HasCallInTailPosition을 반환합니다.

CallExpression

CoverCallExpressionAndAsyncArrowHead

이 CallExpression이 call이면 true를 반환합니다.
false를 반환합니다.

인수 call을 사용한 OptionalChain의 HasCallInTailPosition을 반환합니다.

[

]

[

]

false를 반환합니다.

이 OptionalChain이 call이면 true를 반환합니다.
false를 반환합니다.

MemberExpression

TemplateLiteral

이 MemberExpression이 call이면 true를 반환합니다.
false를 반환합니다.

PrimaryExpression

CoverParenthesizedExpressionAndArrowParameterList

expr을 CoverParenthesizedExpressionAndArrowParameterList가 포괄하는 ParenthesizedExpression로 둡니다.
인수 call을 사용한 expr의 HasCallInTailPosition을 반환합니다.

ParenthesizedExpression

(

Expression

)

인수 call을 사용한 Expression의 HasCallInTailPosition을 반환합니다.

15.10.3 PrepareForTailCall ( )

추상 연산 PrepareForTailCall. 인수 없음. 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 현재 실행 컨텍스트는 이후 어떤 ECMAScript 코드 또는 내장 함수의 평가에도 사용되지 않습니다. 이 추상 연산 호출 이후의 Call 호출은 그러한 평가를 수행하기 전에 새로운 실행 컨텍스트를 생성하고 푸시합니다.
현재 실행 컨텍스트와 연결된 모든 리소스를 폐기합니다.
unused를 반환합니다.

꼬리 위치 호출은 대상 함수를 호출하기 전에 현재 실행 중인 함수 실행 컨텍스트와 연결된 모든 일시적 내부 리소스를 해제하거나, 대상 함수를 지원하기 위해 해당 리소스를 재사용해야 합니다.

참고

예를 들어 꼬리 위치 호출은 대상 함수의 활성화 레코드 크기가 호출 함수의 활성화 레코드 크기를 초과하는 양만큼만 구현체의 활성화 레코드 스택을 증가시켜야 합니다. 대상 함수의 활성화 레코드가 더 작으면 스택의 전체 크기는 감소해야 합니다.

16 ECMAScript 언어: 스크립트와 모듈

16.1 스크립트

구문

opt

[~Yield, ~Await, ~Return]

16.1.1 Static Semantics: 조기 오류

Script

ScriptBody

ScriptBody의 LexicallyDeclaredNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.
ScriptBody의 LexicallyDeclaredNames의 어떤 요소라도 ScriptBody의 VarDeclaredNames에도 나타나면 Syntax Error입니다.

ScriptBody

StatementList

super를 포함하는 소스 텍스트가 직접 eval에 의해 처리되는 eval 코드인 경우를 제외하고 StatementList Contains super이면 Syntax Error입니다. 직접 eval 안의 super에 대한 추가 조기 오류 규칙은 19.2.1.1에 정의되어 있습니다.
NewTarget을 포함하는 소스 텍스트가 직접 eval에 의해 처리되는 eval 코드인 경우를 제외하고 StatementList Contains NewTarget이면 Syntax Error입니다. 직접 eval 안의 NewTarget에 대한 추가 조기 오류 규칙은 19.2.1.1에 정의되어 있습니다.
인수 « »을 사용한 StatementList의 ContainsDuplicateLabels가 true이면 Syntax Error입니다.
인수 « »을 사용한 StatementList의 ContainsUndefinedBreakTarget이 true이면 Syntax Error입니다.
인수 « » 및 « »을 사용한 StatementList의 ContainsUndefinedContinueTarget이 true이면 Syntax Error입니다.
ScriptBody를 포함하는 소스 텍스트가 직접 eval에 의해 처리되는 eval 코드인 경우를 제외하고 인수 « »을 사용한 StatementList의 AllPrivateIdentifiersValid가 false이면 Syntax Error입니다.
StatementList의 ContainsUsing이 true이면 Syntax Error입니다.

16.1.2 Static Semantics: ScriptIsStrict

구문 지향 연산 ScriptIsStrict. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

Script

ScriptBody

opt

ScriptBody가 존재하고 ScriptBody의 Directive Prologue에 Use Strict Directive가 포함되어 있으면 true를 반환합니다.
false를 반환합니다.

16.1.3 Runtime Semantics: 평가

Script

[empty]

undefined를 반환합니다.

16.1.4 Script Record

Script Record는 평가 중인 스크립트에 관한 정보를 캡슐화합니다. 각 Script Record에는 표 35에 나열된 필드가 포함됩니다.

표 35: Script Record 필드

필드 이름	값 타입	의미
`[[Realm]]`	a Realm Record	이 스크립트가 생성된 realm입니다.
`[[ECMAScriptCode]]`	a Script Parse Node	이 스크립트의 소스 텍스트를 파싱한 결과입니다.
`[[LoadedModules]]`	a List of LoadedModuleRequest Records	이 스크립트가 가져온 지정자 문자열에서 해석된 Module Record로의 맵입니다. 이 목록에는 ModuleRequestsEqual(`r1`, `r2`)이 true인 서로 다른 두 Record `r1`과 `r2`가 포함되지 않습니다.
`[[HostDefined]]`	anything (default value is empty)	스크립트에 추가 정보를 연결해야 하는 호스트 환경에서 사용하도록 예약된 필드입니다.

16.1.5 ParseScript ( `sourceText`, `realm`, `hostDefined` )

추상 연산 ParseScript. 인수 sourceText ((String 또는 a sequence of Unicode code points)), realm (Realm 레코드) 및 hostDefined (임의의 값). 반환값: (Script 레코드 또는 a non-empty List of SyntaxError objects). sourceText를 Script로 파싱한 결과를 기반으로 Script Record를 생성합니다. 호출되면 다음 단계를 수행한다.

script를 ParseText(sourceText, Script)로 둡니다.
script가 오류의 List이면 script를 반환합니다.
Script Record { [[Realm]]: realm, [[ECMAScriptCode]]: script, [[LoadedModules]]: « », [[HostDefined]]: hostDefined }를 반환합니다.

참고

구현체는 해당 스크립트 소스 텍스트에 ParseScript를 평가하기 전에 스크립트 소스 텍스트를 파싱하고 조기 오류 조건을 분석할 수 있습니다. 그러나 오류 보고는 이 명세가 실제로 해당 소스 텍스트에 ParseScript를 수행하는 시점까지 지연되어야 합니다.

16.1.6 ScriptEvaluation ( `scriptRecord` )

추상 연산 ScriptEvaluation. 인수 scriptRecord (Script 레코드). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

globalEnv를 scriptRecord.[[Realm]].[[GlobalEnv]]로 둡니다.
scriptContext를 새로운 ECMAScript 코드 실행 컨텍스트로 둡니다.
scriptContext의 Function을 null로 설정합니다.
scriptContext의 Realm을 scriptRecord.[[Realm]]으로 설정합니다.
scriptContext의 ScriptOrModule을 scriptRecord로 설정합니다.
scriptContext의 VariableEnvironment를 globalEnv로 설정합니다.
scriptContext의 LexicalEnvironment를 globalEnv로 설정합니다.
scriptContext의 PrivateEnvironment를 null로 설정합니다.
실행 중인 실행 컨텍스트를 일시 중단합니다.
scriptContext를 실행 컨텍스트 스택에 푸시합니다. 이제 scriptContext가 실행 중인 실행 컨텍스트입니다.
scriptNode를 scriptRecord.[[ECMAScriptCode]]로 둡니다.
result를 Completion(GlobalDeclarationInstantiation(scriptNode, globalEnv))으로 둡니다.
result가 정상 완료이면, 다음을 수행합니다.
1. result를 Completion(scriptNode의 Evaluation)으로 설정합니다.
2. result가 정상 완료이고 result.[[Value]]가 empty이면, 다음을 수행합니다.
  1. result를 NormalCompletion(undefined)으로 설정합니다.
scriptContext를 일시 중단하고 실행 컨텍스트 스택에서 제거합니다.
단언: 실행 컨텍스트 스택은 비어 있지 않습니다.
이제 실행 컨텍스트 스택의 맨 위에 있는 컨텍스트를 실행 중인 실행 컨텍스트로 재개합니다.
? result를 반환합니다.

16.1.7 GlobalDeclarationInstantiation ( `script`, `envRecord` )

추상 연산 GlobalDeclarationInstantiation. 인수 script (a Script Parse Node) 및 envRecord (Global Environment 레코드). 반환값: (정상 완료 (값: unused) 또는 throw 완료). script는 실행 컨텍스트를 설정할 Script입니다. envRecord는 바인딩을 생성할 전역 환경입니다.

참고 1

스크립트를 평가하기 위한 실행 컨텍스트가 설정될 때 선언은 현재 전역 환경에 인스턴스화됩니다. 코드에서 선언된 각 전역 바인딩이 인스턴스화됩니다.

호출되면 다음 단계를 수행합니다:

lexicalNames를 script의 LexicallyDeclaredNames로 둡니다.
variableNames를 script의 VarDeclaredNames로 둡니다.
lexicalNames의 각 요소 name에 대해 다음을 수행합니다.
1. HasLexicalDeclaration(envRecord, name)이 true이면 SyntaxError 예외를 던집니다.
2. hasRestrictedGlobal을 ? HasRestrictedGlobalProperty(envRecord, name)로 둡니다.
3. 참고: 전역 var 및 function 바인딩(비엄격 직접 eval에 의해 도입되는 바인딩 제외)은 구성 불가능하므로 제한된 전역 프로퍼티입니다.
4. hasRestrictedGlobal이 true이면 SyntaxError 예외를 던집니다.
variableNames의 각 요소 name에 대해 다음을 수행합니다.
1. HasLexicalDeclaration(envRecord, name)이 true이면 SyntaxError 예외를 던집니다.
variableDecls를 script의 VarScopedDeclarations로 둡니다.
funcsToInitialize를 새로운 빈 List로 둡니다.
declaredFuncNames를 새로운 빈 List로 둡니다.
variableDecls의 각 요소 variableDecl에 대해 List의 역순으로 다음을 수행합니다.
1. variableDecl이 VariableDeclaration, ForBinding 또는 BindingIdentifier 중 어느 것도 아니면, 다음을 수행합니다.
  1. 단언: variableDecl은 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration 또는 AsyncGeneratorDeclaration 중 하나입니다.
  2. 참고: 같은 이름에 함수 선언이 여러 개 있으면 마지막 선언이 사용됩니다.
  3. funcName을 variableDecl의 BoundNames의 유일한 요소로 둡니다.
  4. declaredFuncNames에 funcName이 포함되어 있지 않으면, 다음을 수행합니다.
    1. funcDefinable을 ? CanDeclareGlobalFunction(envRecord, funcName)으로 둡니다.
    2. funcDefinable이 false이면 TypeError 예외를 던집니다.
    3. funcName을 declaredFuncNames에 추가합니다.
    4. variableDecl을 funcsToInitialize의 첫 번째 요소로 삽입합니다.
declaredVariableNames를 새로운 빈 List로 둡니다.
variableDecls의 각 요소 variableDecl에 대해 다음을 수행합니다.
1. variableDecl이 VariableDeclaration, ForBinding 또는 BindingIdentifier 중 하나이면, 다음을 수행합니다.
  1. variableDecl의 BoundNames의 각 String name에 대해 다음을 수행합니다.
    1. declaredFuncNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
      1. variableDefinable을 ? CanDeclareGlobalVar(envRecord, name)로 둡니다.
      2. variableDefinable이 false이면 TypeError 예외를 던집니다.
      3. declaredVariableNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
        name을 declaredVariableNames에 추가합니다.
참고: 전역 객체가 일반 객체이면 이 알고리즘 단계 이후에는 비정상 종료가 발생하지 않습니다. 그러나 전역 객체가 Proxy 특수 객체이면 다음 단계 중 일부에서 비정상 종료를 일으키는 동작을 나타낼 수 있습니다.
Normative Optional
호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하면, 다음을 수행합니다.
1. strict를 script의 ScriptIsStrict로 둡니다.
2. strict가 false이면, 다음을 수행합니다.
  1. declaredFuncOrVariableNames를 declaredFuncNames와 declaredVariableNames의 목록 연결로 둡니다.
  2. script Contains x가 true인 어떤 Block, CaseClause 또는 DefaultClause x의 StatementList에 직접 포함된 각 FunctionDeclaration funcDecl에 대해 다음을 수행합니다.
    1. funcName을 funcDecl의 BindingIdentifier의 StringValue로 둡니다.
    2. FunctionDeclaration funcDecl을 funcName을 BindingIdentifier로 갖는 VariableStatement로 바꿔도 script에 조기 오류가 발생하지 않으면, 다음을 수행합니다.
      1. HasLexicalDeclaration(envRecord, funcName)이 false이면, 다음을 수행합니다.
        funcDefinable을 ? CanDeclareGlobalVar(envRecord, funcName)로 둡니다.
        funcDefinable이 true이면, 다음을 수행합니다.
        참고: funcName에 대한 var 바인딩은 여기에서 funcName이 VarDeclaredName도 아니고 다른 FunctionDeclaration의 이름도 아닌 경우에만 인스턴스화됩니다.
        declaredFuncOrVariableNames에 funcName이 포함되어 있지 않으면, 다음을 수행합니다.
        ? CreateGlobalVarBinding(envRecord, funcName, false)를 수행합니다.
        funcName을 declaredFuncOrVariableNames에 추가합니다.
        FunctionDeclaration funcDecl이 평가될 때 15.2.6에 제공된 FunctionDeclaration Evaluation 알고리즘 대신 다음 단계를 수행합니다:
        globalEnv를 실행 중인 실행 컨텍스트의 VariableEnvironment로 둡니다.
        blockEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
        funcObj를 ! blockEnv.GetBindingValue(funcName, false)로 둡니다.
        ? globalEnv.SetMutableBinding(funcName, funcObj, false)를 수행합니다.
        unused를 반환합니다.
lexicalDecls를 script의 LexicallyScopedDeclarations로 둡니다.
privateEnv를 null로 둡니다.
lexicalDecls의 각 요소 lexicalDecl에 대해 다음을 수행합니다.
1. 참고: 렉시컬하게 선언된 이름은 여기에서 인스턴스화되기만 하며 초기화되지는 않습니다.
2. lexicalDecl의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
  1. lexicalDecl의 IsConstantDeclaration이 true이면, 다음을 수행합니다.
    1. ? envRecord.CreateImmutableBinding(name, true)를 수행합니다.
  2. 그렇지 않으면,
    1. ? envRecord.CreateMutableBinding(name, false)를 수행합니다.
funcsToInitialize의 각 Parse Node funcDecl에 대해 다음을 수행합니다.
1. funcName을 funcDecl의 BoundNames의 유일한 요소로 둡니다.
2. funcObj를 인수 envRecord 및 privateEnv를 사용한 funcDecl의 InstantiateFunctionObject로 둡니다.
3. ? CreateGlobalFunctionBinding(envRecord, funcName, funcObj, false)를 수행합니다.
declaredVariableNames의 각 String variableName에 대해 다음을 수행합니다.
1. ? CreateGlobalVarBinding(envRecord, variableName, false)를 수행합니다.
unused를 반환합니다.

참고 2

16.1.1에 명시된 조기 오류는 하나의 Script 안에 포함된 선언에서 함수/var 선언과 let/const/class 선언 사이의 이름 충돌 및 let/const/class 바인딩의 재선언을 방지합니다. 그러나 둘 이상의 Script에 걸친 이러한 충돌과 재선언은 GlobalDeclarationInstantiation 중 런타임 오류로 검출됩니다. 그러한 오류가 하나라도 검출되면 해당 스크립트에는 어떤 바인딩도 인스턴스화되지 않습니다. 다만 전역 객체가 Proxy 특수 객체를 사용하여 정의된 경우 충돌 선언에 대한 런타임 검사가 신뢰할 수 없을 수 있으며, 그 결과 비정상 완료가 발생하고 일부 전역 선언이 인스턴스화되지 않을 수 있습니다. 이런 일이 발생하면 Script의 코드는 평가되지 않습니다.

명시적인 var 또는 함수 선언과 달리 전역 객체에 직접 생성된 프로퍼티로 인해 생긴 전역 바인딩은 let/const/class 선언에 의해 가려질 수 있습니다.

16.2 모듈

구문

opt

[~Yield, +Await, ~Return]

ModuleExportName

IdentifierName

StringLiteral

16.2.1 모듈 의미론

16.2.1.1 Static Semantics: 조기 오류

ModuleBody

ModuleItemList

ModuleItemList의 LexicallyDeclaredNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.
ModuleItemList의 LexicallyDeclaredNames의 어떤 요소라도 ModuleItemList의 VarDeclaredNames에도 나타나면 Syntax Error입니다.
ModuleItemList의 ExportedNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.
ModuleItemList의 ExportedBindings의 어떤 요소라도 ModuleItemList의 VarDeclaredNames 또는 LexicallyDeclaredNames 중 어느 쪽에도 나타나지 않으면 Syntax Error입니다.
ModuleItemList Contains super이면 Syntax Error입니다.
ModuleItemList Contains NewTarget이면 Syntax Error입니다.
인수 « »을 사용한 ModuleItemList의 ContainsDuplicateLabels가 true이면 Syntax Error입니다.
인수 « »을 사용한 ModuleItemList의 ContainsUndefinedBreakTarget이 true이면 Syntax Error입니다.
인수 « » 및 « »을 사용한 ModuleItemList의 ContainsUndefinedContinueTarget이 true이면 Syntax Error입니다.
인수 « »을 사용한 ModuleItemList의 AllPrivateIdentifiersValid가 false이면 Syntax Error입니다.

참고

중복 ExportedNames 규칙은 하나의 ModuleBody 안에 여러 export default ExportDeclaration 항목이 있으면 Syntax Error라는 것을 의미합니다. 충돌하거나 중복된 선언과 관련된 추가 오류 조건은 Module을 평가하기 전에 모듈 연결 중 검사됩니다. 이러한 오류가 하나라도 검출되면 Module은 평가되지 않습니다.

ModuleExportName

StringLiteral

IsStringWellFormedUnicode(StringLiteral의 SV)가 false이면 Syntax Error입니다.

16.2.1.2 Static Semantics: ImportedLocalNames ( `importEntries` )

추상 연산 ImportedLocalNames. 인수 importEntries (리스트 (요소: ImportEntry 레코드)). 반환값: 리스트 (요소: String). importEntries에 의해 정의된 모든 로컬 이름 바인딩의 List를 생성합니다. 호출되면 다음 단계를 수행한다.

localNames를 새로운 빈 List로 둡니다.
importEntries의 각 ImportEntry Record importEntry에 대해 다음을 수행합니다.
1. importEntry.[[LocalName]]을 localNames에 추가합니다.
localNames를 반환합니다.

16.2.1.3 ModuleRequest Record

ModuleRequest Record는 주어진 import 속성을 사용하여 모듈을 가져오라는 요청을 나타냅니다. 다음 필드로 구성됩니다:

표 36: ModuleRequest Record 필드

필드 이름	값 타입	의미
`[[Specifier]]`	a String	모듈 지정자
`[[Attributes]]`	a List of ImportAttribute Records	import 속성

LoadedModuleRequest Record는 결과 Module Record와 함께 모듈을 가져오라는 요청을 나타냅니다. 표 36 표에 정의된 것과 동일한 필드에 [[Module]]이 추가됩니다:

표 37: LoadedModuleRequest Record 필드

필드 이름	값 타입	의미
`[[Specifier]]`	a String	모듈 지정자
`[[Attributes]]`	a List of ImportAttribute Records	import 속성
`[[Module]]`	a Module Record	이 모듈 요청에 대응하여 로드된 모듈

ImportAttribute Record는 다음 필드로 구성됩니다:

표 38: ImportAttribute Record 필드

필드 이름	값 타입	의미
`[[Key]]`	a String	속성 키
`[[Value]]`	a String	속성 값

16.2.1.3.1 ModuleRequestsEqual ( `x`, `y` )

추상 연산 ModuleRequestsEqual. 인수 x ((ModuleRequest 레코드 또는 LoadedModuleRequest 레코드)) 및 y ((ModuleRequest 레코드 또는 LoadedModuleRequest 레코드)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

x.[[Specifier]]가 y.[[Specifier]]와 같지 않으면 false를 반환합니다.
xAttrs를 x.[[Attributes]]로 둡니다.
yAttrs를 y.[[Attributes]]로 둡니다.
xAttrsCount를 xAttrs의 요소 수로 둡니다.
yAttrsCount를 yAttrs의 요소 수로 둡니다.
xAttrsCount ≠ yAttrsCount이면 false를 반환합니다.
xAttrs의 각 ImportAttribute Record xAttr에 대해 다음을 수행합니다.
1. xAttr.[[Key]]가 yAttr.[[Key]]와 같고 xAttr.[[Value]]가 yAttr.[[Value]]와 같은 ImportAttribute Record yAttr이 yAttrs에 포함되어 있지 않으면 false를 반환합니다.
true를 반환합니다.

16.2.1.4 Static Semantics: ModuleRequests

구문 지향 연산 ModuleRequests. 인수 없음. 반환값: 리스트 (요소: ModuleRequest 레코드). 다음 생성 규칙별로 정의된다.

Module

[empty]

새로운 빈 List를 반환합니다.

ModuleItemList

ModuleItem

ModuleItem의 ModuleRequests를 반환합니다.

ModuleItemList

ModuleItem

requests를 ModuleItemList의 ModuleRequests로 둡니다.
additionalRequests를 ModuleItem의 ModuleRequests로 둡니다.
additionalRequests의 각 ModuleRequest Record moduleRequest에 대해 다음을 수행합니다.
1. ModuleRequestsEqual(moduleRequest, otherModuleRequest)이 true인 ModuleRequest Record otherModuleRequest가 requests에 포함되어 있지 않으면, 다음을 수행합니다.
  1. moduleRequest를 requests에 추가합니다.
requests를 반환합니다.

ModuleItem

StatementListItem

새로운 빈 List를 반환합니다.

ImportDeclaration

import

ImportClause

FromClause

;

specifier를 FromClause의 SV로 둡니다.
유일한 요소가 ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }인 List를 반환합니다.

import

;

specifier를 FromClause의 SV로 둡니다.
attrs를 WithClause의 WithClauseToAttributes로 둡니다.
유일한 요소가 ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }인 List를 반환합니다.

ImportDeclaration

import

ModuleSpecifier

;

specifier를 ModuleSpecifier의 SV로 둡니다.
유일한 요소가 ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }인 List를 반환합니다.

ImportDeclaration

import

ModuleSpecifier

WithClause

;

specifier를 ModuleSpecifier의 SV로 둡니다.
attrs를 WithClause의 WithClauseToAttributes로 둡니다.
유일한 요소가 ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }인 List를 반환합니다.

ExportDeclaration

export

ExportFromClause

FromClause

;

specifier를 FromClause의 SV로 둡니다.
유일한 요소가 ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }인 List를 반환합니다.

export

;

specifier를 FromClause의 SV로 둡니다.
attrs를 WithClause의 WithClauseToAttributes로 둡니다.
유일한 요소가 ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }인 List를 반환합니다.

ExportDeclaration

export

NamedExports

;

export

VariableStatement

export

Declaration

export

default

HoistableDeclaration

export

default

ClassDeclaration

export

default

AssignmentExpression

;

새로운 빈 List를 반환합니다.

16.2.1.5 추상 Module Record

Module Record는 하나의 모듈이 가져오고 내보내는 항목에 관한 구조적 정보를 캡슐화합니다. 이 정보는 서로 연결된 모듈 집합의 import와 export를 연결하는 데 사용됩니다. Module Record에는 모듈을 평가할 때만 사용하는 네 개의 필드가 포함됩니다.

명세를 위한 목적으로 Module Record는 Record 명세 타입의 값이며, Module Record가 추상 클래스이고 추상 및 구체 하위 클래스를 모두 갖는 단순한 객체 지향 계층 구조에 존재한다고 생각할 수 있습니다. 이 명세는 Cyclic Module Record라는 추상 하위 클래스와 그 구체 하위 클래스인 Source Text Module Record를 정의합니다. 다른 명세와 구현체는 자신들이 정의한 대체 모듈 정의 기능에 대응하는 추가 Module Record 하위 클래스를 정의할 수 있습니다.

Module Record는 표 39에 나열된 필드를 정의합니다. 모든 Module Definition 하위 클래스는 최소한 이러한 필드를 포함합니다. Module Record는 또한 표 40의 추상 메서드 목록을 정의합니다. 모든 Module definition 하위 클래스는 이러한 추상 메서드의 구체 구현을 제공해야 합니다.

표 39: Module Record 필드

필드 이름	값 타입	의미
`[[Realm]]`	a Realm Record	이 모듈이 생성된 Realm입니다.
`[[Environment]]`	a Module Environment Record or empty	이 모듈의 최상위 바인딩을 포함하는 Environment Record입니다. 이 필드는 모듈이 연결될 때 설정됩니다.
`[[Namespace]]`	an Object or empty	이 모듈에 대해 생성된 경우 Module Namespace Object(28.3)입니다.
`[[HostDefined]]`	anything (default value is undefined)	모듈에 추가 정보를 연결해야 하는 호스트 환경에서 사용하도록 예약된 필드입니다.

표 40: Module Records의 추상 메서드

메서드	목적	정의
LoadRequestedModules ( [ `hostDefined` ] )	추상 메서드 LoadRequestedModules. 선택적 인수 `hostDefined` (임의의 값). 반환값: Promise. 모든 종속성을 재귀적으로 로드하여 모듈을 연결할 준비를 합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.6.1.1 Cyclic Module Record 16.2.1.8.4.1 Synthetic Module Record
GetExportedNames ( [ `exportStarSet` ] )	추상 메서드 GetExportedNames. 선택적 인수 `exportStarSet` (리스트 (요소: Source Text Module 레코드)). 반환값: 리스트 (요소: String). 이 모듈에서 직접 또는 간접으로 내보내는 모든 이름의 목록을 반환합니다. 이 메서드를 호출하기 전에 LoadRequestedModules가 성공적으로 완료되어 있어야 합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.7.2.1 Source Text Module Record 16.2.1.8.4.2 Synthetic Module Record
ResolveExport ( `exportName` [ , `resolveSet` ] )	추상 메서드 ResolveExport. 인수 `exportName` (String) 및 선택적 인수 `resolveSet` (리스트 (요소: 레코드 (필드: `[[Module]]` (Module 레코드), `[[ExportName]]` (String)))). 반환값: (ResolvedBinding 레코드, null 또는 ambiguous). 이 모듈에서 내보낸 이름의 바인딩을 반환합니다. 바인딩은 { `[[Module]]`: Module Record, `[[BindingName]]`: String \| namespace } 형태의 ResolvedBinding Record로 나타냅니다. export가 어떤 모듈에도 직접 바인딩이 없는 Module Namespace Object이면 `[[BindingName]]`은 namespace로 설정됩니다. 이름을 해석할 수 없으면 null을 반환하고 여러 바인딩이 발견되면 ambiguous를 반환합니다. 이 연산을 특정 `exportName`, `resolveSet` 쌍을 인수로 사용하여 호출할 때마다 동일한 결과를 반환해야 합니다. 이 메서드를 호출하기 전에 LoadRequestedModules가 성공적으로 완료되어 있어야 합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.7.2.2 Source Text Module Record 16.2.1.8.4.3 Synthetic Module Record
Link ( )	추상 메서드 Link. 인수 없음. 반환값: (정상 완료 (값: unused) 또는 throw 완료). 모든 모듈 종속성을 전이적으로 해석하고 Module Environment Record를 생성하여 모듈을 평가할 준비를 합니다. 이 메서드를 호출하기 전에 LoadRequestedModules가 성공적으로 완료되어 있어야 합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.6.1.2 Cyclic Module Record 16.2.1.8.4.4 Synthetic Module Record
Evaluate ( )	추상 메서드 Evaluate. 인수 없음. 반환값: Promise. 이 모듈과 그 종속성의 평가에 대한 promise를 반환합니다. 평가가 성공하거나 이미 성공적으로 평가된 경우 resolve되고, 평가 오류가 발생하거나 이미 평가에 실패한 경우 reject됩니다. promise가 reject되면 호스트는 promise rejection을 처리하고 평가 오류를 다시 던질 것으로 예상됩니다. 이 모듈이 Cyclic Module Record가 아닌 한 반환된 promise는 이미 settle되어 있어야 합니다. 이 메서드를 호출하기 전에 Link가 성공적으로 완료되어 있어야 합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.6.1.3 Cyclic Module Record 16.2.1.8.4.5 Synthetic Module Record

16.2.1.5.1 EvaluateModuleSync ( `module` )

추상 연산 EvaluateModuleSync. 인수 module (Module 레코드). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출자가 module의 평가가 이미 settle된 promise를 반환할 것임을 보장하는 경우 module을 동기적으로 평가합니다. 호출되면 다음 단계를 수행한다.

단언: module은 Cyclic Module Record가 아닙니다.
promise를 module.Evaluate()로 둡니다.
단언: promise.[[PromiseState]]는 fulfilled 또는 rejected입니다.
promise.[[PromiseState]]가 rejected이면, 다음을 수행합니다.
1. promise.[[PromiseIsHandled]]가 false이면 HostPromiseRejectionTracker(promise, "handle")를 수행합니다.
2. promise.[[PromiseIsHandled]]를 true로 설정합니다.
3. promise.[[PromiseResult]]를 던집니다.
unused를 반환합니다.

16.2.1.6 Cyclic Module Record

Cyclic Module Record는 Cyclic Module Record 타입의 하위 클래스인 다른 모듈과 종속성 순환에 참여할 수 있는 모듈에 관한 정보를 나타내는 데 사용됩니다. Cyclic Module Record 타입의 하위 클래스가 아닌 Module Record는 Source Text Module Record와의 종속성 순환에 참여해서는 안 됩니다.

표 39에 정의된 필드 외에도 Cyclic Module Record에는 표 41에 나열된 추가 필드가 있습니다.

표 41: Cyclic Module Record의 추가 필드

필드 이름	값 타입	의미
`[[Status]]`	new, unlinked, linking, linked, evaluating, evaluating-async, or evaluated	처음에는 new입니다. 모듈이 수명 주기를 진행하면서 unlinked, linking, linked, evaluating, 경우에 따라 evaluating-async, evaluated 순서로 전이합니다. evaluating-async는 이 모듈이 비동기 종속성 완료 시 실행 대기 중이거나 `[[HasTLA]]` 필드가 true인 모듈로서 실행되었지만 최상위 완료를 기다리고 있음을 나타냅니다.
`[[EvaluationError]]`	a throw completion or empty	평가 중 발생한 예외를 나타내는 throw 완료입니다. 예외가 발생하지 않았거나 `[[Status]]`가 evaluated가 아니면 empty입니다.
`[[DFSAncestorIndex]]`	an integer or empty	Link 및 Evaluate 중에만 사용하는 보조 필드입니다. `[[Status]]`가 linking 또는 evaluating이면 이 값은 모듈 자체의 깊이 우선 탐색 인덱스 또는 동일한 강연결 요소에 있는 “더 앞선” 모듈의 인덱스입니다.
`[[RequestedModules]]`	a List of ModuleRequest Records	이 모듈의 import와 연결된 ModuleRequest Record의 List입니다. List는 import가 소스 텍스트에 나타나는 순서입니다.
`[[LoadedModules]]`	a List of LoadedModuleRequest Records	이 Record가 나타내는 모듈이 상대 import 속성과 함께 모듈을 가져오도록 요청하는 데 사용한 지정자 문자열에서 해석된 Module Record로의 맵입니다. 이 목록에는 ModuleRequestsEqual(`r1`, `r2`)이 true인 서로 다른 두 Record `r1`과 `r2`가 포함되지 않습니다.
`[[CycleRoot]]`	a Cyclic Module Record or empty	순환에서 처음 방문한 모듈, 즉 강연결 요소의 루트 DFS 조상입니다. 순환에 속하지 않는 모듈에서는 모듈 자신입니다. Evaluate가 완료되면 모듈의 `[[DFSAncestorIndex]]`는 해당 `[[CycleRoot]]`의 깊이 우선 탐색 인덱스입니다.
`[[HasTLA]]`	a Boolean	이 모듈 자체가 비동기인지 여부입니다(예: 최상위 await를 포함하는 Source Text Module Record). 비동기 종속성을 갖는다고 해서 이 필드가 true인 것은 아닙니다. 이 필드는 모듈을 파싱한 뒤 변경되어서는 안 됩니다.
`[[AsyncEvaluationOrder]]`	unset, an integer, or done	이 필드는 처음에 unset으로 설정되며 완전히 동기적인 모듈에서는 계속 unset입니다. 모듈 자체가 비동기이거나 비동기 종속성을 갖는 경우, 16.2.1.6.1.3.4이 대기 중인 모듈의 실행을 큐에 넣는 순서를 결정하는 정수로 설정됩니다. 대기 중인 모듈이 성공적으로 실행되면 이 필드는 done으로 설정됩니다.
`[[TopLevelCapability]]`	a PromiseCapability Record or empty	이 모듈이 어떤 순환의 `[[CycleRoot]]`이고 해당 순환의 어떤 모듈에 대해 Evaluate()가 호출되었다면, 이 필드는 전체 평가에 대한 PromiseCapability Record를 포함합니다. Evaluate() 추상 메서드에서 반환한 Promise 객체를 settle하는 데 사용됩니다. 해당 모듈의 종속성에서는 일부 종속성에 대해 최상위 Evaluate()가 시작된 경우를 제외하면 이 필드가 empty입니다.
`[[AsyncParentModules]]`	a List of Cyclic Module Records	이 모듈 또는 종속성의 `[[HasTLA]]`가 true이고 실행이 진행 중이면 최상위 실행 작업에 대해 이 모듈의 부모 importer를 추적합니다. 이러한 부모 모듈은 이 모듈이 성공적으로 실행을 완료하기 전에는 실행을 시작하지 않습니다.
`[[PendingAsyncDependencies]]`	an integer or empty	이 모듈에 비동기 종속성이 있으면 이 모듈을 위해 아직 실행해야 하는 비동기 종속 모듈의 수를 추적합니다. 비동기 종속성이 있는 모듈은 이 필드가 0에 도달하고 실행 오류가 없을 때 실행됩니다.

표 40에 정의된 메서드 외에도 Cyclic Module Record에는 표 42에 나열된 추가 메서드가 있습니다:

표 42: Cyclic Module Record의 추가 추상 메서드

메서드	목적	정의
InitializeEnvironment ( )	추상 메서드 InitializeEnvironment. 인수 없음. 반환값: (정상 완료 (값: unused) 또는 throw 완료). 모든 가져온 바인딩을 해석하는 것을 포함하여 모듈의 Environment Record를 초기화하고 모듈의 실행 컨텍스트를 생성합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.7.3.1 Source Text Module Record
ExecuteModule ( [ `capability` ] )	추상 메서드 ExecuteModule. 선택적 인수 `capability` (PromiseCapability 레코드). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 해당 실행 컨텍스트에서 모듈의 코드를 평가합니다. 이 모듈의 `[[HasTLA]]`가 true이면 PromiseCapability Record가 인수로 전달되며, 메서드는 주어진 capability를 resolve 또는 reject할 것으로 예상됩니다. 이 경우 메서드는 예외를 던져서는 안 되며 필요한 경우 대신 PromiseCapability Record를 reject해야 합니다.	이 명세에서는 다음 타입에 정의가 있으며, 호스트는 자체 정의를 갖는 추가 타입을 제공할 수 있습니다: 16.2.1.7.3.2 Source Text Module Record

GraphLoadingState Record는 모듈 그래프의 로딩 과정에 관한 정보를 포함하는 Record입니다. HostLoadImportedModule 호출 이후 로딩을 계속하는 데 사용됩니다. 각 GraphLoadingState Record에는 표 43에 정의된 필드가 있습니다:

표 43: GraphLoadingState Record 필드

필드 이름	값 타입	의미
`[[PromiseCapability]]`	a PromiseCapability Record	로딩 과정이 끝날 때 resolve할 promise입니다.
`[[IsLoading]]`	a Boolean	로딩 과정이 성공이나 오류 어느 쪽으로도 아직 완료되지 않았으면 true입니다.
`[[PendingModulesCount]]`	a non-negative integer	대기 중인 HostLoadImportedModule 호출 수를 추적합니다.
`[[Visited]]`	a List of Cyclic Module Records	순환 종속성에 의한 무한 루프를 피하기 위해 현재 로딩 과정에서 이미 로드된 Cyclic Module Record의 목록입니다.
`[[HostDefined]]`	anything (default value is empty)	LoadRequestedModules 호출자에서 HostLoadImportedModule로 전달할 호스트 정의 데이터를 포함합니다.

16.2.1.6.1 Module Record 추상 메서드의 구현

다음은 표 40에 정의된 대응 Module Record 추상 메서드를 구현하는 Cyclic Module Record의 구체 메서드입니다.

16.2.1.6.1.1 LoadRequestedModules ( [ `hostDefined` ] )

a Cyclic Module Record module의 구체 메서드 LoadRequestedModules. 선택적 인수 hostDefined (임의의 값). 반환값: Promise. module의 종속성 그래프에 있는 모든 Module Record의 [[LoadedModules]]를 채웁니다(대부분의 작업은 보조 함수 InnerModuleLoading이 수행합니다). HostLoadImportedModule 훅에 전달되는 선택적 hostDefined 매개변수를 받습니다. 호출되면 다음 단계를 수행한다.

hostDefined가 존재하지 않으면 hostDefined를 empty로 설정합니다.
promiseCapability를 ! NewPromiseCapability(%Promise%)로 둡니다.
state를 GraphLoadingState Record { [[IsLoading]]: true, [[PendingModulesCount]]: 1, [[Visited]]: « », [[PromiseCapability]]: promiseCapability, [[HostDefined]]: hostDefined }로 둡니다.
InnerModuleLoading(state, module)을 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

참고

hostDefined 매개변수는 가져온 모듈을 가져오는 데 필요한 추가 정보를 전달하는 데 사용할 수 있습니다. 예를 들어 HTML은 이를 사용하여 <link rel="preload" as="..."> 태그에 올바른 fetch destination을 설정합니다. import() 표현식은 hostDefined 매개변수를 절대로 설정하지 않습니다.

16.2.1.6.1.1.1 InnerModuleLoading ( `state`, `module` )

추상 연산 InnerModuleLoading. 인수 state (GraphLoadingState 레코드) 및 module (Module 레코드). 반환값: unused. LoadRequestedModules가 module의 종속성 그래프에 대한 실제 로딩 과정을 재귀적으로 수행하는 데 사용합니다. 호출되면 다음 단계를 수행한다.

단언: state.[[IsLoading]]은 true입니다.
module이 Cyclic Module Record이고 module.[[Status]]가 new이며 state.[[Visited]]에 module이 포함되어 있지 않으면, 다음을 수행합니다.
1. module을 state.[[Visited]]에 추가합니다.
2. requestedModulesCount를 module.[[RequestedModules]]의 요소 수로 둡니다.
3. state.[[PendingModulesCount]]를 state.[[PendingModulesCount]] + requestedModulesCount로 설정합니다.
4. module.[[RequestedModules]]의 각 ModuleRequest Record request에 대해 다음을 수행합니다.
  1. AllImportAttributesSupported(request.[[Attributes]])가 false이면, 다음을 수행합니다.
    1. error를 ThrowCompletion(새로 생성된 SyntaxError 객체)으로 둡니다.
    2. ContinueModuleLoading(state, error)을 수행합니다.
  2. 그렇지 않고 module.[[LoadedModules]]에 ModuleRequestsEqual(record, request)이 true인 LoadedModuleRequest Record record가 포함되어 있으면, 다음을 수행합니다.
    1. InnerModuleLoading(state, record.[[Module]])을 수행합니다.
  3. 그렇지 않으면,
    1. HostLoadImportedModule(module, request, state.[[HostDefined]], state)을 수행합니다.
    2. 참고: HostLoadImportedModule은 FinishLoadingImportedModule을 호출하며, FinishLoadingImportedModule은 ContinueModuleLoading을 통해 그래프 로딩 과정에 다시 진입합니다.
  4. state.[[IsLoading]]이 false이면 unused를 반환합니다.
단언: state.[[PendingModulesCount]] ≥ 1입니다.
state.[[PendingModulesCount]]를 state.[[PendingModulesCount]] - 1로 설정합니다.
state.[[PendingModulesCount]] = 0이면, 다음을 수행합니다.
1. state.[[IsLoading]]을 false로 설정합니다.
2. state.[[Visited]]의 각 Cyclic Module Record loaded에 대해 다음을 수행합니다.
  1. loaded.[[Status]]가 new이면 loaded.[[Status]]를 unlinked로 설정합니다.
3. ! Call(state.[[PromiseCapability]].[[Resolve]], undefined, « undefined »)를 수행합니다.
unused를 반환합니다.

16.2.1.6.1.1.2 ContinueModuleLoading ( `state`, `moduleCompletion` )

추상 연산 ContinueModuleLoading. 인수 state (GraphLoadingState 레코드) 및 moduleCompletion ((정상 완료 (값: Module 레코드) 또는 throw 완료)). 반환값: unused. HostLoadImportedModule 호출 후 로딩 과정에 다시 진입하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

state.[[IsLoading]]이 false이면 unused를 반환합니다.
moduleCompletion이 정상 완료이면, 다음을 수행합니다.
1. InnerModuleLoading(state, moduleCompletion.[[Value]])을 수행합니다.
그렇지 않으면,
1. state.[[IsLoading]]을 false로 설정합니다.
2. ! Call(state.[[PromiseCapability]].[[Reject]], undefined, « moduleCompletion.[[Value]] »)를 수행합니다.
unused를 반환합니다.

16.2.1.6.1.2 Link ( )

a Cyclic Module Record module의 구체 메서드 Link. 인수 없음. 반환값: (정상 완료 (값: unused) 또는 throw 완료). 성공하면 Link는 이 모듈의 [[Status]]를 unlinked에서 linked로 전이합니다. 실패하면 예외가 던져지고 이 모듈의 [[Status]]는 unlinked 상태로 유지됩니다. (대부분의 작업은 보조 함수 InnerModuleLinking이 수행합니다.) 호출되면 다음 단계를 수행한다.

단언: module.[[Status]]는 unlinked, linked, evaluating-async 또는 evaluated 중 하나입니다.
stack을 새로운 빈 List로 둡니다.
result를 Completion(InnerModuleLinking(module, stack, 0))으로 둡니다.
result가 비정상 완료이면, 다음을 수행합니다.
1. stack의 각 Cyclic Module Record requiredModule에 대해 다음을 수행합니다.
  1. 단언: requiredModule.[[Status]]는 linking입니다.
  2. requiredModule.[[Status]]를 unlinked로 설정합니다.
2. 단언: module.[[Status]]는 unlinked입니다.
3. ? result를 반환합니다.
단언: module.[[Status]]는 linked, evaluating-async 또는 evaluated 중 하나입니다.
단언: stack은 비어 있습니다.
unused를 반환합니다.

16.2.1.6.1.2.1 InnerModuleLinking ( `module`, `stack`, `index` )

추상 연산 InnerModuleLinking. 인수 module (Module 레코드), stack (리스트 (요소: Cyclic Module 레코드)) 및 index (음이 아닌 정수). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). Link가 module에 대한 실제 연결 과정을 수행하고 종속성 그래프의 다른 모든 모듈에도 재귀적으로 수행하는 데 사용합니다. stack과 index 매개변수 및 모듈의 [[DFSAncestorIndex]] 필드는 깊이 우선 탐색(DFS)을 추적합니다. 특히 [[DFSAncestorIndex]]는 강연결 요소(SCC)를 찾아내는 데 사용되며, 하나의 SCC에 있는 모든 모듈은 함께 linked로 전이합니다. 호출되면 다음 단계를 수행한다.

module이 Cyclic Module Record가 아니면, 다음을 수행합니다.
1. ? module.Link()를 수행합니다.
2. index를 반환합니다.
module.[[Status]]가 linking, linked, evaluating-async 또는 evaluated 중 하나이면, 다음을 수행합니다.
1. index를 반환합니다.
단언: module.[[Status]]는 unlinked입니다.
module.[[Status]]를 linking으로 설정합니다.
moduleIndex를 index로 둡니다.
module.[[DFSAncestorIndex]]를 index로 설정합니다.
index를 index + 1로 설정합니다.
module을 stack에 추가합니다.
module.[[RequestedModules]]의 각 ModuleRequest Record request에 대해 다음을 수행합니다.
1. requiredModule을 GetImportedModule(module, request)로 둡니다.
2. index를 ? InnerModuleLinking(requiredModule, stack, index)으로 설정합니다.
3. requiredModule이 Cyclic Module Record이면, 다음을 수행합니다.
  1. 단언: requiredModule.[[Status]]는 linking, linked, evaluating-async 또는 evaluated 중 하나입니다.
  2. 단언: requiredModule.[[Status]]가 linking인 것과 stack에 requiredModule이 포함되어 있는 것은 동치입니다.
  3. requiredModule.[[Status]]가 linking이면, 다음을 수행합니다.
    1. module.[[DFSAncestorIndex]]를 min(module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])로 설정합니다.
? module.InitializeEnvironment()를 수행합니다.
단언: module은 stack에 정확히 한 번 나타납니다.
단언: module.[[DFSAncestorIndex]] ≤ moduleIndex입니다.
module.[[DFSAncestorIndex]] = moduleIndex이면, 다음을 수행합니다.
1. done을 false로 둡니다.
2. done이 false인 동안 다음을 반복합니다.
  1. requiredModule을 stack의 마지막 요소로 둡니다.
  2. stack의 마지막 요소를 제거합니다.
  3. 단언: requiredModule은 Cyclic Module Record입니다.
  4. requiredModule.[[Status]]를 linked로 설정합니다.
  5. requiredModule과 module이 동일한 Module Record이면 done을 true로 설정합니다.
index를 반환합니다.

16.2.1.6.1.3 Evaluate ( )

a Cyclic Module Record module의 구체 메서드 Evaluate. 인수 없음. 반환값: Promise. Evaluate는 이 모듈의 [[Status]]를 linked에서 evaluating-async 또는 evaluated로 전이합니다. 주어진 강연결 요소의 모듈에 대해 처음 호출될 때 Evaluate는 모듈 평가가 완료될 때 resolve되는 Promise를 생성하고 반환합니다. 이 Promise는 해당 요소의 [[CycleRoot]]의 [[TopLevelCapability]] 필드에 저장됩니다. 이후 해당 요소의 어떤 모듈에 대해 Evaluate를 호출해도 같은 Promise를 반환합니다. (대부분의 작업은 보조 함수 InnerModuleEvaluation이 수행합니다.) 호출되면 다음 단계를 수행한다.

단언: 이 Evaluate 호출은 주변 agent 안의 다른 Evaluate 호출과 동시에 발생하고 있지 않습니다.
단언: module.[[Status]]는 linked, evaluating-async 또는 evaluated 중 하나입니다.
module.[[Status]]가 evaluating-async 또는 evaluated이면, 다음을 수행합니다.
1. module.[[CycleRoot]]가 empty가 아니면, 다음을 수행합니다.
  1. module을 module.[[CycleRoot]]로 설정합니다.
2. 그렇지 않으면,
  1. 단언: module.[[Status]]는 evaluated이고 module.[[EvaluationError]]는 throw 완료입니다.
module.[[TopLevelCapability]]가 empty가 아니면, 다음을 수행합니다.
1. module.[[TopLevelCapability]].[[Promise]]를 반환합니다.
stack을 새로운 빈 List로 둡니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
module.[[TopLevelCapability]]를 promiseCapability로 설정합니다.
result를 Completion(InnerModuleEvaluation(module, stack, 0))으로 둡니다.
result가 비정상 완료이면, 다음을 수행합니다.
1. stack의 각 Cyclic Module Record requiredModule에 대해 다음을 수행합니다.
  1. 단언: requiredModule.[[Status]]는 evaluating입니다.
  2. requiredModule.[[Status]]를 evaluated로 설정합니다.
  3. requiredModule.[[EvaluationError]]를 result로 설정합니다.
2. 단언: module.[[Status]]는 evaluated입니다.
3. 단언: module.[[EvaluationError]]와 result는 동일한 Completion Record입니다.
4. ! Call(promiseCapability.[[Reject]], undefined, « result.[[Value]] »)를 수행합니다.
그렇지 않으면,
1. 단언: module.[[Status]]는 evaluating-async 또는 evaluated입니다.
2. 단언: module.[[EvaluationError]]는 empty입니다.
3. module.[[Status]]가 evaluated이면, 다음을 수행합니다.
  1. 단언: module.[[AsyncEvaluationOrder]]는 unset 또는 done입니다.
  2. 참고: module이 이미 평가되었고 해당 평가가 비동기였던 경우에만 module.[[AsyncEvaluationOrder]]는 done입니다.
  3. ! Call(promiseCapability.[[Resolve]], undefined, « undefined »)를 수행합니다.
4. 단언: stack은 비어 있습니다.
promiseCapability.[[Promise]]를 반환합니다.

16.2.1.6.1.3.1 InnerModuleEvaluation ( `module`, `stack`, `index` )

추상 연산 InnerModuleEvaluation. 인수 module (Module 레코드), stack (리스트 (요소: Cyclic Module 레코드)) 및 index (음이 아닌 정수). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). Evaluate가 module의 실제 평가 과정을 수행하고 종속성 그래프의 다른 모든 모듈에도 재귀적으로 수행하는 데 사용합니다. stack과 index 매개변수 및 module의 [[DFSAncestorIndex]] 필드는 InnerModuleLinking과 같은 방식으로 사용됩니다. 호출되면 다음 단계를 수행한다.

module이 Cyclic Module Record가 아니면, 다음을 수행합니다.
1. ? EvaluateModuleSync(module)를 수행합니다.
2. index를 반환합니다.
module.[[Status]]가 evaluating-async 또는 evaluated이면, 다음을 수행합니다.
1. module.[[EvaluationError]]가 empty이면 index를 반환합니다.
2. ? module.[[EvaluationError]]를 반환합니다.
module.[[Status]]가 evaluating이면 index를 반환합니다.
단언: module.[[Status]]는 linked입니다.
module.[[Status]]를 evaluating으로 설정합니다.
moduleIndex를 index로 둡니다.
module.[[DFSAncestorIndex]]를 index로 설정합니다.
module.[[PendingAsyncDependencies]]를 0으로 설정합니다.
index를 index + 1로 설정합니다.
module을 stack에 추가합니다.
module.[[RequestedModules]]의 각 ModuleRequest Record request에 대해 다음을 수행합니다.
1. requiredModule을 GetImportedModule(module, request)로 둡니다.
2. index를 ? InnerModuleEvaluation(requiredModule, stack, index)으로 설정합니다.
3. requiredModule이 Cyclic Module Record이면, 다음을 수행합니다.
  1. 단언: requiredModule.[[Status]]는 evaluating, evaluating-async 또는 evaluated 중 하나입니다.
  2. 단언: requiredModule.[[Status]]가 evaluating인 것과 stack에 requiredModule이 포함되어 있는 것은 동치입니다.
  3. requiredModule.[[Status]]가 evaluating이면, 다음을 수행합니다.
    1. module.[[DFSAncestorIndex]]를 min(module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])로 설정합니다.
  4. 그렇지 않으면,
    1. requiredModule을 requiredModule.[[CycleRoot]]로 설정합니다.
    2. 단언: requiredModule.[[Status]]는 evaluating-async 또는 evaluated입니다.
    3. requiredModule.[[EvaluationError]]가 empty가 아니면 ? requiredModule.[[EvaluationError]]를 반환합니다.
  5. requiredModule.[[AsyncEvaluationOrder]]가 정수이면, 다음을 수행합니다.
    1. module.[[PendingAsyncDependencies]]를 module.[[PendingAsyncDependencies]] + 1로 설정합니다.
    2. module을 requiredModule.[[AsyncParentModules]]에 추가합니다.
module.[[HasTLA]]가 true이거나 module.[[PendingAsyncDependencies]] > 0이면, 다음을 수행합니다.
1. 단언: module.[[AsyncEvaluationOrder]]는 unset입니다.
2. module.[[AsyncEvaluationOrder]]를 IncrementModuleAsyncEvaluationCount()로 설정합니다.
3. module.[[PendingAsyncDependencies]] = 0이면 ExecuteAsyncModule(module)을 수행합니다.
그렇지 않으면,
1. ? module.ExecuteModule()를 수행합니다.
단언: module은 stack에 정확히 한 번 나타납니다.
단언: module.[[DFSAncestorIndex]] ≤ moduleIndex입니다.
module.[[DFSAncestorIndex]] = moduleIndex이면, 다음을 수행합니다.
1. done을 false로 둡니다.
2. done이 false인 동안 다음을 반복합니다.
  1. requiredModule을 stack의 마지막 요소로 둡니다.
  2. stack의 마지막 요소를 제거합니다.
  3. 단언: requiredModule은 Cyclic Module Record입니다.
  4. 단언: requiredModule.[[AsyncEvaluationOrder]]는 정수 또는 unset입니다.
  5. requiredModule.[[AsyncEvaluationOrder]]가 unset이면 requiredModule.[[Status]]를 evaluated로 설정합니다.
  6. 그렇지 않으면 requiredModule.[[Status]]를 evaluating-async로 설정합니다.
  7. requiredModule과 module이 동일한 Module Record이면 done을 true로 설정합니다.
  8. requiredModule.[[CycleRoot]]를 module로 설정합니다.
index를 반환합니다.

참고 1

모듈은 InnerModuleEvaluation이 순회하는 동안 evaluating입니다. 실행 완료 시에는 evaluated가 되며, [[HasTLA]] 필드가 true이거나 비동기 종속성이 있으면 실행 중에는 evaluating-async입니다.

참고 2

비동기 순환이 evaluating 상태가 아닐 때 그 순환의 모듈에 의존하는 모든 모듈은 대신 [[CycleRoot]]를 통해 순환 루트의 실행에 의존합니다. 이를 통해 순환 상태를 루트 모듈 상태를 통해 하나의 강연결 요소로 취급할 수 있습니다.

16.2.1.6.1.3.2 ExecuteAsyncModule ( `module` )

추상 연산 ExecuteAsyncModule. 인수 module (Cyclic Module 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: module.[[Status]]는 evaluating 또는 evaluating-async입니다.
단언: module.[[HasTLA]]는 true입니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
fulfilledClosure를 매개변수가 없고 module을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. AsyncModuleExecutionFulfilled(module)을 수행합니다.
2. NormalCompletion(undefined)을 반환합니다.
onFulfilled를 CreateBuiltinFunction(fulfilledClosure, 0, "", « »)로 둡니다.
rejectedClosure를 매개변수 (error)를 갖고 module을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. AsyncModuleExecutionRejected(module, error)를 수행합니다.
2. NormalCompletion(undefined)을 반환합니다.
onRejected를 CreateBuiltinFunction(rejectedClosure, 0, "", « »)로 둡니다.
PerformPromiseThen(promiseCapability.[[Promise]], onFulfilled, onRejected)을 수행합니다.
! module.ExecuteModule(promiseCapability)를 수행합니다.
unused를 반환합니다.

16.2.1.6.1.3.3 GatherAvailableAncestors ( `module`, `execList` )

추상 연산 GatherAvailableAncestors. 인수 module (Cyclic Module 레코드) 및 execList (리스트 (요소: Cyclic Module 레코드)). 반환값: unused. 호출되면 다음 단계를 수행한다.

module.[[AsyncParentModules]]의 각 Cyclic Module Record ancestorModule에 대해 다음을 수행합니다.
1. execList에 ancestorModule이 포함되어 있지 않고 ancestorModule.[[CycleRoot]].[[EvaluationError]]가 empty이면, 다음을 수행합니다.
  1. 단언: ancestorModule.[[Status]]는 evaluating-async입니다.
  2. 단언: ancestorModule.[[EvaluationError]]는 empty입니다.
  3. 단언: ancestorModule.[[AsyncEvaluationOrder]]는 정수입니다.
  4. 단언: ancestorModule.[[PendingAsyncDependencies]] > 0입니다.
  5. ancestorModule.[[PendingAsyncDependencies]]를 ancestorModule.[[PendingAsyncDependencies]] - 1로 설정합니다.
  6. ancestorModule.[[PendingAsyncDependencies]] = 0이면, 다음을 수행합니다.
    1. ancestorModule을 execList에 추가합니다.
    2. ancestorModule.[[HasTLA]]가 false이면 GatherAvailableAncestors(ancestorModule, execList)을 수행합니다.
unused를 반환합니다.

참고

루트 module의 비동기 실행이 이행되면 이 함수는 해당 완료에서 함께 동기적으로 실행할 수 있는 모듈 목록을 결정하여 execList에 채웁니다.

16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( `module` )

추상 연산 AsyncModuleExecutionFulfilled. 인수 module (Cyclic Module 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

module.[[Status]]가 evaluated이면, 다음을 수행합니다.
1. 단언: module.[[EvaluationError]]는 empty가 아닙니다.
2. unused를 반환합니다.
단언: module.[[Status]]는 evaluating-async입니다.
단언: module.[[AsyncEvaluationOrder]]는 정수입니다.
단언: module.[[EvaluationError]]는 empty입니다.
module.[[AsyncEvaluationOrder]]를 done으로 설정합니다.
module.[[Status]]를 evaluated로 설정합니다.
module.[[TopLevelCapability]]가 empty가 아니면, 다음을 수행합니다.
1. 단언: module.[[CycleRoot]]와 module은 동일한 Module Record입니다.
2. ! Call(module.[[TopLevelCapability]].[[Resolve]], undefined, « undefined »)를 수행합니다.
execList를 새로운 빈 List로 둡니다.
GatherAvailableAncestors(module, execList)을 수행합니다.
단언: execList의 모든 요소는 [[AsyncEvaluationOrder]] 필드가 정수이고 [[PendingAsyncDependencies]] 필드가 0이며 [[EvaluationError]] 필드가 empty입니다.
sortedExecList를 execList의 요소를 [[AsyncEvaluationOrder]] 필드에 따라 오름차순으로 정렬한 List로 둡니다.
sortedExecList의 각 Cyclic Module Record ancestorModule에 대해 다음을 수행합니다.
1. ancestorModule.[[Status]]가 evaluated이면, 다음을 수행합니다.
  1. 단언: ancestorModule.[[EvaluationError]]는 empty가 아닙니다.
2. 그렇지 않고 ancestorModule.[[HasTLA]]가 true이면, 다음을 수행합니다.
  1. ExecuteAsyncModule(ancestorModule)을 수행합니다.
3. 그렇지 않으면,
  1. result를 Completion(ancestorModule.ExecuteModule())으로 둡니다.
  2. result가 비정상 완료이면, 다음을 수행합니다.
    1. AsyncModuleExecutionRejected(ancestorModule, result.[[Value]])를 수행합니다.
  3. 그렇지 않으면,
    1. ancestorModule.[[AsyncEvaluationOrder]]를 done으로 설정합니다.
    2. ancestorModule.[[Status]]를 evaluated로 설정합니다.
    3. ancestorModule.[[TopLevelCapability]]가 empty가 아니면, 다음을 수행합니다.
      1. 단언: ancestorModule.[[CycleRoot]]와 ancestorModule은 동일한 Module Record입니다.
      2. ! Call(ancestorModule.[[TopLevelCapability]].[[Resolve]], undefined, « undefined »)를 수행합니다.
unused를 반환합니다.

16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( `module`, `error` )

추상 연산 AsyncModuleExecutionRejected. 인수 module (Cyclic Module 레코드) 및 error (ECMAScript 언어 값). 반환값: unused. 호출되면 다음 단계를 수행한다.

module.[[Status]]가 evaluated이면, 다음을 수행합니다.
1. 단언: module.[[EvaluationError]]는 empty가 아닙니다.
2. unused를 반환합니다.
단언: module.[[Status]]는 evaluating-async입니다.
단언: module.[[AsyncEvaluationOrder]]는 정수입니다.
단언: module.[[EvaluationError]]는 empty입니다.
module.[[EvaluationError]]를 ThrowCompletion(error)로 설정합니다.
module.[[Status]]를 evaluated로 설정합니다.
module.[[AsyncEvaluationOrder]]를 done으로 설정합니다.
참고: module.[[AsyncEvaluationOrder]]는 AsyncModuleExecutionFulfilled와 대칭을 이루기 위해 done으로 설정됩니다. InnerModuleEvaluation에서는 모듈의 [[EvaluationError]] 내부 슬롯이 empty가 아니면 해당 모듈의 [[AsyncEvaluationOrder]] 내부 슬롯 값은 사용되지 않습니다.
module.[[TopLevelCapability]]가 empty가 아니면, 다음을 수행합니다.
1. 단언: module.[[CycleRoot]]와 module은 동일한 Module Record입니다.
2. ! Call(module.[[TopLevelCapability]].[[Reject]], undefined, « error »)를 수행합니다.
module.[[AsyncParentModules]]의 각 Cyclic Module Record ancestorModule에 대해 다음을 수행합니다.
1. AsyncModuleExecutionRejected(ancestorModule, error)를 수행합니다.
unused를 반환합니다.

16.2.1.6.2 Cyclic Module Record 그래프 예제

이 비규범적 절에서는 오류가 어떻게 발생할 수 있는지에 특히 초점을 맞추어 몇 가지 일반적인 모듈 그래프의 연결 및 평가 예를 제시합니다.

먼저 다음의 단순한 모듈 그래프를 살펴보겠습니다:

모듈 A가 모듈 B에 의존하고 모듈 B가 모듈 C에 의존하는 모듈 그래프 — 그림 2: 단순한 모듈 그래프

먼저 오류 조건이 없다고 가정하겠습니다. 호스트가 처음 A.LoadRequestedModules()를 호출하면 가정에 따라 성공적으로 완료되고 B와 C의 종속성(각각 C와 없음)도 재귀적으로 로드한 다음 A.[[Status]] = B.[[Status]] = C.[[Status]] = unlinked로 설정합니다. 그런 다음 호스트가 A.Link()를 호출하면 역시 가정에 따라 성공적으로 완료되어 A.[[Status]] = B.[[Status]] = C.[[Status]] = linked가 됩니다. 이러한 준비 단계는 언제든 수행할 수 있습니다. 이후 호스트가 모듈의 가능한 부작용을 발생시킬 준비가 되면 A.Evaluate()를 호출할 수 있으며, 이는 성공적으로 완료되어 undefined로 resolve되는 Promise를 반환하고(역시 가정에 따라) 먼저 C, 그다음 B를 재귀적으로 평가합니다. 이 시점에서 각 모듈의 [[Status]]는 evaluated입니다.

그다음 A.LoadRequestedModules()를 성공적으로 호출한 이후 연결 오류가 발생하는 경우를 살펴보겠습니다. C의 InnerModuleLinking은 성공하지만 그 이후 B에서 실패하는 경우, 예를 들어 B가 C가 제공하지 않는 항목을 가져오려고 하면 원래의 A.Link()는 실패하고 A와 B의 [[Status]]는 모두 unlinked로 남습니다. 그러나 C의 [[Status]]는 linked가 됩니다.

마지막으로 Link()를 성공적으로 호출한 뒤 평가 오류가 발생하는 경우를 살펴보겠습니다. C의 InnerModuleEvaluation은 성공하지만 그 이후 B에서 실패하는 경우, 예를 들어 B에 예외를 던지는 코드가 포함되어 있으면 원래의 A.Evaluate()는 실패하여 reject된 Promise를 반환합니다. 그 결과 예외는 A와 B의 [[EvaluationError]] 필드 모두에 기록되고 [[Status]]는 evaluated가 됩니다. C도 evaluated가 되지만 A와 B와 달리 평가를 성공적으로 완료했으므로 [[EvaluationError]]는 없는 상태로 유지됩니다. 예외를 저장함으로써 호스트가 Evaluate() 메서드를 호출하여 A 또는 B를 다시 사용하려 할 때마다 동일한 예외를 만나도록 보장합니다. (호스트는 Cyclic Module Record를 반드시 재사용해야 하는 것은 아니며, 마찬가지로 이러한 메서드가 던진 예외 객체를 노출해야 할 의무도 없습니다. 그러나 이 명세는 그러한 사용을 가능하게 합니다.)

이제 다른 종류의 오류 조건을 살펴보겠습니다:

모듈 A가 누락된(해석할 수 없는) 모듈에 의존하며 해당 모듈을 ???로 나타낸 모듈 그래프 — 그림 3: 해석할 수 없는 모듈이 있는 모듈 그래프

이 시나리오에서는 모듈 A가 다른 어떤 모듈에 대한 종속성을 선언하지만 해당 모듈에 대한 Module Record가 존재하지 않습니다. 즉, HostLoadImportedModule이 해당 모듈을 요청받았을 때 예외와 함께 FinishLoadingImportedModule을 호출합니다. 이는 대응 리소스가 존재하지 않거나 리소스는 존재하지만 결과 소스 텍스트를 파싱하려 할 때 ParseModule이 몇 가지 오류를 반환하는 등 여러 이유로 발생할 수 있습니다. 호스트는 FinishLoadingImportedModule에 전달하는 완료를 통해 실패 원인을 노출하도록 선택할 수 있습니다. 어떤 경우든 이 예외로 인해 로딩이 실패하며 A의 [[Status]]는 new 상태로 유지됩니다.

여기서 로딩, 연결 및 평가 오류가 서로 다른 이유는 다음 특성 때문입니다:

평가는 부작용을 일으킬 수 있으므로 한 번만 수행해야 합니다. 따라서 실패했더라도 평가가 이미 수행되었는지 기억하는 것이 중요합니다. (오류의 경우 예외도 기억하는 것이 타당합니다. 그렇지 않으면 이후 Evaluate() 호출 때마다 새 예외를 합성해야 하기 때문입니다.)
반면 연결에는 부작용이 없으므로 실패하더라도 나중에 문제없이 다시 시도할 수 있습니다.
로딩은 호스트와 밀접하게 상호작용하며, 일부 호스트에서는 사용자가 실패한 로드를 다시 시도하도록 허용하는 것이 바람직할 수 있습니다(예: 일시적인 네트워크 상태 불량으로 실패한 경우).

이제 순환이 있는 모듈 그래프를 살펴보겠습니다:

모듈 A가 모듈 B와 C에 의존하지만 모듈 B도 모듈 A에 의존하는 모듈 그래프 — 그림 4: 순환 모듈 그래프

여기서는 진입점이 모듈 A라고 가정하므로 호스트는 A.LoadRequestedModules()를 호출하여 진행하며, 이는 A에 InnerModuleLoading을 수행합니다. 이어서 B와 C에 InnerModuleLoading을 호출합니다. 순환 때문에 A에 InnerModuleLoading이 다시 호출되지만, 이 시점에는 이 LoadRequestedModules 과정에서 A의 종속성 로딩이 이미 시작되었으므로 아무 작업도 하지 않습니다. 그래프의 모든 모듈이 성공적으로 로드되면 해당 [[Status]]는 동시에 new에서 unlinked로 전이합니다.

그다음 호스트는 A.Link()를 호출하며, 이는 A에 InnerModuleLinking을 수행합니다. 이어서 B에 InnerModuleLinking을 호출합니다. 순환 때문에 A에 InnerModuleLinking이 다시 호출되지만 이 시점에는 A.[[Status]]가 이미 linking이므로 아무 작업도 하지 않습니다. 제어가 A로 돌아오고 C에 InnerModuleLinking이 시작될 때 B.[[Status]] 자체는 계속 linking 상태입니다. 이 호출이 C.[[Status]]가 linked인 상태로 반환된 후 A와 B는 함께 linking에서 linked로 전이합니다. 이들이 하나의 강연결 요소를 형성하므로 이는 의도된 동작입니다. 이 단계에서 모듈 그래프는 깊이 우선 탐색으로 순회되므로 동일한 SCC에 있는 모듈의 상태를 동시에 전이할 수 있습니다.

성공하는 경우 순환 모듈 그래프의 평가 단계에서도 이와 유사한 과정이 발생합니다.

이제 A에 연결 오류가 있는 경우를 생각해 보겠습니다. 예를 들어 A가 C에 존재하지 않는 바인딩을 가져오려고 할 수 있습니다. 이 경우 A에 대한 두 번째 InnerModuleLinking 호출에서 조기 반환되는 것을 포함하여 위 단계는 여전히 발생합니다. 그러나 원래의 A에 대한 InnerModuleLinking으로 되돌아오면 InitializeEnvironment 중, 정확히는 C.ResolveExport() 직후에 실패합니다. 던져진 SyntaxError 예외는 A.Link까지 전파되며, A.Link는 현재 자신의 stack에 있는 모든 모듈(항상 아직 linking 상태인 모듈과 정확히 같습니다)을 재설정합니다. 따라서 A와 B는 모두 unlinked가 됩니다. C는 linked 상태로 남는다는 점에 유의하시기 바랍니다.

또는 A에 평가 오류가 있는 경우를 생각해 보겠습니다. 예를 들어 소스 코드가 예외를 던질 수 있습니다. 이 경우 A에 대한 두 번째 InnerModuleEvaluation 호출에서 조기 반환되는 것을 포함하여 위 단계에 대응하는 평가 시점의 과정이 여전히 발생합니다. 그러나 원래의 A에 대한 InnerModuleEvaluation으로 되돌아오면 가정대로 실패합니다. 던져진 예외는 A.Evaluate()까지 전파되며, A.Evaluate()는 현재 자신의 stack에 있는 모든 모듈(즉, 여전히 evaluating 상태인 모듈)과 [[AsyncParentModules]]를 통해 오류를 기록합니다. [[AsyncParentModules]]는 AsyncModuleExecutionRejected 알고리즘을 통해 전체 종속성 그래프에서 최상위 await를 포함하거나 이에 의존하는 모듈의 체인을 형성합니다. 따라서 A와 B는 모두 evaluated가 되고 예외는 A와 B의 [[EvaluationError]] 필드 모두에 기록되는 반면, C는 [[EvaluationError]] 없이 evaluated 상태로 남습니다.

마지막으로 모든 모듈이 비동기적으로 완료되는 순환 모듈 그래프를 살펴보겠습니다:

모듈 A가 모듈 B와 C에 의존하고, 모듈 B는 모듈 D에 의존하며, 모듈 C는 모듈 D와 E에 의존하고, 모듈 D는 모듈 A에 의존하는 모듈 그래프 — 그림 5: 비동기 순환 모듈 그래프

로딩과 연결은 이전과 동일하게 진행되며 모든 모듈은 [[Status]]가 linked로 설정된 상태가 됩니다.

A.Evaluate()를 호출하면 A, B, D에 InnerModuleEvaluation이 호출되고 이들은 모두 evaluating으로 전이합니다. 그런 다음 A에 InnerModuleEvaluation이 다시 호출되지만 이미 evaluating 상태이므로 아무 작업도 하지 않습니다. 이 시점에서 D.[[PendingAsyncDependencies]]는 0이므로 ExecuteAsyncModule(D)이 호출되고 D의 비동기 실행을 추적하는 새로운 PromiseCapability과 함께 D.ExecuteModule을 호출합니다. B에 대한 InnerModuleEvaluation으로 되돌아가면서 B.[[PendingAsyncDependencies]]를 1로, B.[[AsyncEvaluationOrder]]를 1로 설정합니다. 원래의 A에 대한 InnerModuleEvaluation으로 되돌아가면서 A.[[PendingAsyncDependencies]]를 1로 설정합니다. A의 종속성을 순회하는 다음 반복에서 C에 InnerModuleEvaluation을 호출하고, 따라서 D(다시 아무 작업도 하지 않음)와 E에도 호출합니다. E는 종속성이 없고 순환의 일부도 아니므로 D와 같은 방식으로 ExecuteAsyncModule(E)을 호출하고 E는 즉시 스택에서 제거됩니다. 다시 C에 대한 InnerModuleEvaluation으로 되돌아가 C.[[AsyncEvaluationOrder]]를 3으로 설정합니다. 이제 A의 종속성 순회를 끝내고 A.[[AsyncEvaluationOrder]]를 4로 설정한 다음 전체 강연결 요소를 스택에서 제거하여 모든 모듈을 한꺼번에 evaluating-async로 전이합니다. 이 시점의 모듈 필드는 표 44과 같습니다.

표 44: 초기 Evaluate() 호출 후의 모듈 필드

필드 모듈	`A`	`B`	`C`	`D`	`E`
`[[DFSAncestorIndex]]`	0	0	0	0	4
`[[Status]]`	evaluating-async	evaluating-async	evaluating-async	evaluating-async	evaluating-async
`[[AsyncEvaluationOrder]]`	4	1	3	0	2
`[[AsyncParentModules]]`	« »	« `A` »	« `A` »	« `B`, `C` »	« `C` »
`[[PendingAsyncDependencies]]`	2 (`B` and `C`)	1 (`D`)	2 (`D` and `E`)	0	0

E가 먼저 실행을 끝낸다고 가정하겠습니다. 이때 AsyncModuleExecutionFulfilled가 호출되고 E.[[Status]]는 evaluated로 설정되며 C.[[PendingAsyncDependencies]]는 1로 감소합니다. 갱신된 모듈 필드는 표 45와 같습니다.

표 45: 모듈 E의 실행이 끝난 후의 모듈 필드

필드 모듈	`C`	`E`
`[[DFSAncestorIndex]]`	0	4
`[[Status]]`	evaluating-async	evaluated
`[[AsyncEvaluationOrder]]`	3	done
`[[AsyncParentModules]]`	« `A` »	« `C` »
`[[PendingAsyncDependencies]]`	1 (`D`)	0

다음으로 D가 실행을 끝냅니다(여전히 실행 중인 유일한 모듈이었습니다). 이때 AsyncModuleExecutionFulfilled가 다시 호출되고 D.[[Status]]는 evaluated로 설정됩니다. 실행할 수 있는 조상은 B([[AsyncEvaluationOrder]]가 1)와 C([[AsyncEvaluationOrder]]가 3)이므로 B가 먼저 처리됩니다. B.[[PendingAsyncDependencies]]는 0으로 감소하고 ExecuteAsyncModule이 B에 호출되어 실행을 시작합니다. C.[[PendingAsyncDependencies]]도 0으로 감소하고 C도 실행을 시작합니다(B에 await가 포함되어 있다면 B와 병렬로 실행될 수 있습니다). 갱신된 모듈 필드는 표 46과 같습니다.

표 46: 모듈 D의 실행이 끝난 후의 모듈 필드

필드 모듈	`B`	`C`	`D`
`[[DFSAncestorIndex]]`	0	0	0
`[[Status]]`	evaluating-async	evaluating-async	evaluated
`[[AsyncEvaluationOrder]]`	1	3	done
`[[AsyncParentModules]]`	« `A` »	« `A` »	« `B`, `C` »
`[[PendingAsyncDependencies]]`	0	0	0

다음으로 C가 실행을 끝낸다고 가정하겠습니다. 이때 AsyncModuleExecutionFulfilled가 다시 호출되고 C.[[Status]]는 evaluated로 설정되며 A.[[PendingAsyncDependencies]]는 1로 감소합니다. 갱신된 모듈 필드는 표 47와 같습니다.

표 47: 모듈 C의 실행이 끝난 후의 모듈 필드

필드 모듈	`A`	`C`
`[[DFSAncestorIndex]]`	0	0
`[[Status]]`	evaluating-async	evaluated
`[[AsyncEvaluationOrder]]`	4	done
`[[AsyncParentModules]]`	« »	« `A` »
`[[PendingAsyncDependencies]]`	1 (`B`)	0

그다음 B가 실행을 끝냅니다. 이때 AsyncModuleExecutionFulfilled가 다시 호출되고 B.[[Status]]는 evaluated로 설정됩니다. A.[[PendingAsyncDependencies]]는 0으로 감소하므로 ExecuteAsyncModule이 호출되어 실행을 시작합니다. 갱신된 모듈 필드는 표 48와 같습니다.

표 48: 모듈 B의 실행이 끝난 후의 모듈 필드

필드 모듈	`A`	`B`
`[[DFSAncestorIndex]]`	0	0
`[[Status]]`	evaluating-async	evaluated
`[[AsyncEvaluationOrder]]`	4	done
`[[AsyncParentModules]]`	« »	« `A` »
`[[PendingAsyncDependencies]]`	0	0

마지막으로 A가 실행을 끝냅니다. 이때 AsyncModuleExecutionFulfilled가 다시 호출되고 A.[[Status]]는 evaluated로 설정됩니다. 이 시점에서 A.[[TopLevelCapability]]의 Promise(A.Evaluate()가 반환했던 Promise)가 resolve되며 이 모듈 그래프의 처리가 끝납니다. 갱신된 모듈 필드는 표 49과 같습니다.

표 49: 모듈 A의 실행이 끝난 후의 모듈 필드

필드 모듈	`A`
`[[DFSAncestorIndex]]`	0
`[[Status]]`	evaluated
`[[AsyncEvaluationOrder]]`	done
`[[AsyncParentModules]]`	« »
`[[PendingAsyncDependencies]]`	0

또는 B가 실행을 끝내기 전에 C의 실행이 실패하여 오류를 반환하는 실패 사례를 생각해 보겠습니다. 이때 AsyncModuleExecutionRejected가 호출되고 C.[[Status]]는 evaluated로, C.[[EvaluationError]]는 해당 오류로 설정됩니다. 그런 다음 각 AsyncParentModules에 AsyncModuleExecutionRejected를 수행하여 이 오류를 모든 AsyncParentModules에 전파합니다. 갱신된 모듈 필드는 표 50과 같습니다.

표 50: 모듈 C가 오류와 함께 완료된 후의 모듈 필드

필드 모듈	`A`	`C`
`[[DFSAncestorIndex]]`	0	0
`[[Status]]`	evaluated	evaluated
`[[AsyncEvaluationOrder]]`	done	done
`[[AsyncParentModules]]`	« »	« `A` »
`[[PendingAsyncDependencies]]`	1 (`B`)	0
`[[EvaluationError]]`	empty	`C`'s evaluation error

C가 C의 오류를 사용하여 A에 AsyncModuleExecutionRejected를 호출하므로 A는 C와 동일한 오류로 reject됩니다. A.[[Status]]는 evaluated로 설정됩니다. 이 시점에서 A.[[TopLevelCapability]]의 Promise(A.Evaluate()가 반환했던 Promise)는 reject됩니다. 갱신된 모듈 필드는 표 51과 같습니다.

표 51: 모듈 A가 reject된 후의 모듈 필드

필드 모듈	`A`
`[[DFSAncestorIndex]]`	0
`[[Status]]`	evaluated
`[[AsyncEvaluationOrder]]`	done
`[[AsyncParentModules]]`	« »
`[[PendingAsyncDependencies]]`	0
`[[EvaluationError]]`	`C`'s Evaluation Error

그다음 B가 오류 없이 실행을 끝냅니다. 이때 AsyncModuleExecutionFulfilled가 다시 호출되고 B.[[Status]]는 evaluated로 설정됩니다. B에 GatherAvailableAncestors가 호출됩니다. 그러나 A.[[CycleRoot]]는 A이며 평가 오류를 갖고 있으므로 반환되는 sortedExecList에는 추가되지 않고 AsyncModuleExecutionFulfilled는 추가 처리 없이 반환합니다. 이후 B를 가져오는 모든 importer는 순환 루트 A에 설정된 C의 평가 오류에서 B.[[CycleRoot]].[[EvaluationError]]의 rejection을 해석합니다. 갱신된 모듈 필드는 표 52와 같습니다.

표 52: 오류가 발생하는 그래프에서 모듈 B의 실행이 끝난 후의 모듈 필드

필드 모듈	`A`	`B`
`[[DFSAncestorIndex]]`	0	0
`[[Status]]`	evaluated	evaluated
`[[AsyncEvaluationOrder]]`	4	1
`[[AsyncParentModules]]`	« »	« `A` »
`[[PendingAsyncDependencies]]`	0	0
`[[EvaluationError]]`	`C`'s Evaluation Error	empty

16.2.1.7 Source Text Module Record

Source Text Module Record는 목표 기호 Module을 사용하여 파싱한 ECMAScript 소스 텍스트(11)로 정의된 모듈에 관한 정보를 나타내는 데 사용됩니다. 그 필드에는 모듈이 가져오고 내보내는 이름에 관한 요약 정보가 포함되며, 구체 메서드는 이러한 요약 정보를 사용하여 모듈을 연결하고 평가합니다.

Source Text Module Record는 추상 Module Record 타입의 다른 하위 클래스와 함께 모듈 그래프에 존재할 수 있으며 Cyclic Module Record 타입의 다른 하위 클래스와 순환에 참여할 수 있습니다.

표 41에 정의된 필드 외에도 Source Text Module Record에는 표 53에 나열된 추가 필드가 있습니다. 이러한 각 필드는 처음 ParseModule에서 설정됩니다.

표 53: Source Text Module Record의 추가 필드

필드 이름	값 타입	의미
`[[ECMAScriptCode]]`	a Parse Node	Module을 목표 기호로 사용하여 이 모듈의 소스 텍스트를 파싱한 결과입니다.
`[[Context]]`	an ECMAScript code execution context or empty	이 모듈과 연결된 실행 컨텍스트입니다. 모듈의 환경이 초기화될 때까지 empty입니다.
`[[ImportMeta]]`	an Object or empty	`import.meta` 메타 프로퍼티를 통해 노출되는 객체입니다. ECMAScript 코드가 접근할 때까지 empty입니다.
`[[ImportEntries]]`	a List of ImportEntry Records	이 모듈의 코드에서 파생된 ImportEntry Record의 List입니다.
`[[LocalExportEntries]]`	a List of ExportEntry Records	이 모듈 안에서 발생하는 선언에 대응하는, 이 모듈의 코드에서 파생된 ExportEntry Record의 List입니다.
`[[IndirectExportEntries]]`	a List of ExportEntry Records	이 모듈 안에서 다시 내보내는 import 또는 `export * as namespace` 선언의 export에 대응하는, 이 모듈의 코드에서 파생된 ExportEntry Record의 List입니다.
`[[StarExportEntries]]`	a List of ExportEntry Records	이 모듈 안의 `export ` 선언에 대응하는, 이 모듈의 코드에서 파생된 ExportEntry Record의 List입니다. `export as namespace` 선언은 포함하지 않습니다.

ImportEntry Record는 하나의 선언적 import에 관한 정보를 요약하는 Record입니다. 각 ImportEntry Record에는 표 54에 정의된 필드가 있습니다:

표 54: ImportEntry Record 필드

필드 이름	값 타입	의미
`[[ModuleRequest]]`	a ModuleRequest Record	ImportDeclaration의 ModuleSpecifier 및 import 속성을 나타내는 ModuleRequest Record입니다.
`[[ImportName]]`	a String or namespace	`[[ModuleRequest]]`가 식별하는 모듈에서 원하는 바인딩이 내보내지는 이름입니다. 값 namespace는 import 요청이 대상 모듈의 네임스페이스 객체에 대한 것임을 나타냅니다.
`[[LocalName]]`	a String	가져오는 모듈 안에서 가져온 값에 로컬로 접근하는 데 사용하는 이름입니다.

참고 1

표 55는 구문적 import 형식을 나타내는 데 사용되는 ImportEntry Record 필드의 예를 제공합니다:

표 55 (참고): Import 형식과 ImportEntry Record의 대응

Import 문 형식	`[[ModuleRequest]]`	`[[ImportName]]`	`[[LocalName]]`
`import v from "mod";`	"mod"	"default"	"v"
`import * as ns from "mod";`	"mod"	namespace	"ns"
`import {x} from "mod";`	"mod"	"x"	"x"
`import {x as v} from "mod";`	"mod"	"x"	"v"
`import "mod";`	ImportEntry Record는 생성되지 않습니다.

ExportEntry Record는 하나의 선언적 export에 관한 정보를 요약하는 Record입니다. 각 ExportEntry Record에는 표 56에 정의된 필드가 있습니다:

표 56: ExportEntry Record 필드

필드 이름	값 타입	의미
`[[ExportName]]`	a String or null	이 모듈이 이 바인딩을 내보내는 데 사용하는 이름입니다.
`[[ModuleRequest]]`	a ModuleRequest Record or null	ExportDeclaration의 ModuleSpecifier 및 import 속성을 나타내는 ModuleRequest Record입니다. ExportDeclaration에 ModuleSpecifier가 없으면 null입니다.
`[[ImportName]]`	a String, null, namespace, or all-but-default	`[[ModuleRequest]]`가 식별하는 모듈에서 원하는 바인딩이 내보내지는 이름입니다. ExportDeclaration에 ModuleSpecifier가 없으면 null입니다. namespace는 `export * as ns from "mod"` 선언에 사용됩니다. all-but-default는 `export * from "mod"` 선언에 사용됩니다.
`[[LocalName]]`	a String or null	모듈 안에서 내보낸 값에 로컬로 접근하는 데 사용하는 이름입니다. 모듈 안에서 내보낸 값에 로컬로 접근할 수 없으면 null입니다.

참고 2

표 57는 구문적 export 형식을 나타내는 데 사용되는 ExportEntry Record 필드의 예를 제공합니다:

표 57 (참고): Export 형식과 ExportEntry Record의 대응

Export 문 형식	`[[ExportName]]`	`[[ModuleRequest]]`	`[[ImportName]]`	`[[LocalName]]`
`export var v;`	"v"	null	null	"v"
`export default function f() {}`	"default"	null	null	"f"
`export default function () {}`	"default"	null	null	"default"
`export default 42;`	"default"	null	null	"default"
`export {x};`	"x"	null	null	"x"
`export {v as x};`	"x"	null	null	"v"
`export {x} from "mod";`	"x"	"mod"	"x"	null
`export {v as x} from "mod";`	"x"	"mod"	"v"	null
`export * from "mod";`	null	"mod"	all-but-default	null
`export * as ns from "mod";`	"ns"	"mod"	namespace	null

다음 정의는 Source Text Module Record에 필요한 구체 메서드와 그 밖의 추상 연산을 명시합니다.

16.2.1.7.1 ParseModule ( `sourceText`, `realm`, `hostDefined` )

추상 연산 ParseModule. 인수 sourceText ((String 또는 a sequence of Unicode code points)), realm (Realm 레코드) 및 hostDefined (임의의 값). 반환값: (Source Text Module 레코드 또는 a non-empty List of SyntaxError objects). sourceText를 Module로 파싱한 결과를 기반으로 Source Text Module Record를 생성합니다. 호출되면 다음 단계를 수행한다.

body를 ParseText(sourceText, Module)로 둡니다.
body가 오류의 List이면 body를 반환합니다.
requestedModules를 body의 ModuleRequests로 둡니다.
importEntries를 body의 ImportEntries로 둡니다.
importedBoundNames를 ImportedLocalNames(importEntries)로 둡니다.
indirectExportEntries를 새로운 빈 List로 둡니다.
localExportEntries를 새로운 빈 List로 둡니다.
starExportEntries를 새로운 빈 List로 둡니다.
exportEntries를 body의 ExportEntries로 둡니다.
exportEntries의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. exportEntry.[[ModuleRequest]]가 null이면, 다음을 수행합니다.
  1. importedBoundNames에 exportEntry.[[LocalName]]이 포함되어 있지 않으면, 다음을 수행합니다.
    1. exportEntry를 localExportEntries에 추가합니다.
  2. 그렇지 않으면,
    1. 참고: 원래 다른 모듈에서 가져온 바인딩 또는 네임스페이스 객체를 내보낼 때 ExportEntry Record는 바인딩 또는 네임스페이스 객체를 가져온 뒤 내보낸 것이 아니라 원래 모듈에서 직접 다시 내보냈다면 갖게 되었을 형식과 일치하도록 다시 작성됩니다. 이를 통해 export * from을 통해 동일한 이름으로 같은 바인딩 또는 네임스페이스를 두 번 내보내 발생하는 충돌을 Source Text Module Record의 ResolveExport 구체 메서드의 9.e.iii 단계에서 모호한 것으로 취급하지 않고 무시할 수 있습니다.
    2. importEntry를 [[LocalName]]이 exportEntry.[[LocalName]]인 importEntries의 요소로 둡니다.
    3. ExportEntry Record { [[ModuleRequest]]: importEntry.[[ModuleRequest]], [[ImportName]]: importEntry.[[ImportName]], [[LocalName]]: null, [[ExportName]]: exportEntry.[[ExportName]] }를 indirectExportEntries에 추가합니다.
2. 그렇지 않고 exportEntry.[[ImportName]]이 all-but-default이면, 다음을 수행합니다.
  1. 단언: exportEntry.[[ExportName]]은 null입니다.
  2. exportEntry를 starExportEntries에 추가합니다.
3. 그렇지 않으면,
  1. exportEntry를 indirectExportEntries에 추가합니다.
async를 body Contains await로 둡니다.
Source Text Module Record { [[Realm]]: realm, [[Environment]]: empty, [[Namespace]]: empty, [[CycleRoot]]: empty, [[HasTLA]]: async, [[AsyncEvaluationOrder]]: unset, [[TopLevelCapability]]: empty, [[AsyncParentModules]]: « », [[PendingAsyncDependencies]]: empty, [[Status]]: new, [[EvaluationError]]: empty, [[HostDefined]]: hostDefined, [[ECMAScriptCode]]: body, [[Context]]: empty, [[ImportMeta]]: empty, [[RequestedModules]]: requestedModules, [[LoadedModules]]: « », [[ImportEntries]]: importEntries, [[LocalExportEntries]]: localExportEntries, [[IndirectExportEntries]]: indirectExportEntries, [[StarExportEntries]]: starExportEntries, [[DFSAncestorIndex]]: empty }를 반환합니다.

참고

구현체는 해당 모듈 소스 텍스트에 ParseModule을 평가하기 전에 모듈 소스 텍스트를 파싱하고 조기 오류 조건을 분석할 수 있습니다. 그러나 오류 보고는 이 명세가 실제로 해당 소스 텍스트에 ParseModule을 수행하는 시점까지 지연되어야 합니다.

16.2.1.7.2 Module Record 추상 메서드의 구현

다음은 표 40에 정의된 대응 Module Record 추상 메서드를 구현하는 Source Text Module Record의 구체 메서드입니다.

16.2.1.7.2.1 GetExportedNames ( [ `exportStarSet` ] )

a Source Text Module Record module의 구체 메서드 GetExportedNames. 선택적 인수 exportStarSet (리스트 (요소: Source Text Module 레코드)). 반환값: 리스트 (요소: String). 호출되면 다음 단계를 수행한다.

단언: module.[[Status]]는 new가 아닙니다.
exportStarSet이 존재하지 않으면 exportStarSet을 새로운 빈 List로 설정합니다.
exportStarSet에 module이 포함되어 있으면, 다음을 수행합니다.
1. 단언: export * 순환의 시작점에 도달했습니다.
2. 새로운 빈 List를 반환합니다.
module을 exportStarSet에 추가합니다.
exportedNames를 새로운 빈 List로 둡니다.
module.[[LocalExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. 단언: module은 이 export에 대한 직접 바인딩을 제공합니다.
2. 단언: exportEntry.[[ExportName]]은 null이 아닙니다.
3. exportEntry.[[ExportName]]을 exportedNames에 추가합니다.
module.[[IndirectExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. 단언: module은 이 export를 위해 특정 바인딩을 가져옵니다.
2. 단언: exportEntry.[[ExportName]]은 null이 아닙니다.
3. exportEntry.[[ExportName]]을 exportedNames에 추가합니다.
module.[[StarExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. 단언: exportEntry.[[ModuleRequest]]는 null이 아닙니다.
2. requestedModule을 GetImportedModule(module, exportEntry.[[ModuleRequest]])로 둡니다.
3. starNames를 requestedModule.GetExportedNames(exportStarSet)로 둡니다.
4. starNames의 각 요소 name에 대해 다음을 수행합니다.
  1. name이 "default"가 아니면, 다음을 수행합니다.
    1. exportedNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
      1. name을 exportedNames에 추가합니다.
exportedNames를 반환합니다.

참고

GetExportedNames는 모호한 star export 바인딩을 가진 이름을 걸러내거나 이에 대해 예외를 던지지 않습니다.

16.2.1.7.2.2 ResolveExport ( `exportName` [ , `resolveSet` ] )

a Source Text Module Record module의 구체 메서드 ResolveExport. 인수 exportName (String) 및 선택적 인수 resolveSet (리스트 (요소: 레코드 (필드: [[Module]] (Module 레코드), [[ExportName]] (String)))). 반환값: (ResolvedBinding 레코드, null 또는 ambiguous).

ResolveExport는 가져온 바인딩을 실제 정의 모듈 및 로컬 바인딩 이름으로 해석하려고 합니다. 정의 모듈은 이 메서드를 호출한 Module Record가 나타내는 모듈일 수도 있고, 해당 모듈이 가져오는 다른 모듈일 수도 있습니다. 매개변수 resolveSet은 해석되지 않은 순환 import/export 경로를 검출하는 데 사용됩니다. 이미 resolveSet에 있는 특정 Module Record와 exportName으로 구성된 쌍에 도달하면 import 순환이 발생한 것입니다. ResolveExport를 재귀적으로 호출하기 전에 module과 exportName으로 구성된 쌍을 resolveSet에 추가합니다.

정의 모듈을 찾으면 ResolvedBinding Record { [[Module]], [[BindingName]] }을 반환합니다. 이 Record는 로컬 바인딩이 없는 네임스페이스 export인 경우를 제외하고 원래 요청한 export의 해석된 바인딩을 식별합니다. 이 경우 [[BindingName]]은 namespace로 설정됩니다. 정의를 찾지 못했거나 요청이 순환인 것으로 확인되면 null을 반환합니다. 요청이 모호한 것으로 확인되면 ambiguous를 반환합니다.

호출되면 다음 단계를 수행한다.

단언: module.[[Status]]는 new가 아닙니다.
resolveSet이 존재하지 않으면 resolveSet을 새로운 빈 List로 설정합니다.
resolveSet의 각 Record { [[Module]], [[ExportName]] } record에 대해 다음을 수행합니다.
1. module과 record.[[Module]]이 동일한 Module Record이고 exportName이 record.[[ExportName]]과 같으면, 다음을 수행합니다.
  1. 단언: 이는 순환 import 요청입니다.
  2. null을 반환합니다.
Record { [[Module]]: module, [[ExportName]]: exportName }을 resolveSet에 추가합니다.
module.[[LocalExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. exportEntry.[[ExportName]]이 exportName과 같으면, 다음을 수행합니다.
  1. 단언: module은 이 export에 대한 직접 바인딩을 제공합니다.
  2. ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportEntry.[[LocalName]] }을 반환합니다.
module.[[IndirectExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. exportEntry.[[ExportName]]이 exportName과 같으면, 다음을 수행합니다.
  1. 단언: exportEntry.[[ModuleRequest]]는 null이 아닙니다.
  2. importedModule을 GetImportedModule(module, exportEntry.[[ModuleRequest]])로 둡니다.
  3. exportEntry.[[ImportName]]이 namespace이면, 다음을 수행합니다.
    1. 단언: module은 이 export에 대한 직접 바인딩을 제공하지 않습니다.
    2. ResolvedBinding Record { [[Module]]: importedModule, [[BindingName]]: namespace }을 반환합니다.
  4. 단언: module은 이 export를 위해 특정 바인딩을 가져옵니다.
  5. 단언: exportEntry.[[ImportName]]은 String입니다.
  6. importedModule.ResolveExport(exportEntry.[[ImportName]], resolveSet)를 반환합니다.
exportName이 "default"이면, 다음을 수행합니다.
1. 단언: 이 모듈은 default export를 명시적으로 정의하지 않았습니다.
2. null을 반환합니다.
3. 참고: default export는 export * from "mod" 선언에서 제공할 수 없습니다.
starResolution을 null로 둡니다.
module.[[StarExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. 단언: exportEntry.[[ModuleRequest]]는 null이 아닙니다.
2. importedModule을 GetImportedModule(module, exportEntry.[[ModuleRequest]])로 둡니다.
3. resolution을 importedModule.ResolveExport(exportName, resolveSet)로 둡니다.
4. resolution이 ambiguous이면 ambiguous를 반환합니다.
5. resolution이 null이 아니면, 다음을 수행합니다.
  1. 단언: resolution은 ResolvedBinding Record입니다.
  2. starResolution이 null이면, 다음을 수행합니다.
    1. starResolution을 resolution으로 설정합니다.
  3. 그렇지 않으면,
    1. 단언: 요청한 이름을 포함하는 * export가 둘 이상 있습니다.
    2. resolution.[[Module]]과 starResolution.[[Module]]이 동일한 Module Record가 아니면 ambiguous를 반환합니다.
    3. resolution.[[BindingName]]이 starResolution.[[BindingName]]과 같지 않으면 ambiguous를 반환합니다.
starResolution을 반환합니다.

16.2.1.7.3 Cyclic Module Record 추상 메서드의 구현

다음은 표 42에 정의된 대응 Cyclic Module Record 추상 메서드를 구현하는 Source Text Module Record의 구체 메서드입니다.

16.2.1.7.3.1 InitializeEnvironment ( )

a Source Text Module Record module의 구체 메서드 InitializeEnvironment. 인수 없음. 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

module.[[IndirectExportEntries]]의 각 ExportEntry Record exportEntry에 대해 다음을 수행합니다.
1. 단언: exportEntry.[[ExportName]]은 null이 아닙니다.
2. resolution을 module.ResolveExport(exportEntry.[[ExportName]])로 둡니다.
3. resolution이 null 또는 ambiguous 중 하나이면 SyntaxError 예외를 던집니다.
4. 단언: resolution은 ResolvedBinding Record입니다.
단언: module의 모든 이름 있는 export는 해석 가능합니다.
realm을 module.[[Realm]]으로 둡니다.
단언: realm은 undefined가 아닙니다.
envRecord를 NewModuleEnvironment(realm.[[GlobalEnv]])로 둡니다.
module.[[Environment]]를 envRecord로 설정합니다.
module.[[ImportEntries]]의 각 ImportEntry Record importEntry에 대해 다음을 수행합니다.
1. importedModule을 GetImportedModule(module, importEntry.[[ModuleRequest]])로 둡니다.
2. importEntry.[[ImportName]]이 namespace이면, 다음을 수행합니다.
  1. namespace를 GetModuleNamespace(importedModule)로 둡니다.
  2. ! envRecord.CreateImmutableBinding(importEntry.[[LocalName]], true)를 수행합니다.
  3. ! envRecord.InitializeBinding(importEntry.[[LocalName]], namespace)를 수행합니다.
3. 그렇지 않으면,
  1. 단언: importEntry.[[ImportName]]은 String입니다.
  2. resolution을 importedModule.ResolveExport(importEntry.[[ImportName]])로 둡니다.
  3. resolution이 null 또는 ambiguous 중 하나이면 SyntaxError 예외를 던집니다.
  4. resolution.[[BindingName]]이 namespace이면, 다음을 수행합니다.
    1. namespace를 GetModuleNamespace(resolution.[[Module]])로 둡니다.
    2. ! envRecord.CreateImmutableBinding(importEntry.[[LocalName]], true)를 수행합니다.
    3. ! envRecord.InitializeBinding(importEntry.[[LocalName]], namespace)를 수행합니다.
  5. 그렇지 않으면,
    1. CreateImportBinding(envRecord, importEntry.[[LocalName]], resolution.[[Module]], resolution.[[BindingName]])을 수행합니다.
moduleContext를 새로운 ECMAScript 코드 실행 컨텍스트로 둡니다.
moduleContext의 Function을 null로 설정합니다.
단언: module.[[Realm]]은 undefined가 아닙니다.
moduleContext의 Realm을 module.[[Realm]]으로 설정합니다.
moduleContext의 ScriptOrModule을 module로 설정합니다.
moduleContext의 VariableEnvironment를 module.[[Environment]]로 설정합니다.
moduleContext의 LexicalEnvironment를 module.[[Environment]]로 설정합니다.
moduleContext의 PrivateEnvironment를 null로 설정합니다.
module.[[Context]]를 moduleContext로 설정합니다.
moduleContext를 실행 컨텍스트 스택에 푸시합니다. 이제 moduleContext가 실행 중인 실행 컨텍스트입니다.
code를 module.[[ECMAScriptCode]]로 둡니다.
variableDecls를 code의 VarScopedDeclarations로 둡니다.
declaredVariableNames를 새로운 빈 List로 둡니다.
variableDecls의 각 요소 variableDecl에 대해 다음을 수행합니다.
1. variableDecl의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
  1. declaredVariableNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
    1. ! envRecord.CreateMutableBinding(name, false)를 수행합니다.
    2. ! envRecord.InitializeBinding(name, undefined)를 수행합니다.
    3. name을 declaredVariableNames에 추가합니다.
lexicalDecls를 code의 LexicallyScopedDeclarations로 둡니다.
privateEnv를 null로 둡니다.
lexicalDecls의 각 요소 lexicalDecl에 대해 다음을 수행합니다.
1. lexicalDecl의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
  1. lexicalDecl의 IsConstantDeclaration이 true이면, 다음을 수행합니다.
    1. ! envRecord.CreateImmutableBinding(name, true)를 수행합니다.
  2. 그렇지 않으면,
    1. ! envRecord.CreateMutableBinding(name, false)를 수행합니다.
  3. lexicalDecl이 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration 또는 AsyncGeneratorDeclaration 중 하나이면, 다음을 수행합니다.
    1. funcObj를 인수 envRecord 및 privateEnv를 사용한 lexicalDecl의 InstantiateFunctionObject로 둡니다.
    2. ! envRecord.InitializeBinding(name, funcObj)를 수행합니다.
moduleContext를 실행 컨텍스트 스택에서 제거합니다.
unused를 반환합니다.

16.2.1.7.3.2 ExecuteModule ( [ `capability` ] )

a Source Text Module Record module의 구체 메서드 ExecuteModule. 선택적 인수 capability (PromiseCapability 레코드). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: module은 연결되었으며 해당 모듈 환경의 선언이 인스턴스화되어 있습니다.
moduleContext를 module.[[Context]]로 둡니다.
module.[[HasTLA]]가 false이면, 다음을 수행합니다.
1. 단언: capability은 존재하지 않습니다.
2. env를 module.[[Environment]]로 둡니다.
3. 실행 중인 실행 컨텍스트를 일시 중단합니다.
4. moduleContext를 실행 컨텍스트 스택에 푸시합니다. 이제 moduleContext가 실행 중인 실행 컨텍스트입니다.
5. result를 Completion(module.[[ECMAScriptCode]]의 Evaluation)으로 둡니다.
6. result를 Completion(DisposeResources(env.[[DisposableResourceStack]], result))으로 설정합니다.
7. moduleContext를 일시 중단하고 실행 컨텍스트 스택에서 제거합니다.
8. 이제 실행 컨텍스트 스택의 맨 위에 있는 컨텍스트를 실행 중인 실행 컨텍스트로 재개합니다.
9. result가 비정상 완료이면, 다음을 수행합니다.
  1. ? result를 반환합니다.
그렇지 않으면,
1. 단언: capability은 PromiseCapability Record입니다.
2. AsyncBlockStart(capability, module.[[ECMAScriptCode]], moduleContext)를 수행합니다.
unused를 반환합니다.

16.2.1.8 Synthetic Module Record

Synthetic Module Record는 명세에 의해 정의된 모듈에 관한 정보를 나타내는 데 사용됩니다. 내보낸 이름은 생성 시 정적으로 정의되지만 대응 값은 SetSyntheticModuleExport를 사용하여 시간에 따라 변경될 수 있습니다. import나 종속성은 없습니다.

참고

Synthetic Module Record는 다양한 종류의 모듈, 예를 들어 JSON 모듈이나 CSS 모듈을 정의하는 데 사용할 수 있습니다.

표 39에 정의된 필드 외에도 Synthetic Module Record에는 표 58에 나열된 추가 필드가 있습니다.

표 58: Synthetic Module Record의 추가 필드

필드 이름	값 타입	의미
`[[ExportNames]]`	a List of Strings	모듈의 export 이름입니다. 이 목록에는 중복 항목이 없습니다.
`[[EvaluationSteps]]`	an Abstract Closure	모듈 평가 시 수행할 초기화 로직이며 Synthetic Module Record를 유일한 인수로 받습니다. `[[ExportNames]]`를 수정해서는 안 됩니다. 비정상 완료를 반환할 수 있습니다.

16.2.1.8.1 CreateDefaultExportSyntheticModule ( `defaultExport` )

추상 연산 CreateDefaultExportSyntheticModule. 인수 defaultExport (ECMAScript 언어 값). 반환값: Synthetic Module 레코드. 기본 export가 defaultExport인 Synthetic Module Record를 생성합니다. 호출되면 다음 단계를 수행한다.

realm을 현재 Realm Record로 둡니다.
setDefaultExport를 매개변수 (module)를 갖고 defaultExport를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. SetSyntheticModuleExport(module, "default", defaultExport)를 수행합니다.
2. NormalCompletion(unused)을 반환합니다.
Synthetic Module Record { [[Realm]]: realm, [[Environment]]: empty, [[Namespace]]: empty, [[HostDefined]]: undefined, [[ExportNames]]: « "default" », [[EvaluationSteps]]: setDefaultExport }를 반환합니다.

16.2.1.8.2 ParseJSONModule ( `source` )

추상 연산 ParseJSONModule. 인수 source (String). 반환값: (정상 완료 (값: Synthetic Module 레코드) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

parseResult를 ? ParseJSON(source)로 둡니다.
CreateDefaultExportSyntheticModule(parseResult.[[Value]])을 반환합니다.

16.2.1.8.3 SetSyntheticModuleExport ( `module`, `exportName`, `exportValue` )

추상 연산 SetSyntheticModuleExport. 인수 module (Synthetic Module 레코드), exportName (String) 및 exportValue (ECMAScript 언어 값). 반환값: unused. Synthetic Module Record의 기존 export에 대해 내보내는 값을 설정하거나 변경하는 데 사용할 수 있습니다. 호출되면 다음 단계를 수행한다.

단언: module.[[ExportNames]]에 exportName이 포함되어 있습니다.
envRecord를 module.[[Environment]]로 둡니다.
단언: envRecord는 empty가 아닙니다.
! envRecord.SetMutableBinding(exportName, exportValue, true)를 수행합니다.
unused를 반환합니다.

16.2.1.8.4 Module Record 추상 메서드의 구현

다음은 표 40에 정의된 대응 Module Record 추상 메서드를 구현하는 Synthetic Module Record의 구체 메서드입니다.

16.2.1.8.4.1 LoadRequestedModules ( [ `hostDefined` ] )

a Synthetic Module Record module의 구체 메서드 LoadRequestedModules. 선택적 인수 hostDefined (임의의 값). 반환값: Promise. 호출되면 다음 단계를 수행한다.

참고: 이 LoadRequestedModules 구현은 hostDefined를 사용하지 않습니다.
! PromiseResolve(%Promise%, undefined)를 반환합니다.

참고

Synthetic Module Record에는 종속성이 없습니다.

16.2.1.8.4.2 GetExportedNames ( [ `exportStarSet` ] )

a Synthetic Module Record module의 구체 메서드 GetExportedNames. 선택적 인수 exportStarSet (리스트 (요소: Source Text Module 레코드)). 반환값: 리스트 (요소: String). 호출되면 다음 단계를 수행한다.

참고: 이 GetExportedNames 구현은 exportStarSet을 사용하지 않습니다.
module.[[ExportNames]]를 반환합니다.

16.2.1.8.4.3 ResolveExport ( `exportName` [ , `resolveSet` ] )

a Synthetic Module Record module의 구체 메서드 ResolveExport. 인수 exportName (String) 및 선택적 인수 resolveSet (리스트 (요소: 레코드 (필드: [[Module]] (Module 레코드), [[ExportName]] (String)))). 반환값: (ResolvedBinding 레코드, null 또는 ambiguous). 호출되면 다음 단계를 수행한다.

참고: 이 ResolveExport 구현은 resolveSet을 사용하지 않습니다.
module.[[ExportNames]]에 exportName이 포함되어 있지 않으면 null을 반환합니다.
ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportName }을 반환합니다.

16.2.1.8.4.4 Link ( )

a Synthetic Module Record module의 구체 메서드 Link. 인수 없음. 반환값: 정상 완료 (값: unused). 호출되면 다음 단계를 수행한다.

realm을 module.[[Realm]]으로 둡니다.
envRecord를 NewModuleEnvironment(realm.[[GlobalEnv]])로 둡니다.
module.[[Environment]]를 envRecord로 설정합니다.
module.[[ExportNames]]의 각 String exportName에 대해 다음을 수행합니다.
1. ! envRecord.CreateMutableBinding(exportName, false)를 수행합니다.
2. ! envRecord.InitializeBinding(exportName, undefined)를 수행합니다.
NormalCompletion(unused)을 반환합니다.

16.2.1.8.4.5 Evaluate ( )

a Synthetic Module Record module의 구체 메서드 Evaluate. 인수 없음. 반환값: Promise. 호출되면 다음 단계를 수행한다.

moduleContext를 새로운 ECMAScript 코드 실행 컨텍스트로 둡니다.
moduleContext의 Function을 null로 설정합니다.
moduleContext의 Realm을 module.[[Realm]]으로 설정합니다.
moduleContext의 ScriptOrModule을 module로 설정합니다.
moduleContext의 VariableEnvironment를 module.[[Environment]]로 설정합니다.
moduleContext의 LexicalEnvironment를 module.[[Environment]]로 설정합니다.
실행 중인 실행 컨텍스트를 일시 중단합니다.
moduleContext를 실행 컨텍스트 스택에 푸시합니다. 이제 moduleContext가 실행 중인 실행 컨텍스트입니다.
steps를 module.[[EvaluationSteps]]로 둡니다.
result를 Completion(steps(module))으로 둡니다.
moduleContext를 일시 중단하고 실행 컨텍스트 스택에서 제거합니다.
이제 실행 컨텍스트 스택의 맨 위에 있는 컨텍스트를 실행 중인 실행 컨텍스트로 재개합니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
! Call(promiseCapability.[[Resolve]], undefined, « undefined »)를 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

16.2.1.9 GetImportedModule ( `referrer`, `request` )

추상 연산 GetImportedModule. 인수 referrer (Cyclic Module 레코드) 및 request (ModuleRequest 레코드). 반환값: Module 레코드. 호출되면 다음 단계를 수행한다.

records를 referrer.[[LoadedModules]]의 각 LoadedModuleRequest Record r 중 ModuleRequestsEqual(r, request)이 true인 것들로 구성된 List로 둡니다.
단언: 이 추상 연산을 호출하기 전에 referrer에서 LoadRequestedModules가 성공적으로 완료되었으므로 records에는 정확히 하나의 요소가 있습니다.
record를 records의 유일한 요소로 둡니다.
record.[[Module]]을 반환합니다.

16.2.1.10 HostLoadImportedModule ( `referrer`, `moduleRequest`, `hostDefined`, `payload` )

호스트 정의 추상 연산 HostLoadImportedModule. 인수 referrer ((Script 레코드, Cyclic Module 레코드 또는 Realm 레코드)), moduleRequest (ModuleRequest 레코드), hostDefined (임의의 값) 및 payload ((GraphLoadingState 레코드 또는 PromiseCapability 레코드)). 반환값: unused.

참고 1

referrer가 Realm Record일 수 있는 예로 웹 브라우저 호스트를 들 수 있습니다. 여기서 사용자가 다음과 같이 주어진 컨트롤을 클릭하면

<button type="button" onclick="import('./foo.mjs')">Click me</button>

import() 표현식이 실행될 때 활성 스크립트 또는 모듈이 존재하지 않습니다. 더 일반적으로 이는 호스트가 null ScriptOrModule 구성 요소를 갖는 실행 컨텍스트를 실행 컨텍스트 스택에 푸시하는 모든 상황에서 발생할 수 있습니다.

HostLoadImportedModule 구현은 다음 요구 사항을 준수해야 합니다:

호스트 환경은 FinishLoadingImportedModule(referrer, moduleRequest, payload, result)을 동기 또는 비동기로 수행해야 하며, 여기서 result는 로드된 Module Record를 포함하는 정상 완료 또는 throw 완료 중 하나입니다.
이 연산이 다음 조건을 만족하는 두 (referrer, moduleRequest) 쌍으로 여러 번 호출되는 경우:
- 첫 번째 referrer가 두 번째 referrer와 동일하고,
- ModuleRequestsEqual(첫 번째 moduleRequest, 두 번째 moduleRequest)이 true이며,
result가 정상 완료인 FinishLoadingImportedModule(referrer, moduleRequest, payload, result)을 수행한다면 매번 동일한 result로 FinishLoadingImportedModule(referrer, moduleRequest, payload, result)을 수행해야 합니다.
moduleRequest.[[Attributes]]에 entry.[[Key]]가 "type"이고 entry.[[Value]]가 "json"인 항목 entry가 있으면, 호스트 환경이 FinishLoadingImportedModule(referrer, moduleRequest, payload, result)을 수행할 때 result는 ParseJSONModule 호출이 반환한 Completion Record 또는 throw 완료 중 하나여야 합니다.
이 연산은 payload를 FinishLoadingImportedModule에 그대로 전달할 불투명한 값으로 취급해야 합니다.

실제로 수행되는 과정은 호스트 정의이지만 일반적으로 적절한 Module Record를 로드하는 데 필요한 I/O 연산을 수행하는 것으로 구성됩니다. 서로 다른 여러 (referrer, moduleRequest.[[Specifier]], moduleRequest.[[Attributes]]) 트리플이 동일한 Module Record 인스턴스로 매핑될 수 있습니다. 실제 매핑 의미론은 호스트 정의이지만 일반적으로 매핑 과정의 일부로 specifier에 정규화 과정을 적용합니다. 일반적인 정규화 과정에는 상대 경로 및 축약 경로 지정자의 확장과 같은 작업이 포함됩니다.

참고 2

위 텍스트는 type: "json"으로 가져오는 경우(그리고 HostLoadImportedModule이 정상 완료하는 경우) 호스트가 JSON 모듈을 지원하도록 요구하지만, type: "json" 없이 가져오는 경우 JSON 모듈을 지원하는 것을 금지하지는 않습니다.

16.2.1.11 FinishLoadingImportedModule ( `referrer`, `moduleRequest`, `payload`, `result` )

추상 연산 FinishLoadingImportedModule. 인수 referrer ((Script 레코드, Cyclic Module 레코드 또는 Realm 레코드)), moduleRequest (ModuleRequest 레코드), payload ((GraphLoadingState 레코드 또는 PromiseCapability 레코드)) 및 result ((정상 완료 (값: Module 레코드) 또는 throw 완료)). 반환값: unused. 호출되면 다음 단계를 수행한다.

result가 정상 완료이면, 다음을 수행합니다.
1. referrer.[[LoadedModules]]에 ModuleRequestsEqual(record, moduleRequest)이 true인 LoadedModuleRequest Record record가 포함되어 있으면, 다음을 수행합니다.
  1. 단언: record.[[Module]]과 result.[[Value]]는 동일한 Module Record입니다.
2. 그렇지 않으면,
  1. LoadedModuleRequest Record { [[Specifier]]: moduleRequest.[[Specifier]], [[Attributes]]: moduleRequest.[[Attributes]], [[Module]]: result.[[Value]] }를 referrer.[[LoadedModules]]에 추가합니다.
payload가 GraphLoadingState Record이면, 다음을 수행합니다.
1. ContinueModuleLoading(payload, result)을 수행합니다.
그렇지 않으면,
1. ContinueDynamicImport(payload, result)을 수행합니다.
unused를 반환합니다.

16.2.1.12 AllImportAttributesSupported ( `attrs` )

추상 연산 AllImportAttributesSupported. 인수 attrs (리스트 (요소: ImportAttribute 레코드)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

supported를 HostGetSupportedImportAttributes()로 둡니다.
attrs의 각 ImportAttribute Record attr에 대해 다음을 수행합니다.
1. supported에 attr.[[Key]]가 포함되어 있지 않으면 false를 반환합니다.
true를 반환합니다.

16.2.1.12.1 HostGetSupportedImportAttributes ( )

호스트 정의 추상 연산 HostGetSupportedImportAttributes. 인수 없음. 반환값: 리스트 (요소: String). 호스트 환경이 어떤 import 속성을 지원하는지 명시할 수 있도록 합니다. 지원되는 키를 갖는 속성만 호스트에 제공됩니다.

HostGetSupportedImportAttributes 구현은 다음 요구 사항을 준수해야 합니다:

지원되는 속성을 각각 나타내는 String의 List를 반환해야 합니다.
이 연산을 호출할 때마다 동일한 내용과 동일한 순서의 같은 List를 반환해야 합니다.

HostGetSupportedImportAttributes의 기본 구현은 새로운 빈 List를 반환합니다.

참고

모든 속성을 호스트에 전달한 뒤 호스트가 처리할 속성을 선택하게 하지 않고 호스트가 지원하는 import 속성을 명시하도록 요구하는 목적은 지원되지 않는 속성이 서로 다른 호스트에서 일관된 방식으로 처리되도록 보장하기 위한 것입니다.

16.2.1.13 GetModuleNamespace ( `module` )

추상 연산 GetModuleNamespace. 인수 module (instance of a concrete subclass of Module 레코드). 반환값: a Module Namespace Object. module의 export를 나타내는 Module Namespace Object를 가져오며, 처음 요청될 때 지연 생성하고 향후 조회를 위해 module.[[Namespace]]에 저장합니다. 호출되면 다음 단계를 수행한다.

단언: module이 Cyclic Module Record이면 module.[[Status]]는 new 또는 unlinked가 아닙니다.
namespace를 module.[[Namespace]]로 둡니다.
namespace가 empty이면, 다음을 수행합니다.
1. exportedNames를 module.GetExportedNames()로 둡니다.
2. unambiguousNames를 새로운 빈 List로 둡니다.
3. exportedNames의 각 요소 name에 대해 다음을 수행합니다.
  1. resolution을 module.ResolveExport(name)로 둡니다.
  2. resolution이 ResolvedBinding Record이면 name을 unambiguousNames에 추가합니다.
4. namespace를 ModuleNamespaceCreate(module, unambiguousNames)로 설정합니다.
namespace를 반환합니다.

참고

GetModuleNamespace는 절대로 예외를 던지지 않습니다. 대신 해석할 수 없는 이름은 이 시점에서 네임스페이스에서 단순히 제외됩니다. 이러한 이름이 어디에서도 명시적으로 요청되지 않은 모호한 star export가 전부인 경우를 제외하면 나중에 실제 연결 오류를 일으킵니다.

16.2.1.14 Runtime Semantics: 평가

Module

[empty]

undefined를 반환합니다.

ModuleBody

ModuleItemList

result를 Completion(ModuleItemList의 Evaluation)으로 둡니다.
result가 정상 완료이고 result.[[Value]]가 empty이면, 다음을 수행합니다.
1. undefined를 반환합니다.
? result를 반환합니다.

ModuleItemList

ModuleItem

sl을 ModuleItemList의 ? Evaluation으로 둡니다.
s를 Completion(ModuleItem의 Evaluation)으로 둡니다.
? UpdateEmpty(s, sl)을 반환합니다.

참고

ModuleItemList의 값은 ModuleItemList에서 값을 생성하는 마지막 항목의 값입니다.

ModuleItem

ImportDeclaration

empty를 반환합니다.

16.2.2 Import

구문

import

opt

;

import

ModuleSpecifier

WithClause

opt

;

ImportClause

ImportedDefaultBinding

NameSpaceImport

NamedImports

ImportedDefaultBinding

NameSpaceImport

ImportedDefaultBinding

NamedImports

ImportedDefaultBinding

{

}

{

ImportsList

opt

}

from

[~Yield, +Await]

with

{

}

with

{

WithEntries

opt

}

16.2.2.1 Static Semantics: 조기 오류

ModuleItem

ImportDeclaration

ImportDeclaration의 BoundNames에 중복 항목이 하나라도 포함되어 있으면 Syntax Error입니다.

WithClause

with

{

WithEntries

opt

}

WithClause의 WithClauseToAttributes에 서로 다른 두 항목 a와 b가 있고 a.[[Key]]가 b.[[Key]]와 같으면 Syntax Error입니다.

16.2.2.2 Static Semantics: ImportEntries

구문 지향 연산 ImportEntries. 인수 없음. 반환값: 리스트 (요소: ImportEntry 레코드). 다음 생성 규칙별로 정의된다.

Module

[empty]

새로운 빈 List를 반환합니다.

ModuleItemList

ModuleItem

entries1을 ModuleItemList의 ImportEntries로 둡니다.
entries2를 ModuleItem의 ImportEntries로 둡니다.
entries1과 entries2의 목록 연결을 반환합니다.

ModuleItem

ExportDeclaration

StatementListItem

새로운 빈 List를 반환합니다.

import

opt

;

module을 ImportDeclaration의 ModuleRequests의 유일한 요소로 둡니다.
인수 module을 사용한 ImportClause의 ImportEntriesForModule을 반환합니다.

ImportDeclaration

import

ModuleSpecifier

WithClause

opt

;

새로운 빈 List를 반환합니다.

16.2.2.3 Static Semantics: ImportEntriesForModule

구문 지향 연산 ImportEntriesForModule. 인수 module (ModuleRequest 레코드). 반환값: 리스트 (요소: ImportEntry 레코드). 다음 생성 규칙별로 정의된다.

ImportClause

ImportedDefaultBinding

NameSpaceImport

entries1을 인수 module을 사용한 ImportedDefaultBinding의 ImportEntriesForModule로 둡니다.
entries2를 인수 module을 사용한 NameSpaceImport의 ImportEntriesForModule로 둡니다.
entries1과 entries2의 목록 연결을 반환합니다.

ImportClause

ImportedDefaultBinding

NamedImports

entries1을 인수 module을 사용한 ImportedDefaultBinding의 ImportEntriesForModule로 둡니다.
entries2를 인수 module을 사용한 NamedImports의 ImportEntriesForModule로 둡니다.
entries1과 entries2의 목록 연결을 반환합니다.

ImportedDefaultBinding

ImportedBinding

localName을 ImportedBinding의 BoundNames의 유일한 요소로 둡니다.
defaultEntry를 ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: "default", [[LocalName]]: localName }로 둡니다.
« defaultEntry »을 반환합니다.

NameSpaceImport

ImportedBinding

localName을 ImportedBinding의 StringValue로 둡니다.
entry를 ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: namespace, [[LocalName]]: localName }로 둡니다.
« entry »을 반환합니다.

NamedImports

{

}

새로운 빈 List를 반환합니다.

ImportsList

ImportSpecifier

specs1을 인수 module을 사용한 ImportsList의 ImportEntriesForModule로 둡니다.
specs2를 인수 module을 사용한 ImportSpecifier의 ImportEntriesForModule로 둡니다.
specs1과 specs2의 목록 연결을 반환합니다.

ImportSpecifier

ImportedBinding

localName을 ImportedBinding의 BoundNames의 유일한 요소로 둡니다.
entry를 ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: localName, [[LocalName]]: localName }로 둡니다.
« entry »을 반환합니다.

ImportSpecifier

ModuleExportName

ImportedBinding

importName을 ModuleExportName의 StringValue로 둡니다.
localName을 ImportedBinding의 StringValue로 둡니다.
entry를 ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName }로 둡니다.
« entry »을 반환합니다.

16.2.2.4 Static Semantics: WithClauseToAttributes

구문 지향 연산 WithClauseToAttributes. 인수 없음. 반환값: 리스트 (요소: ImportAttribute 레코드). 다음 생성 규칙별로 정의된다.

WithClause

with

{

}

새로운 빈 List를 반환합니다.

WithClause

with

{

WithEntries

opt

}

attrs를 WithEntries의 WithClauseToAttributes로 둡니다.
각 [[Key]] 필드 값을 UTF-16 코드 단위 값의 시퀀스로 취급하여 해당 [[Key]] 필드의 사전식 순서에 따라 attrs를 정렬합니다. 참고: 호스트가 속성이 열거되는 순서를 기반으로 동작을 변경하는 것이 금지되어 있다는 점에서만 이 정렬을 관찰할 수 있습니다.
attrs를 반환합니다.

WithEntries

AttributeKey

StringLiteral

key를 AttributeKey의 PropName으로 둡니다.
entry를 ImportAttribute Record { [[Key]]: key, [[Value]]: StringLiteral의 SV }로 둡니다.
« entry »을 반환합니다.

key를 AttributeKey의 PropName으로 둡니다.
entry를 ImportAttribute Record { [[Key]]: key, [[Value]]: StringLiteral의 SV }로 둡니다.
rest를 WithEntries의 WithClauseToAttributes로 둡니다.
« entry »과 rest의 목록 연결을 반환합니다.

16.2.3 Export

구문

export

opt

;

export

NamedExports

;

export

VariableStatement

[~Yield, +Await]

export

[lookahead ∉ { using, await }]

Declaration

[~Yield, +Await]

export

default

HoistableDeclaration

[~Yield, +Await, +Default]

export

default

ClassDeclaration

[~Yield, +Await, +Default]

export

default

[lookahead ∉ { function, async

[no LineTerminator here]

function, class }]

AssignmentExpression

[+In, ~Yield, +Await]

;

ExportFromClause

ModuleExportName

NamedExports

{

}

{

ExportsList

opt

}

16.2.3.1 Static Semantics: 조기 오류

ExportDeclaration

export

NamedExports

;

NamedExports의 ReferencedBindings에 StringLiteral이 하나라도 포함되어 있으면 Syntax Error입니다.
NamedExports의 ReferencedBindings에 있는 각 IdentifierName n에 대해: n의 StringValue가 ReservedWord이거나 n의 StringValue가 "implements", "interface", "let", "package", "private", "protected", "public" 또는 "static" 중 하나이면 Syntax Error입니다.

참고

위 규칙은 NamedExports의 각 ReferencedBindings를 IdentifierReference처럼 취급한다는 의미입니다.

16.2.3.2 Static Semantics: ExportedBindings

구문 지향 연산 ExportedBindings. 인수 없음. 반환값: 리스트 (요소: String).

참고

ExportedBindings는 Module의 ExportedNames와 명시적으로 연결된 로컬 바인딩 이름입니다.

다음 생성 규칙별로 정의된다.

ModuleItemList

ModuleItem

names1을 ModuleItemList의 ExportedBindings로 둡니다.
names2를 ModuleItem의 ExportedBindings로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ModuleItem

ImportDeclaration

StatementListItem

새로운 빈 List를 반환합니다.

export

opt

;

새로운 빈 List를 반환합니다.

ExportDeclaration

export

NamedExports

;

NamedExports의 ExportedBindings를 반환합니다.

ExportDeclaration

export

VariableStatement

VariableStatement의 BoundNames를 반환합니다.

ExportDeclaration

export

Declaration

Declaration의 BoundNames를 반환합니다.

ExportDeclaration

export

default

HoistableDeclaration

export

default

ClassDeclaration

export

default

AssignmentExpression

;

이 ExportDeclaration의 BoundNames를 반환합니다.

NamedExports

{

}

새로운 빈 List를 반환합니다.

ExportsList

ExportSpecifier

names1을 ExportsList의 ExportedBindings로 둡니다.
names2를 ExportSpecifier의 ExportedBindings로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ExportSpecifier

ModuleExportName

유일한 요소가 ModuleExportName의 StringValue인 List를 반환합니다.

ExportSpecifier

ModuleExportName

유일한 요소가 첫 번째 ModuleExportName의 StringValue인 List를 반환합니다.

16.2.3.3 Static Semantics: ExportedNames

구문 지향 연산 ExportedNames. 인수 없음. 반환값: 리스트 (요소: String).

참고

ExportedNames는 Module이 자신의 로컬 이름 바인딩 중 하나에 명시적으로 매핑하는 외부에서 볼 수 있는 이름입니다.

다음 생성 규칙별로 정의된다.

ModuleItemList

ModuleItem

names1을 ModuleItemList의 ExportedNames로 둡니다.
names2를 ModuleItem의 ExportedNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ModuleItem

ExportDeclaration

ExportDeclaration의 ExportedNames를 반환합니다.

ModuleItem

ImportDeclaration

StatementListItem

새로운 빈 List를 반환합니다.

export

opt

;

ExportFromClause의 ExportedNames를 반환합니다.

ExportFromClause

새로운 빈 List를 반환합니다.

ExportFromClause

ModuleExportName

유일한 요소가 ModuleExportName의 StringValue인 List를 반환합니다.

ExportFromClause

NamedExports

NamedExports의 ExportedNames를 반환합니다.

ExportDeclaration

export

VariableStatement

VariableStatement의 BoundNames를 반환합니다.

ExportDeclaration

export

Declaration

Declaration의 BoundNames를 반환합니다.

ExportDeclaration

export

default

HoistableDeclaration

export

default

ClassDeclaration

export

default

AssignmentExpression

;

« "default" »를 반환합니다.

NamedExports

{

}

새로운 빈 List를 반환합니다.

ExportsList

ExportSpecifier

names1을 ExportsList의 ExportedNames로 둡니다.
names2를 ExportSpecifier의 ExportedNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ExportSpecifier

ModuleExportName

유일한 요소가 ModuleExportName의 StringValue인 List를 반환합니다.

ExportSpecifier

ModuleExportName

유일한 요소가 두 번째 ModuleExportName의 StringValue인 List를 반환합니다.

16.2.3.4 Static Semantics: ExportEntries

구문 지향 연산 ExportEntries. 인수 없음. 반환값: 리스트 (요소: ExportEntry 레코드). 다음 생성 규칙별로 정의된다.

Module

[empty]

새로운 빈 List를 반환합니다.

ModuleItemList

ModuleItem

entries1을 ModuleItemList의 ExportEntries로 둡니다.
entries2를 ModuleItem의 ExportEntries로 둡니다.
entries1과 entries2의 목록 연결을 반환합니다.

ModuleItem

ImportDeclaration

StatementListItem

새로운 빈 List를 반환합니다.

export

opt

;

module을 ExportDeclaration의 ModuleRequests의 유일한 요소로 둡니다.
인수 module을 사용한 ExportFromClause의 ExportEntriesForModule을 반환합니다.

ExportDeclaration

export

NamedExports

;

인수 null을 사용한 NamedExports의 ExportEntriesForModule을 반환합니다.

ExportDeclaration

export

VariableStatement

entries를 새로운 빈 List로 둡니다.
names를 VariableStatement의 BoundNames로 둡니다.
names의 각 요소 name에 대해 다음을 수행합니다.
1. ExportEntry Record { [[ModuleRequest]]: null, [[ImportName]]: null, [[LocalName]]: name, [[ExportName]]: name }을 entries에 추가합니다.
entries를 반환합니다.

ExportDeclaration

export

Declaration

entries를 새로운 빈 List로 둡니다.
names를 Declaration의 BoundNames로 둡니다.
names의 각 요소 name에 대해 다음을 수행합니다.
1. ExportEntry Record { [[ModuleRequest]]: null, [[ImportName]]: null, [[LocalName]]: name, [[ExportName]]: name }을 entries에 추가합니다.
entries를 반환합니다.

ExportDeclaration

export

default

HoistableDeclaration

names를 HoistableDeclaration의 BoundNames로 둡니다.
localName을 names의 유일한 요소로 둡니다.
유일한 요소가 새로운 ExportEntry Record { [[ModuleRequest]]: null, [[ImportName]]: null, [[LocalName]]: localName, [[ExportName]]: "default" }인 List를 반환합니다.

ExportDeclaration

export

default

ClassDeclaration

names를 ClassDeclaration의 BoundNames로 둡니다.
localName을 names의 유일한 요소로 둡니다.
유일한 요소가 새로운 ExportEntry Record { [[ModuleRequest]]: null, [[ImportName]]: null, [[LocalName]]: localName, [[ExportName]]: "default" }인 List를 반환합니다.

ExportDeclaration

export

default

AssignmentExpression

;

entry를 ExportEntry Record { [[ModuleRequest]]: null, [[ImportName]]: null, [[LocalName]]: "*default*", [[ExportName]]: "default" }로 둡니다.
« entry »을 반환합니다.

참고

"*default*"는 이 명세 안에서 익명 기본 export 값의 합성 이름으로 사용됩니다. 자세한 내용은 이 참고를 참조하시기 바랍니다.

16.2.3.5 Static Semantics: ExportEntriesForModule

구문 지향 연산 ExportEntriesForModule. 인수 module ((ModuleRequest 레코드 또는 null)). 반환값: 리스트 (요소: ExportEntry 레코드). 다음 생성 규칙별로 정의된다.

ExportFromClause

entry를 ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: all-but-default, [[LocalName]]: null, [[ExportName]]: null }로 둡니다.
« entry »을 반환합니다.

ExportFromClause

ModuleExportName

exportName을 ModuleExportName의 StringValue로 둡니다.
entry를 ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: namespace, [[LocalName]]: null, [[ExportName]]: exportName }로 둡니다.
« entry »을 반환합니다.

NamedExports

{

}

새로운 빈 List를 반환합니다.

ExportsList

ExportSpecifier

specs1을 인수 module을 사용한 ExportsList의 ExportEntriesForModule로 둡니다.
specs2를 인수 module을 사용한 ExportSpecifier의 ExportEntriesForModule로 둡니다.
specs1과 specs2의 목록 연결을 반환합니다.

ExportSpecifier

ModuleExportName

sourceName을 ModuleExportName의 StringValue로 둡니다.
module이 null이면, 다음을 수행합니다.
1. localName을 sourceName으로 둡니다.
2. importName을 null로 둡니다.
그렇지 않으면,
1. localName을 null로 둡니다.
2. importName을 sourceName으로 둡니다.
유일한 요소가 새로운 ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: sourceName }인 List를 반환합니다.

ExportSpecifier

ModuleExportName

sourceName을 첫 번째 ModuleExportName의 StringValue로 둡니다.
exportName을 두 번째 ModuleExportName의 StringValue로 둡니다.
module이 null이면, 다음을 수행합니다.
1. localName을 sourceName으로 둡니다.
2. importName을 null로 둡니다.
그렇지 않으면,
1. localName을 null로 둡니다.
2. importName을 sourceName으로 둡니다.
유일한 요소가 새로운 ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: exportName }인 List를 반환합니다.

16.2.3.6 Static Semantics: ReferencedBindings

구문 지향 연산 ReferencedBindings. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

NamedExports

{

}

새로운 빈 List를 반환합니다.

ExportsList

ExportSpecifier

names1을 ExportsList의 ReferencedBindings로 둡니다.
names2를 ExportSpecifier의 ReferencedBindings로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

ExportSpecifier

ModuleExportName

첫 번째 ModuleExportName의 ReferencedBindings를 반환합니다.

ModuleExportName

IdentifierName

유일한 요소가 IdentifierName인 List를 반환합니다.

ModuleExportName

StringLiteral

유일한 요소가 StringLiteral인 List를 반환합니다.

16.2.3.7 Runtime Semantics: 평가

export

opt

;

export

NamedExports

;

empty를 반환합니다.

ExportDeclaration

export

VariableStatement

VariableStatement의 ? Evaluation을 반환합니다.

ExportDeclaration

export

Declaration

Declaration의 ? Evaluation을 반환합니다.

ExportDeclaration

export

default

HoistableDeclaration

HoistableDeclaration의 ? Evaluation을 반환합니다.

ExportDeclaration

export

default

ClassDeclaration

value를 ClassDeclaration의 ? BindingClassDeclarationEvaluation으로 둡니다.
className을 ClassDeclaration의 BoundNames의 유일한 요소로 둡니다.
className이 "*default*"이면, 다음을 수행합니다.
1. envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
2. ? InitializeBoundName("*default*", value, envRecord)를 수행합니다.
empty를 반환합니다.

ExportDeclaration

export

default

AssignmentExpression

;

IsAnonymousFunctionDefinition(AssignmentExpression)이 true이면, 다음을 수행합니다.
1. value를 인수 "default"를 사용한 AssignmentExpression의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rhs를 AssignmentExpression의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(rhs)로 둡니다.
envRecord를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
? InitializeBoundName("*default*", value, envRecord)를 수행합니다.
empty를 반환합니다.

17 오류 처리 및 언어 확장

구현체는 관련 ECMAScript 언어 구문이 평가되는 시점에 대부분의 오류를 보고해야 합니다. 조기 오류는 오류를 포함하는 Script의 어떤 구문도 평가되기 전에 검출하고 보고할 수 있는 오류입니다. 조기 오류가 존재하면 해당 구문의 평가가 방지됩니다. 구현체는 ParseScript에서 해당 Script를 파싱하는 과정의 일부로 Script의 조기 오류를 보고해야 합니다. Module의 조기 오류는 Module이 평가될 시점에 보고되며 해당 Module은 절대로 초기화되지 않습니다. eval 코드의 조기 오류는 eval이 호출될 때 보고되며 eval 코드의 평가를 방지합니다. 조기 오류가 아닌 모든 오류는 런타임 오류입니다.

구현체는 이 명세의 “Static Semantics: 조기 오류” 하위 절에 나열된 조건이 발생하면 이를 조기 오류로 보고해야 합니다.

구현체는 컴파일러가 어떤 구문이 어떠한 상황에서도 오류 없이 실행될 수 없음을 증명할 수 있더라도 다른 종류의 오류를 조기 오류로 취급해서는 안 됩니다. 이러한 경우 구현체는 조기 경고를 낼 수 있지만 관련 구문이 실제로 실행될 때까지 오류를 보고해서는 안 됩니다.

구현체는 다음의 경우를 제외하고 명시된 대로 모든 오류를 보고해야 합니다:

17.1에서 제한하는 경우를 제외하고 호스트 또는 구현체는 Script 구문, Module 구문 및 정규 표현식 패턴 또는 플래그 구문을 확장할 수 있습니다. 이를 허용하기 위해 SyntaxError를 던질 수 있는 모든 연산(예: eval 호출, 정규 표현식 리터럴 사용 또는 Function이나 RegExp 생성자 사용)은 스크립트 구문이나 정규 표현식 패턴 또는 플래그 구문에 대한 호스트 정의 확장을 발견했을 때 SyntaxError를 던지는 대신 호스트 정의 동작을 나타낼 수 있습니다.
17.1에서 제한하는 경우를 제외하고 호스트 또는 구현체는 이 명세에 설명된 것 외에 추가 타입, 값, 객체, 프로퍼티 및 함수를 제공할 수 있습니다. 이로 인해 구문(예: 전역 스코프에서 변수를 조회하는 경우)이 오류(예: ReferenceError)를 던지는 대신 호스트 정의 동작을 나타낼 수 있습니다.

17.1 금지된 확장

구현체는 다음과 같은 방식으로 이 명세를 확장해서는 안 됩니다:

엄격 모드 코드에서 구문적 생성자를 사용하여 정의된 ECMAScript 함수 객체에는 "caller" 또는 "arguments"라는 이름의 자체 프로퍼티를 생성해서는 안 됩니다. 또한 정의가 엄격 모드 코드 안에 포함되어 있는지 여부와 관계없이 ArrowFunction, MethodDefinition, GeneratorDeclaration, GeneratorExpression, AsyncGeneratorDeclaration, AsyncGeneratorExpression, ClassDeclaration, ClassExpression, AsyncFunctionDeclaration, AsyncFunctionExpression 또는 AsyncArrowFunction을 사용하여 정의된 함수 객체에도 이러한 자체 프로퍼티를 생성해서는 안 됩니다. 내장 함수, Function 생성자를 사용하여 생성된 엄격 함수, Generator 생성자를 사용하여 생성된 제너레이터 함수, AsyncFunction 생성자를 사용하여 생성된 비동기 함수 및 bind 메서드를 사용하여 생성된 함수에도 이러한 자체 프로퍼티를 생성해서는 안 됩니다.
구현체가 어떤 함수 객체에 "caller"라는 이름의 자체 프로퍼티를 추가하는 경우 [[Get]] 또는 [[GetOwnProperty]]을 사용하여 관찰되는 해당 프로퍼티의 값은 엄격 함수 객체여서는 안 됩니다. 접근자 프로퍼티인 경우 해당 프로퍼티의 [[Getter]] 속성 값인 함수는 호출될 때 엄격 함수를 절대로 반환해서는 안 됩니다.
매핑된 arguments 객체와 매핑되지 않은 arguments 객체 모두 "caller"라는 이름의 자체 프로퍼티를 갖도록 생성해서는 안 됩니다.
toLocaleString이라는 이름의 메서드처럼 ECMA-402에 명시된 내장 메서드의 동작은 ECMA-402에 명시된 경우를 제외하고 확장해서는 안 됩니다.
22.2.1 및 B.1.2의 RegExp 패턴 문법은 _{[UnicodeMode]} 문법 매개변수가 존재할 때 소스 문자 A-Z 또는 a-z 중 어떤 것도 IdentityEscape[+UnicodeMode]로 인식하도록 확장해서는 안 됩니다.
구문 문법은 BindingIdentifier 비단말 기호와 일치하는 소스 텍스트 바로 뒤에 토큰 :가 올 수 있도록 어떤 방식으로도 확장해서는 안 됩니다.
엄격 모드 코드를 처리할 때 구현체는 12.9.3.1의 조기 오류 규칙을 완화해서는 안 됩니다.
TemplateEscapeSequence는 12.9.4에 정의된 LegacyOctalEscapeSequence 또는 NonOctalDecimalEscapeSequence를 포함하도록 확장해서는 안 됩니다.
엄격 모드 코드를 처리할 때 B.3.1, B.3.2, B.3.3 및 B.3.5에 정의된 확장을 지원해서는 안 됩니다.
Module 목표 기호를 사용하여 파싱할 때 B.1.1에 정의된 어휘 문법 확장을 지원해서는 안 됩니다.
ImportCall은 확장해서는 안 됩니다.

18 ECMAScript 표준 내장 객체

ECMAScript Script 또는 Module이 실행을 시작할 때마다 사용할 수 있는 특정 내장 객체가 있습니다. 그중 하나인 전역 객체는 실행 중인 프로그램의 전역 환경의 일부입니다. 그 밖의 객체는 전역 객체의 초기 프로퍼티로 접근하거나 접근 가능한 내장 객체의 프로퍼티를 통해 간접적으로 접근할 수 있습니다.

달리 명시되지 않는 한 함수로 호출할 수 있는 내장 객체는 10.3에 설명된 특성을 갖는 내장 함수 객체입니다. 달리 명시되지 않는 한 내장 객체의 [[Extensible]] 내부 슬롯은 처음에 true 값을 갖습니다. 모든 내장 함수 객체는 해당 객체가 처음 생성된 realm의 Realm Record를 값으로 갖는 [[Realm]] 내부 슬롯을 갖습니다.

많은 내장 객체는 함수이며 인수를 사용하여 호출할 수 있습니다. 그중 일부는 생성자이기도 하며 new 연산자와 함께 사용하기 위한 함수입니다. 각 내장 함수에 대해 이 명세는 해당 함수에 필요한 인수와 해당 함수 객체의 프로퍼티를 설명합니다. 각 내장 생성자에 대해 이 명세는 추가로 해당 생성자의 프로토타입 객체의 프로퍼티와 해당 생성자를 호출하는 new 표현식이 반환하는 특정 객체 인스턴스의 프로퍼티를 설명합니다.

특정 함수의 설명에서 달리 명시하지 않는 한 내장 함수 또는 생성자에 함수가 필요로 하는 것보다 적은 수의 인수가 주어지면, 해당 함수 또는 생성자는 각 추가 인수가 undefined 값인 충분한 수의 추가 인수를 전달받은 것과 정확히 동일하게 동작해야 합니다. 이러한 누락된 인수는 “존재하지 않는” 것으로 간주되며 명세 알고리즘에서 그러한 방식으로 식별될 수 있습니다. 특정 함수의 설명에서 “this 값” 및 “NewTarget”이라는 용어는 10.3에 주어진 의미를 갖습니다.

특정 함수의 설명에서 달리 명시하지 않는 한 설명된 내장 함수 또는 생성자에 함수가 허용하도록 명시된 것보다 많은 인수가 주어지면 추가 인수는 호출에 의해 평가된 다음 함수에서 무시됩니다. 다만 구현체는 단순히 추가 인수가 존재한다는 사실만을 근거로 TypeError 예외를 던지는 동작이 아닌 한 이러한 인수와 관련된 구현체 고유 동작을 정의할 수 있습니다.

참고 1

내장 함수 집합에 추가 기능을 추가하는 구현체는 기존 함수에 새 매개변수를 추가하는 대신 새 함수를 추가하는 방식으로 구현하는 것이 권장됩니다.

달리 명시되지 않는 한 모든 내장 함수와 모든 내장 생성자는 Function.prototype 표현식의 초기 값인 Function 프로토타입 객체(20.2.3)를 [[Prototype]] 내부 슬롯의 값으로 갖습니다.

달리 명시되지 않는 한 Object 프로토타입 객체 자체를 제외한 모든 내장 프로토타입 객체는 Object.prototype 표현식의 초기 값인 Object 프로토타입 객체(20.1.3)를 [[Prototype]] 내부 슬롯의 값으로 갖습니다.

이 명세가 알고리즘 단계를 통해 내장 생성자의 동작을 정의하는 경우 이는 [[Call]] 및 [[Construct]] 모두에 대한 동작입니다. 이러한 알고리즘이 두 경우를 구분해야 한다면 NewTarget이 undefined인지 검사하며, 이는 [[Call]] 호출임을 나타냅니다.

생성자로 식별되지 않은 내장 함수 객체는 특정 함수의 설명에서 달리 명시하지 않는 한 [[Construct]] 내부 메서드를 구현하지 않습니다.

생성자가 아닌 내장 함수 객체는 특정 함수의 설명에서 달리 명시하지 않는 한 "prototype" 프로퍼티를 갖지 않습니다.

이 명세에 정의된 각 내장 함수는 CreateBuiltinFunction 추상 연산(10.3.4)을 호출하여 생성됩니다. length 및 name 매개변수의 값은 아래에서 설명하는 "length" 및 "name" 프로퍼티의 초기 값입니다. prefix 매개변수의 값도 마찬가지로 아래에서 설명합니다.

생성자를 포함한 모든 내장 함수 객체는 값이 음수가 아닌 정수 Number인 "length" 프로퍼티를 갖습니다. 달리 명시되지 않는 한 이 값은 함수 설명의 하위 절 제목에 표시된 필수 매개변수의 수입니다. 선택적 매개변수와 나머지 매개변수는 매개변수 수에 포함되지 않습니다.

참고 2

예를 들어 Array 프로토타입 객체의 "map" 프로퍼티 초기 값인 함수 객체는 «Array.prototype.map (callback [ , thisArg])»이라는 하위 절 제목 아래에 설명되어 있으며, callback과 thisArg라는 두 개의 이름 있는 인수가 표시되고 후자는 선택적입니다. 따라서 해당 함수 객체의 "length" 프로퍼티 값은 1_𝔽입니다.

달리 명시되지 않는 한 내장 함수 객체의 "length" 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

생성자를 포함한 모든 내장 함수 객체는 값이 String인 "name" 프로퍼티를 갖습니다. 달리 명시되지 않는 한 이 값은 이 명세에서 함수에 주어진 이름입니다. 익명 함수로 식별된 함수는 빈 String을 "name" 프로퍼티의 값으로 사용합니다. 객체의 프로퍼티로 명시된 함수의 경우 name 값은 해당 함수에 접근하는 데 사용하는 프로퍼티 이름 문자열입니다. 내장 프로퍼티의 get 또는 set 접근자 함수로 명시된 함수는 CreateBuiltinFunction을 호출할 때 각각 "get" 또는 "set"을 prefix 매개변수에 전달합니다.

프로퍼티 키가 Symbol 값인 각 내장 함수의 "name" 프로퍼티 값은 명시적으로 지정됩니다. 이렇게 명시적으로 지정된 값이 "get " 또는 "set " 접두사로 시작하고 해당 함수가 내장 프로퍼티의 get 또는 set 접근자 함수이면 접두사를 제거한 값을 name 매개변수에 전달하고 각각 "get" 또는 "set" 값을 CreateBuiltinFunction 호출 시 prefix 매개변수에 전달합니다.

달리 명시되지 않는 한 내장 함수 객체의 "name" 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

19부터 28까지의 절과 부록 B.2에 설명된 그 밖의 모든 데이터 프로퍼티는 달리 명시되지 않는 한 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

19부터 28까지의 절과 부록 B.2에 설명된 모든 접근자 프로퍼티는 달리 명시되지 않는 한 { [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다. get 접근자 함수만 설명된 경우 set 접근자 함수는 기본값 undefined입니다. set 접근자만 설명된 경우 get 접근자는 기본값 undefined입니다.

19 전역 객체

전역 객체는:

제어가 어떤 실행 컨텍스트에 진입하기 전에 생성됩니다.
[[Construct]] 내부 메서드를 갖지 않으므로 new 연산자와 함께 생성자로 사용할 수 없습니다.
[[Call]] 내부 메서드를 갖지 않으므로 함수로 호출할 수 없습니다.
값이 호스트 정의인 [[Prototype]] 내부 슬롯을 갖습니다.
이 명세에 정의된 프로퍼티 외에 호스트 정의 프로퍼티를 가질 수 있습니다. 여기에는 값이 전역 객체 자체인 프로퍼티가 포함될 수 있습니다.

19.1 전역 객체의 값 프로퍼티

19.1.1 globalThis

Realm Record realm에서 전역 객체의 "globalThis" 프로퍼티 초기 값은 realm.[[GlobalEnv]].[[GlobalThisValue]]입니다.

이 프로퍼티는 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

19.1.2 Infinity

전역 객체의 "Infinity" 프로퍼티 초기 값은 +∞_𝔽입니다(6.1.6.1 참조).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

19.1.3 NaN

전역 객체의 "NaN" 프로퍼티 초기 값은 NaN입니다(6.1.6.1 참조).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

19.1.4 undefined

전역 객체의 "undefined" 프로퍼티 초기 값은 undefined입니다(6.1.1 참조).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

19.2 전역 객체의 함수 프로퍼티

19.2.1 eval ( `source` )

이 함수는 %eval% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

? PerformEval(source, false, false)를 반환합니다.

19.2.1.1 PerformEval ( `source`, `strictCaller`, `direct` )

추상 연산 PerformEval. 인수 source (ECMAScript 언어 값), strictCaller (Boolean) 및 direct (Boolean). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: direct가 false이면 strictCaller도 false입니다.
source가 String이 아니면 source를 반환합니다.
evalRealm을 현재 Realm Record로 둡니다.
참고: 직접 eval의 경우 evalRealm은 eval 호출자와 eval 함수 자체 모두의 realm입니다.
? HostEnsureCanCompileStrings(evalRealm, « », source, direct)를 수행합니다.
inFunc를 false로 둡니다.
inMethod를 false로 둡니다.
inDerivedCtor를 false로 둡니다.
inClassFieldInitializer를 false로 둡니다.
direct가 true이면, 다음을 수행합니다.
1. thisEnvRecord를 GetThisEnvironment()로 둡니다.
2. thisEnvRecord가 Function Environment Record이면, 다음을 수행합니다.
  1. func를 thisEnvRecord.[[FunctionObject]]로 둡니다.
  2. inFunc를 true로 설정합니다.
  3. inMethod를 thisEnvRecord.HasSuperBinding()으로 설정합니다.
  4. func.[[ConstructorKind]]가 derived이면 inDerivedCtor를 true로 설정합니다.
  5. classFieldInitializerName을 func.[[ClassFieldInitializerName]]으로 둡니다.
  6. classFieldInitializerName이 empty가 아니면 inClassFieldInitializer를 true로 설정합니다.
다음 하위 단계를 구현체 정의 순서로 수행하며, 파싱과 오류 검출을 서로 섞어서 수행할 수도 있습니다:
1. script를 ParseText(source, Script)로 둡니다.
2. script가 오류의 List이면 SyntaxError 예외를 던집니다.
3. script Contains ScriptBody가 false이면 undefined를 반환합니다.
4. body를 script의 ScriptBody로 둡니다.
5. inFunc가 false이고 body Contains NewTarget이면 SyntaxError 예외를 던집니다.
6. inMethod가 false이고 body Contains SuperProperty이면 SyntaxError 예외를 던집니다.
7. inDerivedCtor가 false이고 body Contains SuperCall이면 SyntaxError 예외를 던집니다.
8. inClassFieldInitializer가 true이고 body의 ContainsArguments가 true이면 SyntaxError 예외를 던집니다.
strictCaller가 true이면 strictEval을 true로 둡니다.
그렇지 않으면 strictEval을 script의 ScriptIsStrict로 둡니다.
runningContext를 실행 중인 실행 컨텍스트로 둡니다.
참고: direct가 true이면 runningContext는 직접 eval을 수행한 실행 컨텍스트입니다. direct가 false이면 runningContext는 eval 함수 호출의 실행 컨텍스트입니다.
direct가 true이면, 다음을 수행합니다.
1. lexicalEnv를 NewDeclarativeEnvironment(runningContext의 LexicalEnvironment)로 둡니다.
2. variableEnv를 runningContext의 VariableEnvironment로 둡니다.
3. privateEnv를 runningContext의 PrivateEnvironment로 둡니다.
그렇지 않으면,
1. lexicalEnv를 NewDeclarativeEnvironment(evalRealm.[[GlobalEnv]])로 둡니다.
2. variableEnv를 evalRealm.[[GlobalEnv]]로 둡니다.
3. privateEnv를 null로 둡니다.
strictEval이 true이면 variableEnv를 lexicalEnv로 설정합니다.
runningContext가 아직 일시 중단되지 않았다면 runningContext를 일시 중단합니다.
evalContext를 새로운 ECMAScript 코드 실행 컨텍스트로 둡니다.
evalContext의 Function을 null로 설정합니다.
evalContext의 Realm을 evalRealm으로 설정합니다.
evalContext의 ScriptOrModule을 runningContext의 ScriptOrModule로 설정합니다.
evalContext의 VariableEnvironment를 variableEnv로 설정합니다.
evalContext의 LexicalEnvironment를 lexicalEnv로 설정합니다.
evalContext의 PrivateEnvironment를 privateEnv로 설정합니다.
evalContext를 실행 컨텍스트 스택에 푸시합니다. 이제 evalContext가 실행 중인 실행 컨텍스트입니다.
result를 Completion(EvalDeclarationInstantiation(body, variableEnv, lexicalEnv, privateEnv, strictEval))으로 둡니다.
result가 정상 완료이면, 다음을 수행합니다.
1. result를 Completion(body의 Evaluation)으로 설정합니다.
result가 정상 완료이고 result.[[Value]]가 empty이면, 다음을 수행합니다.
1. result를 NormalCompletion(undefined)으로 설정합니다.
evalContext를 일시 중단하고 실행 컨텍스트 스택에서 제거합니다.
이제 실행 컨텍스트 스택의 맨 위에 있는 컨텍스트를 실행 중인 실행 컨텍스트로 재개합니다.
? result를 반환합니다.

참고

호출 컨텍스트의 코드 또는 eval 코드 중 하나라도 엄격 모드 코드이면 eval 코드는 eval을 호출한 호출 컨텍스트의 변수 환경에 변수 또는 함수 바인딩을 인스턴스화할 수 없습니다. 대신 이러한 바인딩은 eval 코드에서만 접근할 수 있는 새로운 VariableEnvironment에 인스턴스화됩니다. let, const 또는 class 선언이 도입한 바인딩은 항상 새로운 LexicalEnvironment에 인스턴스화됩니다.

19.2.1.2 HostEnsureCanCompileStrings ( `calleeRealm`, `paramStrings`, `bodyString`, `direct` )

호스트 정의 추상 연산 HostEnsureCanCompileStrings. 인수 calleeRealm (Realm 레코드), paramStrings (리스트 (요소: String)), bodyString (String) 및 direct (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호스트 환경이 개발자가 문자열을 ECMAScript 코드로 해석하고 평가할 수 있게 하는 특정 ECMAScript 함수를 차단할 수 있도록 합니다.

paramStrings는 함수 생성자 중 하나를 사용할 때 서로 연결되어 매개변수 목록을 구성하는 문자열을 나타냅니다. bodyString은 함수 본문 또는 eval 호출에 전달된 문자열을 나타냅니다. direct는 평가가 직접 eval인지 여부를 나타냅니다.

HostEnsureCanCompileStrings의 기본 구현은 NormalCompletion(unused)을 반환합니다.

19.2.1.3 EvalDeclarationInstantiation ( `body`, `variableEnv`, `lexicalEnv`, `privateEnv`, `strict` )

추상 연산 EvalDeclarationInstantiation. 인수 body (a ScriptBody Parse Node), variableEnv (Environment 레코드), lexicalEnv (Declarative Environment 레코드), privateEnv ((PrivateEnvironment 레코드 또는 null)) 및 strict (Boolean). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

variableNames를 body의 VarDeclaredNames로 둡니다.
variableDecls를 body의 VarScopedDeclarations로 둡니다.
strict가 false이면, 다음을 수행합니다.
1. variableEnv가 Global Environment Record이면, 다음을 수행합니다.
  1. variableNames의 각 요소 name에 대해 다음을 수행합니다.
    1. HasLexicalDeclaration(variableEnv, name)이 true이면 SyntaxError 예외를 던집니다.
    2. 참고: eval은 전역 렉시컬 선언에 의해 가려지는 전역 var 선언을 생성하지 않습니다.
2. thisEnv를 lexicalEnv로 둡니다.
3. 단언: 다음 반복은 종료됩니다.
4. thisEnv와 variableEnv가 동일한 Environment Record가 아닌 동안 다음을 반복합니다.
  1. thisEnv가 Object Environment Record가 아니면, 다음을 수행합니다.
    1. 참고: with 문의 환경에는 렉시컬 선언이 포함될 수 없으므로 var/let 호이스팅 충돌을 검사할 필요가 없습니다.
    2. variableNames의 각 요소 name에 대해 다음을 수행합니다.
      1. ! thisEnv.HasBinding(name)이 true이면, 다음을 수행합니다.
        Normative Optional
        호스트가 웹 브라우저이거나 그 밖의 방식으로 Catch 블록의 VariableStatement을 지원하면, 다음을 수행합니다.
        thisEnv가 Catch 절의 Environment Record가 아니면 SyntaxError 예외를 던집니다.
        그렇지 않으면,
        SyntaxError 예외를 던집니다.
      2. 참고: 직접 eval은 같은 이름의 렉시컬 선언을 넘어 var 선언을 호이스팅하지 않습니다.
  2. thisEnv를 thisEnv.[[OuterEnv]]로 설정합니다.
privateIdentifiers를 새로운 빈 List로 둡니다.
pointer를 privateEnv로 둡니다.
pointer가 null이 아닌 동안 다음을 반복합니다.
1. pointer.[[Names]]의 각 Private Name binding에 대해 다음을 수행합니다.
  1. privateIdentifiers에 binding.[[Description]]이 포함되어 있지 않으면 binding.[[Description]]을 privateIdentifiers에 추가합니다.
2. pointer를 pointer.[[OuterPrivateEnvironment]]로 설정합니다.
인수 privateIdentifiers를 사용한 body의 AllPrivateIdentifiersValid가 false이면 SyntaxError 예외를 던집니다.
funcsToInitialize를 새로운 빈 List로 둡니다.
declaredFuncNames를 새로운 빈 List로 둡니다.
variableDecls의 각 요소 variableDecl에 대해 List의 역순으로 다음을 수행합니다.
1. variableDecl이 VariableDeclaration, ForBinding 또는 BindingIdentifier 중 어느 것도 아니면, 다음을 수행합니다.
  1. 단언: variableDecl은 FunctionDeclaration, GeneratorDeclaration, AsyncFunctionDeclaration 또는 AsyncGeneratorDeclaration 중 하나입니다.
  2. 참고: 같은 이름에 여러 함수 선언이 있으면 마지막 선언이 사용됩니다.
  3. funcName을 variableDecl의 BoundNames의 유일한 요소로 둡니다.
  4. declaredFuncNames에 funcName이 포함되어 있지 않으면, 다음을 수행합니다.
    1. variableEnv가 Global Environment Record이면, 다음을 수행합니다.
      1. funcDefinable을 ? CanDeclareGlobalFunction(variableEnv, funcName)으로 둡니다.
      2. funcDefinable이 false이면 TypeError 예외를 던집니다.
    2. funcName을 declaredFuncNames에 추가합니다.
    3. variableDecl을 funcsToInitialize의 첫 번째 요소로 삽입합니다.
declaredVariableNames를 새로운 빈 List로 둡니다.
variableDecls의 각 요소 variableDecl에 대해 다음을 수행합니다.
1. variableDecl이 VariableDeclaration, ForBinding 또는 BindingIdentifier 중 하나이면, 다음을 수행합니다.
  1. variableDecl의 BoundNames의 각 String name에 대해 다음을 수행합니다.
    1. declaredFuncNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
      1. variableEnv가 Global Environment Record이면, 다음을 수행합니다.
        variableDefinable을 ? CanDeclareGlobalVar(variableEnv, name)로 둡니다.
        variableDefinable이 false이면 TypeError 예외를 던집니다.
      2. declaredVariableNames에 name이 포함되어 있지 않으면, 다음을 수행합니다.
        name을 declaredVariableNames에 추가합니다.
Normative Optional
strict가 false이고 호스트가 웹 브라우저이거나 그 밖의 방식으로 블록 수준 함수 선언의 웹 레거시 호환성 의미론을 지원하면, 다음을 수행합니다.
1. declaredFuncOrVariableNames를 declaredFuncNames와 declaredVariableNames의 목록 연결로 둡니다.
2. body Contains x가 true인 어떤 Block, CaseClause 또는 DefaultClause x의 StatementList에 직접 포함된 각 FunctionDeclaration funcDecl에 대해 다음을 수행합니다.
  1. funcName을 funcDecl의 BindingIdentifier의 StringValue로 둡니다.
  2. FunctionDeclaration funcDecl을 funcName을 BindingIdentifier로 갖는 VariableStatement로 바꿔도 body에 조기 오류가 발생하지 않으면, 다음을 수행합니다.
    1. bindingExists를 false로 둡니다.
    2. thisEnv를 lexicalEnv로 설정합니다.
    3. 단언: 다음 반복은 종료됩니다.
    4. thisEnv가 variableEnv가 아닌 동안 다음을 반복합니다.
      1. thisEnv가 Object Environment Record가 아니면, 다음을 수행합니다.
        ! thisEnv.HasBinding(funcName)이 true이면, 다음을 수행합니다.
        Normative Optional
        호스트가 웹 브라우저이거나 그 밖의 방식으로 Catch 블록의 VariableStatement을 지원하면, 다음을 수행합니다.
        thisEnv가 Catch 절의 Environment Record가 아니면 bindingExists를 true로 설정합니다.
        그렇지 않으면,
        bindingExists를 true로 설정합니다.
      2. thisEnv를 thisEnv.[[OuterEnv]]로 설정합니다.
    5. bindingExists가 false이고 variableEnv가 Global Environment Record이면, 다음을 수행합니다.
      1. HasLexicalDeclaration(variableEnv, funcName)이 false이면, 다음을 수행합니다.
        funcDefinable을 ? CanDeclareGlobalVar(variableEnv, funcName)로 둡니다.
      2. 그렇지 않으면,
        funcDefinable을 false로 둡니다.
    6. 그렇지 않으면,
      1. funcDefinable을 true로 둡니다.
    7. bindingExists가 false이고 funcDefinable이 true이면, 다음을 수행합니다.
      1. declaredFuncOrVariableNames에 funcName이 포함되어 있지 않으면, 다음을 수행합니다.
        variableEnv가 Global Environment Record이면, 다음을 수행합니다.
        ? CreateGlobalVarBinding(variableEnv, funcName, true)를 수행합니다.
        그렇지 않으면,
        bindingExists를 ! variableEnv.HasBinding(funcName)으로 설정합니다.
        bindingExists가 false이면, 다음을 수행합니다.
        ! variableEnv.CreateMutableBinding(funcName, true)를 수행합니다.
        ! variableEnv.InitializeBinding(funcName, undefined)를 수행합니다.
        funcName을 declaredFuncOrVariableNames에 추가합니다.
      2. FunctionDeclaration funcDecl이 평가될 때 15.2.6에 제공된 FunctionDeclaration Evaluation 알고리즘 대신 다음 단계를 수행합니다:
        globalEnv를 실행 중인 실행 컨텍스트의 VariableEnvironment로 둡니다.
        blockEnv를 실행 중인 실행 컨텍스트의 LexicalEnvironment로 둡니다.
        funcObj를 ! blockEnv.GetBindingValue(funcName, false)로 둡니다.
        ? globalEnv.SetMutableBinding(funcName, funcObj, false)를 수행합니다.
        unused를 반환합니다.
참고: variableEnv가 Global Environment Record이고 전역 객체가 Proxy 특수 객체인 경우를 제외하면 이 알고리즘 단계 이후에는 비정상 종료가 발생하지 않습니다.
lexicalDecls를 body의 LexicallyScopedDeclarations로 둡니다.
lexicalDecls의 각 요소 lexicalDecl에 대해 다음을 수행합니다.
1. 참고: 렉시컬하게 선언된 이름은 여기에서 인스턴스화되기만 하며 초기화되지는 않습니다.
2. lexicalDecl의 BoundNames의 각 요소 name에 대해 다음을 수행합니다.
  1. lexicalDecl의 IsConstantDeclaration이 true이면, 다음을 수행합니다.
    1. ? lexicalEnv.CreateImmutableBinding(name, true)를 수행합니다.
  2. 그렇지 않으면,
    1. ? lexicalEnv.CreateMutableBinding(name, false)를 수행합니다.
funcsToInitialize의 각 Parse Node funcDecl에 대해 다음을 수행합니다.
1. funcName을 funcDecl의 BoundNames의 유일한 요소로 둡니다.
2. funcObj를 인수 lexicalEnv 및 privateEnv를 사용한 funcDecl의 InstantiateFunctionObject로 둡니다.
3. variableEnv가 Global Environment Record이면, 다음을 수행합니다.
  1. ? CreateGlobalFunctionBinding(variableEnv, funcName, funcObj, true)를 수행합니다.
4. 그렇지 않으면,
  1. bindingExists를 ! variableEnv.HasBinding(funcName)으로 둡니다.
  2. bindingExists가 false이면, 다음을 수행합니다.
    1. 참고: 다음 호출은 14 단계에 앞선 검증으로 인해 비정상 완료를 반환할 수 없습니다.
    2. ! variableEnv.CreateMutableBinding(funcName, true)를 수행합니다.
    3. ! variableEnv.InitializeBinding(funcName, funcObj)를 수행합니다.
  3. 그렇지 않으면,
    1. ! variableEnv.SetMutableBinding(funcName, funcObj, false)를 수행합니다.
declaredVariableNames의 각 String variableName에 대해 다음을 수행합니다.
1. variableEnv가 Global Environment Record이면, 다음을 수행합니다.
  1. ? CreateGlobalVarBinding(variableEnv, variableName, true)를 수행합니다.
2. 그렇지 않으면,
  1. bindingExists를 ! variableEnv.HasBinding(variableName)으로 둡니다.
  2. bindingExists가 false이면, 다음을 수행합니다.
    1. 참고: 다음 호출은 14 단계에 앞선 검증으로 인해 비정상 완료를 반환할 수 없습니다.
    2. ! variableEnv.CreateMutableBinding(variableName, true)를 수행합니다.
    3. ! variableEnv.InitializeBinding(variableName, undefined)를 수행합니다.
unused를 반환합니다.

19.2.2 isFinite ( `value` )

이 함수는 %isFinite% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

number를 ? ToNumber(value)로 둡니다.
number가 유한 Number이면 true를 반환합니다.
false를 반환합니다.

19.2.3 isNaN ( `value` )

이 함수는 %isNaN% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

number를 ? ToNumber(value)로 둡니다.
number가 NaN이면 true를 반환합니다.
false를 반환합니다.

참고

ECMAScript 코드에서 값 X가 NaN인지 안정적으로 검사하는 방법은 X !== X 형식의 표현식을 사용하는 것입니다. X가 NaN인 경우에만 결과가 true입니다.

19.2.4 parseFloat ( `string` )

이 함수는 string 인수의 내용을 십진수 리터럴로 해석하여 결정되는 Number 값을 생성합니다.

이 함수는 %parseFloat% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

inputString을 ? ToString(string)으로 둡니다.
trimmedString을 ! TrimString(inputString, start)으로 둡니다.
trimmed를 StringToCodePoints(trimmedString)로 둡니다.
trimmedPrefix를 StrDecimalLiteral의 구문을 만족하는 trimmed의 가장 긴 접두사로 둡니다. 이는 trimmed 자체일 수도 있습니다. 이러한 접두사가 없으면 NaN을 반환합니다.
parsedNumber를 ParseText(trimmedPrefix, StrDecimalLiteral)로 둡니다.
단언: parsedNumber는 Parse Node입니다.
parsedNumber의 StringNumericValue를 반환합니다.

참고

이 함수는 string의 앞부분만 Number 값으로 해석할 수 있습니다. 십진수 리터럴 표기의 일부로 해석할 수 없는 코드 단위는 무시하며 이러한 코드 단위가 무시되었다는 어떠한 표시도 제공하지 않습니다.

19.2.5 parseInt ( `string`, `radix` )

이 함수는 지정된 radix에 따라 string의 내용을 해석하여 결정되는 정수 Number를 생성합니다. string 앞의 공백은 무시됩니다. radix가 0으로 강제 변환되면(undefined인 경우 등) 숫자 표현이 "0x" 또는 "0X"로 시작하는 경우를 제외하고 10으로 간주하며, 해당 경우에는 16으로 간주합니다. radix가 16이면 숫자 표현은 선택적으로 "0x" 또는 "0X"로 시작할 수 있습니다.

이 함수는 %parseInt% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

inputString을 ? ToString(string)으로 둡니다.
radixMV를 ℝ(? ToInt32(radix))로 둡니다.
radixMV ≠ 0이고 radixMV가 2부터 36까지의 폐구간에 속하지 않으면 NaN을 반환합니다.
trimmedString을 ! TrimString(inputString, start)으로 둡니다.
trimmedString이 빈 String이면 NaN을 반환합니다.
sign을 1로 둡니다.
trimmedString의 첫 번째 코드 단위가 코드 단위 0x002D (HYPHEN-MINUS)이면, 다음을 수행합니다.
1. sign을 -1로 설정합니다.
2. trimmedString을 trimmedString의 인덱스 1부터의 부분 문자열로 설정합니다.
그렇지 않고 trimmedString의 첫 번째 코드 단위가 코드 단위 0x002B (PLUS SIGN)이면, 다음을 수행합니다.
1. trimmedString을 trimmedString의 인덱스 1부터의 부분 문자열로 설정합니다.
radixMV = 0 또는 radixMV = 16이면, 다음을 수행합니다.
1. trimmedString의 길이가 ≥ 2이고 trimmedString의 인덱스 0부터 2까지의 부분 문자열이 "0x" 또는 "0X" 중 하나이면, 다음을 수행합니다.
  1. trimmedString을 trimmedString의 인덱스 2부터의 부분 문자열로 설정합니다.
  2. radixMV를 16으로 설정합니다.
radixMV = 0이면 radixMV를 10으로 설정합니다.
trimmedString에 기수-radixMV 숫자가 아닌 코드 단위가 포함되어 있으면 end를 trimmedString 안에서 그러한 첫 번째 코드 단위의 인덱스로 둡니다. 그렇지 않으면 end를 trimmedString의 길이로 둡니다.
numberString을 trimmedString의 인덱스 0부터 end까지의 부분 문자열로 둡니다.
numberString이 비어 있으면 NaN을 반환합니다.
mathInt를 값 10부터 35까지의 숫자에 문자 A부터 Z 및 a부터 z를 사용하여 기수-radixMV 표기법으로 numberString이 나타내는 정수 값으로 둡니다. (다만 radixMV = 10이고 numberString에 유효 숫자가 20개보다 많으면 구현체의 선택에 따라 20번째 이후의 모든 유효 숫자를 숫자 0으로 바꿀 수 있습니다. 또한 radixMV가 2, 4, 8, 10, 16 또는 32 중 하나가 아니면 mathInt는 기수-radixMV 표기법에서 numberString이 나타내는 정수 값을 표현하는 구현체 근사 정수일 수 있습니다.)
sign = -1이고 mathInt = 0이면 -0_𝔽을 반환합니다.
𝔽(sign × mathInt)을 반환합니다.

참고

이 함수는 string의 앞부분만 정수 값으로 해석할 수 있습니다. 정수 표기의 일부로 해석할 수 없는 코드 단위는 무시하며 이러한 코드 단위가 무시되었다는 어떠한 표시도 제공하지 않습니다.

19.2.6 URI 처리 함수

Uniform Resource Identifier, 즉 URI는 인터넷에서 리소스(예: 웹 페이지 또는 파일)와 이에 접근하기 위한 전송 프로토콜(예: HTTP 또는 FTP)을 식별하는 String입니다. ECMAScript 언어 자체는 이 절에 설명된 URI 인코딩 및 디코딩 함수를 제외하고 URI 사용을 지원하지 않습니다. encodeURI와 decodeURI는 완전한 URI를 처리하기 위한 것입니다. 예약 문자는 특별한 의미(예: 구분자로서)를 갖도록 의도되었다고 가정하므로 인코딩하지 않습니다. encodeURIComponent와 decodeURIComponent는 URI의 개별 구성 요소를 처리하기 위한 것입니다. 예약 문자는 텍스트를 나타낸다고 가정하며 구성 요소가 완전한 URI의 일부가 되었을 때 특별한 의미를 갖지 않도록 인코딩해야 합니다.

참고 1

예약 문자 집합은 RFC 2396을 기반으로 하며 더 최신인 RFC 3986에서 도입된 변경 사항은 반영하지 않습니다.

참고 2

많은 ECMAScript 구현체는 웹 페이지를 조작하는 추가 함수와 메서드를 제공합니다. 이러한 함수는 이 표준의 범위를 벗어납니다.

19.2.6.1 decodeURI ( `encodedURI` )

이 함수는 encodeURI 함수가 도입할 수 있는 종류의 각 이스케이프 시퀀스 및 UTF-8 인코딩을 해당 코드 포인트의 UTF-16 인코딩으로 바꾼 새로운 URI 버전을 계산합니다. encodeURI가 도입할 수 없었던 이스케이프 시퀀스는 바꾸지 않습니다.

이 함수는 %decodeURI% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

uriString을 ? ToString(encodedURI)로 둡니다.
preserveEscapeSet을 ";/?:@&=+$,#"로 둡니다.
? Decode(uriString, preserveEscapeSet)를 반환합니다.

19.2.6.2 decodeURIComponent ( `encodedURIComponent` )

이 함수는 encodeURIComponent 함수가 도입할 수 있는 종류의 각 이스케이프 시퀀스 및 UTF-8 인코딩을 해당 코드 포인트의 UTF-16 인코딩으로 바꾼 새로운 URI 버전을 계산합니다.

이 함수는 %decodeURIComponent% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

componentString을 ? ToString(encodedURIComponent)로 둡니다.
preserveEscapeSet을 빈 String으로 둡니다.
? Decode(componentString, preserveEscapeSet)를 반환합니다.

19.2.6.3 encodeURI ( `uri` )

이 함수는 특정 코드 포인트의 각 인스턴스를 해당 코드 포인트의 UTF-8 인코딩을 나타내는 하나, 둘, 셋 또는 네 개의 이스케이프 시퀀스로 바꾼 UTF-16 인코딩(6.1.4) URI의 새로운 버전을 계산합니다.

이 함수는 %encodeURI% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

uriString을 ? ToString(uri)로 둡니다.
extraUnescaped를 ";/?:@&=+$,#"로 둡니다.
? Encode(uriString, extraUnescaped)를 반환합니다.

19.2.6.4 encodeURIComponent ( `uriComponent` )

이 함수는 %encodeURIComponent% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

componentString을 ? ToString(uriComponent)로 둡니다.
extraUnescaped를 빈 String으로 둡니다.
? Encode(componentString, extraUnescaped)를 반환합니다.

19.2.6.5 Encode ( `string`, `extraUnescaped` )

추상 연산 Encode. 인수 string (String) 및 extraUnescaped (String). 반환값: (정상 완료 (값: String) 또는 throw 완료). 6.1.4에 설명된 대로 string을 UTF-16으로 인코딩된 코드 포인트의 시퀀스로 해석하여 URI 인코딩 및 이스케이프를 수행합니다. 문자가 RFC 2396에서 예약되지 않은 문자로 식별되거나 extraUnescaped에 나타나면 이스케이프하지 않습니다. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
result를 빈 String으로 둡니다.
alwaysUnescaped를 ASCII 단어 문자와 "-.!~*'()"의 문자열 연결로 둡니다.
unescapedSet을 alwaysUnescaped와 extraUnescaped의 문자열 연결로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. codeUnit을 string 안의 인덱스 k에 있는 코드 단위로 둡니다.
2. unescapedSet에 codeUnit이 포함되어 있으면, 다음을 수행합니다.
  1. k를 k + 1로 설정합니다.
  2. result를 result와 codeUnit의 문자열 연결로 설정합니다.
3. 그렇지 않으면,
  1. codePoint를 CodePointAt(string, k)로 둡니다.
  2. codePoint.[[IsUnpairedSurrogate]]가 true이면 URIError 예외를 던집니다.
  3. k를 k + codePoint.[[CodeUnitCount]]로 설정합니다.
  4. octets를 codePoint.[[CodePoint]]에 UTF-8 변환을 적용하여 얻은 옥텟의 List로 둡니다.
  5. octets의 각 요소 octet에 대해 다음을 수행합니다.
    1. hex를 octet을 대문자 16진수로 형식화한 String 표현으로 둡니다.
    2. result를 result, "%" 및 StringPad(hex, 2, "0", start)의 문자열 연결로 설정합니다.
result를 반환합니다.

참고

퍼센트 인코딩은 개별 옥텟을 나타내는 데 사용되므로 하나의 코드 포인트는 여러 개의 연속된 이스케이프 시퀀스(각 8비트 UTF-8 코드 단위마다 하나씩)로 표현될 수 있습니다.

19.2.6.6 Decode ( `string`, `preserveEscapeSet` )

추상 연산 Decode. 인수 string (String) 및 preserveEscapeSet (String). 반환값: (정상 완료 (값: String) 또는 throw 완료). preserveEscapeSet의 Basic Latin 문자에 대응하는 모든 이스케이프 시퀀스를 유지하면서 URI 이스케이프 해제 및 디코딩을 수행합니다. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
result를 빈 String으로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. codeUnit을 string 안의 인덱스 k에 있는 코드 단위로 둡니다.
2. segment를 codeUnit으로 둡니다.
3. codeUnit이 코드 단위 0x0025 (PERCENT SIGN)이면, 다음을 수행합니다.
  1. k + 3 > length이면 URIError 예외를 던집니다.
  2. escape를 string의 인덱스 k부터 k + 3까지의 부분 문자열로 둡니다.
  3. firstOctet을 ParseHexOctet(string, k + 1)로 둡니다.
  4. firstOctet이 정수가 아니면 URIError 예외를 던집니다.
  5. k를 k + 2로 설정합니다.
  6. n을 firstOctet에서 앞쪽의 1 비트 수로 둡니다.
  7. n = 0이면, 다음을 수행합니다.
    1. asciiChar를 숫자 값이 firstOctet인 코드 단위로 둡니다.
    2. preserveEscapeSet에 asciiChar가 포함되어 있으면 segment를 escape로 설정합니다. 그렇지 않으면 segment를 asciiChar로 설정합니다.
  8. 그렇지 않으면,
    1. n = 1 또는 n > 4이면 URIError 예외를 던집니다.
    2. octets를 « firstOctet »으로 둡니다.
    3. j를 1로 둡니다.
    4. j < n인 동안 다음을 반복합니다.
      1. k를 k + 1로 설정합니다.
      2. k + 3 > length이면 URIError 예외를 던집니다.
      3. string 안의 인덱스 k에 있는 코드 단위가 코드 단위 0x0025 (PERCENT SIGN)가 아니면 URIError 예외를 던집니다.
      4. continuationByte를 ParseHexOctet(string, k + 1)로 둡니다.
      5. continuationByte가 정수가 아니면 URIError 예외를 던집니다.
      6. continuationByte를 octets에 추가합니다.
      7. k를 k + 2로 설정합니다.
      8. j를 j + 1로 설정합니다.
    5. 단언: octets의 길이는 n입니다.
    6. octets에 유효한 유니코드 코드 포인트의 UTF-8 인코딩이 포함되어 있지 않으면 URIError 예외를 던집니다.
    7. codePoint를 octets에 UTF-8 변환을 적용하여, 즉 옥텟의 List를 21비트 값으로 변환하여 얻은 코드 포인트로 둡니다.
    8. segment를 UTF16EncodeCodePoint(codePoint)로 설정합니다.
4. result를 result와 segment의 문자열 연결로 설정합니다.
5. k를 k + 1로 설정합니다.
result를 반환합니다.

참고

RFC 3629는 유효하지 않은 UTF-8 옥텟 시퀀스의 디코딩을 금지합니다. 예를 들어 유효하지 않은 시퀀스 0xC0 0x80은 코드 단위 0x0000으로 디코딩되어서는 안 됩니다. Decode 알고리즘 구현체는 이러한 유효하지 않은 시퀀스를 발견하면 URIError를 던져야 합니다.

19.2.6.7 ParseHexOctet ( `string`, `position` )

추상 연산 ParseHexOctet. 인수 string (String) 및 position (음이 아닌 정수). 반환값: (음이 아닌 정수 또는 a non-empty List of SyntaxError objects). string의 지정된 position에 있는 두 개의 16진수 문자 시퀀스를 부호 없는 8비트 정수로 파싱합니다. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
단언: position + 2 ≤ length입니다.
hexDigits를 string의 position부터 position + 2까지의 부분 문자열로 둡니다.
parseResult를 ParseText(hexDigits, HexDigits[~Sep])로 둡니다.
parseResult가 Parse Node가 아니면 parseResult를 반환합니다.
n을 parseResult의 MV로 둡니다.
단언: n은 0부터 255까지의 폐구간에 속합니다.
n을 반환합니다.

19.3 전역 객체의 생성자 프로퍼티

19.3.1 AggregateError ( . . . )

20.5.7.1를 참조하시기 바랍니다.

19.3.2 Array ( . . . )

23.1.1를 참조하시기 바랍니다.

19.3.3 ArrayBuffer ( . . . )

25.1.4를 참조하시기 바랍니다.

19.3.4 AsyncDisposableStack ( . . . )

27.4.1를 참조하시기 바랍니다.

19.3.5 BigInt ( . . . )

21.2.1를 참조하시기 바랍니다.

19.3.6 BigInt64Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.7 BigUint64Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.8 Boolean ( . . . )

20.3.1를 참조하시기 바랍니다.

19.3.9 DataView ( . . . )

25.3.2를 참조하시기 바랍니다.

19.3.10 Date ( . . . )

21.4.2를 참조하시기 바랍니다.

19.3.11 DisposableStack ( . . . )

27.3.1를 참조하시기 바랍니다.

19.3.12 Error ( . . . )

20.5.1를 참조하시기 바랍니다.

19.3.13 EvalError ( . . . )

20.5.5.1를 참조하시기 바랍니다.

19.3.14 FinalizationRegistry ( . . . )

26.2.1를 참조하시기 바랍니다.

19.3.15 Float16Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.16 Float32Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.17 Float64Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.18 Function ( . . . )

20.2.1를 참조하시기 바랍니다.

19.3.19 Int8Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.20 Int16Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.21 Int32Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.22 Iterator ( . . . )

27.1.3.1를 참조하시기 바랍니다.

19.3.23 Map ( . . . )

24.1.1를 참조하시기 바랍니다.

19.3.24 Number ( . . . )

21.1.1를 참조하시기 바랍니다.

19.3.25 Object ( . . . )

20.1.1를 참조하시기 바랍니다.

19.3.26 Promise ( . . . )

27.5.3를 참조하시기 바랍니다.

19.3.27 Proxy ( . . . )

28.2.1를 참조하시기 바랍니다.

19.3.28 RangeError ( . . . )

20.5.5.2를 참조하시기 바랍니다.

19.3.29 ReferenceError ( . . . )

20.5.5.3를 참조하시기 바랍니다.

19.3.30 RegExp ( . . . )

22.2.4를 참조하시기 바랍니다.

19.3.31 Set ( . . . )

24.2.2를 참조하시기 바랍니다.

19.3.32 SharedArrayBuffer ( . . . )

25.2.3를 참조하시기 바랍니다.

19.3.33 String ( . . . )

22.1.1를 참조하시기 바랍니다.

19.3.34 SuppressedError ( . . . )

20.5.8.1를 참조하시기 바랍니다.

19.3.35 Symbol ( . . . )

20.4.1를 참조하시기 바랍니다.

19.3.36 SyntaxError ( . . . )

20.5.5.4를 참조하시기 바랍니다.

19.3.37 TypeError ( . . . )

20.5.5.5를 참조하시기 바랍니다.

19.3.38 Uint8Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.39 Uint8ClampedArray ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.40 Uint16Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.41 Uint32Array ( . . . )

23.2.5를 참조하시기 바랍니다.

19.3.42 URIError ( . . . )

20.5.5.6를 참조하시기 바랍니다.

19.3.43 WeakMap ( . . . )

24.3.1를 참조하시기 바랍니다.

19.3.44 WeakRef ( . . . )

26.1.1를 참조하시기 바랍니다.

19.3.45 WeakSet ( . . . )

24.4를 참조하시기 바랍니다.

19.4 전역 객체의 기타 프로퍼티

19.4.1 Atomics

25.4를 참조하시기 바랍니다.

19.4.2 JSON

25.5를 참조하시기 바랍니다.

19.4.3 Math

21.3를 참조하시기 바랍니다.

19.4.4 Reflect

28.1를 참조하시기 바랍니다.

20 기본 객체

20.1 Object 객체

20.1.1 Object 생성자

Object 생성자는:

%Object%입니다.
전역 객체의 "Object" 프로퍼티 초기 값입니다.
생성자로 호출되면 새로운 일반 객체를 생성합니다.
생성자가 아니라 함수로 호출되면 타입 변환을 수행합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다.

20.1.1.1 Object ( `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined도 활성 함수 객체도 아니면, 다음을 수행합니다.
1. ? OrdinaryCreateFromConstructor(NewTarget, "%Object.prototype%")를 반환합니다.
value가 undefined 또는 null이면 OrdinaryObjectCreate(%Object.prototype%)를 반환합니다.
! ToObject(value)를 반환합니다.

20.1.2 Object 생성자의 프로퍼티

Object 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음과 같은 추가 프로퍼티를 갖습니다:

20.1.2.1 Object.assign ( `target`, ...`sources` )

이 함수는 하나 이상의 소스 객체에서 열거 가능한 모든 자체 프로퍼티의 값을 target 객체로 복사합니다.

호출되면 다음 단계를 수행합니다:

targetObj를 ? ToObject(target)로 둡니다.
인수가 하나만 전달되었으면 targetObj를 반환합니다.
sources의 각 요소 nextSource에 대해 다음을 수행합니다.
1. nextSource가 undefined도 null도 아니면, 다음을 수행합니다.
  1. from을 ! ToObject(nextSource)로 둡니다.
  2. keys를 ? from.[[OwnPropertyKeys]]()로 둡니다.
  3. keys의 각 요소 nextKey에 대해 다음을 수행합니다.
    1. propertyDesc를 ? from.[[GetOwnProperty]](nextKey)로 둡니다.
    2. propertyDesc가 undefined가 아니고 propertyDesc.[[Enumerable]]이 true이면, 다음을 수행합니다.
      1. propertyValue를 ? Get(from, nextKey)로 둡니다.
      2. ? Set(targetObj, nextKey, propertyValue, true)를 수행합니다.
targetObj를 반환합니다.

이 함수의 "length" 프로퍼티는 2_𝔽입니다.

20.1.2.2 Object.create ( `proto`, `properties` )

이 함수는 지정된 프로토타입을 갖는 새로운 객체를 생성합니다.

호출되면 다음 단계를 수행합니다:

proto가 Object가 아니고 proto가 null도 아니면 TypeError 예외를 던집니다.
obj를 OrdinaryObjectCreate(proto)로 둡니다.
properties가 undefined가 아니면, 다음을 수행합니다.
1. ? ObjectDefineProperties(obj, properties)를 반환합니다.
obj를 반환합니다.

20.1.2.3 Object.defineProperties ( `obj`, `properties` )

이 함수는 객체에 자체 프로퍼티를 추가하거나 기존 자체 프로퍼티의 속성을 갱신합니다.

호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 TypeError 예외를 던집니다.
? ObjectDefineProperties(obj, properties)를 반환합니다.

20.1.2.3.1 ObjectDefineProperties ( `obj`, `properties` )

추상 연산 ObjectDefineProperties. 인수 obj (Object) 및 properties (ECMAScript 언어 값). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

properties를 ? ToObject(properties)로 설정합니다.
keys를 ? properties.[[OwnPropertyKeys]]()로 둡니다.
propertyDescs를 새로운 빈 List로 둡니다.
keys의 각 요소 nextKey에 대해 다음을 수행합니다.
1. currentPropertyDesc를 ? properties.[[GetOwnProperty]](nextKey)로 둡니다.
2. currentPropertyDesc가 undefined가 아니고 currentPropertyDesc.[[Enumerable]]이 true이면, 다음을 수행합니다.
  1. propertyDescObj를 ? Get(properties, nextKey)로 둡니다.
  2. propertyDesc를 ? ToPropertyDescriptor(propertyDescObj)로 둡니다.
  3. Record { [[Key]]: nextKey, [[Descriptor]]: propertyDesc }를 propertyDescs에 추가합니다.
propertyDescs의 각 요소 property에 대해 다음을 수행합니다.
1. ? DefinePropertyOrThrow(obj, property.[[Key]], property.[[Descriptor]])를 수행합니다.
obj를 반환합니다.

20.1.2.4 Object.defineProperty ( `obj`, `key`, `attrs` )

이 함수는 객체에 자체 프로퍼티를 추가하거나 기존 자체 프로퍼티의 속성을 갱신합니다.

호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
propertyDesc를 ? ToPropertyDescriptor(attrs)로 둡니다.
? DefinePropertyOrThrow(obj, propertyKey, propertyDesc)를 수행합니다.
obj를 반환합니다.

20.1.2.5 Object.entries ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
entryList를 ? EnumerableOwnProperties(coerced, key+value)로 둡니다.
CreateArrayFromList(entryList)를 반환합니다.

20.1.2.6 Object.freeze ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 obj를 반환합니다.
status를 ? SetIntegrityLevel(obj, frozen)으로 둡니다.
status가 false이면 TypeError 예외를 던집니다.
obj를 반환합니다.

20.1.2.7 Object.fromEntries ( `iterable` )

이 함수는 호출되면 다음 단계를 수행합니다:

? RequireObjectCoercible(iterable)을 수행합니다.
obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
단언: obj는 자체 프로퍼티가 없는 확장 가능한 일반 객체입니다.
closure를 매개변수 (key, value)를 갖고 obj를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. propertyKey를 ? ToPropertyKey(key)로 둡니다.
2. ! CreateDataPropertyOrThrow(obj, propertyKey, value)를 수행합니다.
3. NormalCompletion(undefined)을 반환합니다.
adder를 CreateBuiltinFunction(closure, 2, "", « »)로 둡니다.
? AddEntriesFromIterable(obj, iterable, adder)를 반환합니다.

참고

adder를 위해 생성된 함수는 ECMAScript 코드에서 절대로 직접 접근할 수 없습니다.

20.1.2.8 Object.getOwnPropertyDescriptor ( `obj`, `key` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
propertyDesc를 ? coerced.[[GetOwnProperty]](propertyKey)로 둡니다.
FromPropertyDescriptor(propertyDesc)를 반환합니다.

20.1.2.9 Object.getOwnPropertyDescriptors ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
ownKeys를 ? coerced.[[OwnPropertyKeys]]()로 둡니다.
descs를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
ownKeys의 각 요소 key에 대해 다음을 수행합니다.
1. propertyDesc를 ? coerced.[[GetOwnProperty]](key)로 둡니다.
2. propertyDescObj를 FromPropertyDescriptor(propertyDesc)로 둡니다.
3. propertyDescObj가 undefined가 아니면 ! CreateDataPropertyOrThrow(descs, key, propertyDescObj)를 수행합니다.
descs를 반환합니다.

20.1.2.10 Object.getOwnPropertyNames ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

CreateArrayFromList(? GetOwnPropertyKeys(obj, string))를 반환합니다.

20.1.2.11 Object.getOwnPropertySymbols ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

CreateArrayFromList(? GetOwnPropertyKeys(obj, symbol))를 반환합니다.

20.1.2.11.1 GetOwnPropertyKeys ( `value`, `type` )

추상 연산 GetOwnPropertyKeys. 인수 value (ECMAScript 언어 값) 및 type ((string 또는 symbol)). 반환값: (정상 완료 (값: 리스트 (요소: 프로퍼티 키)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

obj를 ? ToObject(value)로 둡니다.
keys를 ? obj.[[OwnPropertyKeys]]()로 둡니다.
nameList를 새로운 빈 List로 둡니다.
keys의 각 요소 nextKey에 대해 다음을 수행합니다.
1. nextKey가 Symbol이고 type이 symbol이거나, nextKey가 String이고 type이 string이면, 다음을 수행합니다.
  1. nextKey를 nameList에 추가합니다.
nameList를 반환합니다.

20.1.2.12 Object.getPrototypeOf ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
? coerced.[[GetPrototypeOf]]()를 반환합니다.

20.1.2.13 Object.groupBy ( `items`, `callback` )

참고

callback은 두 개의 인수를 받는 함수여야 합니다. groupBy는 items의 각 요소에 대해 오름차순으로 callback을 한 번씩 호출하고 새로운 객체를 구성합니다. callback이 반환한 각 값은 프로퍼티 키로 강제 변환됩니다. 이러한 각 프로퍼티 키에 대해 결과 객체는 해당 키를 프로퍼티 키로 하고 callback 반환 값이 해당 키로 강제 변환된 모든 요소를 포함하는 배열을 값으로 하는 프로퍼티를 갖습니다.

callback은 요소의 값과 요소의 인덱스라는 두 개의 인수로 호출됩니다.

groupBy의 반환 값은 %Object.prototype%에서 상속하지 않는 객체입니다.

이 함수는 호출되면 다음 단계를 수행합니다:

groups를 ? GroupBy(items, callback, property)로 둡니다.
obj를 OrdinaryObjectCreate(null)로 둡니다.
groups의 각 Record { [[Key]], [[Elements]] } group에 대해 다음을 수행합니다.
1. elements를 CreateArrayFromList(group.[[Elements]])로 둡니다.
2. ! CreateDataPropertyOrThrow(obj, group.[[Key]], elements)를 수행합니다.
obj를 반환합니다.

20.1.2.14 Object.hasOwn ( `obj`, `key` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
? HasOwnProperty(coerced, propertyKey)를 반환합니다.

20.1.2.15 Object.is ( `value1`, `value2` )

이 함수는 호출되면 다음 단계를 수행합니다:

SameValue(value1, value2)를 반환합니다.

20.1.2.16 Object.isExtensible ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 false를 반환합니다.
? IsExtensible(obj)을 반환합니다.

20.1.2.17 Object.isFrozen ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 true를 반환합니다.
? TestIntegrityLevel(obj, frozen)을 반환합니다.

20.1.2.18 Object.isSealed ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 true를 반환합니다.
? TestIntegrityLevel(obj, sealed)을 반환합니다.

20.1.2.19 Object.keys ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
keyList를 ? EnumerableOwnProperties(coerced, key)로 둡니다.
CreateArrayFromList(keyList)를 반환합니다.

20.1.2.20 Object.preventExtensions ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 obj를 반환합니다.
status를 ? obj.[[PreventExtensions]]()로 둡니다.
status가 false이면 TypeError 예외를 던집니다.
obj를 반환합니다.

20.1.2.21 Object.prototype

Object.prototype의 초기 값은 Object 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.1.2.22 Object.seal ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object가 아니면 obj를 반환합니다.
status를 ? SetIntegrityLevel(obj, sealed)로 둡니다.
status가 false이면 TypeError 예외를 던집니다.
obj를 반환합니다.

20.1.2.23 Object.setPrototypeOf ( `obj`, `proto` )

이 함수는 호출되면 다음 단계를 수행합니다:

? RequireObjectCoercible(obj)을 수행합니다.
proto가 Object가 아니고 proto가 null도 아니면 TypeError 예외를 던집니다.
obj가 Object가 아니면 obj를 반환합니다.
status를 ? obj.[[SetPrototypeOf]](proto)로 둡니다.
status가 false이면 TypeError 예외를 던집니다.
obj를 반환합니다.

20.1.2.24 Object.values ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

coerced를 ? ToObject(obj)로 둡니다.
valueList를 ? EnumerableOwnProperties(coerced, value)로 둡니다.
CreateArrayFromList(valueList)를 반환합니다.

20.1.3 Object 프로토타입 객체의 프로퍼티

Object 프로토타입 객체는:

%Object.prototype%입니다.
값이 true인 [[Extensible]] 내부 슬롯을 갖습니다.
10.4.7.1에 정의된 [[SetPrototypeOf]] 메서드를 제외하고 일반 객체에 정의된 내부 메서드를 갖습니다. (따라서 불변 프로토타입 특수 객체입니다.)
값이 null인 [[Prototype]] 내부 슬롯을 갖습니다.

20.1.3.1 Object.prototype.constructor

Object.prototype.constructor의 초기 값은 %Object%입니다.

20.1.3.2 Object.prototype.hasOwnProperty ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

propertyKey를 ? ToPropertyKey(value)로 둡니다.
obj를 ? ToObject(this 값)로 둡니다.
? HasOwnProperty(obj, propertyKey)를 반환합니다.

참고

1 및 2 단계의 순서는 this 값이 undefined 또는 null인 경우에도 이 명세의 이전 판에서 1 단계가 던졌을 예외가 계속 던져지도록 하기 위해 선택되었습니다.

20.1.3.3 Object.prototype.isPrototypeOf ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

value가 Object가 아니면 false를 반환합니다.
obj를 ? ToObject(this 값)로 둡니다.
다음을 반복합니다.
1. value를 ? value.[[GetPrototypeOf]]()로 설정합니다.
2. value가 null이면 false를 반환합니다.
3. SameValue(obj, value)가 true이면 true를 반환합니다.

참고

1 및 2 단계의 순서는 value가 객체가 아니고 this 값이 undefined 또는 null인 경우에 대해 이 명세의 이전 판에서 명시한 동작을 보존합니다.

20.1.3.4 Object.prototype.propertyIsEnumerable ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

propertyKey를 ? ToPropertyKey(value)로 둡니다.
obj를 ? ToObject(this 값)로 둡니다.
propertyDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
propertyDesc가 undefined이면 false를 반환합니다.
propertyDesc.[[Enumerable]]을 반환합니다.

참고 1

이 메서드는 프로토타입 체인의 객체를 고려하지 않습니다.

참고 2

1 및 2 단계의 순서는 this 값이 undefined 또는 null인 경우에도 이 명세의 이전 판에서 1 단계가 던졌을 예외가 계속 던져지도록 하기 위해 선택되었습니다.

20.1.3.5 Object.prototype.toLocaleString ( [ `reserved1` [ , `reserved2` ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? Invoke(thisValue, "toString")을 반환합니다.

이 메서드의 선택적 매개변수는 사용되지 않지만 ECMA-402 toLocaleString 메서드가 사용하는 매개변수 패턴에 대응하도록 의도되었습니다. ECMA-402 지원을 포함하지 않는 구현체는 해당 매개변수 위치를 다른 목적으로 사용해서는 안 됩니다.

참고 1

이 메서드는 로케일에 민감한 toString 동작을 갖지 않는 객체에 대한 일반적인 toLocaleString 구현을 제공합니다. Array, Number, Date 및 %TypedArray%는 각자의 로케일에 민감한 toLocaleString 메서드를 제공합니다.

참고 2

ECMA-402는 의도적으로 이 기본 구현의 대안을 제공하지 않습니다.

20.1.3.6 Object.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

this 값이 undefined이면 "[object Undefined]"를 반환합니다.
this 값이 null이면 "[object Null]"을 반환합니다.
obj를 ! ToObject(this 값)로 둡니다.
isArray를 ? IsArray(obj)로 둡니다.
isArray가 true이면 builtinTag를 "Array"로 둡니다.
그렇지 않고 obj가 [[ParameterMap]] 내부 슬롯을 가지면 builtinTag를 "Arguments"로 둡니다.
그렇지 않고 obj가 [[Call]] 내부 메서드를 가지면 builtinTag를 "Function"으로 둡니다.
그렇지 않고 obj가 [[ErrorData]] 내부 슬롯을 가지면 builtinTag를 "Error"로 둡니다.
그렇지 않고 obj가 [[BooleanData]] 내부 슬롯을 가지면 builtinTag를 "Boolean"으로 둡니다.
그렇지 않고 obj가 [[NumberData]] 내부 슬롯을 가지면 builtinTag를 "Number"로 둡니다.
그렇지 않고 obj가 [[StringData]] 내부 슬롯을 가지면 builtinTag를 "String"으로 둡니다.
그렇지 않고 obj가 [[DateValue]] 내부 슬롯을 가지면 builtinTag를 "Date"로 둡니다.
그렇지 않고 obj가 [[RegExpMatcher]] 내부 슬롯을 가지면 builtinTag를 "RegExp"로 둡니다.
그렇지 않으면 builtinTag를 "Object"로 둡니다.
tag를 ? Get(obj, %Symbol.toStringTag%)로 둡니다.
tag가 String이 아니면 tag를 builtinTag로 설정합니다.
"[object ", tag 및 "]"의 문자열 연결을 반환합니다.

참고

역사적으로 이 메서드는 이 명세의 이전 판에서 다양한 내장 객체의 명목상 타입 태그로 사용된 [[Class]] 내부 슬롯의 String 값에 접근하는 데 간혹 사용되었습니다. 위의 toString 정의는 이러한 특정 종류의 내장 객체를 검사하기 위해 toString을 사용하는 레거시 코드와의 호환성을 보존합니다. 다른 종류의 내장 객체 또는 프로그램 정의 객체에 대해서는 신뢰할 수 있는 타입 검사 메커니즘을 제공하지 않습니다. 또한 프로그램은 이러한 레거시 타입 검사의 신뢰성을 무효화하는 방식으로 %Symbol.toStringTag%를 사용할 수 있습니다.

20.1.3.7 Object.prototype.valueOf ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

? ToObject(this 값)를 반환합니다.

규정 선택 사항, 레거시

20.1.3.8 Object.prototype.proto

Object.prototype.__proto__는 { [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖는 접근자 프로퍼티입니다. [[Getter]] 및 [[Setter]] 속성은 다음과 같이 정의됩니다:

20.1.3.8.1 get Object.prototype.proto

[[Getter]] 속성의 값은 인수를 필요로 하지 않는 내장 함수입니다. 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)로 둡니다.
? obj.[[GetPrototypeOf]]()를 반환합니다.

20.1.3.8.2 set Object.prototype.proto

[[Setter]] 속성의 값은 인수 proto를 받는 내장 함수입니다. 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)을 수행합니다.
proto가 Object가 아니고 proto가 null도 아니면 undefined를 반환합니다.
thisValue가 Object가 아니면 undefined를 반환합니다.
status를 ? thisValue.[[SetPrototypeOf]](proto)로 둡니다.
status가 false이면 TypeError 예외를 던집니다.
undefined를 반환합니다.

규정 선택 사항, 레거시

20.1.3.9 레거시 Object.prototype 접근자 메서드

20.1.3.9.1 Object.prototype.defineGetter ( `key`, `getter` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)로 둡니다.
IsCallable(getter)가 false이면 TypeError 예외를 던집니다.
propertyDesc를 PropertyDescriptor { [[Getter]]: getter, [[Enumerable]]: true, [[Configurable]]: true }로 둡니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
? DefinePropertyOrThrow(obj, propertyKey, propertyDesc)를 수행합니다.
undefined를 반환합니다.

20.1.3.9.2 Object.prototype.defineSetter ( `key`, `setter` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)로 둡니다.
IsCallable(setter)가 false이면 TypeError 예외를 던집니다.
propertyDesc를 PropertyDescriptor { [[Setter]]: setter, [[Enumerable]]: true, [[Configurable]]: true }로 둡니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
? DefinePropertyOrThrow(obj, propertyKey, propertyDesc)를 수행합니다.
undefined를 반환합니다.

20.1.3.9.3 Object.prototype.lookupGetter ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)로 둡니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
다음을 반복합니다.
1. propertyDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
2. propertyDesc가 undefined가 아니면, 다음을 수행합니다.
  1. IsAccessorDescriptor(propertyDesc)가 true이면 propertyDesc.[[Getter]]를 반환합니다.
  2. undefined를 반환합니다.
3. obj를 ? obj.[[GetPrototypeOf]]()로 설정합니다.
4. obj가 null이면 undefined를 반환합니다.

20.1.3.9.4 Object.prototype.lookupSetter ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)로 둡니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
다음을 반복합니다.
1. propertyDesc를 ? obj.[[GetOwnProperty]](propertyKey)로 둡니다.
2. propertyDesc가 undefined가 아니면, 다음을 수행합니다.
  1. IsAccessorDescriptor(propertyDesc)가 true이면 propertyDesc.[[Setter]]를 반환합니다.
  2. undefined를 반환합니다.
3. obj를 ? obj.[[GetPrototypeOf]]()로 설정합니다.
4. obj가 null이면 undefined를 반환합니다.

20.1.4 Object 인스턴스의 프로퍼티

Object 인스턴스에는 Object 프로토타입 객체에서 상속된 프로퍼티 외에 특별한 프로퍼티가 없습니다.

20.2 Function 객체

20.2.1 Function 생성자

Function 생성자는:

%Function%입니다.
전역 객체의 "Function" 프로퍼티 초기 값입니다.
생성자가 아니라 함수로 호출되면 새로운 함수 객체를 생성하고 초기화합니다. 따라서 함수 호출 Function(…)은 동일한 인수를 사용한 객체 생성 표현식 new Function(…)과 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 Function 동작을 상속하려는 하위 클래스 생성자는 내장 함수 동작에 필요한 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Function 생성자에 대한 super 호출을 포함해야 합니다. 함수 객체를 정의하는 모든 ECMAScript 구문 형식은 Function의 인스턴스를 생성합니다. 내장 GeneratorFunction, AsyncFunction 및 AsyncGeneratorFunction 하위 클래스를 제외하고 Function 하위 클래스의 인스턴스를 생성하는 구문적 방법은 없습니다.

20.2.1.1 Function ( ...`paramArgs`, `bodyArg` )

마지막 인수(있는 경우)는 함수의 본문(실행 가능한 코드)을 지정하며, 그 앞의 모든 인수는 형식 매개변수를 지정합니다.

이 함수는 호출되면 다음 단계를 수행합니다:

ctor를 활성 함수 객체로 둡니다.
bodyArg가 존재하지 않으면 bodyArg를 빈 String으로 설정합니다.
? CreateDynamicFunction(ctor, NewTarget, normal, paramArgs, bodyArg)을 반환합니다.

참고

지정할 각 형식 매개변수마다 하나의 인수를 갖는 것은 허용되지만 필수는 아닙니다. 예를 들어 다음 세 표현식은 모두 동일한 결과를 생성합니다:

new Function("a", "b", "c", "return a+b+c")
new Function("a, b, c", "return a+b+c")
new Function("a,b", "c", "return a+b+c")

20.2.1.1.1 CreateDynamicFunction ( `ctor`, `newTarget`, `kind`, `paramArgs`, `bodyArg` )

추상 연산 CreateDynamicFunction. 인수 ctor (생성자), newTarget ((생성자 또는 undefined)), kind ((normal, generator, async 또는 async-generator)), paramArgs (리스트 (요소: ECMAScript 언어 값)) 및 bodyArg (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 함수 객체) 또는 throw 완료). ctor는 이 동작을 수행하는 생성자 함수입니다. newTarget은 처음 new가 적용된 생성자입니다. paramArgs와 bodyArg는 ctor에 전달된 인수 값을 반영합니다. 호출되면 다음 단계를 수행한다.

newTarget이 undefined이면 newTarget을 ctor로 설정합니다.
kind가 normal이면, 다음을 수행합니다.
1. prefix를 "function"으로 둡니다.
2. exprGrammar를 문법 기호 FunctionExpression로 둡니다.
3. bodyGrammar를 문법 기호 FunctionBody[~Yield, ~Await]로 둡니다.
4. paramGrammar를 문법 기호 FormalParameters[~Yield, ~Await]로 둡니다.
5. fallbackProto를 "%Function.prototype%"로 둡니다.
그렇지 않고 kind가 generator이면, 다음을 수행합니다.
1. prefix를 "function*"으로 둡니다.
2. exprGrammar를 문법 기호 GeneratorExpression로 둡니다.
3. bodyGrammar를 문법 기호 GeneratorBody로 둡니다.
4. paramGrammar를 문법 기호 FormalParameters[+Yield, ~Await]로 둡니다.
5. fallbackProto를 "%GeneratorFunction.prototype%"로 둡니다.
그렇지 않고 kind가 async이면, 다음을 수행합니다.
1. prefix를 "async function"으로 둡니다.
2. exprGrammar를 문법 기호 AsyncFunctionExpression로 둡니다.
3. bodyGrammar를 문법 기호 AsyncFunctionBody로 둡니다.
4. paramGrammar를 문법 기호 FormalParameters[~Yield, +Await]로 둡니다.
5. fallbackProto를 "%AsyncFunction.prototype%"로 둡니다.
그렇지 않으면,
1. 단언: kind는 async-generator입니다.
2. prefix를 "async function*"으로 둡니다.
3. exprGrammar를 문법 기호 AsyncGeneratorExpression로 둡니다.
4. bodyGrammar를 문법 기호 AsyncGeneratorBody로 둡니다.
5. paramGrammar를 문법 기호 FormalParameters[+Yield, +Await]로 둡니다.
6. fallbackProto를 "%AsyncGeneratorFunction.prototype%"로 둡니다.
argCount를 paramArgs의 요소 수로 둡니다.
paramStrings를 새로운 빈 List로 둡니다.
paramArgs의 각 요소 arg에 대해 다음을 수행합니다.
1. ? ToString(arg)을 paramStrings에 추가합니다.
bodyString을 ? ToString(bodyArg)으로 둡니다.
currentRealm을 현재 Realm Record로 둡니다.
? HostEnsureCanCompileStrings(currentRealm, paramStrings, bodyString, false)를 수행합니다.
paramString을 빈 String으로 둡니다.
argCount > 0이면, 다음을 수행합니다.
1. paramString을 paramStrings[0]으로 설정합니다.
2. k를 1로 둡니다.
3. k < argCount인 동안 다음을 반복합니다.
  1. nextArgString을 paramStrings[k]로 둡니다.
  2. paramString을 paramString, "," (쉼표) 및 nextArgString의 문자열 연결로 설정합니다.
  3. k를 k + 1로 설정합니다.
bodyParseString을 0x000A (LINE FEED), bodyString 및 0x000A (LINE FEED)의 문자열 연결로 둡니다.
sourceString을 prefix, " anonymous(", paramString, 0x000A (LINE FEED), ") {", bodyParseString 및 "}"의 문자열 연결로 둡니다.
sourceText를 StringToCodePoints(sourceString)로 둡니다.
params를 ParseText(paramString, paramGrammar)로 둡니다.
params가 오류의 List이면 SyntaxError 예외를 던집니다.
body를 ParseText(bodyParseString, bodyGrammar)로 둡니다.
body가 오류의 List이면 SyntaxError 예외를 던집니다.
참고: 매개변수와 본문은 각각 독립적으로 유효함을 보장하기 위해 별도로 파싱됩니다. 예를 들어 new Function("/*", "*/ ) {")는 함수로 평가되지 않습니다.
참고: 이 단계에 도달하면 sourceText는 exprGrammar의 구문을 가져야 합니다(반대 방향의 함의는 성립하지 않음). 다음 두 단계의 목적은 exprGrammar에 직접 적용되는 모든 조기 오류 규칙을 적용하는 것입니다.
expr을 ParseText(sourceText, exprGrammar)로 둡니다.
expr이 오류의 List이면 SyntaxError 예외를 던집니다.
funcProto를 ? GetPrototypeFromConstructor(newTarget, fallbackProto)로 둡니다.
envRecord를 currentRealm.[[GlobalEnv]]로 둡니다.
privateEnv를 null로 둡니다.
func를 OrdinaryFunctionCreate(funcProto, sourceText, params, body, non-lexical-this, envRecord, privateEnv)로 둡니다.
SetFunctionName(func, "anonymous")을 수행합니다.
kind가 generator이면, 다음을 수행합니다.
1. protoProto를 OrdinaryObjectCreate(%GeneratorPrototype%)로 둡니다.
2. ! DefinePropertyOrThrow(func, "prototype", PropertyDescriptor { [[Value]]: protoProto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
그렇지 않고 kind가 async-generator이면, 다음을 수행합니다.
1. protoProto를 OrdinaryObjectCreate(%AsyncGeneratorPrototype%)로 둡니다.
2. ! DefinePropertyOrThrow(func, "prototype", PropertyDescriptor { [[Value]]: protoProto, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
그렇지 않고 kind가 normal이면, 다음을 수행합니다.
1. MakeConstructor(func)를 수행합니다.
참고: kind가 async인 함수는 생성할 수 없으며 [[Construct]] 내부 메서드 또는 "prototype" 프로퍼티를 갖지 않습니다.
func를 반환합니다.

참고

CreateDynamicFunction은 생성자로 사용될 가능성을 제공하기 위해 kind가 async가 아닌 생성하는 모든 함수에 "prototype" 프로퍼티를 정의합니다.

20.2.2 Function 생성자의 프로퍼티

Function 생성자는:

그 자체가 내장 함수 객체입니다.
값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 1_𝔽인 "length" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

20.2.2.1 Function.prototype

Function.prototype의 값은 Function 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.2.3 Function 프로토타입 객체의 프로퍼티

Function 프로토타입 객체는:

%Function.prototype%입니다.
그 자체가 내장 함수 객체입니다.
어떤 인수든 허용하며 호출되면 undefined를 반환합니다.
[[Construct]] 내부 메서드를 갖지 않으므로 new 연산자와 함께 생성자로 사용할 수 없습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
"prototype" 프로퍼티를 갖지 않습니다.
값이 +0_𝔽인 "length" 프로퍼티를 갖습니다.
값이 빈 String인 "name" 프로퍼티를 갖습니다.

참고

Function 프로토타입 객체는 ECMAScript 2015 명세 이전에 작성된 ECMAScript 코드와의 호환성을 보장하기 위해 함수 객체로 명시됩니다.

20.2.3.1 Function.prototype.apply ( `thisArg`, `argArray` )

이 메서드는 호출되면 다음 단계를 수행합니다:

func를 this 값으로 둡니다.
IsCallable(func)이 false이면 TypeError 예외를 던집니다.
argArray가 undefined 또는 null이면, 다음을 수행합니다.
1. PrepareForTailCall()을 수행합니다.
2. ? Call(func, thisArg)를 반환합니다.
argList를 ? CreateListFromArrayLike(argArray)로 둡니다.
PrepareForTailCall()을 수행합니다.
? Call(func, thisArg, argList)를 반환합니다.

참고 1

thisArg 값은 수정되지 않은 채 this 값으로 전달됩니다. 이는 undefined 또는 null인 thisArg를 전역 객체로 바꾸고 그 밖의 모든 값에 ToObject를 적용한 결과를 this 값으로 전달하던 Edition 3에서 변경된 사항입니다. thisArg가 수정되지 않고 전달되더라도 비엄격 함수는 함수 진입 시 여전히 이러한 변환을 수행합니다.

참고 2

func가 화살표 함수 또는 바인드된 함수 특수 객체 중 하나이면 6 단계의 함수 [[Call]]에서 thisArg는 무시됩니다.

20.2.3.2 Function.prototype.bind ( `thisArg`, ...`args` )

이 메서드는 호출되면 다음 단계를 수행합니다:

target을 this 값으로 둡니다.
IsCallable(target)이 false이면 TypeError 예외를 던집니다.
boundFunc를 ? BoundFunctionCreate(target, thisArg, args)로 둡니다.
length를 0으로 둡니다.
targetHasLength를 ? HasOwnProperty(target, "length")로 둡니다.
targetHasLength가 true이면, 다음을 수행합니다.
1. targetLength를 ? Get(target, "length")로 둡니다.
2. targetLength가 Number이면, 다음을 수행합니다.
  1. targetLengthAsInt를 ! ToIntegerOrInfinity(targetLength)로 둡니다.
  2. targetLengthAsInt = +∞이면, 다음을 수행합니다.
    1. length를 +∞로 설정합니다.
  3. 그렇지 않고 targetLengthAsInt = -∞이면, 다음을 수행합니다.
    1. length를 0으로 설정합니다.
  4. 그렇지 않으면,
    1. argCount를 args의 요소 수로 둡니다.
    2. length를 max(targetLengthAsInt - argCount, 0)으로 설정합니다.
SetFunctionLength(boundFunc, length)를 수행합니다.
targetName을 ? Get(target, "name")로 둡니다.
targetName이 String이 아니면 targetName을 빈 String으로 설정합니다.
SetFunctionName(boundFunc, targetName, "bound")를 수행합니다.
boundFunc를 반환합니다.

참고 1

Function.prototype.bind를 사용하여 생성된 Function 객체는 특수 객체입니다. 또한 "prototype" 프로퍼티를 갖지 않습니다.

참고 2

target이 화살표 함수 또는 바인드된 함수 특수 객체 중 하나이면 이 메서드에 전달된 thisArg는 이후 func 호출에서 사용되지 않습니다.

20.2.3.3 Function.prototype.call ( `thisArg`, ...`args` )

이 메서드는 호출되면 다음 단계를 수행합니다:

func를 this 값으로 둡니다.
IsCallable(func)이 false이면 TypeError 예외를 던집니다.
PrepareForTailCall()을 수행합니다.
? Call(func, thisArg, args)를 반환합니다.

참고 1

참고 2

func가 화살표 함수 또는 바인드된 함수 특수 객체 중 하나이면 4 단계의 함수 [[Call]]에서 thisArg는 무시됩니다.

20.2.3.4 Function.prototype.constructor

Function.prototype.constructor의 초기 값은 %Function%입니다.

20.2.3.5 Function.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

func를 this 값으로 둡니다.
func가 Object이고, func가 [[SourceText]] 내부 슬롯을 가지며, func.[[SourceText]]가 유니코드 코드 포인트의 시퀀스이고, HostHasSourceTextAvailable(func)이 true이면, 다음을 수행합니다.
1. CodePointsToString(func.[[SourceText]])을 반환합니다.
func가 내장 함수 객체이면 func의 구현체 정의 String 소스 코드 표현을 반환합니다. 표현은 NativeFunction의 구문을 가져야 합니다. 또한 func에 [[InitialName]] 내부 슬롯이 있고 func.[[InitialName]]이 String이면 반환된 String에서 NativeFunctionAccessoropt PropertyName과 일치하는 부분은 func.[[InitialName]]이어야 합니다.
func가 Object이고 IsCallable(func)이 true이면 func의 구현체 정의 String 소스 코드 표현을 반환합니다. 표현은 NativeFunction의 구문을 가져야 합니다.
TypeError 예외를 던집니다.

NativeFunction

function

NativeFunctionAccessor

opt

PropertyName

[~Yield, ~Await]

opt

(

FormalParameters

[~Yield, ~Await]

)

{

[

native

code

]

}

NativeFunctionAccessor

get

set

20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? OrdinaryHasInstance(thisValue, value)를 반환합니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

참고

이는 대부분의 함수가 상속하는 %Symbol.hasInstance%의 기본 구현입니다. %Symbol.hasInstance%는 값이 특정 생성자의 인스턴스인지 결정하기 위해 instanceof 연산자가 호출합니다. 다음과 같은 표현식은

v instanceof F

다음과 같이 평가됩니다.

F[%Symbol.hasInstance%](v)

생성자 함수는 함수에 다른 %Symbol.hasInstance% 메서드를 노출하여 instanceof가 어떤 객체를 자신의 인스턴스로 인식할지 제어할 수 있습니다.

이 프로퍼티는 바인드된 함수의 대상 함수를 전역적으로 노출하는 데 사용될 수 있는 변조를 방지하기 위해 쓰기 불가능하고 구성 불가능합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.hasInstance]"입니다.

20.2.4 Function 인스턴스

모든 Function 인스턴스는 ECMAScript 함수 객체이며 표 26에 나열된 내부 슬롯을 갖습니다. Function.prototype.bind 메서드(20.2.3.2)를 사용하여 생성된 Function 객체는 표 27에 나열된 내부 슬롯을 갖습니다.

Function 인스턴스는 다음 프로퍼티를 갖습니다:

20.2.4.1 length

"length" 프로퍼티의 값은 함수가 일반적으로 예상하는 인수 수를 나타내는 정수 Number입니다. 그러나 언어는 다른 수의 인수로 함수를 호출하는 것을 허용합니다. "length" 프로퍼티에 명시된 수와 다른 수의 인수로 함수가 호출되었을 때의 동작은 함수에 따라 달라집니다. 이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

20.2.4.2 name

"name" 프로퍼티의 값은 함수를 설명하는 String입니다. 이름에는 의미론적 중요성이 없지만 일반적으로 ECMAScript 소스 텍스트에서 함수가 정의된 위치에서 해당 함수를 참조하는 데 사용하는 변수 또는 프로퍼티 이름입니다. 이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

이 명세에 의해 문맥적 이름이 연결되지 않은 익명 함수 객체는 빈 String을 "name" 프로퍼티의 값으로 사용합니다.

20.2.4.3 prototype

생성자로 사용할 수 있는 Function 인스턴스는 "prototype" 프로퍼티를 갖습니다. 이러한 Function 인스턴스가 생성될 때마다 또 다른 일반 객체도 생성되며 함수의 "prototype" 프로퍼티 초기 값이 됩니다. 달리 명시되지 않는 한 "prototype" 프로퍼티의 값은 해당 함수가 생성자로 호출될 때 생성되는 객체의 [[Prototype]] 내부 슬롯을 초기화하는 데 사용됩니다.

이 프로퍼티는 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

참고

Function.prototype.bind를 사용하여 생성되거나 MethodDefinition(GeneratorMethod 또는 AsyncGeneratorMethod이 아닌 것) 또는 ArrowFunction을 평가하여 생성된 Function 객체는 "prototype" 프로퍼티를 갖지 않습니다.

20.2.5 HostHasSourceTextAvailable ( `func` )

호스트 정의 추상 연산 HostHasSourceTextAvailable. 인수 func (함수 객체). 반환값: Boolean. 호스트 환경이 func의 소스 텍스트 제공을 막을 수 있도록 합니다.

HostHasSourceTextAvailable 구현은 다음 요구 사항을 준수해야 합니다:

매개변수에 대해 결정적이어야 합니다. 특정 func를 인수로 호출될 때마다 동일한 결과를 반환해야 합니다.

HostHasSourceTextAvailable의 기본 구현은 true를 반환합니다.

20.3 Boolean 객체

20.3.1 Boolean 생성자

Boolean 생성자는:

%Boolean%입니다.
전역 객체의 "Boolean" 프로퍼티 초기 값입니다.
생성자로 호출되면 새로운 Boolean 객체를 생성하고 초기화합니다.
생성자가 아니라 함수로 호출되면 타입 변환을 수행합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 Boolean 동작을 상속하려는 하위 클래스 생성자는 [[BooleanData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Boolean 생성자에 대한 super 호출을 포함해야 합니다.

20.3.1.1 Boolean ( `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

bool을 ToBoolean(value)으로 둡니다.
NewTarget이 undefined이면 bool을 반환합니다.
obj를 ? OrdinaryCreateFromConstructor(NewTarget, "%Boolean.prototype%", « [[BooleanData]] »)로 둡니다.
obj.[[BooleanData]]를 bool로 설정합니다.
obj를 반환합니다.

20.3.2 Boolean 생성자의 프로퍼티

Boolean 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

20.3.2.1 Boolean.prototype

Boolean.prototype의 초기 값은 Boolean 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.3.3 Boolean 프로토타입 객체의 프로퍼티

Boolean 프로토타입 객체는:

%Boolean.prototype%입니다.
일반 객체입니다.
그 자체가 Boolean 객체이며 값이 false인 [[BooleanData]] 내부 슬롯을 갖습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

20.3.3.1 Boolean.prototype.constructor

Boolean.prototype.constructor의 초기 값은 %Boolean%입니다.

20.3.3.2 Boolean.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

bool을 ? ThisBooleanValue(this 값)로 둡니다.
bool이 true이면 "true"를 반환합니다.
"false"를 반환합니다.

20.3.3.3 Boolean.prototype.valueOf ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

? ThisBooleanValue(this 값)를 반환합니다.

20.3.3.3.1 ThisBooleanValue ( `arg` )

추상 연산 ThisBooleanValue. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

arg가 Boolean이면 arg를 반환합니다.
arg가 Object이고 arg에 [[BooleanData]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. bool을 arg.[[BooleanData]]로 둡니다.
2. 단언: bool은 Boolean입니다.
3. bool을 반환합니다.
TypeError 예외를 던집니다.

20.3.4 Boolean 인스턴스의 프로퍼티

Boolean 인스턴스는 Boolean 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. Boolean 인스턴스에는 [[BooleanData]] 내부 슬롯이 있습니다. [[BooleanData]] 내부 슬롯은 이 Boolean 객체가 나타내는 Boolean 값입니다.

20.4 Symbol 객체

20.4.1 Symbol 생성자

Symbol 생성자는:

%Symbol%입니다.
전역 객체의 "Symbol" 프로퍼티 초기 값입니다.
함수로 호출되면 새로운 Symbol 값을 반환합니다.
new 연산자와 함께 사용하도록 의도되지 않았습니다.
하위 클래스를 만들도록 의도되지 않았습니다.
클래스 정의의 extends 절 값으로 사용할 수 있지만 이에 대한 super 호출은 예외를 발생시킵니다.

20.4.1.1 Symbol ( [ `description` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined가 아니면 TypeError 예외를 던집니다.
description이 undefined이면 descString을 undefined로 둡니다.
그렇지 않으면 descString을 ? ToString(description)으로 둡니다.
descString을 [[Description]]으로 갖는 새로운 Symbol을 반환합니다.

20.4.2 Symbol 생성자의 프로퍼티

Symbol 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

20.4.2.1 Symbol.asyncDispose

Symbol.asyncDispose의 초기 값은 잘 알려진 symbol %Symbol.asyncDispose%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.2 Symbol.asyncIterator

Symbol.asyncIterator의 초기 값은 잘 알려진 symbol %Symbol.asyncIterator%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.3 Symbol.dispose

Symbol.dispose의 초기 값은 잘 알려진 symbol %Symbol.dispose%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.4 Symbol.for ( `key` )

이 함수는 호출되면 다음 단계를 수행합니다:

stringKey를 ? ToString(key)로 둡니다.
agentRecord를 주변 agent의 Agent Record로 둡니다.
globalSymbolRegistry를 agentRecord.[[GlobalSymbolRegistry]]로 둡니다.
globalSymbolRegistry의 각 요소 element에 대해 다음을 수행합니다.
1. element.[[Key]]가 stringKey이면 element.[[Symbol]]을 반환합니다.
단언: globalSymbolRegistry에는 현재 stringKey에 대한 항목이 없습니다.
newSymbol을 [[Description]]이 stringKey인 새로운 Symbol로 둡니다.
GlobalSymbolRegistry Record { [[Key]]: stringKey, [[Symbol]]: newSymbol }을 globalSymbolRegistry에 추가합니다.
newSymbol을 반환합니다.

20.4.2.5 Symbol.hasInstance

Symbol.hasInstance의 초기 값은 잘 알려진 symbol %Symbol.hasInstance%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.6 Symbol.isConcatSpreadable

Symbol.isConcatSpreadable의 초기 값은 잘 알려진 symbol %Symbol.isConcatSpreadable%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.7 Symbol.iterator

Symbol.iterator의 초기 값은 잘 알려진 symbol %Symbol.iterator%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.8 Symbol.keyFor ( `symbol` )

이 함수는 호출되면 다음 단계를 수행합니다:

symbol이 Symbol이 아니면 TypeError 예외를 던집니다.
KeyForSymbol(symbol)을 반환합니다.

20.4.2.9 Symbol.match

Symbol.match의 초기 값은 잘 알려진 symbol %Symbol.match%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.10 Symbol.matchAll

Symbol.matchAll의 초기 값은 잘 알려진 symbol %Symbol.matchAll%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.11 Symbol.prototype

Symbol.prototype의 초기 값은 Symbol 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.12 Symbol.replace

Symbol.replace의 초기 값은 잘 알려진 symbol %Symbol.replace%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.13 Symbol.search

Symbol.search의 초기 값은 잘 알려진 symbol %Symbol.search%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.14 Symbol.species

Symbol.species의 초기 값은 잘 알려진 symbol %Symbol.species%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.15 Symbol.split

Symbol.split의 초기 값은 잘 알려진 symbol %Symbol.split%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.16 Symbol.toPrimitive

Symbol.toPrimitive의 초기 값은 잘 알려진 symbol %Symbol.toPrimitive%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.17 Symbol.toStringTag

Symbol.toStringTag의 초기 값은 잘 알려진 symbol %Symbol.toStringTag%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.2.18 Symbol.unscopables

Symbol.unscopables의 초기 값은 잘 알려진 symbol %Symbol.unscopables%입니다(표 1).

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.4.3 Symbol 프로토타입 객체의 프로퍼티

Symbol 프로토타입 객체는:

%Symbol.prototype%입니다.
일반 객체입니다.
Symbol 인스턴스가 아니며 [[SymbolData]] 내부 슬롯을 갖지 않습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

20.4.3.1 Symbol.prototype.constructor

Symbol.prototype.constructor의 초기 값은 %Symbol%입니다.

20.4.3.2 get Symbol.prototype.description

Symbol.prototype.description은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

symbol을 ? ThisSymbolValue(this 값)로 둡니다.
symbol.[[Description]]을 반환합니다.

20.4.3.3 Symbol.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

symbol을 ? ThisSymbolValue(this 값)로 둡니다.
SymbolDescriptiveString(symbol)을 반환합니다.

20.4.3.3.1 SymbolDescriptiveString ( `symbol` )

추상 연산 SymbolDescriptiveString. 인수 symbol (Symbol). 반환값: String. 호출되면 다음 단계를 수행한다.

description을 symbol.[[Description]]으로 둡니다.
description이 undefined이면 description을 빈 String으로 설정합니다.
단언: description은 String입니다.
"Symbol(", description 및 ")"의 문자열 연결을 반환합니다.

20.4.3.4 Symbol.prototype.valueOf ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

? ThisSymbolValue(this 값)를 반환합니다.

20.4.3.4.1 ThisSymbolValue ( `arg` )

추상 연산 ThisSymbolValue. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: Symbol) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

arg가 Symbol이면 arg를 반환합니다.
arg가 Object이고 arg에 [[SymbolData]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. symbol을 arg.[[SymbolData]]로 둡니다.
2. 단언: symbol은 Symbol입니다.
3. symbol을 반환합니다.
TypeError 예외를 던집니다.

20.4.3.5 Symbol.prototype [ %Symbol.toPrimitive% ] ( `hint` )

이 메서드는 ECMAScript 언어 연산자가 Symbol 객체를 원시 값으로 변환하기 위해 호출합니다.

호출되면 다음 단계를 수행합니다:

? ThisSymbolValue(this 값)를 반환합니다.

참고

인수는 무시됩니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.toPrimitive]"입니다.

20.4.3.6 Symbol.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Symbol"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

20.4.4 Symbol 인스턴스의 프로퍼티

Symbol 인스턴스는 Symbol 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. Symbol 인스턴스에는 [[SymbolData]] 내부 슬롯이 있습니다. [[SymbolData]] 내부 슬롯은 이 Symbol 객체가 나타내는 Symbol 값입니다.

20.4.5 Symbol을 위한 추상 연산

20.4.5.1 GlobalSymbolRegistry Record

GlobalSymbolRegistry Record는 Symbol.for를 통해 등록된 String 키와 Symbol 값을 연결하는 데 사용하는 Record입니다.

GlobalSymbolRegistry Record에는 표 59에 나열된 필드가 있습니다.

표 59: GlobalSymbolRegistry Record 필드

필드 이름	값	용도
`[[Key]]`	a String	Symbol을 전역적으로 식별하는 데 사용하는 문자열 키입니다.
`[[Symbol]]`	a Symbol	어떤 realm에서도 가져올 수 있는 symbol입니다.

20.4.5.2 KeyForSymbol ( `symbol` )

추상 연산 KeyForSymbol. 인수 symbol (Symbol). 반환값: (String 또는 undefined). symbol이 주변 agent의 [[GlobalSymbolRegistry]] List에 있으면 symbol을 등록하는 데 사용된 String을 반환합니다. 호출되면 다음 단계를 수행한다.

agentRecord를 주변 agent의 Agent Record로 둡니다.
globalSymbolRegistry를 agentRecord.[[GlobalSymbolRegistry]]로 둡니다.
globalSymbolRegistry의 각 요소 element에 대해 다음을 수행합니다.
1. SameValue(element.[[Symbol]], symbol)가 true이면 element.[[Key]]를 반환합니다.
단언: globalSymbolRegistry에는 현재 symbol에 대한 항목이 없습니다.
undefined를 반환합니다.

20.5 Error 객체

런타임 오류가 발생하면 Error 객체의 인스턴스가 예외로 던져집니다. Error 객체는 사용자 정의 예외 클래스의 기본 객체 역할도 할 수 있습니다.

ECMAScript 구현체가 런타임 오류를 검출하면 20.5.5에 정의된 NativeError 객체 중 하나의 새로운 인스턴스 또는 20.5.7에 정의된 AggregateError 객체나 20.5.8에 정의된 SuppressedError 객체 중 하나의 새로운 인스턴스를 던집니다. 이러한 각 객체는 아래에 설명된 구조를 가지며, 생성자 이름으로 NativeError 대신 사용하는 이름, 프로토타입 객체의 "name" 프로퍼티, 프로토타입 객체의 구현체 정의 "message" 프로퍼티, 그리고 %AggregateError% 고유의 "errors" 프로퍼티 또는 %SuppressedError% 고유의 "error" 및 "suppressed" 프로퍼티의 존재 여부만 다릅니다.

20.5.1 Error 생성자

Error 생성자는:

%Error%입니다.
전역 객체의 "Error" 프로퍼티 초기 값입니다.
생성자가 아니라 함수로 호출되면 새로운 Error 객체를 생성하고 초기화합니다. 따라서 함수 호출 Error(…)는 동일한 인수를 사용한 객체 생성 표현식 new Error(…)와 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 Error 동작을 상속하려는 하위 클래스 생성자는 [[ErrorData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Error 생성자에 대한 super 호출을 포함해야 합니다.

20.5.1.1 Error ( `message` [ , `options` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 newTarget을 활성 함수 객체로 둡니다. 그렇지 않으면 newTarget을 NewTarget으로 둡니다.
obj를 ? OrdinaryCreateFromConstructor(newTarget, "%Error.prototype%", « [[ErrorData]] »)로 둡니다.
message가 undefined가 아니면, 다음을 수행합니다.
1. messageString을 ? ToString(message)으로 둡니다.
2. CreateNonEnumerableDataPropertyOrThrow(obj, "message", messageString)을 수행합니다.
? InstallErrorCause(obj, options)를 수행합니다.
obj를 반환합니다.

20.5.2 Error 생성자의 프로퍼티

Error 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

20.5.2.1 Error.isError ( `arg` )

이 함수는 호출되면 다음 단계를 수행합니다:

arg가 Object가 아니면 false를 반환합니다.
arg에 [[ErrorData]] 내부 슬롯이 없으면 false를 반환합니다.
true를 반환합니다.

20.5.2.2 Error.prototype

Error.prototype의 초기 값은 Error 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.5.3 Error 프로토타입 객체의 프로퍼티

Error 프로토타입 객체는:

%Error.prototype%입니다.
일반 객체입니다.
Error 인스턴스가 아니며 [[ErrorData]] 내부 슬롯을 갖지 않습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

20.5.3.1 Error.prototype.constructor

Error.prototype.constructor의 초기 값은 %Error%입니다.

20.5.3.2 Error.prototype.message

Error.prototype.message의 초기 값은 빈 String입니다.

20.5.3.3 Error.prototype.name

Error.prototype.name의 초기 값은 "Error"입니다.

20.5.3.4 Error.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
name을 ? Get(obj, "name")으로 둡니다.
name이 undefined이면 name을 "Error"로 설정합니다. 그렇지 않으면 name을 ? ToString(name)으로 설정합니다.
message를 ? Get(obj, "message")로 둡니다.
message가 undefined이면 message를 빈 String으로 설정합니다. 그렇지 않으면 message를 ? ToString(message)으로 설정합니다.
name이 빈 String이면 message를 반환합니다.
message가 빈 String이면 name을 반환합니다.
name, 코드 단위 0x003A (COLON), 코드 단위 0x0020 (SPACE) 및 message의 문자열 연결을 반환합니다.

20.5.4 Error 인스턴스의 프로퍼티

Error 인스턴스는 Error 프로토타입 객체에서 프로퍼티를 상속하고 값이 undefined인 [[ErrorData]] 내부 슬롯을 갖는 일반 객체입니다. [[ErrorData]]의 유일한 명시된 용도는 Object.prototype.toString 및 Error.isError 안에서 Error, AggregateError, SuppressedError 및 NativeError 인스턴스를 Error 객체로 식별하는 것입니다.

20.5.5 이 표준에서 사용하는 Native Error 타입

런타임 오류가 검출되면 아래의 NativeError 객체 중 하나 또는 AggregateError 객체나 SuppressedError 객체 중 하나의 새로운 인스턴스가 던져집니다. 모든 NativeError 객체는 20.5.6에 설명된 동일한 구조를 공유합니다.

20.5.5.1 EvalError

EvalError 생성자는 %EvalError%입니다.

이 예외는 현재 이 명세 안에서 사용되지 않습니다. 이 객체는 이 명세의 이전 판과의 호환성을 위해 남아 있습니다.

20.5.5.2 RangeError

RangeError 생성자는 %RangeError%입니다.

허용되는 값의 집합 또는 범위에 속하지 않는 값을 나타냅니다.

20.5.5.3 ReferenceError

ReferenceError 생성자는 %ReferenceError%입니다.

유효하지 않은 참조가 검출되었음을 나타냅니다.

20.5.5.4 SyntaxError

SyntaxError 생성자는 %SyntaxError%입니다.

파싱 오류가 발생했음을 나타냅니다.

20.5.5.5 TypeError

TypeError 생성자는 %TypeError%입니다.

TypeError는 다른 NativeError 객체 중 어느 것도 실패 원인을 적절히 나타내지 못할 때 성공하지 못한 연산을 나타내는 데 사용됩니다.

20.5.5.6 URIError

URIError 생성자는 %URIError%입니다.

전역 URI 처리 함수 중 하나가 해당 정의와 호환되지 않는 방식으로 사용되었음을 나타냅니다.

20.5.6 `NativeError` 객체 구조

이러한 각 객체는 아래에 설명된 구조를 가지며, 생성자 이름으로 사용되는 이름과 프로토타입 객체의 "name" 프로퍼티만 다릅니다.

각 오류 객체에 대해 정의 안의 NativeError 참조는 20.5.5의 적절한 오류 객체 이름으로 바꿔야 합니다.

20.5.6.1 `NativeError` 생성자

각 NativeError 생성자는:

생성자가 아니라 함수로 호출되면 새로운 NativeError 객체를 생성하고 초기화합니다. 객체를 함수로 호출하는 것은 동일한 인수로 생성자로 호출하는 것과 동등합니다. 따라서 함수 호출 NativeError(…)는 동일한 인수를 사용한 객체 생성 표현식 new NativeError(…)와 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 NativeError 동작을 상속하려는 하위 클래스 생성자는 [[ErrorData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 NativeError 생성자에 대한 super 호출을 포함해야 합니다.

20.5.6.1.1 `NativeError` ( `message` [ , `options` ] )

각 NativeError 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 newTarget을 활성 함수 객체로 둡니다. 그렇지 않으면 newTarget을 NewTarget으로 둡니다.
obj를 ? OrdinaryCreateFromConstructor(newTarget, "%NativeError.prototype%", « [[ErrorData]] »)로 둡니다.
message가 undefined가 아니면, 다음을 수행합니다.
1. messageString을 ? ToString(message)으로 둡니다.
2. CreateNonEnumerableDataPropertyOrThrow(obj, "message", messageString)을 수행합니다.
? InstallErrorCause(obj, options)를 수행합니다.
obj를 반환합니다.

2 단계에서 전달되는 문자열의 실제 값은 정의 중인 NativeError 생성자에 따라 "%EvalError.prototype%", "%RangeError.prototype%", "%ReferenceError.prototype%", "%SyntaxError.prototype%", "%TypeError.prototype%" 또는 "%URIError.prototype%" 중 하나입니다.

20.5.6.2 `NativeError` 생성자의 프로퍼티

각 NativeError 생성자는:

값이 %Error%인 [[Prototype]] 내부 슬롯을 갖습니다.
String 값 "NativeError"을 값으로 갖는 "name" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

20.5.6.2.1 `NativeError`.prototype

NativeError.prototype의 초기 값은 NativeError 프로토타입 객체(20.5.6.3)입니다. 각 NativeError 생성자는 서로 다른 프로토타입 객체를 갖습니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.5.6.3 `NativeError` 프로토타입 객체의 프로퍼티

각 NativeError 프로토타입 객체는:

일반 객체입니다.
Error 인스턴스가 아니며 [[ErrorData]] 내부 슬롯을 갖지 않습니다.
값이 %Error.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

20.5.6.3.1 `NativeError`.prototype.constructor

주어진 NativeError 생성자에 대한 프로토타입의 "constructor" 프로퍼티 초기 값은 해당 생성자 자체입니다.

20.5.6.3.2 `NativeError`.prototype.message

주어진 NativeError 생성자에 대한 프로토타입의 "message" 프로퍼티 초기 값은 빈 String입니다.

20.5.6.3.3 `NativeError`.prototype.name

주어진 NativeError 생성자에 대한 프로토타입의 "name" 프로퍼티 초기 값은 생성자의 이름(NativeError 대신 사용되는 이름)으로 구성된 String 값입니다.

20.5.6.4 `NativeError` 인스턴스의 프로퍼티

NativeError 인스턴스는 해당 NativeError 프로토타입 객체에서 프로퍼티를 상속하고 값이 undefined인 [[ErrorData]] 내부 슬롯을 갖는 일반 객체입니다. [[ErrorData]]의 유일한 명시된 용도는 Object.prototype.toString(20.1.3.6) 및 Error.isError(20.5.2.1)가 Error, AggregateError, SuppressedError 또는 NativeError 인스턴스를 식별하는 것입니다.

20.5.7 AggregateError 객체

20.5.7.1 AggregateError 생성자

AggregateError 생성자는:

%AggregateError%입니다.
전역 객체의 "AggregateError" 프로퍼티 초기 값입니다.
생성자가 아니라 함수로 호출되면 새로운 AggregateError 객체를 생성하고 초기화합니다. 따라서 함수 호출 AggregateError(…)는 동일한 인수를 사용한 객체 생성 표현식 new AggregateError(…)와 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 AggregateError 동작을 상속하려는 하위 클래스 생성자는 [[ErrorData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 AggregateError 생성자에 대한 super 호출을 포함해야 합니다.

20.5.7.1.1 AggregateError ( `errors`, `message` [ , `options` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 newTarget을 활성 함수 객체로 둡니다. 그렇지 않으면 newTarget을 NewTarget으로 둡니다.
obj를 ? OrdinaryCreateFromConstructor(newTarget, "%AggregateError.prototype%", « [[ErrorData]] »)로 둡니다.
message가 undefined가 아니면, 다음을 수행합니다.
1. messageString을 ? ToString(message)으로 둡니다.
2. CreateNonEnumerableDataPropertyOrThrow(obj, "message", messageString)을 수행합니다.
? InstallErrorCause(obj, options)를 수행합니다.
errorsList를 ? IteratorToList(? GetIterator(errors, sync))로 둡니다.
! DefinePropertyOrThrow(obj, "errors", PropertyDescriptor { [[Configurable]]: true, [[Enumerable]]: false, [[Writable]]: true, [[Value]]: CreateArrayFromList(errorsList) })를 수행합니다.
obj를 반환합니다.

20.5.7.2 AggregateError 생성자의 프로퍼티

AggregateError 생성자는:

값이 %Error%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

20.5.7.2.1 AggregateError.prototype

AggregateError.prototype의 초기 값은 %AggregateError.prototype%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.5.7.3 AggregateError 프로토타입 객체의 프로퍼티

AggregateError 프로토타입 객체는:

%AggregateError.prototype%입니다.
일반 객체입니다.
Error 인스턴스도 AggregateError 인스턴스도 아니며 [[ErrorData]] 내부 슬롯을 갖지 않습니다.
값이 %Error.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

20.5.7.3.1 AggregateError.prototype.constructor

AggregateError.prototype.constructor의 초기 값은 %AggregateError%입니다.

20.5.7.3.2 AggregateError.prototype.message

AggregateError.prototype.message의 초기 값은 빈 String입니다.

20.5.7.3.3 AggregateError.prototype.name

AggregateError.prototype.name의 초기 값은 "AggregateError"입니다.

20.5.7.4 AggregateError 인스턴스의 프로퍼티

AggregateError 인스턴스는 해당 AggregateError 프로토타입 객체에서 프로퍼티를 상속하고 값이 undefined인 [[ErrorData]] 내부 슬롯을 갖는 일반 객체입니다. [[ErrorData]]의 유일한 명시된 용도는 Object.prototype.toString(20.1.3.6) 및 Error.isError(20.5.2.1)가 Error, AggregateError, SuppressedError 또는 NativeError 인스턴스를 식별하는 것입니다.

20.5.8 SuppressedError 객체

20.5.8.1 SuppressedError 생성자

SuppressedError 생성자는:

%SuppressedError%입니다.
전역 객체의 "SuppressedError" 프로퍼티 초기 값입니다.
생성자가 아니라 함수로 호출되면 새로운 SuppressedError 객체를 생성하고 초기화합니다. 따라서 함수 호출 SuppressedError(…)는 동일한 인수를 사용한 객체 생성 표현식 new SuppressedError(…)와 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 SuppressedError 동작을 상속하려는 하위 클래스 생성자는 [[ErrorData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 SuppressedError 생성자에 대한 super 호출을 포함해야 합니다.

20.5.8.1.1 SuppressedError ( `error`, `suppressed`, `message` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 newTarget을 활성 함수 객체로 둡니다. 그렇지 않으면 newTarget을 NewTarget으로 둡니다.
obj를 ? OrdinaryCreateFromConstructor(newTarget, "%SuppressedError.prototype%", « [[ErrorData]] »)로 둡니다.
message가 undefined가 아니면, 다음을 수행합니다.
1. messageString을 ? ToString(message)으로 둡니다.
2. CreateNonEnumerableDataPropertyOrThrow(obj, "message", messageString)을 수행합니다.
CreateNonEnumerableDataPropertyOrThrow(obj, "error", error)를 수행합니다.
CreateNonEnumerableDataPropertyOrThrow(obj, "suppressed", suppressed)를 수행합니다.
obj를 반환합니다.

20.5.8.2 SuppressedError 생성자의 프로퍼티

SuppressedError 생성자는:

값이 %Error%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

20.5.8.2.1 SuppressedError.prototype

SuppressedError.prototype의 초기 값은 SuppressedError 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

20.5.8.3 SuppressedError 프로토타입 객체의 프로퍼티

SuppressedError 프로토타입 객체는:

%SuppressedError.prototype%입니다.
일반 객체입니다.
Error 인스턴스도 SuppressedError 인스턴스도 아니며 [[ErrorData]] 내부 슬롯을 갖지 않습니다.
값이 %Error.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

20.5.8.3.1 SuppressedError.prototype.constructor

SuppressedError.prototype.constructor의 초기 값은 %SuppressedError%입니다.

20.5.8.3.2 SuppressedError.prototype.message

SuppressedError.prototype.message의 초기 값은 빈 String입니다.

20.5.8.3.3 SuppressedError.prototype.name

SuppressedError.prototype.name의 초기 값은 "SuppressedError"입니다.

20.5.8.4 SuppressedError 인스턴스의 프로퍼티

SuppressedError 인스턴스는 해당 SuppressedError 프로토타입 객체에서 프로퍼티를 상속하고 값이 undefined인 [[ErrorData]] 내부 슬롯을 갖는 일반 객체입니다. [[ErrorData]]의 유일한 명시된 용도는 Object.prototype.toString 및 Error.isError 안에서 Error, AggregateError, SuppressedError 및 NativeError 인스턴스를 Error 객체로 식별하는 것입니다.

20.5.9 Error 객체를 위한 추상 연산

20.5.9.1 InstallErrorCause ( `obj`, `options` )

추상 연산 InstallErrorCause. 인수 obj (Object) 및 options (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). options에 "cause" 프로퍼티가 존재할 때 obj에 "cause" 프로퍼티를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

options가 Object이고 ? HasProperty(options, "cause")가 true이면, 다음을 수행합니다.
1. cause를 ? Get(options, "cause")로 둡니다.
2. CreateNonEnumerableDataPropertyOrThrow(obj, "cause", cause)를 수행합니다.
unused를 반환합니다.

21 숫자와 날짜

21.1 Number 객체

21.1.1 Number 생성자

Number 생성자는:

%Number%입니다.
전역 객체의 "Number" 프로퍼티 초기 값입니다.
생성자로 호출되면 새로운 Number 객체를 생성하고 초기화합니다.
생성자가 아니라 함수로 호출되면 타입 변환을 수행합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 Number 동작을 상속하려는 하위 클래스 생성자는 [[NumberData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Number 생성자에 대한 super 호출을 포함해야 합니다.

21.1.1.1 Number ( `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

value가 존재하면, 다음을 수행합니다.
1. primitive를 ? ToNumeric(value)으로 둡니다.
2. primitive가 BigInt이면 n을 𝔽(ℝ(primitive))로 둡니다.
3. 그렇지 않으면 n을 primitive로 둡니다.
그렇지 않으면,
1. n을 +0_𝔽으로 둡니다.
NewTarget이 undefined이면 n을 반환합니다.
obj를 ? OrdinaryCreateFromConstructor(NewTarget, "%Number.prototype%", « [[NumberData]] »)로 둡니다.
obj.[[NumberData]]를 n으로 설정합니다.
obj를 반환합니다.

21.1.2 Number 생성자의 프로퍼티

Number 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

21.1.2.1 Number.EPSILON

Number.EPSILON의 값은 1과 Number 값으로 표현할 수 있는 1보다 큰 가장 작은 값의 차이의 크기에 해당하는 Number 값이며, 약 2.2204460492503130808472633361816 × 10^-16입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

21.1.2.2 Number.isFinite ( `number` )

이 함수는 호출될 때 다음 단계를 수행합니다:

number가 유한 Number이면 true를 반환합니다.
false를 반환합니다.

21.1.2.3 Number.isInteger ( `number` )

이 함수는 호출될 때 다음 단계를 수행합니다:

number가 정수 Number이면 true를 반환합니다.
false를 반환합니다.

21.1.2.4 Number.isNaN ( `number` )

이 함수는 호출될 때 다음 단계를 수행합니다:

number가 Number가 아니면 false를 반환합니다.
number가 NaN이면 true를 반환합니다.
false를 반환합니다.

참고

이 함수는 인수가 NaN인지 판별하기 전에 인수를 Number로 변환하지 않는다는 점에서 전역 isNaN 함수(19.2.3)와 다릅니다.

21.1.2.5 Number.isSafeInteger ( `number` )

참고

정수 n에 대한 Number 값이 다른 어떤 정수에 대한 Number 값도 아닌 경우에만 정수 n을 “안전한 정수”라고 합니다.

이 함수는 호출될 때 다음 단계를 수행합니다:

number가 정수 Number이면 다음을 수행합니다.
1. abs(ℝ(number)) ≤ 2⁵³ - 1이면 true를 반환합니다.
false를 반환합니다.

21.1.2.6 Number.MAX_SAFE_INTEGER

참고

IEEE 754-2019의 정밀도 제한으로 인해 필요한 반올림 동작 때문에 Number.MAX_SAFE_INTEGER보다 큰 모든 정수에 대한 Number 값은 적어도 하나의 다른 정수와 공유됩니다. 따라서 이러한 큰 크기의 정수는 안전하지 않으며, Number 값으로 정확히 표현될 수 있거나 서로 구별될 수 있다고 보장되지 않습니다. 예를 들어 9007199254740992와 9007199254740993은 모두 Number 값 9007199254740992_𝔽로 평가됩니다.

Number.MAX_SAFE_INTEGER의 값은 9007199254740991_𝔽 (𝔽(2⁵³ - 1))입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.7 Number.MAX_VALUE

Number.MAX_VALUE의 값은 가장 큰 양의 유한 Number이며, 대략 1.7976931348623157 × 10³⁰⁸입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.8 Number.MIN_SAFE_INTEGER

참고

IEEE 754-2019의 정밀도 제한으로 인해 필요한 반올림 동작 때문에 Number.MIN_SAFE_INTEGER보다 작은 모든 정수에 대한 Number 값은 적어도 하나의 다른 정수와 공유됩니다. 따라서 이러한 큰 크기의 정수는 안전하지 않으며, Number 값으로 정확히 표현될 수 있거나 서로 구별될 수 있다고 보장되지 않습니다. 예를 들어 -9007199254740992와 -9007199254740993은 모두 Number 값 -9007199254740992_𝔽로 평가됩니다.

Number.MIN_SAFE_INTEGER의 값은 -9007199254740991_𝔽 (𝔽(-(2⁵³ - 1)))입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.9 Number.MIN_VALUE

Number.MIN_VALUE의 값은 Number 타입의 가장 작은 양의 값이며, 대략 5 × 10^-324입니다.

IEEE 754-2019 배정밀도 이진 표현에서 가능한 가장 작은 값은 비정규화된 수입니다. 구현이 비정규화된 값을 지원하지 않는 경우 Number.MIN_VALUE의 값은 구현에서 실제로 표현할 수 있는 가장 작은 0이 아닌 양의 값이어야 합니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.10 Number.NaN

Number.NaN의 값은 NaN입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.11 Number.NEGATIVE_INFINITY

Number.NEGATIVE_INFINITY의 값은 -∞_𝔽입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.12 Number.parseFloat ( `string` )

"parseFloat" 속성의 초기값은 %parseFloat%입니다.

21.1.2.13 Number.parseInt ( `string`, `radix` )

"parseInt" 속성의 초기값은 %parseInt%입니다.

21.1.2.14 Number.POSITIVE_INFINITY

Number.POSITIVE_INFINITY의 값은 +∞_𝔽입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.2.15 Number.prototype

Number.prototype의 초기값은 Number 프로토타입 객체입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.1.3 Number 프로토타입 객체의 속성

Number 프로토타입 객체는 다음과 같습니다:

%Number.prototype%입니다.
일반 객체입니다.
그 자체가 Number 객체이며, 값이 +0_𝔽인 [[NumberData]] 내부 슬롯을 가집니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 가집니다.

명시적으로 달리 언급되지 않는 한, 아래에 정의된 Number 프로토타입 객체의 메서드는 제네릭이 아니며, 해당 메서드에 전달되는 this 값은 Number 값 또는 Number 값으로 초기화된 [[NumberData]] 내부 슬롯을 가진 객체여야 합니다.

메서드 명세에서 “이 Number 값”이라는 구문은 메서드 호출의 this 값을 인수로 전달하여 추상 연산 ThisNumberValue를 호출했을 때 반환되는 결과를 가리킵니다.

21.1.3.1 Number.prototype.constructor

Number.prototype.constructor의 초기값은 %Number%입니다.

21.1.3.2 Number.prototype.toExponential ( `fractionDigits` )

이 메서드는 이 Number 값을 유효숫자의 소수점 앞에 한 자리, 유효숫자의 소수점 뒤에 fractionDigits자리 숫자가 있는 십진 지수 표기법으로 나타낸 String을 반환합니다. fractionDigits가 undefined이면 Number를 고유하게 지정하는 데 필요한 만큼의 유효숫자를 포함합니다(ToString과 같지만 이 경우 Number는 항상 지수 표기법으로 출력됩니다).

호출될 때 다음 단계를 수행합니다:

number를 ? ThisNumberValue(this 값)으로 둡니다.
fractionCount를 ? ToIntegerOrInfinity(fractionDigits)로 둡니다.
단언: fractionDigits가 undefined이면 fractionCount는 0입니다.
number가 유한 Number가 아니면 Number::toString(number, 10)을 반환합니다.
fractionCount가 정수가 아니면 RangeError 예외를 던집니다.
fractionCount < 0 또는 fractionCount > 100이면 RangeError 예외를 던집니다.
number를 ℝ(number)로 설정합니다.
sign을 빈 String으로 둡니다.
number < 0이면 다음을 수행합니다.
1. sign을 "-"로 설정합니다.
2. number를 -number로 설정합니다.
number = 0이면 다음을 수행합니다.
1. significand를 코드 단위 0x0030 (DIGIT ZERO)이 fractionCount + 1회 나타나는 String 값으로 둡니다.
2. exponent를 0으로 둡니다.
그렇지 않으면,
1. fractionDigits가 undefined가 아니면 다음을 수행합니다.
  1. exponent와 intSignificand를 10^{fractionCount} ≤ intSignificand < 10^{fractionCount + 1}이고 intSignificand × 10^{exponent - fractionCount} - number가 가능한 한 0에 가까워지는 정수로 둡니다. 이러한 exponent와 intSignificand의 쌍이 두 개 있으면 intSignificand × 10^{exponent - fractionCount}가 더 큰 exponent와 intSignificand를 선택합니다.
2. 그렇지 않으면,
  1. exponent, intSignificand, ff를 ff ≥ 0, 10^ff ≤ intSignificand < 10^{ff + 1}, 𝔽(intSignificand × 10^{exponent - ff})가 𝔽(number)이고 ff가 가능한 한 작은 정수로 둡니다. intSignificand의 십진 표현은 ff + 1자리 숫자를 가지며, intSignificand는 10으로 나누어떨어지지 않고, intSignificand의 최하위 숫자가 이러한 기준에 의해 반드시 고유하게 결정되는 것은 아니라는 점에 유의하십시오.
  2. fractionCount를 ff로 설정합니다.
3. significand를 intSignificand의 십진 표현 숫자들로 구성된 String 값으로 둡니다(순서대로, 선행 0 없이).
fractionCount ≠ 0이면 다음을 수행합니다.
1. intPart를 significand의 첫 번째 코드 단위로 둡니다.
2. fractionalPart를 significand의 나머지 fractionCount개 코드 단위로 둡니다.
3. significand를 intPart, ".", fractionalPart의 문자열 연결로 설정합니다.
exponent = 0이면 다음을 수행합니다.
1. exponentSign을 "+"로 둡니다.
2. exponentDigits를 "0"으로 둡니다.
그렇지 않으면,
1. exponent > 0이면 다음을 수행합니다.
  1. exponentSign을 "+"로 둡니다.
2. 그렇지 않으면,
  1. 단언: exponent < 0입니다.
  2. exponentSign을 "-"로 둡니다.
  3. exponent를 -exponent로 설정합니다.
3. exponentDigits를 exponent의 십진 표현 숫자들로 구성된 String 값으로 둡니다(순서대로, 선행 0 없이).
significand를 significand, "e", exponentSign, exponentDigits의 문자열 연결로 설정합니다.
sign과 significand의 문자열 연결을 반환합니다.

참고

위 규칙에서 요구하는 것보다 더 정확한 변환을 제공하는 구현의 경우, 11.b.i 단계의 다음 대체 버전을 지침으로 사용하는 것이 권장됩니다:

exponent, intSignificand, ff를 ff ≥ 0, 10^ff ≤ intSignificand < 10^{ff + 1}, 𝔽(intSignificand × 10^{exponent - ff})가 𝔽(number)이고 ff가 가능한 한 작은 정수로 둡니다. intSignificand에 여러 가능성이 있으면 𝔽(intSignificand × 10^{exponent - ff})가 𝔽(number)에 가장 가까워지는 intSignificand를 선택합니다. 이러한 가능한 intSignificand 값이 두 개 있으면 짝수인 값을 선택합니다.

21.1.3.3 Number.prototype.toFixed ( `fractionDigits` )

참고 1

이 메서드는 이 Number 값을 소수점 뒤에 fractionDigits자리 숫자가 있는 십진 고정 소수점 표기법으로 나타낸 String을 반환합니다. fractionDigits가 undefined이면 0으로 간주합니다.

호출될 때 다음 단계를 수행합니다:

number를 ? ThisNumberValue(this 값)으로 둡니다.
fractionCount를 ? ToIntegerOrInfinity(fractionDigits)로 둡니다.
단언: fractionDigits가 undefined이면 fractionCount는 0입니다.
fractionCount가 정수가 아니면 RangeError 예외를 던집니다.
fractionCount < 0 또는 fractionCount > 100이면 RangeError 예외를 던집니다.
number가 유한 Number가 아니면 Number::toString(number, 10)을 반환합니다.
number를 ℝ(number)로 설정합니다.
sign을 빈 String으로 둡니다.
number < 0이면 다음을 수행합니다.
1. sign을 "-"로 설정합니다.
2. number를 -number로 설정합니다.
number ≥ 10²¹이면 다음을 수행합니다.
1. digitString을 ! ToString(𝔽(number))으로 둡니다.
그렇지 않으면,
1. intValue를 intValue / 10^{fractionCount} - number가 가능한 한 0에 가까워지는 정수로 둡니다. 이러한 intValue가 두 개 있으면 더 큰 intValue를 선택합니다.
2. intValue = 0이면 digitString을 "0"으로 둡니다. 그렇지 않으면 digitString을 intValue의 십진 표현 숫자들로 구성된 String 값으로 둡니다(순서대로, 선행 0 없이).
3. fractionCount ≠ 0이면 다음을 수행합니다.
  1. digitCount를 digitString의 길이로 둡니다.
  2. digitCount ≤ fractionCount이면 다음을 수행합니다.
    1. zeroPad를 코드 단위 0x0030 (DIGIT ZERO)이 fractionCount + 1 - digitCount회 나타나는 String 값으로 둡니다.
    2. digitString을 zeroPad와 digitString의 문자열 연결로 설정합니다.
    3. digitCount를 fractionCount + 1로 설정합니다.
  3. intPart를 digitString의 처음 digitCount - fractionCount개 코드 단위로 둡니다.
  4. fractionalPart를 digitString의 나머지 fractionCount개 코드 단위로 둡니다.
  5. digitString을 intPart, ".", fractionalPart의 문자열 연결로 설정합니다.
sign과 digitString의 문자열 연결을 반환합니다.

참고 2

toString은 숫자를 인접한 Number 값과 구별하는 데 충분한 유효숫자만 출력하므로 일부 값에서는 toFixed의 출력이 toString보다 더 정밀할 수 있습니다. 예를 들어,

(1000000000000000128).toString()은 "1000000000000000100"을 반환하지만,
(1000000000000000128).toFixed(0)은 "1000000000000000128"을 반환합니다.

21.1.3.4 Number.prototype.toLocaleString ( [ `reserved1` [ , `reserved2` ] ] )

ECMA-402 국제화 API를 포함하는 ECMAScript 구현은 ECMA-402에 명시된 대로 이 메서드를 구현해야 합니다. 그렇지 않으면 다음과 같은 이 메서드의 명세를 사용합니다:

이 메서드는 호스트 환경의 현재 로캘 규칙에 따라 형식화된 이 Number 값을 나타내는 String 값을 생성합니다. 이 메서드는 구현 정의이며, 권장되지는 않지만 toString과 동일한 값을 반환하는 것도 허용됩니다.

이 메서드의 선택적 매개변수의 의미는 ECMA-402에 정의되어 있습니다. ECMA-402 지원을 포함하지 않는 구현은 해당 매개변수 위치를 다른 용도로 사용해서는 안 됩니다.

21.1.3.5 Number.prototype.toPrecision ( `precision` )

이 메서드는 이 Number 값을 유효숫자의 소수점 앞에 한 자리, 유효숫자의 소수점 뒤에 precision - 1자리 숫자가 있는 십진 지수 표기법 또는 precision개의 유효숫자가 있는 십진 고정 표기법으로 나타낸 String을 반환합니다. precision이 undefined이면 대신 ToString을 호출합니다.

호출될 때 다음 단계를 수행합니다:

number를 ? ThisNumberValue(this 값)으로 둡니다.
precision이 undefined이면 ! ToString(number)을 반환합니다.
precisionCount를 ? ToIntegerOrInfinity(precision)로 둡니다.
number가 유한 Number가 아니면 Number::toString(number, 10)을 반환합니다.
precisionCount가 정수가 아니면 RangeError 예외를 던집니다.
precisionCount < 1 또는 precisionCount > 100이면 RangeError 예외를 던집니다.
number를 ℝ(number)로 설정합니다.
sign을 빈 String으로 둡니다.
number < 0이면 다음을 수행합니다.
1. sign을 코드 단위 0x002D (HYPHEN-MINUS)로 설정합니다.
2. number를 -number로 설정합니다.
number = 0이면 다음을 수행합니다.
1. significand를 코드 단위 0x0030 (DIGIT ZERO)이 precisionCount회 나타나는 String 값으로 둡니다.
2. exponent를 0으로 둡니다.
그렇지 않으면,
1. exponent와 intSignificand를 10^{precisionCount - 1} ≤ intSignificand < 10^{precisionCount}이고 intSignificand × 10^{exponent - precisionCount + 1} - number가 가능한 한 0에 가까워지는 정수로 둡니다. 이러한 exponent와 intSignificand의 쌍이 두 개 있으면 intSignificand × 10^{exponent - precisionCount + 1}이 더 큰 exponent와 intSignificand를 선택합니다.
2. significand를 intSignificand의 십진 표현 숫자들로 구성된 String 값으로 둡니다(순서대로, 선행 0 없이).
3. exponent < -6 또는 exponent ≥ precisionCount이면 다음을 수행합니다.
  1. 단언: exponent ≠ 0입니다.
  2. precisionCount ≠ 1이면 다음을 수행합니다.
    1. intPart를 significand의 첫 번째 코드 단위로 둡니다.
    2. fractionalPart를 significand의 나머지 precisionCount - 1개 코드 단위로 둡니다.
    3. significand를 intPart, ".", fractionalPart의 문자열 연결로 설정합니다.
  3. exponent > 0이면 다음을 수행합니다.
    1. exponentSign을 코드 단위 0x002B (PLUS SIGN)로 둡니다.
  4. 그렇지 않으면,
    1. 단언: exponent < 0입니다.
    2. exponentSign을 코드 단위 0x002D (HYPHEN-MINUS)로 둡니다.
    3. exponent를 -exponent로 설정합니다.
  5. exponentDigits를 exponent의 십진 표현 숫자들로 구성된 String 값으로 둡니다(순서대로, 선행 0 없이).
  6. sign, significand, 코드 단위 0x0065 (LATIN SMALL LETTER E), exponentSign, exponentDigits의 문자열 연결을 반환합니다.
exponent = precisionCount - 1이면 sign과 significand의 문자열 연결을 반환합니다.
exponent ≥ 0이면 다음을 수행합니다.
1. significand를 significand의 처음 exponent + 1개 코드 단위, 코드 단위 0x002E (FULL STOP), 나머지 precisionCount - (exponent + 1)개 코드 단위의 문자열 연결로 설정합니다.
그렇지 않으면,
1. significand를 코드 단위 0x0030 (DIGIT ZERO), 코드 단위 0x002E (FULL STOP), 코드 단위 0x0030 (DIGIT ZERO)의 -(exponent + 1)회 반복, String significand의 문자열 연결로 설정합니다.
sign과 significand의 문자열 연결을 반환합니다.

21.1.3.6 Number.prototype.toString ( [ `radix` ] )

참고

선택적 radix는 2_𝔽부터 36_𝔽까지의 양 끝을 포함하는 구간에 있는 정수 Number 값이어야 합니다. radix가 undefined이면 10_𝔽을 radix의 값으로 사용합니다.

이 메서드는 호출될 때 다음 단계를 수행합니다:

x를 ? ThisNumberValue(this 값)으로 둡니다.
radix가 undefined이면 radixMV를 10으로 둡니다.
그렇지 않으면 radixMV를 ? SnapToInteger(radix, truncate, 2, 36)로 둡니다.
Number::toString(x, radixMV)을 반환합니다.

이 메서드는 제네릭이 아닙니다. this 값이 Number 또는 Number 객체가 아니면 TypeError 예외를 던집니다. 따라서 메서드로 사용하기 위해 다른 종류의 객체로 전송할 수 없습니다.

이 메서드의 "length" 속성은 1_𝔽입니다.

21.1.3.7 Number.prototype.valueOf ( )

? ThisNumberValue(this 값)을 반환합니다.

21.1.3.7.1 ThisNumberValue ( `arg` )

추상 연산 ThisNumberValue. 인수 arg (ECMAScript 언어 값). 반환값: Number를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

arg가 Number이면 arg를 반환합니다.
arg가 Object이고 arg에 [[NumberData]] 내부 슬롯이 있으면 다음을 수행합니다.
1. number를 arg.[[NumberData]]로 둡니다.
2. 단언: number는 Number입니다.
3. number를 반환합니다.
TypeError 예외를 던집니다.

21.1.4 Number 인스턴스의 속성

Number 인스턴스는 Number 프로토타입 객체에서 속성을 상속하는 일반 객체입니다. Number 인스턴스에는 [[NumberData]] 내부 슬롯도 있습니다. [[NumberData]] 내부 슬롯은 이 Number 객체가 나타내는 Number 값입니다.

21.2 BigInt 객체

21.2.1 BigInt 생성자

BigInt 생성자는 다음과 같습니다:

%BigInt%입니다.
전역 객체의 "BigInt" 속성의 초기값입니다.
생성자가 아니라 함수로 호출될 때 타입 변환을 수행합니다.
new 연산자와 함께 사용하거나 서브클래싱하는 용도로 의도되지 않았습니다. 클래스 정의의 extends 절의 값으로 사용할 수 있지만 BigInt 생성자에 대한 super 호출은 예외를 발생시킵니다.

21.2.1.1 BigInt ( `value` )

이 함수는 호출될 때 다음 단계를 수행합니다:

NewTarget이 undefined가 아니면 TypeError 예외를 던집니다.
primitive를 ? ToPrimitive(value, number)로 둡니다.
primitive가 Number이면 ? NumberToBigInt(primitive)를 반환합니다.
? ToBigInt(primitive)를 반환합니다.

21.2.1.1.1 NumberToBigInt ( `number` )

추상 연산 NumberToBigInt. 인수 number (Number). 반환값: BigInt를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

number가 정수 Number가 아니면 RangeError 예외를 던집니다.
ℤ(ℝ(number))를 반환합니다.

21.2.2 BigInt 생성자의 속성

BigInt 생성자는 다음과 같습니다:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 가집니다.
다음 속성을 가집니다:

21.2.2.1 BigInt.asIntN ( `bits`, `bigint` )

이 함수는 호출될 때 다음 단계를 수행합니다:

bits를 ? ToIndex(bits)로 설정합니다.
bigint를 ? ToBigInt(bigint)로 설정합니다.
remainder를 ℝ(bigint) modulo 2^bits로 둡니다.
remainder ≥ 2^{bits - 1}이면 ℤ(remainder - 2^bits)를 반환합니다.
ℤ(remainder)를 반환합니다.

21.2.2.2 BigInt.asUintN ( `bits`, `bigint` )

이 함수는 호출될 때 다음 단계를 수행합니다:

bits를 ? ToIndex(bits)로 설정합니다.
bigint를 ? ToBigInt(bigint)로 설정합니다.
ℤ(ℝ(bigint) modulo 2^bits)를 반환합니다.

21.2.2.3 BigInt.prototype

BigInt.prototype의 초기값은 BigInt 프로토타입 객체입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.2.3 BigInt 프로토타입 객체의 속성

BigInt 프로토타입 객체는 다음과 같습니다:

%BigInt.prototype%입니다.
일반 객체입니다.
BigInt 객체가 아니며 [[BigIntData]] 내부 슬롯을 가지지 않습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 가집니다.

메서드 명세에서 “이 BigInt 값”이라는 구문은 메서드 호출의 this 값을 인수로 전달하여 추상 연산 ThisBigIntValue를 호출했을 때 반환되는 결과를 가리킵니다.

21.2.3.1 BigInt.prototype.constructor

BigInt.prototype.constructor의 초기값은 %BigInt%입니다.

21.2.3.2 BigInt.prototype.toLocaleString ( [ `reserved1` [ , `reserved2` ] ] )

이 메서드는 호스트 환경의 현재 로캘 규칙에 따라 형식화된 이 BigInt 값을 나타내는 String 값을 생성합니다. 이 메서드는 구현 정의이며, 권장되지는 않지만 toString과 동일한 값을 반환하는 것도 허용됩니다.

21.2.3.3 BigInt.prototype.toString ( [ `radix` ] )

참고

이 메서드는 호출될 때 다음 단계를 수행합니다:

x를 ? ThisBigIntValue(this 값)으로 둡니다.
radix가 undefined이면 radixMV를 10으로 둡니다.
그렇지 않으면 radixMV를 ? SnapToInteger(radix, truncate, 2, 36)로 둡니다.
BigInt::toString(x, radixMV)을 반환합니다.

이 메서드는 제네릭이 아닙니다. this 값이 BigInt 또는 BigInt 객체가 아니면 TypeError 예외를 던집니다. 따라서 메서드로 사용하기 위해 다른 종류의 객체로 전송할 수 없습니다.

21.2.3.4 BigInt.prototype.valueOf ( )

? ThisBigIntValue(this 값)을 반환합니다.

21.2.3.4.1 ThisBigIntValue ( `arg` )

추상 연산 ThisBigIntValue. 인수 arg (ECMAScript 언어 값). 반환값: BigInt를 포함하는 정상 완료 또는 throw 완료. 호출되면 다음 단계를 수행한다.

arg가 BigInt이면 arg를 반환합니다.
arg가 Object이고 arg에 [[BigIntData]] 내부 슬롯이 있으면 다음을 수행합니다.
1. 단언: arg.[[BigIntData]]는 BigInt입니다.
2. arg.[[BigIntData]]를 반환합니다.
TypeError 예외를 던집니다.

21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 속성의 초기값은 String 값 "BigInt"입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 특성이 있습니다.

21.2.4 BigInt 인스턴스의 속성

BigInt 인스턴스는 BigInt 프로토타입 객체에서 속성을 상속하는 일반 객체입니다. BigInt 인스턴스에는 [[BigIntData]] 내부 슬롯도 있습니다. [[BigIntData]] 내부 슬롯은 이 BigInt 객체가 나타내는 BigInt 값입니다.

21.3 Math 객체

Math 객체는 다음과 같습니다:

%Math%입니다.
전역 객체의 "Math" 속성의 초기값입니다.
일반 객체입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 가집니다.
함수 객체가 아닙니다.
[[Construct]] 내부 메서드를 가지지 않으므로 new 연산자와 함께 생성자로 사용할 수 없습니다.
[[Call]] 내부 메서드를 가지지 않으므로 함수로 호출할 수 없습니다.

참고

이 명세에서 “x에 대한 Number 값”이라는 구문은 6.1.6.1에 정의된 기술적 의미를 가집니다.

21.3.1 Math 객체의 값 속성

21.3.1.1 Math.E

자연로그의 밑인 e에 대한 Number 값이며, 대략 2.7182818284590452354입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.3.1.2 Math.LN10

10의 자연로그에 대한 Number 값이며, 대략 2.302585092994046입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.3.1.3 Math.LN2

2의 자연로그에 대한 Number 값이며, 대략 0.6931471805599453입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.3.1.4 Math.LOG10E

자연로그의 밑인 e의 밑이 10인 로그에 대한 Number 값이며, 이 값은 대략 0.4342944819032518입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

참고

Math.LOG10E의 값은 Math.LN10 값의 역수와 대략 같습니다.

21.3.1.5 Math.LOG2E

자연로그의 밑인 e의 밑이 2인 로그에 대한 Number 값이며, 이 값은 대략 1.4426950408889634입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

참고

Math.LOG2E의 값은 Math.LN2 값의 역수와 대략 같습니다.

21.3.1.6 Math.PI

원의 지름에 대한 둘레의 비율인 π에 대한 Number 값이며, 대략 3.1415926535897932입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.3.1.7 Math.SQRT1_2

½의 제곱근에 대한 Number 값이며, 대략 0.7071067811865476입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

참고

Math.SQRT1_2의 값은 Math.SQRT2 값의 역수와 대략 같습니다.

21.3.1.8 Math.SQRT2

2의 제곱근에 대한 Number 값이며, 대략 1.4142135623730951입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 특성이 있습니다.

21.3.1.9 Math [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 속성의 초기값은 String 값 "Math"입니다.

이 속성에는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 특성이 있습니다.

21.3.2 Math 객체의 함수 속성

참고

acos, acosh, asin, asinh, atan, atanh, atan2, cbrt, cos, cosh, exp, expm1, hypot, log, log1p, log2, log10, pow, random, sin, sinh, tan, tanh 함수의 동작은 관심 있는 경계 사례를 나타내는 특정 인수 값에 대해 특정 결과를 요구하는 것을 제외하고는 여기에서 정확히 명시되지 않습니다. 다른 인수 값에 대해 이러한 함수는 익숙한 수학 함수의 결과에 대한 근삿값을 계산하도록 의도되지만, 근사 알고리즘의 선택에는 어느 정도의 재량이 허용됩니다. 일반적인 의도는 구현자가 특정 하드웨어 플랫폼에서 ECMAScript에 대해 해당 플랫폼의 C 프로그래머가 사용할 수 있는 것과 동일한 수학 라이브러리를 사용할 수 있도록 하는 것입니다.

알고리즘의 선택은 구현에 맡겨져 있지만, 구현에서는 Sun Microsystems의 자유롭게 배포 가능한 수학 라이브러리인 fdlibm에 포함된 IEEE 754-2019 산술용 근사 알고리즘을 사용하는 것이 권장됩니다(다만 이 표준에서 명시하는 것은 아닙니다)(http://www.netlib.org/fdlibm).

21.3.2.1 Math.abs ( `x` )

이 함수는 x의 절댓값을 반환합니다. 결과는 x와 크기가 같지만 양의 부호를 가집니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN이면 NaN을 반환합니다.
n이 -0_𝔽이면 +0_𝔽을 반환합니다.
n이 -∞_𝔽이면 +∞_𝔽을 반환합니다.
n < -0_𝔽이면 -n을 반환합니다.
n을 반환합니다.

21.3.2.2 Math.acos ( `x` )

이 함수는 x의 아크코사인을 반환합니다. 결과는 라디안으로 표현되며 +0_𝔽부터 𝔽(π)까지의 양 끝을 포함하는 구간에 있습니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN이거나, n > 1_𝔽이거나, n < -1_𝔽이면 NaN을 반환합니다.
n이 1_𝔽이면 +0_𝔽을 반환합니다.
ℝ(n)의 아크코사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.3 Math.acosh ( `x` )

이 함수는 x의 역쌍곡코사인을 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN 또는 +∞_𝔽 중 하나이면 n을 반환합니다.
n이 1_𝔽이면 +0_𝔽을 반환합니다.
n < 1_𝔽이면 NaN을 반환합니다.
ℝ(n)의 역쌍곡코사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.4 Math.asin ( `x` )

이 함수는 x의 아크사인을 반환합니다. 결과는 라디안으로 표현되며 𝔽(-π / 2)부터 𝔽(π / 2)까지의 양 끝을 포함하는 구간에 있습니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n > 1_𝔽 또는 n < -1_𝔽이면 NaN을 반환합니다.
ℝ(n)의 아크사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.5 Math.asinh ( `x` )

이 함수는 x의 역쌍곡사인을 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 +0_𝔽 또는 -0_𝔽 중 하나이면 n을 반환합니다.
ℝ(n)의 역쌍곡사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.6 Math.atan ( `x` )

이 함수는 x의 아크탄젠트를 반환합니다. 결과는 라디안으로 표현되며 𝔽(-π / 2)부터 𝔽(π / 2)까지의 양 끝을 포함하는 구간에 있습니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n이 +∞_𝔽이면 π / 2를 나타내는 구현에서 근사한 Number 값을 반환합니다.
n이 -∞_𝔽이면 -π / 2를 나타내는 구현에서 근사한 Number 값을 반환합니다.
ℝ(n)의 아크탄젠트를 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.7 Math.atanh ( `x` )

이 함수는 x의 역쌍곡탄젠트를 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n > 1_𝔽 또는 n < -1_𝔽이면 NaN을 반환합니다.
n이 1_𝔽이면 +∞_𝔽을 반환합니다.
n이 -1_𝔽이면 -∞_𝔽을 반환합니다.
ℝ(n)의 역쌍곡탄젠트를 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.8 Math.atan2 ( `y`, `x` )

이 함수는 인수 y와 x의 몫 y / x의 아크탄젠트를 반환하며, 여기서 y와 x의 부호를 사용하여 결과의 사분면을 결정합니다. 두 인수를 받는 아크탄젠트 함수에서 y라는 이름의 인수가 첫 번째이고 x라는 이름의 인수가 두 번째인 것은 의도적이며 전통적인 방식이라는 점에 유의하십시오. 결과는 라디안으로 표현되며 -π부터 +π까지의 양 끝을 포함하는 구간에 있습니다.

호출될 때 다음 단계를 수행합니다:

ny를 ? ToNumber(y)로 둡니다.
nx를 ? ToNumber(x)로 둡니다.
ny가 NaN이거나 nx가 NaN이면 NaN을 반환합니다.
ny가 +∞_𝔽이면 다음을 수행합니다.
1. nx가 +∞_𝔽이면 π / 4를 나타내는 구현에서 근사한 Number 값을 반환합니다.
2. nx가 -∞_𝔽이면 3π / 4를 나타내는 구현에서 근사한 Number 값을 반환합니다.
3. π / 2를 나타내는 구현에서 근사한 Number 값을 반환합니다.
ny가 -∞_𝔽이면 다음을 수행합니다.
1. nx가 +∞_𝔽이면 -π / 4를 나타내는 구현에서 근사한 Number 값을 반환합니다.
2. nx가 -∞_𝔽이면 -3π / 4를 나타내는 구현에서 근사한 Number 값을 반환합니다.
3. -π / 2를 나타내는 구현에서 근사한 Number 값을 반환합니다.
ny가 +0_𝔽이면 다음을 수행합니다.
1. nx > +0_𝔽이거나 nx가 +0_𝔽이면 +0_𝔽을 반환합니다.
2. π를 나타내는 구현에서 근사한 Number 값을 반환합니다.
ny가 -0_𝔽이면 다음을 수행합니다.
1. nx > +0_𝔽이거나 nx가 +0_𝔽이면 -0_𝔽을 반환합니다.
2. -π를 나타내는 구현에서 근사한 Number 값을 반환합니다.
단언: ny는 유한 Number이며 +0_𝔽도 -0_𝔽도 아닙니다.
ny > +0_𝔽이면 다음을 수행합니다.
1. nx가 +∞_𝔽이면 +0_𝔽을 반환합니다.
2. nx가 -∞_𝔽이면 π를 나타내는 구현에서 근사한 Number 값을 반환합니다.
3. nx가 +0_𝔽 또는 -0_𝔽 중 하나이면 π / 2를 나타내는 구현에서 근사한 Number 값을 반환합니다.
ny < -0_𝔽이면 다음을 수행합니다.
1. nx가 +∞_𝔽이면 -0_𝔽을 반환합니다.
2. nx가 -∞_𝔽이면 -π를 나타내는 구현에서 근사한 Number 값을 반환합니다.
3. nx가 +0_𝔽 또는 -0_𝔽 중 하나이면 -π / 2를 나타내는 구현에서 근사한 Number 값을 반환합니다.
단언: nx는 유한 Number이며 +0_𝔽도 -0_𝔽도 아닙니다.
result를 abs(ℝ(ny) / ℝ(nx))의 아크탄젠트로 둡니다.
nx < -0_𝔽이면 다음을 수행합니다.
1. ny > +0_𝔽이면 result를 π - result로 설정합니다.
2. 그렇지 않으면 result를 -π + result로 설정합니다.
그렇지 않으면,
1. ny < -0_𝔽이면 result를 -result로 설정합니다.
result를 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.9 Math.cbrt ( `x` )

이 함수는 x의 세제곱근을 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 +0_𝔽 또는 -0_𝔽 중 하나이면 n을 반환합니다.
ℝ(n)의 세제곱근을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.10 Math.ceil ( `x` )

이 함수는 x보다 작지 않은 가장 작은(-∞에 가장 가까운) 정수 Number 값을 반환합니다. x가 이미 정수 Number이면 결과는 x입니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 +0_𝔽 또는 -0_𝔽 중 하나이면 n을 반환합니다.
n < -0_𝔽이고 n > -1_𝔽이면 -0_𝔽을 반환합니다.
n이 정수 Number이면 n을 반환합니다.
n보다 작지 않은 가장 작은(-∞에 가장 가까운) 정수 Number 값을 반환합니다.

참고

Math.ceil(x)의 값은 -Math.floor(-x)의 값과 같습니다.

21.3.2.11 Math.clz32 ( `x` )

이 함수는 호출될 때 다음 단계를 수행합니다:

n을 ? ToUint32(x)로 둡니다.
p를 n의 부호 없는 32비트 이진 표현에서 선행 0 비트의 수로 둡니다.
𝔽(p)를 반환합니다.

참고

n이 +0_𝔽 또는 -0_𝔽 중 하나이면 이 메서드는 32_𝔽를 반환합니다. n의 32비트 이진 인코딩에서 최상위 비트가 1이면 이 메서드는 +0_𝔽을 반환합니다.

21.3.2.12 Math.cos ( `x` )

이 함수는 x의 코사인을 반환합니다. 인수는 라디안으로 표현됩니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니면 NaN을 반환합니다.
n이 +0_𝔽 또는 -0_𝔽 중 하나이면 1_𝔽을 반환합니다.
ℝ(n)의 코사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.13 Math.cosh ( `x` )

이 함수는 x의 쌍곡코사인을 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN이면 NaN을 반환합니다.
n이 +∞_𝔽 또는 -∞_𝔽 중 하나이면 +∞_𝔽을 반환합니다.
n이 +0_𝔽 또는 -0_𝔽 중 하나이면 1_𝔽을 반환합니다.
ℝ(n)의 쌍곡코사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

참고

Math.cosh(x)의 값은 (Math.exp(x) + Math.exp(-x)) / 2의 값과 같습니다.

21.3.2.14 Math.exp ( `x` )

이 함수는 x의 지수 함수(자연로그의 밑인 e를 x제곱한 값)를 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN 또는 +∞_𝔽 중 하나이면 n을 반환합니다.
n이 +0_𝔽 또는 -0_𝔽 중 하나이면 1_𝔽을 반환합니다.
n이 -∞_𝔽이면 +0_𝔽을 반환합니다.
ℝ(n)의 지수 함수를 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.15 Math.expm1 ( `x` )

이 함수는 x의 지수 함수(자연로그의 밑인 e를 x제곱한 값)에서 1을 뺀 결과를 반환합니다. 결과는 x의 값이 0에 가까운 경우에도 정확하도록 계산됩니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽, +∞_𝔽 중 하나이면 n을 반환합니다.
n이 -∞_𝔽이면 -1_𝔽을 반환합니다.
exp를 ℝ(n)의 지수 함수로 둡니다.
exp - 1을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.16 Math.floor ( `x` )

이 함수는 x보다 크지 않은 가장 큰(+∞에 가장 가까운) 정수 Number 값을 반환합니다. x가 이미 정수 Number이면 결과는 x입니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 +0_𝔽 또는 -0_𝔽 중 하나이면 n을 반환합니다.
n < 1_𝔽이고 n > +0_𝔽이면 +0_𝔽을 반환합니다.
n이 정수 Number이면 n을 반환합니다.
n보다 크지 않은 가장 큰(+∞에 가장 가까운) 정수 Number 값을 반환합니다.

참고

Math.floor(x)의 값은 -Math.ceil(-x)의 값과 같습니다.

21.3.2.17 Math.fround ( `x` )

이 함수는 호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN이면 NaN을 반환합니다.
n이 +0_𝔽, -0_𝔽, +∞_𝔽, -∞_𝔽 중 하나이면 n을 반환합니다.
n32를 roundTiesToEven 모드를 사용하여 n을 IEEE 754-2019 binary32 형식으로 변환한 결과로 둡니다.
n64를 n32를 IEEE 754-2019 binary64 형식으로 변환한 결과로 둡니다.
n64에 대응하는 ECMAScript Number 값을 반환합니다.

21.3.2.18 Math.f16round ( `x` )

이 함수는 호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN이면 NaN을 반환합니다.
n이 +0_𝔽, -0_𝔽, +∞_𝔽, -∞_𝔽 중 하나이면 n을 반환합니다.
n16을 roundTiesToEven 모드를 사용하여 n을 IEEE 754-2019 binary16 형식으로 변환한 결과로 둡니다.
n64를 n16을 IEEE 754-2019 binary64 형식으로 변환한 결과로 둡니다.
n64에 대응하는 ECMAScript Number 값을 반환합니다.

참고

이 연산은 이중 반올림 가능성 때문에 binary32로 캐스팅한 다음 binary16으로 캐스팅하는 것과 같지 않습니다. 예를 들어 k = 1.00048828125000022204_𝔽인 수를 고려하면 Math.f16round(k)는 1.0009765625_𝔽이지만 Math.f16round(Math.fround(k))는 1_𝔽입니다.

모든 플랫폼이 binary64에서 binary16으로의 캐스팅을 기본적으로 지원하는 것은 아닙니다. MIT 라이선스의 half 라이브러리를 포함하여 이를 제공할 수 있는 다양한 라이브러리가 있습니다. 또는 먼저 roundTiesToEven에서 binary64를 binary32로 캐스팅한 다음 결과가 잘못된 이중 반올림을 초래할 수 있는지 확인할 수 있습니다. 이러한 경우에는 binary32 값의 가수를 조정하여 초기 캐스팅을 roundTiesToOdd에서 수행했을 때 생성되는 값이 되도록 명시적으로 처리할 수 있습니다. 그런 다음 조정된 값을 roundTiesToEven에서 binary16으로 캐스팅하면 올바른 값이 생성됩니다.

21.3.2.19 Math.hypot ( ...`args` )

0개 이상의 인수가 주어지면 이 함수는 각 인수의 제곱합의 제곱근을 반환합니다.

호출될 때 다음 단계를 수행합니다:

coerced를 새로운 빈 List로 둡니다.
args의 각 요소 arg에 대해 다음을 수행합니다.
1. n을 ? ToNumber(arg)로 둡니다.
2. n을 coerced에 추가합니다.
coerced의 각 요소 number에 대해 다음을 수행합니다.
1. number가 +∞_𝔽 또는 -∞_𝔽 중 하나이면 +∞_𝔽을 반환합니다.
onlyZero를 true로 둡니다.
coerced의 각 요소 number에 대해 다음을 수행합니다.
1. number가 NaN이면 NaN을 반환합니다.
2. number가 +0_𝔽도 -0_𝔽도 아니면 onlyZero를 false로 설정합니다.
onlyZero가 true이면 +0_𝔽을 반환합니다.
coerced 요소들의 수학적 값의 제곱합의 제곱근을 나타내는 구현에서 근사한 Number 값을 반환합니다.

이 함수의 "length" 속성은 2_𝔽입니다.

참고

구현은 이 함수가 두 개 이상의 인수로 호출될 때 단순한 구현에서 발생하기 쉬운 오버플로와 언더플로로 인한 정밀도 손실을 방지하도록 주의해야 합니다.

21.3.2.20 Math.imul ( `x`, `y` )

이 함수는 호출될 때 다음 단계를 수행합니다:

a를 ℝ(? ToUint32(x))로 둡니다.
b를 ℝ(? ToUint32(y))로 둡니다.
product를 (a × b) modulo 2³²로 둡니다.
product ≥ 2³¹이면 𝔽(product - 2³²)를 반환합니다.
𝔽(product)를 반환합니다.

21.3.2.21 Math.log ( `x` )

이 함수는 x의 자연로그를 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN 또는 +∞_𝔽 중 하나이면 n을 반환합니다.
n이 1_𝔽이면 +0_𝔽을 반환합니다.
n이 +0_𝔽 또는 -0_𝔽 중 하나이면 -∞_𝔽을 반환합니다.
n < -0_𝔽이면 NaN을 반환합니다.
ln(ℝ(n))을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.22 Math.log1p ( `x` )

이 함수는 1 + x의 자연로그를 반환합니다. 결과는 x의 값이 0에 가까운 경우에도 정확하도록 계산됩니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽, +∞_𝔽 중 하나이면 n을 반환합니다.
n이 -1_𝔽이면 -∞_𝔽을 반환합니다.
n < -1_𝔽이면 NaN을 반환합니다.
ln(1 + ℝ(n))을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.23 Math.log10 ( `x` )

이 함수는 x의 밑이 10인 로그를 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN 또는 +∞_𝔽 중 하나이면 n을 반환합니다.
n이 1_𝔽이면 +0_𝔽을 반환합니다.
n이 +0_𝔽 또는 -0_𝔽 중 하나이면 -∞_𝔽을 반환합니다.
n < -0_𝔽이면 NaN을 반환합니다.
log10(ℝ(n))을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.24 Math.log2 ( `x` )

이 함수는 x의 밑이 2인 로그를 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN 또는 +∞_𝔽 중 하나이면 n을 반환합니다.
n이 1_𝔽이면 +0_𝔽을 반환합니다.
n이 +0_𝔽 또는 -0_𝔽 중 하나이면 -∞_𝔽을 반환합니다.
n < -0_𝔽이면 NaN을 반환합니다.
log2(ℝ(n))을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.25 Math.max ( ...`args` )

0개 이상의 인수가 주어지면 이 함수는 각 인수에 대해 ToNumber를 호출하고 결과 값 중 가장 큰 값을 반환합니다.

호출될 때 다음 단계를 수행합니다:

coerced를 새로운 빈 List로 둡니다.
args의 각 요소 arg에 대해 다음을 수행합니다.
1. n을 ? ToNumber(arg)로 둡니다.
2. n을 coerced에 추가합니다.
highest를 -∞_𝔽로 둡니다.
coerced의 각 요소 number에 대해 다음을 수행합니다.
1. number가 NaN이면 NaN을 반환합니다.
2. number가 +0_𝔽이고 highest가 -0_𝔽이면 highest를 +0_𝔽으로 설정합니다.
3. number > highest이면 highest를 number로 설정합니다.
highest를 반환합니다.

참고

가장 큰 값을 결정하기 위한 값의 비교는 +0_𝔽을 -0_𝔽보다 큰 것으로 간주한다는 점을 제외하면 IsLessThan 알고리즘을 사용하여 수행됩니다.

이 함수의 "length" 속성은 2_𝔽입니다.

21.3.2.26 Math.min ( ...`args` )

0개 이상의 인수가 주어지면 이 함수는 각 인수에 대해 ToNumber를 호출하고 결과 값 중 가장 작은 값을 반환합니다.

호출될 때 다음 단계를 수행합니다:

coerced를 새로운 빈 List로 둡니다.
args의 각 요소 arg에 대해 다음을 수행합니다.
1. n을 ? ToNumber(arg)로 둡니다.
2. n을 coerced에 추가합니다.
lowest를 +∞_𝔽로 둡니다.
coerced의 각 요소 number에 대해 다음을 수행합니다.
1. number가 NaN이면 NaN을 반환합니다.
2. number가 -0_𝔽이고 lowest가 +0_𝔽이면 lowest를 -0_𝔽으로 설정합니다.
3. number < lowest이면 lowest를 number로 설정합니다.
lowest를 반환합니다.

참고

가장 작은 값을 결정하기 위한 값의 비교는 +0_𝔽을 -0_𝔽보다 큰 것으로 간주한다는 점을 제외하면 IsLessThan 알고리즘을 사용하여 수행됩니다.

이 함수의 "length" 속성은 2_𝔽입니다.

21.3.2.27 Math.pow ( `base`, `exponent` )

이 함수는 호출될 때 다음 단계를 수행합니다:

base를 ? ToNumber(base)로 설정합니다.
exponent를 ? ToNumber(exponent)로 설정합니다.
Number::exponentiate(base, exponent)를 반환합니다.

21.3.2.28 Math.random ( )

이 함수는 양의 부호를 가지며 +0_𝔽 이상이지만 1_𝔽보다 엄격히 작은 Number 값을 반환합니다. 이 값은 구현 정의 알고리즘 또는 전략을 사용하여 해당 범위에 걸쳐 대략 균등한 분포로 무작위 또는 의사 무작위로 선택됩니다.

서로 다른 realm에 대해 생성된 각 Math.random 함수는 연속 호출에서 서로 다른 값의 시퀀스를 생성해야 합니다.

21.3.2.29 Math.round ( `x` )

이 함수는 x에 가장 가깝고 정수인 Number 값을 반환합니다. 두 정수 Number가 x에 동일하게 가까우면 결과는 +∞에 더 가까운 Number 값입니다. x가 이미 정수이면 결과는 x입니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 정수 Number이면 n을 반환합니다.
n < 0.5_𝔽이고 n > +0_𝔽이면 +0_𝔽을 반환합니다.
n < -0_𝔽이고 n ≥ -0.5_𝔽이면 -0_𝔽을 반환합니다.
n에 가장 가까운 정수 Number를 반환하며, 동률인 경우 +∞에 더 가까운 Number를 우선합니다.

참고 1

Math.round(3.5)는 4를 반환하지만 Math.round(-3.5)는 -3을 반환합니다.

참고 2

Math.round(x)의 값이 항상 Math.floor(x + 0.5)의 값과 같은 것은 아닙니다. x가 -0_𝔽이거나 x가 -0_𝔽보다 작지만 -0.5_𝔽 이상인 경우 Math.round(x)는 -0_𝔽을 반환하지만 Math.floor(x + 0.5)는 +0_𝔽을 반환합니다. Math.round(x)는 x + 0.5를 계산할 때 발생하는 내부 반올림 때문에 Math.floor(x + 0.5)의 값과 다를 수도 있습니다.

21.3.2.30 Math.sign ( `x` )

이 함수는 x의 부호를 반환하여 x가 양수인지, 음수인지 또는 0인지 나타냅니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n < -0_𝔽이면 -1_𝔽을 반환합니다.
1_𝔽을 반환합니다.

21.3.2.31 Math.sin ( `x` )

이 함수는 x의 사인을 반환합니다. 인수는 라디안으로 표현됩니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n이 +∞_𝔽 또는 -∞_𝔽 중 하나이면 NaN을 반환합니다.
ℝ(n)의 사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.32 Math.sinh ( `x` )

이 함수는 x의 쌍곡사인을 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 +0_𝔽 또는 -0_𝔽 중 하나이면 n을 반환합니다.
ℝ(n)의 쌍곡사인을 나타내는 구현에서 근사한 Number 값을 반환합니다.

참고

Math.sinh(x)의 값은 (Math.exp(x) - Math.exp(-x)) / 2의 값과 같습니다.

21.3.2.33 Math.sqrt ( `x` )

이 함수는 x의 제곱근을 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽, +∞_𝔽 중 하나이면 n을 반환합니다.
n < -0_𝔽이면 NaN을 반환합니다.
𝔽(ℝ(n)의 제곱근)을 반환합니다.

21.3.2.34 Math.sumPrecise ( `items` )

Numbers의 iterable이 주어지면 이 함수는 iterable의 각 값을 합산하고 그 합을 반환합니다. 어떤 값이라도 Number가 아니면 TypeError 예외를 던집니다.

호출될 때 다음 단계를 수행합니다:

? RequireObjectCoercible(items)를 수행합니다.
iteratorRecord를 ? GetIterator(items, sync)로 둡니다.
state를 minus-zero로 둡니다.
sum을 0으로 둡니다.
count를 0으로 둡니다.
next를 not-started로 둡니다.
next가 done이 아닌 동안 다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 설정합니다.
2. next가 done이 아니면 다음을 수행합니다.
  1. count ≥ 2⁵³ - 1이면 다음을 수행합니다.
    1. 참고: 이 단계는 실제로 도달할 것으로 예상되지 않으며, 구현이 이 명세를 위반하지 않고 입력이 “합리적인 크기”라고 가정할 수 있도록 하기 위해서만 포함되어 있습니다.
    2. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
    3. ? IteratorClose(iteratorRecord, error)를 반환합니다.
  2. next가 Number가 아니면 다음을 수행합니다.
    1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
    2. ? IteratorClose(iteratorRecord, error)를 반환합니다.
  3. n을 next로 둡니다.
  4. state가 not-a-number가 아니면 다음을 수행합니다.
    1. n이 NaN이면 다음을 수행합니다.
      1. state를 not-a-number로 설정합니다.
    2. 그렇지 않고 n이 +∞_𝔽이면 다음을 수행합니다.
      1. state가 minus-infinity이면 state를 not-a-number로 설정합니다.
      2. 그렇지 않으면 state를 plus-infinity로 설정합니다.
    3. 그렇지 않고 n이 -∞_𝔽이면 다음을 수행합니다.
      1. state가 plus-infinity이면 state를 not-a-number로 설정합니다.
      2. 그렇지 않으면 state를 minus-infinity로 설정합니다.
    4. 그렇지 않고 n이 -0_𝔽이 아니며 state가 minus-zero 또는 finite 중 하나이면 다음을 수행합니다.
      1. state를 finite로 설정합니다.
      2. sum을 sum + ℝ(n)으로 설정합니다.
  5. count를 count + 1로 설정합니다.
state가 not-a-number이면 NaN을 반환합니다.
state가 plus-infinity이면 +∞_𝔽을 반환합니다.
state가 minus-infinity이면 -∞_𝔽을 반환합니다.
state가 minus-zero이면 -0_𝔽을 반환합니다.
𝔽(sum)을 반환합니다.

참고

sum의 값은 다양한 알고리즘을 사용하여 임의 정밀도 산술 없이 계산할 수 있습니다. 그중 하나는 Jonathan Richard Shewchuk의 Adaptive Precision Floating-Point Arithmetic and Fast Robust Geometric Predicates에 제시된 “Grow-Expansion” 알고리즘입니다. 더 최근의 알고리즘은 “Fast exact summation using small and large superaccumulators”에 제시되어 있으며, 해당 코드는 https://gitlab.com/radfordneal/xsum에서 사용할 수 있습니다.

21.3.2.35 Math.tan ( `x` )

이 함수는 x의 탄젠트를 반환합니다. 인수는 라디안으로 표현됩니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n이 +∞_𝔽 또는 -∞_𝔽 중 하나이면 NaN을 반환합니다.
ℝ(n)의 탄젠트를 나타내는 구현에서 근사한 Number 값을 반환합니다.

21.3.2.36 Math.tanh ( `x` )

이 함수는 x의 쌍곡탄젠트를 반환합니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 NaN, +0_𝔽, -0_𝔽 중 하나이면 n을 반환합니다.
n이 +∞_𝔽이면 1_𝔽을 반환합니다.
n이 -∞_𝔽이면 -1_𝔽을 반환합니다.
ℝ(n)의 쌍곡탄젠트를 나타내는 구현에서 근사한 Number 값을 반환합니다.

참고

Math.tanh(x)의 값은 (Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x))의 값과 같습니다.

21.3.2.37 Math.trunc ( `x` )

이 함수는 소수 부분을 제거하여 수 x의 정수 부분을 반환합니다. x가 이미 정수이면 결과는 x입니다.

호출될 때 다음 단계를 수행합니다:

n을 ? ToNumber(x)로 둡니다.
n이 유한 Number가 아니거나 n이 +0_𝔽 또는 -0_𝔽 중 하나이면 n을 반환합니다.
n < 1_𝔽이고 n > +0_𝔽이면 +0_𝔽을 반환합니다.
n < -0_𝔽이고 n > -1_𝔽이면 -0_𝔽을 반환합니다.
+0_𝔽 방향으로 n에 가장 가까운 정수 Number를 반환합니다.

21.4 Date 객체

21.4.1 Date 객체 개요 및 추상 연산 정의

다음 추상 연산은 시간 값(21.4.1.1에 정의됨)을 대상으로 동작합니다. 모든 경우에 이러한 함수 중 하나의 인수가 NaN이면 결과도 NaN이 된다는 점에 유의하시기 바랍니다.

21.4.1.1 시간 값과 시간 범위

ECMAScript의 시간 측정은 POSIX의 시간 측정과 유사하며, 특히 역산 그레고리력, 1970년 1월 1일 UTC 시작 시점의 자정인 epoch, 그리고 모든 날이 정확히 86,400초(각각 1000밀리초)로 구성된다는 정의를 공유합니다.

ECMAScript 시간 값은 Number이며, 밀리초 정밀도로 시간상의 한 시점을 나타내는 정수 Number(유한 시간 값이라고 함)이거나 특정 시점을 나타내지 않는 NaN입니다. MillisecondsPerDay의 정수배인 유한 시간 값(즉, 어떤 정수 d에 대해 MillisecondsPerDay × d인 값)은 에포크로부터 d개의 온전한 UTC 일이 지난 뒤 시작되는 UTC 일의 시작 시점을 나타냅니다(음수 d의 경우 에포크보다 앞선 시점). 그 밖의 모든 유한 시간 값 tv는 그러한 배수이면서 그보다 앞선 가장 큰 유한 시간 값 s를 기준으로 정의되며, s와 동일한 UTC 일 내에서 s보다 (tv - s)밀리초 뒤에 발생하는 시점을 나타냅니다.

시간 값은 UTC 윤초를 고려하지 않습니다. 양의 윤초 안의 순간을 나타내는 시간 값은 없으며, 음의 윤초로 UTC 시간선에서 제거된 순간을 나타내는 시간 값은 존재합니다. 그러나 시간 값의 정의는 여전히 UTC와 구간별 정렬을 이루며, 불연속은 윤초 경계에서만 발생하고 윤초 이외에서는 차이가 0입니다.

Number는 -9,007,199,254,740,992부터 9,007,199,254,740,992까지의 모든 정수를 정확하게 나타낼 수 있습니다(21.1.2.8 및 21.1.2.6). 시간 값은 이보다 약간 작은 -8,640,000,000,000,000부터 8,640,000,000,000,000밀리초까지의 범위를 지원합니다. 이는 1970년 1월 1일 UTC 시작 시점의 자정을 기준으로 정확히 -100,000,000일부터 100,000,000일까지의 시간 값 범위를 제공합니다.

1970년 1월 1일 UTC 시작 시점의 자정 정확한 순간은 시간 값 +0_𝔽으로 나타냅니다.

참고

역산 그레고리력에서 윤년은 정확히 4로 나누어떨어지고 동시에 400으로 나누어떨어지거나 100으로 나누어떨어지지 않는 해입니다.

역산 그레고리력의 400년 주기에는 97개의 윤년이 포함됩니다. 따라서 연평균은 365.2425일이며 이는 31,556,952,000밀리초입니다. 따라서 Number가 밀리초 정밀도로 정확하게 나타낼 수 있는 최대 범위는 1970년을 기준으로 약 -285,426년부터 285,426년까지입니다. 이 절에 명시된 시간 값이 지원하는 더 작은 범위는 1970년을 기준으로 약 -273,790년부터 273,790년까지입니다.

21.4.1.3 Day ( `tv` )

추상 연산 Day. 인수 tv (a finite time value). 반환값: 정수. tv가 속하는 날짜의 날짜 번호를 반환합니다. 호출되면 다음 단계를 수행한다.

floor(ℝ(tv) / MillisecondsPerDay)를 반환합니다.

21.4.1.4 TimeWithinDay ( `tv` )

추상 연산 TimeWithinDay. 인수 tv (a finite time value). 반환값: an integer in the interval from 0 (inclusive) to MillisecondsPerDay (exclusive). tv가 속하는 날의 시작 이후 경과한 밀리초 수를 반환합니다. 호출되면 다음 단계를 수행한다.

ℝ(tv) modulo MillisecondsPerDay를 반환합니다.

21.4.1.5 DayFromYear ( `y` )

추상 연산 DayFromYear. 인수 y (정수). 반환값: 정수. 연도 y의 첫날에 해당하는 날짜 번호를 반환합니다. 호출되면 다음 단계를 수행한다.

참고: 다음 단계에서 numberYears1, numberYears4, numberYears100 및 numberYears400은 각각 epoch와 연도 y의 시작 사이에 나타나는 1, 4, 100 및 400으로 나누어떨어지는 연도의 수를 나타냅니다. y가 epoch보다 이전이면 이 수는 음수입니다.
numberYears1을 (y - 1970)으로 둡니다.
numberYears4를 floor((y - 1969) / 4)로 둡니다.
numberYears100을 floor((y - 1901) / 100)으로 둡니다.
numberYears400을 floor((y - 1601) / 400)으로 둡니다.
365 × numberYears1 + numberYears4 - numberYears100 + numberYears400을 반환합니다.

21.4.1.6 TimeFromYear ( `y` )

추상 연산 TimeFromYear. 인수 y (정수). 반환값: a time value. 연도 y의 시작에 해당하는 시간 값을 반환합니다. 호출되면 다음 단계를 수행한다.

𝔽(MillisecondsPerDay × DayFromYear(y))를 반환합니다.

21.4.1.7 YearFromTime ( `tv` )

추상 연산 YearFromTime. 인수 tv (a finite time value). 반환값: 정수. tv가 속하는 연도를 반환합니다. 호출되면 다음 단계를 수행한다.

TimeFromYear(y) ≤ tv를 만족하는 가장 큰(+∞에 가장 가까운) 정수 y를 반환합니다.

21.4.1.8 DayWithinYear ( `tv` )

추상 연산 DayWithinYear. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 365. 호출되면 다음 단계를 수행한다.

Day(tv) - DayFromYear(YearFromTime(tv))를 반환합니다.

21.4.1.9 InLeapYear ( `tv` )

추상 연산 InLeapYear. 인수 tv (a finite time value). 반환값: (0 또는 1). tv가 윤년에 속하면 1을 반환하고 그렇지 않으면 0을 반환합니다. 호출되면 다음 단계를 수행한다.

y를 YearFromTime(tv)로 둡니다.
(y modulo 400) = 0이면 1을 반환합니다.
(y modulo 100) = 0이면 0을 반환합니다.
(y modulo 4) = 0이면 1을 반환합니다.
0을 반환합니다.

21.4.1.10 MonthFromTime ( `tv` )

추상 연산 MonthFromTime. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 11. tv가 속하는 월을 식별하는 정수를 반환합니다. 월 값 0은 1월, 1은 2월, 2는 3월, 3은 4월, 4는 5월, 5는 6월, 6은 7월, 7은 8월, 8은 9월, 9는 10월, 10은 11월, 11은 12월을 지정합니다. MonthFromTime(+0_𝔽) = 0이며 이는 1970년 1월 1일 목요일에 대응한다는 점에 유의하시기 바랍니다. 호출되면 다음 단계를 수행한다.

inLeapYear를 InLeapYear(tv)로 둡니다.
dayWithinYear를 DayWithinYear(tv)로 둡니다.
dayWithinYear < 31이면 0을 반환합니다.
dayWithinYear < 59 + inLeapYear이면 1을 반환합니다.
dayWithinYear < 90 + inLeapYear이면 2를 반환합니다.
dayWithinYear < 120 + inLeapYear이면 3을 반환합니다.
dayWithinYear < 151 + inLeapYear이면 4를 반환합니다.
dayWithinYear < 181 + inLeapYear이면 5를 반환합니다.
dayWithinYear < 212 + inLeapYear이면 6을 반환합니다.
dayWithinYear < 243 + inLeapYear이면 7을 반환합니다.
dayWithinYear < 273 + inLeapYear이면 8을 반환합니다.
dayWithinYear < 304 + inLeapYear이면 9를 반환합니다.
dayWithinYear < 334 + inLeapYear이면 10을 반환합니다.
단언: dayWithinYear < 365 + inLeapYear입니다.
11을 반환합니다.

21.4.1.11 DateFromTime ( `tv` )

추상 연산 DateFromTime. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 1 to 31. tv가 속하는 월의 날짜를 반환합니다. 호출되면 다음 단계를 수행한다.

inLeapYear를 InLeapYear(tv)로 둡니다.
dayWithinYear를 DayWithinYear(tv)로 둡니다.
month를 MonthFromTime(tv)로 둡니다.
month = 0이면 dayWithinYear + 1을 반환합니다.
month = 1이면 dayWithinYear - 30을 반환합니다.
month = 2이면 dayWithinYear - 58 - inLeapYear를 반환합니다.
month = 3이면 dayWithinYear - 89 - inLeapYear를 반환합니다.
month = 4이면 dayWithinYear - 119 - inLeapYear를 반환합니다.
month = 5이면 dayWithinYear - 150 - inLeapYear를 반환합니다.
month = 6이면 dayWithinYear - 180 - inLeapYear를 반환합니다.
month = 7이면 dayWithinYear - 211 - inLeapYear를 반환합니다.
month = 8이면 dayWithinYear - 242 - inLeapYear를 반환합니다.
month = 9이면 dayWithinYear - 272 - inLeapYear를 반환합니다.
month = 10이면 dayWithinYear - 303 - inLeapYear를 반환합니다.
단언: month = 11입니다.
dayWithinYear - 333 - inLeapYear를 반환합니다.

21.4.1.12 WeekDay ( `tv` )

추상 연산 WeekDay. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 6. tv가 속하는 요일을 식별하는 정수를 반환합니다. 요일 값 0은 일요일, 1은 월요일, 2는 화요일, 3은 수요일, 4는 목요일, 5는 금요일, 6은 토요일을 지정합니다. WeekDay(+0_𝔽) = 4이며 이는 1970년 1월 1일 목요일에 대응한다는 점에 유의하시기 바랍니다. 호출되면 다음 단계를 수행한다.

(Day(tv) + 4) modulo 7을 반환합니다.

21.4.1.13 HourFromTime ( `tv` )

추상 연산 HourFromTime. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 23. tv가 속하는 날의 시를 반환합니다. 호출되면 다음 단계를 수행한다.

floor(ℝ(tv) / MillisecondsPerHour) modulo HoursPerDay를 반환합니다.

21.4.1.14 MinuteFromTime ( `tv` )

추상 연산 MinuteFromTime. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 59. tv가 속하는 시의 분을 반환합니다. 호출되면 다음 단계를 수행한다.

floor(ℝ(tv) / MillisecondsPerMinute) modulo MinutesPerHour를 반환합니다.

21.4.1.15 SecondFromTime ( `tv` )

추상 연산 SecondFromTime. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 59. tv가 속하는 분의 초를 반환합니다. 호출되면 다음 단계를 수행한다.

floor(ℝ(tv) / MillisecondsPerSecond) modulo SecondsPerMinute를 반환합니다.

21.4.1.16 MillisecondFromTime ( `tv` )

추상 연산 MillisecondFromTime. 인수 tv (a finite time value). 반환값: an integer in the inclusive interval from 0 to 999. tv가 속하는 초의 밀리초를 반환합니다. 호출되면 다음 단계를 수행한다.

ℝ(tv) modulo MillisecondsPerSecond를 반환합니다.

21.4.1.17 Epoch 나노초와 범위

epoch 나노초 수는 나노초 정밀도로 시간의 한 순간을 나타내는 정수입니다. 시간 값과 동일한 범위를 지원하지만 나노초로 표현되며, MinEpochNanoseconds부터 MaxEpochNanoseconds까지입니다. 시간 값 NaN에 대응하는 나노초 값은 없으며, 특정 순간이 없음을 나타내는 표현도 없습니다.

1970년 1월 1일 UTC 시작 시점의 자정 정확한 순간은 값 0으로 나타냅니다. 최대 값은 MaxEpochNanoseconds이고 최소 값은 MinEpochNanoseconds입니다.

21.4.1.18 GetUTCEpochNanoseconds ( `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond`, `nanosecond` )

추상 연산 GetUTCEpochNanoseconds. 인수 year (정수), month (an integer in the inclusive interval from 1 to 12), day (an integer in the inclusive interval from 1 to 31), hour (an integer in the inclusive interval from 0 to 23), minute (an integer in the inclusive interval from 0 to 59), second (an integer in the inclusive interval from 0 to 59), millisecond (an integer in the inclusive interval from 0 to 999), microsecond (an integer in the inclusive interval from 0 to 999) 및 nanosecond (an integer in the inclusive interval from 0 to 999). 반환값: an epoch nanoseconds count. 반환 값은 주어진 ISO 8601 달력 날짜와 UTC의 시계 시간에 대응하는 epoch 나노초 수입니다. 호출되면 다음 단계를 수행한다.

date를 MakeDay(𝔽(year), 𝔽(month - 1), 𝔽(day))로 둡니다.
time을 MakeTime(𝔽(hour), 𝔽(minute), 𝔽(second), 𝔽(millisecond))로 둡니다.
epochMilliseconds를 MakeDate(date, time)로 둡니다.
단언: epochMilliseconds는 정수 Number입니다.
ℝ(epochMilliseconds) × NanosecondsPerMillisecond + microsecond × NanosecondsPerMicrosecond + nanosecond를 반환합니다.

21.4.1.19 시간대 식별자

ECMAScript의 시간대는 시간대 식별자로 나타내며, 이는 0x0000부터 0x007F까지의 폐구간에 속하는 코드 단위만으로 구성된 String입니다. ECMAScript 구현체가 지원하는 시간대는 AvailableNamedTimeZoneIdentifiers가 반환하는 Time Zone Identifier Record의 [[Identifier]] 필드로 나타내는 사용 가능한 이름 있는 시간대이거나, IsTimeZoneOffsetString이 true를 반환하는 String으로 나타내는 오프셋 시간대일 수 있습니다.

주 시간대 식별자는 사용 가능한 이름 있는 시간대의 기본 식별자입니다. 비주 시간대 식별자는 주 시간대 식별자가 아닌 사용 가능한 이름 있는 시간대의 식별자입니다. 사용 가능한 이름 있는 시간대 식별자는 주 시간대 식별자 또는 비주 시간대 식별자 중 하나입니다. 각 사용 가능한 이름 있는 시간대 식별자는 정확히 하나의 사용 가능한 이름 있는 시간대와 연결됩니다. 각 사용 가능한 이름 있는 시간대는 정확히 하나의 주 시간대 식별자 및 0개 이상의 비주 시간대 식별자와 연결됩니다.

ECMAScript 구현체는 식별자가 "UTC"인 사용 가능한 이름 있는 시간대를 지원해야 하며, 이는 UTC 시간대의 주 시간대 식별자여야 합니다. 또한 구현체는 임의의 수의 다른 사용 가능한 이름 있는 시간대를 지원할 수 있습니다.

ECMA-402 국제화 API 명세에 설명된 시간대 요구 사항을 따르는 구현체를 시간대 인식 구현체라고 합니다. 시간대 인식 구현체는 IANA Time Zone Database의 “Zone” 및 “Link” 이름에 대응하는 사용 가능한 이름 있는 시간대를 지원해야 하며, 그러한 이름만 지원해야 합니다. 시간대 인식 구현체에서 주 시간대 식별자는 IANA Time Zone Database의 “Zone” 이름이고, 비주 시간대 식별자는 각각 “Link” 이름입니다. 다만 ECMA-402에 명시된 AvailableNamedTimeZoneIdentifiers에 의해 특별히 재정의된 경우는 제외합니다. 전체 IANA Time Zone Database를 지원하지 않는 구현체에도 시간대를 나타내는 식별자로 IANA Time Zone Database 이름을 사용하는 것이 권장됩니다.

21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( `timeZoneIdentifier`, `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond`, `nanosecond` )

구현 정의 추상 연산 GetNamedTimeZoneEpochNanoseconds. 인수 timeZoneIdentifier (String), year (정수), month (an integer in the inclusive interval from 1 to 12), day (an integer in the inclusive interval from 1 to 31), hour (an integer in the inclusive interval from 0 to 23), minute (an integer in the inclusive interval from 0 to 59), second (an integer in the inclusive interval from 0 to 59), millisecond (an integer in the inclusive interval from 0 to 999), microsecond (an integer in the inclusive interval from 0 to 999) 및 nanosecond (an integer in the inclusive interval from 0 to 999). 반환값: 리스트 (요소: epoch nanoseconds counts). 반환된 List의 각 값은 timeZoneIdentifier가 식별하는 이름 있는 시간대에서 주어진 ISO 8601 달력 날짜 및 시계 시간에 대응하는 epoch 나노초 수를 나타냅니다.

입력이 음의 시간대 전이 때문에 두 번 이상 발생하는 로컬 시간을 나타내면(예: 일광 절약 시간이 끝나거나 시간대 규칙 변경으로 시간대 오프셋이 감소하는 경우) 반환된 List에는 둘 이상의 요소가 있으며 숫자 값의 오름차순으로 정렬됩니다. 입력이 양의 시간대 전이 때문에 건너뛴 로컬 시간을 나타내면(예: 일광 절약 시간이 시작되거나 시간대 규칙 변경으로 시간대 오프셋이 증가하는 경우) 반환된 List는 비어 있습니다. 그 밖의 경우 반환된 List에는 하나의 요소가 있습니다.

어떤 시간대에도 로컬 정치적 규칙을 포함하지 않는 ECMAScript 구현체에서 사용하는 GetNamedTimeZoneEpochNanoseconds의 기본 구현은 호출되면 다음 단계를 수행합니다:

단언: timeZoneIdentifier는 "UTC"입니다.
epochNanoseconds를 GetUTCEpochNanoseconds(year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)로 둡니다.
« epochNanoseconds »을 반환합니다.

참고

시간대 인식 구현체는 IANA Time Zone Database의 시간대 정보를 사용해야 하며, 다른 모든 구현체에도 이를 사용하는 것이 권장됩니다.

America/New_York에서 2017년 11월 5일 오전 1:30은 두 번 반복되므로 GetNamedTimeZoneEpochNanoseconds("America/New_York", 2017, 11, 5, 1, 30, 0, 0, 0, 0)은 길이가 2인 List를 반환하며, 첫 번째 요소는 05:30 UTC(UTC 오프셋 -04:00인 미국 동부 일광 절약 시간의 01:30에 대응)를 나타내고 두 번째 요소는 06:30 UTC(UTC 오프셋 -05:00인 미국 동부 표준시의 01:30에 대응)를 나타냅니다.

America/New_York에서 2017년 3월 12일 오전 2:30은 존재하지 않으므로 GetNamedTimeZoneEpochNanoseconds("America/New_York", 2017, 3, 12, 2, 30, 0, 0, 0, 0)은 빈 List를 반환합니다.

21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( `timeZoneIdentifier`, `epochNanoseconds` )

구현 정의 추상 연산 GetNamedTimeZoneOffsetNanoseconds. 인수 timeZoneIdentifier (String) 및 epochNanoseconds (an epoch nanoseconds count). 반환값: 정수.

반환된 정수는 epoch 나노초 수 epochNanoseconds에 대응하는 순간에 timeZoneIdentifier가 식별하는 이름 있는 시간대의 UTC로부터의 오프셋을 나노초 단위로 나타냅니다.

어떤 시간대에도 로컬 정치적 규칙을 포함하지 않는 ECMAScript 구현체에서 사용하는 GetNamedTimeZoneOffsetNanoseconds의 기본 구현은 호출되면 다음 단계를 수행합니다:

단언: timeZoneIdentifier는 "UTC"입니다.
0을 반환합니다.

참고

시간대 오프셋 값은 양수 또는 음수일 수 있습니다.

21.4.1.22 Time Zone Identifier Record

Time Zone Identifier Record는 사용 가능한 이름 있는 시간대 식별자 및 이에 대응하는 주 시간대 식별자를 설명하는 데 사용하는 Record입니다.

Time Zone Identifier Record에는 표 60에 나열된 필드가 있습니다.

표 60: Time Zone Identifier Record 필드

필드 이름	값	의미
`[[Identifier]]`	a String	구현체가 지원하는 사용 가능한 이름 있는 시간대 식별자입니다.
`[[PrimaryIdentifier]]`	a String	`[[Identifier]]`가 해석되는 주 시간대 식별자입니다.

참고

[[Identifier]]가 주 시간대 식별자이면 [[Identifier]]는 [[PrimaryIdentifier]]입니다.

21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )

구현 정의 추상 연산 AvailableNamedTimeZoneIdentifiers. 인수 없음. 반환값: 리스트 (요소: Time Zone Identifier 레코드). 결과는 이 구현체에서 사용할 수 있는 모든 이름 있는 시간대 식별자와 각 사용 가능한 이름 있는 시간대 식별자에 대응하는 주 시간대 식별자를 설명합니다. List는 각 Time Zone Identifier Record의 [[Identifier]] 필드에 따라 정렬됩니다.

ECMA-402 국제화 API를 구현하는 모든 구현체를 포함한 시간대 인식 구현체는 ECMA-402에 명시된 대로 AvailableNamedTimeZoneIdentifiers 추상 연산을 구현해야 합니다. 그렇지 않으면 AvailableNamedTimeZoneIdentifiers는 호출되면 다음 단계를 수행합니다:

구현체가 어떤 시간대에도 로컬 정치적 규칙을 포함하지 않으면, 다음을 수행합니다.
1. « Time Zone Identifier Record { [[Identifier]]: "UTC", [[PrimaryIdentifier]]: "UTC" } »를 반환합니다.
identifiers를 고유한 사용 가능한 이름 있는 시간대 식별자의 List로 두고, 사전식 코드 단위 순서에 따라 정렬합니다.
result를 새로운 빈 List로 둡니다.
identifiers의 각 요소 identifier에 대해 다음을 수행합니다.
1. primary를 identifier로 둡니다.
2. identifier가 이 구현체의 비주 시간대 식별자이고 identifier가 "UTC"가 아니면, 다음을 수행합니다.
  1. primary를 identifier와 연결된 주 시간대 식별자로 설정합니다.
  2. 참고: 구현체는 주 시간대 식별자를 얻기 위해 identifier를 반복적으로 해석해야 할 수 있습니다.
3. record를 Time Zone Identifier Record { [[Identifier]]: identifier, [[PrimaryIdentifier]]: primary }로 둡니다.
4. record를 result에 추가합니다.
단언: result에는 record.[[Identifier]]가 "UTC"이고 record.[[PrimaryIdentifier]]가 "UTC"인 Time Zone Identifier Record record가 포함되어 있습니다.
result를 반환합니다.

21.4.1.24 SystemTimeZoneIdentifier ( )

구현 정의 추상 연산 SystemTimeZoneIdentifier. 인수 없음. 반환값: String. 호스트 환경의 현재 시간대를 나타내는 String을 반환하며, 이는 IsTimeZoneOffsetString이 true를 반환하는 UTC 오프셋을 나타내는 String 또는 주 시간대 식별자 중 하나입니다. 호출되면 다음 단계를 수행한다.

구현체가 UTC 시간대만 지원하면 "UTC"를 반환합니다.
systemTimeZoneString을 호스트 환경의 현재 시간대를 나타내는 String으로 두며, 주 시간대 식별자 또는 오프셋 시간대 식별자 중 하나입니다.
systemTimeZoneString을 반환합니다.

참고

구현체가 Date 객체의 메서드에서 일반적으로 제공하는 기능 수준을 보장하기 위해, 그러한 것이 존재한다면 SystemTimeZoneIdentifier가 호스트 환경의 시간대 설정에 대응하는 IANA 시간대 이름을 반환하는 것이 권장됩니다. GetNamedTimeZoneEpochNanoseconds 및 GetNamedTimeZoneOffsetNanoseconds는 해당 시간대에 표준시 및 일광 절약 시간에 대한 로컬 정치적 규칙이 존재하는 경우 이를 반영해야 합니다.

예를 들어 호스트 환경이 사용자가 미국 동부 시간을 자신의 시간대로 선택한 시스템의 브라우저이면 SystemTimeZoneIdentifier는 "America/New_York"를 반환합니다.

21.4.1.25 LocalTime ( `tv` )

추상 연산 LocalTime. 인수 tv (a finite time value). 반환값: 정수인 Number. tv를 UTC에서 로컬 시간으로 변환합니다. tv에 적용되는 표준시 및 일광 절약 시간에 대한 로컬 정치적 규칙을 사용하여 이 절에 명시된 방식으로 결과를 결정해야 합니다. 호출되면 다음 단계를 수행한다.

systemTimeZoneIdentifier를 SystemTimeZoneIdentifier()로 둡니다.
IsTimeZoneOffsetString(systemTimeZoneIdentifier)이 true이면, 다음을 수행합니다.
1. offsetNanoseconds를 ParseTimeZoneOffsetString(systemTimeZoneIdentifier)으로 둡니다.
그렇지 않으면,
1. offsetNanoseconds를 GetNamedTimeZoneOffsetNanoseconds(systemTimeZoneIdentifier, ℝ(tv) × NanosecondsPerMillisecond)로 둡니다.
offsetMilliseconds를 truncate(offsetNanoseconds / NanosecondsPerMillisecond)로 둡니다.
tv + 𝔽(offsetMilliseconds)를 반환합니다.

참고 1

로컬 시간 tv에 대한 정치적 규칙을 구현체 안에서 사용할 수 없으면 SystemTimeZoneIdentifier가 "UTC"를 반환하고 GetNamedTimeZoneOffsetNanoseconds가 0을 반환하므로 결과는 tv입니다.

참고 2

시간대 인식 구현체는 IANA Time Zone Database https://www.iana.org/time-zones/의 시간대 정보를 사용해야 하며, 다른 모든 구현체에도 이를 사용하는 것이 권장됩니다.

참고 3

반복되는 시간이 있는 음의 시간대 전이 시점(예: 일광 절약 시간이 끝나거나 시간대 조정이 감소하는 경우)에 서로 다른 두 입력 시간 값 tv_UTC가 동일한 로컬 시간 t_local로 변환됩니다.

LocalTime(UTC(tv_local))은 반드시 항상 tv_local과 같지는 않습니다. 마찬가지로 UTC(LocalTime(tv_UTC))도 반드시 항상 tv_UTC과 같지는 않습니다.

21.4.1.26 UTC ( `t` )

추상 연산 UTC. 인수 t (Number). 반환값: a time value. t를 로컬 시간에서 UTC 시간 값으로 변환합니다. t에 적용되는 표준시 및 일광 절약 시간에 대한 로컬 정치적 규칙을 사용하여 이 절에 명시된 방식으로 결과를 결정해야 합니다. 호출되면 다음 단계를 수행한다.

t가 유한 Number가 아니면 NaN을 반환합니다.
systemTimeZoneIdentifier를 SystemTimeZoneIdentifier()로 둡니다.
IsTimeZoneOffsetString(systemTimeZoneIdentifier)이 true이면, 다음을 수행합니다.
1. offsetNanoseconds를 ParseTimeZoneOffsetString(systemTimeZoneIdentifier)으로 둡니다.
그렇지 않으면,
1. possibleInstants를 GetNamedTimeZoneEpochNanoseconds(systemTimeZoneIdentifier, YearFromTime(t), MonthFromTime(t) + 1, DateFromTime(t), HourFromTime(t), MinuteFromTime(t), SecondFromTime(t), MillisecondFromTime(t), 0, 0)으로 둡니다.
2. 참고: 다음 단계는 t가 음의 시간대 전이에서 여러 번 반복되는 로컬 시간(예: 일광 절약 시간이 끝나거나 시간대 규칙 변경으로 시간대 오프셋이 감소하는 경우) 또는 양의 시간대 전이에서 건너뛴 로컬 시간(예: 일광 절약 시간이 시작되거나 시간대 규칙 변경으로 시간대 오프셋이 증가하는 경우)을 나타낼 때 t가 전이 이전의 시간대 오프셋을 사용하여 해석되도록 보장합니다.
3. possibleInstants가 비어 있지 않으면, 다음을 수행합니다.
  1. disambiguatedInstant를 possibleInstants[0]으로 둡니다.
4. 그렇지 않으면,
  1. 참고: t는 양의 시간대 전이에서 건너뛴 로컬 시간을 나타냅니다(예: 일광 절약 시간이 시작되거나 시간대 규칙 변경으로 UTC 오프셋이 증가하는 경우).
  2. possibleInstantsBefore를 GetNamedTimeZoneEpochNanoseconds(systemTimeZoneIdentifier, YearFromTime(tBefore), MonthFromTime(tBefore) + 1, DateFromTime(tBefore), HourFromTime(tBefore), MinuteFromTime(tBefore), SecondFromTime(tBefore), MillisecondFromTime(tBefore), 0, 0)으로 둡니다. 여기서 tBefore는 possibleInstantsBefore가 비어 있지 않은(즉, tBefore가 전이 이전의 마지막 로컬 시간을 나타내는) 가장 큰 정수 Number < t입니다.
  3. disambiguatedInstant를 possibleInstantsBefore의 마지막 요소로 둡니다.
5. offsetNanoseconds를 GetNamedTimeZoneOffsetNanoseconds(systemTimeZoneIdentifier, disambiguatedInstant)로 둡니다.
offsetMilliseconds를 truncate(offsetNanoseconds / NanosecondsPerMillisecond)로 둡니다.
t - 𝔽(offsetMilliseconds)를 반환합니다.

입력 t는 명목상 시간 값이지만 어떤 Number 값이든 될 수 있습니다. 로컬 UTC 오프셋과 관계없이 시간 값 범위의 경계에 대응하는 입력을 지원할 수 있도록 알고리즘은 t를 시간 값 범위로 제한해서는 안 됩니다. 예를 들어 최대 시간 값은 8.64 × 10¹⁵이며 "+275760-09-13T00:00:00Z"에 대응합니다. 해당 순간에 로컬 시간대 오프셋이 UTC보다 1시간 앞선 환경에서는 8.64 × 10¹⁵ + 3.6 × 10⁶이라는 더 큰 입력으로 나타내며, 이는 "+275760-09-13T01:00:00+01:00"에 대응합니다.

로컬 시간 t에 대한 정치적 규칙을 구현체 안에서 사용할 수 없으면 SystemTimeZoneIdentifier가 "UTC"를 반환하고 GetNamedTimeZoneOffsetNanoseconds가 0을 반환하므로 결과는 t입니다.

참고 1

시간대 인식 구현체는 IANA Time Zone Database의 시간대 정보를 사용해야 하며, 다른 모든 구현체에도 이를 사용하는 것이 권장됩니다.

America/New_York에서 2017년 11월 5일 오전 1:30은 두 번 반복되지만(시계를 뒤로 돌림), 오전 1:30 UTC-05가 아니라 오전 1:30 UTC-04로 해석해야 합니다. UTC(TimeClip(MakeDate(MakeDay(2017, 10, 5), MakeTime(1, 30, 0, 0))))에서 offsetMilliseconds의 값은 -4 × MillisecondsPerHour입니다.

America/New_York에서 2017년 3월 12일 오전 2:30은 존재하지 않지만 오전 2:30 UTC-05(오전 3:30 UTC-04와 동등)로 해석해야 합니다. UTC(TimeClip(MakeDate(MakeDay(2017, 2, 12), MakeTime(2, 30, 0, 0))))에서 offsetMilliseconds의 값은 -5 × MillisecondsPerHour입니다.

참고 2

UTC(LocalTime(t_UTC))은 반드시 항상 t_UTC과 같지는 않습니다. 마찬가지로 LocalTime(UTC(t_local))도 반드시 항상 t_local과 같지는 않습니다.

21.4.1.27 MakeTime ( `hour`, `minute`, `second`, `millisecond` )

추상 연산 MakeTime. 인수 hour (Number), minute (Number), second (Number) 및 millisecond (Number). 반환값: Number. 밀리초 수를 계산합니다. 호출되면 다음 단계를 수행한다.

hour가 유한 Number가 아니거나, minute이 유한 Number가 아니거나, second가 유한 Number가 아니거나, millisecond가 유한 Number가 아니면 NaN을 반환합니다.
hourMV를 ! ToIntegerOrInfinity(hour)로 둡니다.
minuteMV를 ! ToIntegerOrInfinity(minute)로 둡니다.
secondMV를 ! ToIntegerOrInfinity(second)로 둡니다.
millisecondMV를 ! ToIntegerOrInfinity(millisecond)로 둡니다.
((𝔽(hourMV) × 𝔽(MillisecondsPerHour) + 𝔽(minuteMV) × 𝔽(MillisecondsPerMinute)) + 𝔽(secondMV) × 𝔽(MillisecondsPerSecond)) + 𝔽(millisecondMV)를 반환합니다.

참고

MakeTime의 산술은 결합법칙이 성립하지 않는 부동 소수점 산술이므로 연산을 올바른 순서로 수행해야 합니다.

21.4.1.28 MakeDay ( `year`, `month`, `day` )

추상 연산 MakeDay. 인수 year (Number), month (Number) 및 day (Number). 반환값: (a finite Number 또는 NaN). 날짜 수를 계산합니다. 호출되면 다음 단계를 수행한다.

year가 유한 Number가 아니거나, month가 유한 Number가 아니거나, day가 유한 Number가 아니면 NaN을 반환합니다.
yearMV를 ! ToIntegerOrInfinity(year)로 둡니다.
monthMV를 ! ToIntegerOrInfinity(month)로 둡니다.
dayMV를 ! ToIntegerOrInfinity(day)로 둡니다.
balancedYear를 𝔽(yearMV) + 𝔽(floor(monthMV / 12))로 둡니다.
balancedYear가 유한 Number가 아니면 NaN을 반환합니다.
balancedMonthMV를 monthMV modulo 12로 둡니다.
YearFromTime(tv) = ℝ(balancedYear), MonthFromTime(tv) = balancedMonthMV, DateFromTime(tv) = 1을 만족하는 유한 시간 값 tv를 찾습니다. 단, 이것이 가능하지 않으면(일부 인수가 범위를 벗어나기 때문에) NaN을 반환합니다.
𝔽(Day(tv)) + 𝔽(dayMV) - 1_𝔽을 반환합니다.

21.4.1.29 MakeDate ( `day`, `time` )

추상 연산 MakeDate. 인수 day (Number) 및 time (Number). 반환값: (a finite Number 또는 NaN). 밀리초 수를 계산합니다. 호출되면 다음 단계를 수행한다.

day가 유한 Number가 아니거나 time이 유한 Number가 아니면 NaN을 반환합니다.
tv를 day × 𝔽(MillisecondsPerDay) + time으로 둡니다.
tv가 유한 Number가 아니면 NaN을 반환합니다.
tv를 반환합니다.

21.4.1.30 MakeFullYear ( `year` )

추상 연산 MakeFullYear. 인수 year (Number). 반환값: (정수인 Number 또는 NaN). year의 정수 부분과 연결된 전체 연도를 반환하며, 0부터 99까지의 폐구간에 속하는 값은 1900년 시작 이후 경과한 연도 수로 해석합니다. 역산 그레고리력과 맞추기 위해 “전체 연도”는 연도 0(기원전 1년)의 시작 이후 완료된 연도의 부호 있는 수로 정의됩니다. 호출되면 다음 단계를 수행한다.

year가 NaN, +∞_𝔽 또는 -∞_𝔽 중 하나이면 NaN을 반환합니다.
truncated를 ! ToIntegerOrInfinity(year)로 둡니다.
truncated가 0부터 99까지의 폐구간에 속하면 1900_𝔽 + 𝔽(truncated)를 반환합니다.
𝔽(truncated)를 반환합니다.

21.4.1.31 TimeClip ( `time` )

추상 연산 TimeClip. 인수 time (Number). 반환값: a time value. 밀리초 수를 계산합니다. 호출되면 다음 단계를 수행한다.

time가 유한 Number가 아니면 NaN을 반환합니다.
abs(ℝ(time)) > 8.64 × 10¹⁵이면 NaN을 반환합니다.
𝔽(! ToIntegerOrInfinity(time))를 반환합니다.

21.4.1.32 날짜 시간 문자열 형식

ECMAScript는 ISO 8601 달력 날짜 확장 형식에서 변형된 날짜-시간 문자열 교환 형식을 정의합니다. 형식은 다음과 같습니다: YYYY-MM-DDTHH:mm:ss.sssZ

각 요소는 다음과 같습니다:

`YYYY`	역산 그레고리력의 연도를 0000부터 9999까지의 네 자리 십진수로 나타내거나, "+" 또는 "-" 뒤에 여섯 자리 십진수가 이어지는 확장 연도로 나타냅니다.
`-`	"-" (하이픈)은 문자열에 문자 그대로 두 번 나타납니다.
`MM`	01(1월)부터 12(12월)까지 두 자리 십진수로 나타내는 연중 월입니다.
`DD`	01부터 31까지 두 자리 십진수로 나타내는 월중 날짜입니다.
`T`	시간 요소의 시작을 나타내기 위해 "T"가 문자열에 문자 그대로 나타납니다.
`HH`	자정 이후 지나간 완전한 시간 수를 00부터 24까지 두 자리 십진수로 나타냅니다.
`:`	":" (콜론)이 문자열에 문자 그대로 두 번 나타납니다.
`mm`	시가 시작된 이후 지나간 완전한 분의 수를 00부터 59까지 두 자리 십진수로 나타냅니다.
`ss`	분이 시작된 이후 지나간 완전한 초의 수를 00부터 59까지 두 자리 십진수로 나타냅니다.
`.`	"." (점)이 문자열에 문자 그대로 나타납니다.
`sss`	초가 시작된 이후 지나간 완전한 밀리초 수를 세 자리 십진수로 나타냅니다.
`Z`	"Z" (오프셋이 없는 UTC) 또는 "+"나 "-" 뒤에 시간 표현 `HH:mm`이 이어지는 형식으로 지정되는 UTC 오프셋 표현입니다(각각 UTC보다 앞서거나 뒤처진 로컬 시간을 나타내기 위한 시간대 오프셋 문자열 형식의 부분 집합).

이 형식에는 날짜 전용 형식도 포함됩니다:

YYYY
YYYY-MM
YYYY-MM-DD

또한 위 날짜 전용 형식 중 하나 바로 뒤에 다음 시간 형식 중 하나가 이어지고 선택적으로 UTC 오프셋 표현이 추가되는 “날짜-시간” 형식도 포함됩니다:

THH:mm
THH:mm:ss
THH:mm:ss.sss

범위를 벗어나거나 형식에 맞지 않는 요소를 포함하는 문자열은 이 형식의 유효한 인스턴스가 아닙니다.

참고 1

모든 날은 자정에 시작하고 자정에 끝나므로 하나의 날짜와 연결될 수 있는 두 자정을 구별하기 위해 00:00과 24:00이라는 두 표기법을 사용할 수 있습니다. 따라서 1995-02-04T24:00과 1995-02-05T00:00이라는 다음 두 표기법은 정확히 동일한 시점을 가리킵니다.

참고 2

이 형식은 RFC 9557에 정의된 시간대 이름 주석을 지원하지 않으며, 시간대 오프셋의 숫자 표현만 지원합니다.

21.4.1.32.1 확장 연도

1970년 1월 1일을 기준으로 앞뒤 약 273,790년의 전체 시간 값 범위(21.4.1.1)를 다루려면 0 이전 또는 9999 이후의 연도를 나타내야 합니다. ISO 8601은 연도 표현의 확장을 허용하지만 정보 교환 당사자 간의 상호 합의가 있는 경우에만 허용합니다. 단순화된 ECMAScript 형식에서 이러한 확장 연도 표현은 6자리 숫자를 가져야 하며 항상 + 또는 - 부호가 앞에 붙습니다. 연도 0은 양수로 간주되며 + 부호가 앞에 붙어야 합니다. 연도 0을 -000000으로 나타내는 것은 유효하지 않습니다. 확장 연도를 사용하여 시간 값 범위 밖의 순간을 나타내며 날짜 시간 문자열 형식과 일치하는 문자열은 Date.parse에서 인식할 수 없는 것으로 취급되며, 이 함수는 구현체 고유 동작이나 휴리스틱으로 대체하지 않고 NaN을 반환합니다.

참고

확장 연도를 사용하는 날짜-시간 값의 예:

-271821-04-20T00:00:00Z	기원전 271822년
-000001-01-01T00:00:00Z	기원전 2년
+000000-01-01T00:00:00Z	기원전 1년
+000001-01-01T00:00:00Z	서기 1년
+001970-01-01T00:00:00Z	서기 1970년
+002009-12-15T00:00:00Z	서기 2009년
+275760-09-13T00:00:00Z	서기 275760년

21.4.1.33 시간대 오프셋 문자열 형식

ECMAScript는 ISO 8601에서 파생된 UTC 오프셋용 문자열 교환 형식을 정의합니다. 형식은 다음 문법으로 설명됩니다.

구문

:::

[+Extended]

[~Extended]

:::

one of

Hour

:::

DecimalDigit

HourSubcomponents

[Extended]

:::

[?Extended]

[?Extended]

[?Extended]

TemporalDecimalFraction

opt

TimeSeparator

[Extended]

:::

[+Extended]

[~Extended]

[empty]

MinuteSecond

:::

DecimalDigit

TemporalDecimalFraction

:::

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

:::

one of

21.4.1.33.1 IsTimeZoneOffsetString ( `offsetString` )

추상 연산 IsTimeZoneOffsetString. 인수 offsetString (String). 반환값: Boolean. 반환 값은 offsetString이 UTCOffset이 제시하는 문법을 준수하는지 나타냅니다. 호출되면 다음 단계를 수행한다.

parseResult를 ParseText(offsetString, UTCOffset)로 둡니다.
parseResult가 오류의 List이면 false를 반환합니다.
true를 반환합니다.

21.4.1.33.2 ParseTimeZoneOffsetString ( `offsetString` )

추상 연산 ParseTimeZoneOffsetString. 인수 offsetString (String). 반환값: 정수. 반환 값은 String offsetString에 대응하는 UTC 오프셋을 나노초 수로 나타낸 것입니다. 호출되면 다음 단계를 수행한다.

parseResult를 ParseText(offsetString, UTCOffset)로 둡니다.
단언: parseResult는 오류의 List가 아닙니다.
단언: parseResult에는 ASCIISign Parse Node가 포함되어 있습니다.
parsedSign을 parseResult 안에 포함된 ASCIISign Parse Node와 일치하는 소스 텍스트로 둡니다.
parsedSign이 단일 코드 포인트 U+002D (HYPHEN-MINUS)이면, 다음을 수행합니다.
1. sign을 -1로 둡니다.
그렇지 않으면,
1. sign을 1로 둡니다.
참고: 아래의 StringToNumber 적용은 파싱된 각 값이 충분히 짧은 십진수 문자열임이 보장되므로 정밀도를 잃지 않습니다.
단언: parseResult에는 Hour Parse Node가 포함되어 있습니다.
parsedHours를 parseResult 안에 포함된 Hour Parse Node와 일치하는 소스 텍스트로 둡니다.
hours를 ℝ(StringToNumber(CodePointsToString(parsedHours)))로 둡니다.
parseResult에 MinuteSecond Parse Node가 포함되어 있지 않으면, 다음을 수행합니다.
1. minutes를 0으로 둡니다.
그렇지 않으면,
1. parsedMinutes를 parseResult 안에 포함된 첫 번째 MinuteSecond Parse Node와 일치하는 소스 텍스트로 둡니다.
2. minutes를 ℝ(StringToNumber(CodePointsToString(parsedMinutes)))로 둡니다.
parseResult에 두 개의 MinuteSecond Parse Node가 포함되어 있지 않으면, 다음을 수행합니다.
1. seconds를 0으로 둡니다.
그렇지 않으면,
1. parsedSeconds를 parseResult 안에 포함된 두 번째 MinuteSecond Parse Node와 일치하는 소스 텍스트로 둡니다.
2. seconds를 ℝ(StringToNumber(CodePointsToString(parsedSeconds)))로 둡니다.
parseResult에 TemporalDecimalFraction Parse Node가 포함되어 있지 않으면, 다음을 수행합니다.
1. nanoseconds를 0으로 둡니다.
그렇지 않으면,
1. parsedFraction을 parseResult 안에 포함된 TemporalDecimalFraction Parse Node와 일치하는 소스 텍스트로 둡니다.
2. fraction을 CodePointsToString(parsedFraction)과 "000000000"의 문자열 연결로 둡니다.
3. nanosecondsString을 fraction의 인덱스 1부터 10까지의 부분 문자열로 둡니다.
4. nanoseconds를 ℝ(StringToNumber(nanosecondsString))로 둡니다.
sign × (((hours × MinutesPerHour + minutes) × SecondsPerMinute + seconds) × NanosecondsPerSecond + nanoseconds)를 반환합니다.

21.4.2 Date 생성자

Date 생성자는:

%Date%입니다.
전역 객체의 "Date" 프로퍼티 초기 값입니다.
생성자로 호출되면 새로운 Date를 생성하고 초기화합니다.
생성자가 아니라 함수로 호출되면 현재 시간(UTC)을 나타내는 String을 반환합니다.
인수의 수와 타입에 따라 동작이 달라지는 함수입니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 Date 동작을 상속하려는 하위 클래스 생성자는 [[DateValue]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Date 생성자에 대한 super 호출을 포함해야 합니다.

21.4.2.1 Date ( ...`values` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면, 다음을 수행합니다.
1. now를 현재 시간을 식별하는 시간 값(UTC)으로 둡니다.
2. ToDateString(now)을 반환합니다.
numberOfArgs를 values의 요소 수로 둡니다.
numberOfArgs = 0이면, 다음을 수행합니다.
1. dv를 현재 시간을 식별하는 시간 값(UTC)으로 둡니다.
그렇지 않고 numberOfArgs = 1이면, 다음을 수행합니다.
1. value를 values[0]으로 둡니다.
2. value가 Object이고 value에 [[DateValue]] 내부 슬롯이 있으면, 다음을 수행합니다.
  1. tv를 value.[[DateValue]]로 둡니다.
3. 그렇지 않으면,
  1. primitive를 ? ToPrimitive(value)로 둡니다.
  2. primitive가 String이면, 다음을 수행합니다.
    1. 단언: primitive가 String이므로 다음 단계는 절대로 비정상 완료를 반환하지 않습니다.
    2. tv를 parse 메서드(21.4.3.2)와 정확히 동일한 방식으로 primitive를 날짜로 파싱한 결과로 둡니다.
  3. 그렇지 않으면,
    1. tv를 ? ToNumber(primitive)로 둡니다.
4. dv를 TimeClip(tv)로 둡니다.
그렇지 않으면,
1. 단언: numberOfArgs ≥ 2입니다.
2. yearNumber를 ? ToNumber(values[0])으로 둡니다.
3. monthNumber를 ? ToNumber(values[1])로 둡니다.
4. numberOfArgs > 2이면 dayNumber를 ? ToNumber(values[2])로 둡니다. 그렇지 않으면 dayNumber를 1_𝔽로 둡니다.
5. numberOfArgs > 3이면 hourNumber를 ? ToNumber(values[3])로 둡니다. 그렇지 않으면 hourNumber를 +0_𝔽으로 둡니다.
6. numberOfArgs > 4이면 minuteNumber를 ? ToNumber(values[4])로 둡니다. 그렇지 않으면 minuteNumber를 +0_𝔽으로 둡니다.
7. numberOfArgs > 5이면 secondNumber를 ? ToNumber(values[5])로 둡니다. 그렇지 않으면 secondNumber를 +0_𝔽으로 둡니다.
8. numberOfArgs > 6이면 millisecondNumber를 ? ToNumber(values[6])로 둡니다. 그렇지 않으면 millisecondNumber를 +0_𝔽으로 둡니다.
9. yearNumber를 MakeFullYear(yearNumber)로 설정합니다.
10. finalDate를 MakeDate(MakeDay(yearNumber, monthNumber, dayNumber), MakeTime(hourNumber, minuteNumber, secondNumber, millisecondNumber))로 둡니다.
11. dv를 TimeClip(UTC(finalDate))로 둡니다.
obj를 ? OrdinaryCreateFromConstructor(NewTarget, "%Date.prototype%", « [[DateValue]] »)로 둡니다.
obj.[[DateValue]]를 dv로 설정합니다.
obj를 반환합니다.

21.4.3 Date 생성자의 프로퍼티

Date 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 7_𝔽인 "length" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

21.4.3.1 Date.now ( )

이 함수는 호출이 발생한 UTC 날짜와 시간을 지정하는 시간 값을 반환합니다.

21.4.3.2 Date.parse ( `string` )

이 함수는 인수에 ToString 연산자를 적용합니다. ToString이 비정상 완료를 생성하면 해당 Completion Record를 즉시 반환합니다. 그렇지 않으면 이 함수는 결과 String을 날짜와 시간으로 해석하고, 해당 날짜와 시간에 대응하는 UTC 시간 값인 Number를 반환합니다. String의 내용에 따라 String은 로컬 시간, UTC 시간 또는 다른 시간대의 시간으로 해석될 수 있습니다. 함수는 먼저 확장 연도를 포함하여 날짜 시간 문자열 형식(21.4.1.32)에 설명된 형식에 따라 String을 파싱하려고 합니다. String이 해당 형식을 준수하지 않으면 함수는 구현체 고유 휴리스틱 또는 구현체 고유 날짜 형식으로 대체할 수 있습니다. 인식할 수 없거나 범위를 벗어난 형식 요소 값을 포함하는 String은 이 함수가 NaN을 반환하게 해야 합니다.

String이 날짜 시간 문자열 형식을 준수하면 존재하지 않는 형식 요소 대신 대체 값이 사용됩니다. MM 또는 DD 요소가 없으면 "01"을 사용합니다. HH, mm 또는 ss 요소가 없으면 "00"을 사용합니다. sss 요소가 없으면 "000"을 사용합니다. UTC 오프셋 표현이 없으면 날짜 전용 형식은 UTC 시간으로 해석하고 날짜-시간 형식은 로컬 시간으로 해석합니다.

x가 특정 ECMAScript 구현체에서 밀리초 값이 0인 임의의 Date이고 참조되는 모든 프로퍼티가 초기 값을 갖는다면 다음 표현식은 모두 해당 구현체에서 동일한 숫자 값을 생성해야 합니다:

x.valueOf()
Date.parse(x.toString())
Date.parse(x.toUTCString())
Date.parse(x.toISOString())

그러나 다음 표현식은

Date.parse(x.toLocaleString())

앞의 세 표현식과 동일한 Number 값을 생성해야 할 필요가 없으며, 일반적으로 날짜 시간 문자열 형식을 준수하지 않고 해당 구현체의 toString 또는 toUTCString 메서드가 생성할 수도 없는 임의의 String 값이 주어지면 이 함수가 생성하는 값은 구현체 정의입니다.

21.4.3.3 Date.prototype

Date.prototype의 초기 값은 Date 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

21.4.3.4 Date.UTC ( `year` [ , `month` [ , `day` [ , `hour` [ , `minute` [ , `second` [ , `millisecond` ] ] ] ] ] ] )

이 함수는 호출되면 다음 단계를 수행합니다:

yearNumber를 ? ToNumber(year)로 둡니다.
month가 존재하면 monthNumber를 ? ToNumber(month)로 둡니다. 그렇지 않으면 monthNumber를 +0_𝔽으로 둡니다.
day가 존재하면 dayNumber를 ? ToNumber(day)로 둡니다. 그렇지 않으면 dayNumber를 1_𝔽로 둡니다.
hour가 존재하면 hourNumber를 ? ToNumber(hour)로 둡니다. 그렇지 않으면 hourNumber를 +0_𝔽으로 둡니다.
minute이 존재하면 minuteNumber를 ? ToNumber(minute)로 둡니다. 그렇지 않으면 minuteNumber를 +0_𝔽으로 둡니다.
second가 존재하면 secondNumber를 ? ToNumber(second)로 둡니다. 그렇지 않으면 secondNumber를 +0_𝔽으로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다. 그렇지 않으면 millisecondNumber를 +0_𝔽으로 둡니다.
yearNumber를 MakeFullYear(yearNumber)로 설정합니다.
TimeClip(MakeDate(MakeDay(yearNumber, monthNumber, dayNumber), MakeTime(hourNumber, minuteNumber, secondNumber, millisecondNumber)))을 반환합니다.

이 함수의 "length" 프로퍼티는 7_𝔽입니다.

참고

이 함수는 두 가지 점에서 Date 생성자와 다릅니다. Date를 생성하는 대신 시간 값을 Number로 반환하며, 인수를 로컬 시간이 아니라 UTC로 해석합니다.

21.4.4 Date 프로토타입 객체의 프로퍼티

Date 프로토타입 객체는:

%Date.prototype%입니다.
그 자체가 일반 객체입니다.
Date 인스턴스가 아니며 [[DateValue]] 내부 슬롯을 갖지 않습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

명시적으로 달리 정의되지 않는 한 아래에 정의된 Date 프로토타입 객체의 메서드는 일반적이지 않으며, 메서드에 전달되는 this 값은 시간 값으로 초기화된 [[DateValue]] 내부 슬롯을 갖는 객체여야 합니다.

21.4.4.1 Date.prototype.constructor

Date.prototype.constructor의 초기 값은 %Date%입니다.

21.4.4.2 Date.prototype.getDate ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(DateFromTime(LocalTime(tv)))을 반환합니다.

21.4.4.3 Date.prototype.getDay ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(WeekDay(LocalTime(tv)))를 반환합니다.

21.4.4.4 Date.prototype.getFullYear ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(YearFromTime(LocalTime(tv)))를 반환합니다.

21.4.4.5 Date.prototype.getHours ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(HourFromTime(LocalTime(tv)))을 반환합니다.

21.4.4.6 Date.prototype.getMilliseconds ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(MillisecondFromTime(LocalTime(tv)))을 반환합니다.

21.4.4.7 Date.prototype.getMinutes ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(MinuteFromTime(LocalTime(tv)))를 반환합니다.

21.4.4.8 Date.prototype.getMonth ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(MonthFromTime(LocalTime(tv)))를 반환합니다.

21.4.4.9 Date.prototype.getSeconds ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(SecondFromTime(LocalTime(tv)))를 반환합니다.

21.4.4.10 Date.prototype.getTime ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
dateObj.[[DateValue]]를 반환합니다.

21.4.4.11 Date.prototype.getTimezoneOffset ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
(tv - LocalTime(tv)) / 𝔽(MillisecondsPerMinute)를 반환합니다.

21.4.4.12 Date.prototype.getUTCDate ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(DateFromTime(tv))를 반환합니다.

21.4.4.13 Date.prototype.getUTCDay ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(WeekDay(tv))를 반환합니다.

21.4.4.14 Date.prototype.getUTCFullYear ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(YearFromTime(tv))를 반환합니다.

21.4.4.15 Date.prototype.getUTCHours ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(HourFromTime(tv))를 반환합니다.

21.4.4.16 Date.prototype.getUTCMilliseconds ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(MillisecondFromTime(tv))를 반환합니다.

21.4.4.17 Date.prototype.getUTCMinutes ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(MinuteFromTime(tv))를 반환합니다.

21.4.4.18 Date.prototype.getUTCMonth ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(MonthFromTime(tv))를 반환합니다.

21.4.4.19 Date.prototype.getUTCSeconds ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(SecondFromTime(tv))를 반환합니다.

21.4.4.20 Date.prototype.setDate ( `day` )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
dayNumber를 ? ToNumber(day)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
tv를 LocalTime(tv)로 설정합니다.
newDate를 MakeDate(MakeDay(𝔽(YearFromTime(tv)), 𝔽(MonthFromTime(tv)), dayNumber), 𝔽(TimeWithinDay(tv)))로 둡니다.
u를 TimeClip(UTC(newDate))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

21.4.4.21 Date.prototype.setFullYear ( `year` [ , `month` [ , `day` ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
yearNumber를 ? ToNumber(year)로 둡니다.
tv가 NaN이면 tv를 +0_𝔽으로 설정합니다. 그렇지 않으면 tv를 LocalTime(tv)로 설정합니다.
month가 존재하면 monthNumber를 ? ToNumber(month)로 둡니다. 그렇지 않으면 monthNumber를 𝔽(MonthFromTime(tv))로 둡니다.
day가 존재하면 dayNumber를 ? ToNumber(day)로 둡니다. 그렇지 않으면 dayNumber를 𝔽(DateFromTime(tv))로 둡니다.
newDate를 MakeDate(MakeDay(yearNumber, monthNumber, dayNumber), 𝔽(TimeWithinDay(tv)))로 둡니다.
u를 TimeClip(UTC(newDate))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

이 메서드의 "length" 프로퍼티는 3_𝔽입니다.

참고

month가 존재하지 않으면 이 메서드는 month가 getMonth() 값으로 존재했던 것처럼 동작합니다. day가 존재하지 않으면 day가 getDate() 값으로 존재했던 것처럼 동작합니다.

21.4.4.22 Date.prototype.setHours ( `hour` [ , `minute` [ , `second` [ , `millisecond` ] ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
hourNumber를 ? ToNumber(hour)로 둡니다.
minute이 존재하면 minuteNumber를 ? ToNumber(minute)로 둡니다.
second가 존재하면 secondNumber를 ? ToNumber(second)로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
tv를 LocalTime(tv)로 설정합니다.
minute이 존재하지 않으면 minuteNumber를 𝔽(MinuteFromTime(tv))로 둡니다.
second가 존재하지 않으면 secondNumber를 𝔽(SecondFromTime(tv))로 둡니다.
millisecond가 존재하지 않으면 millisecondNumber를 𝔽(MillisecondFromTime(tv))로 둡니다.
date를 MakeDate(𝔽(Day(tv)), MakeTime(hourNumber, minuteNumber, secondNumber, millisecondNumber))로 둡니다.
u를 TimeClip(UTC(date))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

이 메서드의 "length" 프로퍼티는 4_𝔽입니다.

참고

minute이 존재하지 않으면 이 메서드는 minute이 getMinutes() 값으로 존재했던 것처럼 동작합니다. second가 존재하지 않으면 second가 getSeconds() 값으로 존재했던 것처럼 동작합니다. millisecond가 존재하지 않으면 millisecond가 getMilliseconds() 값으로 존재했던 것처럼 동작합니다.

21.4.4.23 Date.prototype.setMilliseconds ( `millisecond` )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
tv를 LocalTime(tv)로 설정합니다.
time을 MakeTime(𝔽(HourFromTime(tv)), 𝔽(MinuteFromTime(tv)), 𝔽(SecondFromTime(tv)), millisecondNumber)로 둡니다.
u를 TimeClip(UTC(MakeDate(𝔽(Day(tv)), time)))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

21.4.4.24 Date.prototype.setMinutes ( `minute` [ , `second` [ , `millisecond` ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
minuteNumber를 ? ToNumber(minute)로 둡니다.
second가 존재하면 secondNumber를 ? ToNumber(second)로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
tv를 LocalTime(tv)로 설정합니다.
second가 존재하지 않으면 secondNumber를 𝔽(SecondFromTime(tv))로 둡니다.
millisecond가 존재하지 않으면 millisecondNumber를 𝔽(MillisecondFromTime(tv))로 둡니다.
date를 MakeDate(𝔽(Day(tv)), MakeTime(𝔽(HourFromTime(tv)), minuteNumber, secondNumber, millisecondNumber))로 둡니다.
u를 TimeClip(UTC(date))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

이 메서드의 "length" 프로퍼티는 3_𝔽입니다.

참고

second가 존재하지 않으면 이 메서드는 second가 getSeconds() 값으로 존재했던 것처럼 동작합니다. millisecond가 존재하지 않으면 millisecond가 getMilliseconds() 값으로 존재했던 것처럼 동작합니다.

21.4.4.25 Date.prototype.setMonth ( `month` [ , `day` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
monthNumber를 ? ToNumber(month)로 둡니다.
day가 존재하면 dayNumber를 ? ToNumber(day)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
tv를 LocalTime(tv)로 설정합니다.
day가 존재하지 않으면 dayNumber를 𝔽(DateFromTime(tv))로 둡니다.
newDate를 MakeDate(MakeDay(𝔽(YearFromTime(tv)), monthNumber, dayNumber), 𝔽(TimeWithinDay(tv)))로 둡니다.
u를 TimeClip(UTC(newDate))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

이 메서드의 "length" 프로퍼티는 2_𝔽입니다.

참고

day가 존재하지 않으면 이 메서드는 day가 getDate() 값으로 존재했던 것처럼 동작합니다.

21.4.4.26 Date.prototype.setSeconds ( `second` [ , `millisecond` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
secondNumber를 ? ToNumber(second)로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
tv를 LocalTime(tv)로 설정합니다.
millisecond가 존재하지 않으면 millisecondNumber를 𝔽(MillisecondFromTime(tv))로 둡니다.
date를 MakeDate(𝔽(Day(tv)), MakeTime(𝔽(HourFromTime(tv)), 𝔽(MinuteFromTime(tv)), secondNumber, millisecondNumber))로 둡니다.
u를 TimeClip(UTC(date))로 둡니다.
dateObj.[[DateValue]]를 u로 설정합니다.
u를 반환합니다.

이 메서드의 "length" 프로퍼티는 2_𝔽입니다.

참고

millisecond가 존재하지 않으면 이 메서드는 millisecond가 getMilliseconds() 값으로 존재했던 것처럼 동작합니다.

21.4.4.27 Date.prototype.setTime ( `time` )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
t를 ? ToNumber(time)로 둡니다.
v를 TimeClip(t)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

21.4.4.28 Date.prototype.setUTCDate ( `day` )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
dayNumber를 ? ToNumber(day)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
newDate를 MakeDate(MakeDay(𝔽(YearFromTime(tv)), 𝔽(MonthFromTime(tv)), dayNumber), 𝔽(TimeWithinDay(tv)))로 둡니다.
v를 TimeClip(newDate)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

21.4.4.29 Date.prototype.setUTCFullYear ( `year` [ , `month` [ , `day` ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 tv를 +0_𝔽으로 설정합니다.
yearNumber를 ? ToNumber(year)로 둡니다.
month가 존재하면 monthNumber를 ? ToNumber(month)로 둡니다. 그렇지 않으면 monthNumber를 𝔽(MonthFromTime(tv))로 둡니다.
day가 존재하면 dayNumber를 ? ToNumber(day)로 둡니다. 그렇지 않으면 dayNumber를 𝔽(DateFromTime(tv))로 둡니다.
newDate를 MakeDate(MakeDay(yearNumber, monthNumber, dayNumber), 𝔽(TimeWithinDay(tv)))로 둡니다.
v를 TimeClip(newDate)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

이 메서드의 "length" 프로퍼티는 3_𝔽입니다.

참고

month가 존재하지 않으면 이 메서드는 month가 getUTCMonth() 값으로 존재했던 것처럼 동작합니다. day가 존재하지 않으면 day가 getUTCDate() 값으로 존재했던 것처럼 동작합니다.

21.4.4.30 Date.prototype.setUTCHours ( `hour` [ , `minute` [ , `second` [ , `millisecond` ] ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
hourNumber를 ? ToNumber(hour)로 둡니다.
minute이 존재하면 minuteNumber를 ? ToNumber(minute)로 둡니다.
second가 존재하면 secondNumber를 ? ToNumber(second)로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
minute이 존재하지 않으면 minuteNumber를 𝔽(MinuteFromTime(tv))로 둡니다.
second가 존재하지 않으면 secondNumber를 𝔽(SecondFromTime(tv))로 둡니다.
millisecond가 존재하지 않으면 millisecondNumber를 𝔽(MillisecondFromTime(tv))로 둡니다.
date를 MakeDate(𝔽(Day(tv)), MakeTime(hourNumber, minuteNumber, secondNumber, millisecondNumber))로 둡니다.
v를 TimeClip(date)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

이 메서드의 "length" 프로퍼티는 4_𝔽입니다.

참고

minute이 존재하지 않으면 이 메서드는 minute이 getUTCMinutes() 값으로 존재했던 것처럼 동작합니다. second가 존재하지 않으면 second가 getUTCSeconds() 값으로 존재했던 것처럼 동작합니다. millisecond가 존재하지 않으면 millisecond가 getUTCMilliseconds() 값으로 존재했던 것처럼 동작합니다.

21.4.4.31 Date.prototype.setUTCMilliseconds ( `millisecond` )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
time을 MakeTime(𝔽(HourFromTime(tv)), 𝔽(MinuteFromTime(tv)), 𝔽(SecondFromTime(tv)), millisecondNumber)로 둡니다.
v를 TimeClip(MakeDate(𝔽(Day(tv)), time))로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

21.4.4.32 Date.prototype.setUTCMinutes ( `minute` [ , `second` [ , `millisecond` ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
minuteNumber를 ? ToNumber(minute)로 둡니다.
second가 존재하면 secondNumber를 ? ToNumber(second)로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
second가 존재하지 않으면 secondNumber를 𝔽(SecondFromTime(tv))로 둡니다.
millisecond가 존재하지 않으면 millisecondNumber를 𝔽(MillisecondFromTime(tv))로 둡니다.
date를 MakeDate(𝔽(Day(tv)), MakeTime(𝔽(HourFromTime(tv)), minuteNumber, secondNumber, millisecondNumber))로 둡니다.
v를 TimeClip(date)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

이 메서드의 "length" 프로퍼티는 3_𝔽입니다.

참고

second가 존재하지 않으면 이 메서드는 second가 getUTCSeconds() 값으로 존재했던 것처럼 동작합니다. millisecond가 존재하지 않으면 이 메서드는 millisecond가 getUTCMilliseconds()가 반환하는 값으로 존재했던 것처럼 동작합니다.

21.4.4.33 Date.prototype.setUTCMonth ( `month` [ , `day` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
monthNumber를 ? ToNumber(month)로 둡니다.
day가 존재하면 dayNumber를 ? ToNumber(day)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
day가 존재하지 않으면 dayNumber를 𝔽(DateFromTime(tv))로 둡니다.
newDate를 MakeDate(MakeDay(𝔽(YearFromTime(tv)), monthNumber, dayNumber), 𝔽(TimeWithinDay(tv)))로 둡니다.
v를 TimeClip(newDate)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

이 메서드의 "length" 프로퍼티는 2_𝔽입니다.

참고

day가 존재하지 않으면 이 메서드는 day가 getUTCDate() 값으로 존재했던 것처럼 동작합니다.

21.4.4.34 Date.prototype.setUTCSeconds ( `second` [ , `millisecond` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
secondNumber를 ? ToNumber(second)로 둡니다.
millisecond가 존재하면 millisecondNumber를 ? ToNumber(millisecond)로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
millisecond가 존재하지 않으면 millisecondNumber를 𝔽(MillisecondFromTime(tv))로 둡니다.
date를 MakeDate(𝔽(Day(tv)), MakeTime(𝔽(HourFromTime(tv)), 𝔽(MinuteFromTime(tv)), secondNumber, millisecondNumber))로 둡니다.
v를 TimeClip(date)로 둡니다.
dateObj.[[DateValue]]를 v로 설정합니다.
v를 반환합니다.

이 메서드의 "length" 프로퍼티는 2_𝔽입니다.

참고

millisecond가 존재하지 않으면 이 메서드는 millisecond가 getUTCMilliseconds() 값으로 존재했던 것처럼 동작합니다.

21.4.4.35 Date.prototype.toDateString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 "Invalid Date"를 반환합니다.
t를 LocalTime(tv)로 둡니다.
DateString(t)을 반환합니다.

21.4.4.36 Date.prototype.toISOString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 RangeError 예외를 던집니다.
단언: tv는 정수 Number입니다.
tv가 날짜 시간 문자열 형식으로 나타낼 수 없는 연도에 대응하면 RangeError 예외를 던집니다.
모든 형식 요소와 UTC 오프셋 표현 "Z"를 포함하여 UTC 시간 척도에서 날짜 시간 문자열 형식으로 tv를 나타내는 String을 반환합니다.

21.4.4.37 Date.prototype.toJSON ( `key` )

이 메서드는 JSON.stringify(25.5.4)에서 사용하기 위한 Date의 String 표현을 제공합니다.

호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
tv를 ? ToPrimitive(obj, number)로 둡니다.
tv가 Number이고 tv가 유한 Number가 아니면 null을 반환합니다.
? Invoke(obj, "toISOString")를 반환합니다.

참고 1

인수는 무시됩니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Date일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다. 다만 그러한 객체에는 toISOString 메서드가 있어야 합니다.

21.4.4.38 Date.prototype.toLocaleDateString ( [ `reserved1` [ , `reserved2` ] ] )

ECMA-402 국제화 API를 포함하는 ECMAScript 구현체는 ECMA-402에 명시된 대로 이 메서드를 구현해야 합니다. 그렇지 않으면 다음과 같은 이 메서드 명세가 사용됩니다:

이 메서드는 String 값을 반환합니다. String의 내용은 구현체 정의이지만 호스트 환경의 현재 로케일 관례에 대응하는 편리하고 사람이 읽을 수 있는 형식으로 현재 시간대에서 Date의 “날짜” 부분을 나타내도록 의도됩니다.

이 메서드의 선택적 매개변수의 의미는 ECMA-402에 정의되어 있습니다. ECMA-402 지원을 포함하지 않는 구현체는 해당 매개변수 위치를 다른 용도로 사용해서는 안 됩니다.

21.4.4.39 Date.prototype.toLocaleString ( [ `reserved1` [ , `reserved2` ] ] )

이 메서드는 String 값을 반환합니다. String의 내용은 구현체 정의이지만 호스트 환경의 현재 로케일 관례에 대응하는 편리하고 사람이 읽을 수 있는 형식으로 현재 시간대의 Date를 나타내도록 의도됩니다.

21.4.4.40 Date.prototype.toLocaleTimeString ( [ `reserved1` [ , `reserved2` ] ] )

이 메서드는 String 값을 반환합니다. String의 내용은 구현체 정의이지만 호스트 환경의 현재 로케일 관례에 대응하는 편리하고 사람이 읽을 수 있는 형식으로 현재 시간대에서 Date의 “시간” 부분을 나타내도록 의도됩니다.

21.4.4.41 Date.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
ToDateString(tv)을 반환합니다.

참고 1

d.[[DateValue]]가 1000으로 나누어떨어지는 임의의 Date d에 대해 Date.parse(d.toString()) = d.valueOf()입니다. 21.4.3.2를 참조하시기 바랍니다.

참고 2

이 메서드는 일반적이지 않습니다. this 값이 Date가 아니면 TypeError 예외를 던집니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 없습니다.

21.4.4.41.1 TimeString ( `tv` )

추상 연산 TimeString. 인수 tv (a Number, but not NaN). 반환값: String. 호출되면 다음 단계를 수행한다.

hour를 ToZeroPaddedDecimalString(HourFromTime(tv), 2)로 둡니다.
minute을 ToZeroPaddedDecimalString(MinuteFromTime(tv), 2)로 둡니다.
second를 ToZeroPaddedDecimalString(SecondFromTime(tv), 2)로 둡니다.
hour, ":", minute, ":", second, 코드 단위 0x0020 (SPACE) 및 "GMT"의 문자열 연결을 반환합니다.

21.4.4.41.2 DateString ( `tv` )

추상 연산 DateString. 인수 tv (a Number, but not NaN). 반환값: String. 호출되면 다음 단계를 수행한다.

weekday를 WeekDay Index = WeekDay(tv)인 표 61 항목의 Name으로 둡니다.
month를 Month Index = MonthFromTime(tv)인 표 62 항목의 Name으로 둡니다.
day를 ToZeroPaddedDecimalString(DateFromTime(tv), 2)로 둡니다.
yv를 YearFromTime(tv)로 둡니다.
yv ≥ 0이면 yearSign을 빈 String으로 둡니다. 그렇지 않으면 yearSign을 "-"로 둡니다.
paddedYear를 ToZeroPaddedDecimalString(abs(yv), 4)로 둡니다.
weekday, 코드 단위 0x0020 (SPACE), month, 코드 단위 0x0020 (SPACE), day, 코드 단위 0x0020 (SPACE), yearSign 및 paddedYear의 문자열 연결을 반환합니다.

표 61: 요일 이름

WeekDay 인덱스	이름
0	"Sun"
1	"Mon"
2	"Tue"
3	"Wed"
4	"Thu"
5	"Fri"
6	"Sat"

표 62: 연중 월 이름

Month 인덱스	이름
0	"Jan"
1	"Feb"
2	"Mar"
3	"Apr"
4	"May"
5	"Jun"
6	"Jul"
7	"Aug"
8	"Sep"
9	"Oct"
10	"Nov"
11	"Dec"

21.4.4.41.3 TimeZoneString ( `tv` )

추상 연산 TimeZoneString. 인수 tv (정수인 Number). 반환값: String. 호출되면 다음 단계를 수행한다.

systemTimeZoneIdentifier를 SystemTimeZoneIdentifier()로 둡니다.
IsTimeZoneOffsetString(systemTimeZoneIdentifier)이 true이면, 다음을 수행합니다.
1. offsetNanoseconds를 ParseTimeZoneOffsetString(systemTimeZoneIdentifier)으로 둡니다.
그렇지 않으면,
1. offsetNanoseconds를 GetNamedTimeZoneOffsetNanoseconds(systemTimeZoneIdentifier, ℝ(tv) × NanosecondsPerMillisecond)로 둡니다.
offsetMilliseconds를 truncate(offsetNanoseconds / NanosecondsPerMillisecond)로 둡니다.
offsetMilliseconds ≥ 0이면, 다음을 수행합니다.
1. offsetSign을 "+"로 둡니다.
2. absOffsetMilliseconds를 offsetMilliseconds로 둡니다.
그렇지 않으면,
1. offsetSign을 "-"로 둡니다.
2. absOffsetMilliseconds를 -offsetMilliseconds로 둡니다.
offsetMinute을 ToZeroPaddedDecimalString(MinuteFromTime(𝔽(absOffsetMilliseconds)), 2)로 둡니다.
offsetHour를 ToZeroPaddedDecimalString(HourFromTime(𝔽(absOffsetMilliseconds)), 2)로 둡니다.
timeZoneName을 빈 String 또는 코드 단위 0x0020 (SPACE), 코드 단위 0x0028 (LEFT PARENTHESIS), 구현체 정의 시간대 이름 및 코드 단위 0x0029 (RIGHT PARENTHESIS)의 문자열 연결 중 하나인 구현체 정의 문자열로 둡니다.
offsetSign, offsetHour, offsetMinute 및 timeZoneName의 문자열 연결을 반환합니다.

21.4.4.41.4 ToDateString ( `tv` )

추상 연산 ToDateString. 인수 tv ((정수인 Number 또는 NaN)). 반환값: String. 호출되면 다음 단계를 수행한다.

tv가 NaN이면 "Invalid Date"를 반환합니다.
localTime을 LocalTime(tv)로 둡니다.
DateString(localTime), 코드 단위 0x0020 (SPACE), TimeString(localTime) 및 TimeZoneString(tv)의 문자열 연결을 반환합니다.

21.4.4.42 Date.prototype.toTimeString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 "Invalid Date"를 반환합니다.
localTime을 LocalTime(tv)로 둡니다.
TimeString(localTime)과 TimeZoneString(tv)의 문자열 연결을 반환합니다.

21.4.4.43 Date.prototype.toUTCString ( )

이 메서드는 this 값에 대응하는 시간의 순간을 나타내는 String 값을 반환합니다. String 형식은 RFC 7231의 HTTP-date를 기반으로 하며 ECMAScript Date가 지원하는 전체 시간 범위를 지원하도록 일반화되어 있습니다.

호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 "Invalid Date"를 반환합니다.
weekday를 WeekDay Index = WeekDay(tv)인 표 61 항목의 Name으로 둡니다.
month를 Month Index = MonthFromTime(tv)인 표 62 항목의 Name으로 둡니다.
day를 ToZeroPaddedDecimalString(DateFromTime(tv), 2)로 둡니다.
yv를 YearFromTime(tv)로 둡니다.
yv ≥ 0이면 yearSign을 빈 String으로 둡니다. 그렇지 않으면 yearSign을 "-"로 둡니다.
paddedYear를 ToZeroPaddedDecimalString(abs(yv), 4)로 둡니다.
weekday, ",", 코드 단위 0x0020 (SPACE), day, 코드 단위 0x0020 (SPACE), month, 코드 단위 0x0020 (SPACE), yearSign, paddedYear, 코드 단위 0x0020 (SPACE) 및 TimeString(tv)의 문자열 연결을 반환합니다.

21.4.4.44 Date.prototype.valueOf ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
dateObj.[[DateValue]]를 반환합니다.

21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( `hint` )

이 메서드는 ECMAScript 언어 연산자가 Date를 원시 값으로 변환하기 위해 호출합니다. hint에 허용되는 값은 "default", "number" 및 "string"입니다. Date는 "default"를 "string"과 동등하게 취급한다는 점에서 내장 ECMAScript 객체 중 유일합니다. 다른 모든 내장 ECMAScript 객체는 "default"를 "number"와 동등하게 취급합니다.

호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
hint가 "string" 또는 "default" 중 하나이면, 다음을 수행합니다.
1. tryFirst를 string으로 둡니다.
그렇지 않고 hint가 "number"이면, 다음을 수행합니다.
1. tryFirst를 number로 둡니다.
그렇지 않으면,
1. TypeError 예외를 던집니다.
? OrdinaryToPrimitive(obj, tryFirst)를 반환합니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.toPrimitive]"입니다.

21.4.5 Date 인스턴스의 프로퍼티

Date 인스턴스는 Date 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. Date 인스턴스에는 [[DateValue]] 내부 슬롯도 있습니다. [[DateValue]] 내부 슬롯은 이 Date가 나타내는 시간 값입니다.

22 텍스트 처리

22.1 String 객체

22.1.1 String 생성자

String 생성자는:

%String%입니다.
전역 객체의 "String" 프로퍼티 초기 값입니다.
생성자로 호출되면 새로운 String 객체를 생성하고 초기화합니다.
생성자가 아니라 함수로 호출되면 타입 변환을 수행합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 String 동작을 상속하려는 하위 클래스 생성자는 [[StringData]] 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 String 생성자에 대한 super 호출을 포함해야 합니다.

22.1.1.1 String ( `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

value가 존재하지 않으면, 다음을 수행합니다.
1. string을 빈 String으로 둡니다.
그렇지 않으면,
1. NewTarget이 undefined이고 value가 Symbol이면 SymbolDescriptiveString(value)을 반환합니다.
2. string을 ? ToString(value)으로 둡니다.
NewTarget이 undefined이면 string을 반환합니다.
StringCreate(string, ? GetPrototypeFromConstructor(NewTarget, "%String.prototype%"))를 반환합니다.

22.1.2 String 생성자의 프로퍼티

String 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

22.1.2.1 String.fromCharCode ( ...`codeUnits` )

이 함수는 나머지 매개변수 codeUnits를 구성하는 임의의 수의 인수로 호출할 수 있습니다.

호출되면 다음 단계를 수행합니다:

result를 빈 String으로 둡니다.
codeUnits의 각 요소 next에 대해 다음을 수행합니다.
1. nextCU를 숫자 값이 ℝ(? ToUint16(next))인 코드 단위로 둡니다.
2. result를 result와 nextCU의 문자열 연결로 설정합니다.
result를 반환합니다.

이 함수의 "length" 프로퍼티는 1_𝔽입니다.

22.1.2.2 String.fromCodePoint ( ...`codePoints` )

이 함수는 나머지 매개변수 codePoints를 구성하는 임의의 수의 인수로 호출할 수 있습니다.

호출되면 다음 단계를 수행합니다:

result를 빈 String으로 둡니다.
codePoints의 각 요소 next에 대해 다음을 수행합니다.
1. nextCP를 ? ToNumber(next)로 둡니다.
2. nextCP가 정수 Number가 아니면 RangeError 예외를 던집니다.
3. ℝ(nextCP) < 0 또는 ℝ(nextCP) > 0x10FFFF이면 RangeError 예외를 던집니다.
4. result를 result와 UTF16EncodeCodePoint(ℝ(nextCP))의 문자열 연결로 설정합니다.
단언: codePoints가 비어 있으면 result는 빈 String입니다.
result를 반환합니다.

이 함수의 "length" 프로퍼티는 1_𝔽입니다.

22.1.2.3 String.prototype

String.prototype의 초기 값은 String 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

22.1.2.4 String.raw ( `template`, ...`substitutions` )

이 함수는 가변 개수의 인수로 호출할 수 있습니다. 첫 번째 인수는 template이며 나머지 인수는 List substitutions를 구성합니다.

호출되면 다음 단계를 수행합니다:

substitutionCount를 substitutions의 요소 수로 둡니다.
cooked를 ? ToObject(template)로 둡니다.
literals를 ? ToObject(? Get(cooked, "raw"))로 둡니다.
literalCount를 ? LengthOfArrayLike(literals)로 둡니다.
literalCount ≤ 0이면 빈 String을 반환합니다.
result를 빈 String으로 둡니다.
nextIndex를 0으로 둡니다.
다음을 반복합니다.
1. nextLiteralValue를 ? Get(literals, ! ToString(𝔽(nextIndex)))로 둡니다.
2. nextLiteral을 ? ToString(nextLiteralValue)으로 둡니다.
3. result를 result와 nextLiteral의 문자열 연결로 설정합니다.
4. nextIndex + 1 = literalCount이면 result를 반환합니다.
5. nextIndex < substitutionCount이면, 다음을 수행합니다.
  1. nextSubValue를 substitutions[nextIndex]로 둡니다.
  2. nextSub를 ? ToString(nextSubValue)로 둡니다.
  3. result를 result와 nextSub의 문자열 연결로 설정합니다.
6. nextIndex를 nextIndex + 1로 설정합니다.

참고

이 함수는 Tagged Template(13.3.11)의 태그 함수로 사용하도록 의도되었습니다. 이러한 방식으로 호출되면 첫 번째 인수는 올바른 형식의 템플릿 객체이며 나머지 매개변수에는 치환 값이 포함됩니다.

22.1.3 String 프로토타입 객체의 프로퍼티

String 프로토타입 객체는:

%String.prototype%입니다.
String 특수 객체이며 이러한 객체에 지정된 내부 메서드를 갖습니다.
값이 빈 String인 [[StringData]] 내부 슬롯을 갖습니다.
초기 값이 +0_𝔽이고 속성이 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }인 "length" 프로퍼티를 갖습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

명시적으로 달리 언급하지 않는 한 아래에 정의된 String 프로토타입 객체의 메서드는 일반적이지 않으며, 전달되는 this 값은 String 값 또는 String 값으로 초기화된 [[StringData]] 내부 슬롯을 갖는 객체여야 합니다.

22.1.3.1 String.prototype.at ( `index` )

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
length를 string의 길이로 둡니다.
k를 ? ToAbsoluteIndex(index, length)로 둡니다.
k < 0 또는 k ≥ length이면 undefined를 반환합니다.
string의 k부터 k + 1까지의 부분 문자열을 반환합니다.

22.1.3.2 String.prototype.charAt ( `position` )

참고 1

이 메서드는 이 객체를 String으로 변환하여 얻은 String 값의 인덱스 position에 있는 코드 단위를 포함하는 단일 요소 String을 반환합니다. 해당 인덱스에 요소가 없으면 결과는 빈 String입니다. 결과는 String 객체가 아니라 String 값입니다.

pos가 정수 Number이면 x.charAt(pos)의 결과는 x.substring(pos, pos + 1)의 결과와 동등합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
position을 ? ToIntegerOrInfinity(position)으로 설정합니다.
size를 string의 길이로 둡니다.
position < 0 또는 position ≥ size이면 빈 String을 반환합니다.
string의 position부터 position + 1까지의 부분 문자열을 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.3 String.prototype.charCodeAt ( `position` )

참고 1

이 메서드는 이 객체를 String으로 변환하여 얻은 String의 인덱스 position에 있는 코드 단위의 숫자 값인 Number(2¹⁶보다 작은 음이 아닌 정수 Number)를 반환합니다. 해당 인덱스에 요소가 없으면 결과는 NaN입니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
position을 ? ToIntegerOrInfinity(position)으로 설정합니다.
size를 string의 길이로 둡니다.
position < 0 또는 position ≥ size이면 NaN을 반환합니다.
String string 안의 인덱스 position에 있는 코드 단위의 숫자 값에 해당하는 Number 값을 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.4 String.prototype.codePointAt ( `position` )

참고 1

이 메서드는 이 객체를 String으로 변환하여 얻은 String의 인덱스 position에 있는 문자열 요소에서 시작하는 UTF-16 인코딩 코드 포인트(6.1.4)의 숫자 값인 0x10FFFF_𝔽 이하의 음이 아닌 정수 Number를 반환합니다. 해당 인덱스에 요소가 없으면 결과는 undefined입니다. 유효한 UTF-16 서로게이트 쌍이 position에서 시작하지 않으면 결과는 position의 코드 단위입니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
position을 ? ToIntegerOrInfinity(position)으로 설정합니다.
size를 string의 길이로 둡니다.
position < 0 또는 position ≥ size이면 undefined를 반환합니다.
codePoint를 CodePointAt(string, position)로 둡니다.
𝔽(codePoint.[[CodePoint]])를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.5 String.prototype.concat ( ...`args` )

참고 1

이 메서드가 호출되면 this 값의 코드 단위(this 값을 String으로 변환한 것) 뒤에 각 인수를 String으로 변환한 코드 단위가 이어지는 String 값을 반환합니다. 결과는 String 객체가 아니라 String 값입니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
result를 string으로 둡니다.
args의 각 요소 next에 대해 다음을 수행합니다.
1. nextString을 ? ToString(next)으로 둡니다.
2. result를 result와 nextString의 문자열 연결로 설정합니다.
result를 반환합니다.

이 메서드의 "length" 프로퍼티는 1_𝔽입니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.6 String.prototype.constructor

String.prototype.constructor의 초기 값은 %String%입니다.

22.1.3.7 String.prototype.endsWith ( `searchString` [ , `endPosition` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
isRegexp를 ? IsRegExp(searchString)로 둡니다.
isRegexp가 true이면 TypeError 예외를 던집니다.
searchString을 ? ToString(searchString)으로 설정합니다.
length를 string의 길이로 둡니다.
endPosition이 undefined이면 end를 length로 둡니다. 그렇지 않으면 end를 ? ToIntegerOrInfinity(endPosition)을 0과 length 사이로 제한한 결과로 둡니다.
searchLength를 searchString의 길이로 둡니다.
searchLength = 0이면 true를 반환합니다.
start를 end - searchLength로 둡니다.
start < 0이면 false를 반환합니다.
substring을 string의 start부터 end까지의 부분 문자열로 둡니다.
substring이 searchString이면 true를 반환합니다.
false를 반환합니다.

참고 1

첫 번째 인수가 RegExp이면 예외를 던지도록 명시한 것은 향후 판에서 이러한 인수 값을 허용하는 확장을 정의할 수 있도록 하기 위함입니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.8 String.prototype.includes ( `searchString` [ , `position` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
isRegexp를 ? IsRegExp(searchString)로 둡니다.
isRegexp가 true이면 TypeError 예외를 던집니다.
searchString을 ? ToString(searchString)으로 설정합니다.
length를 string의 길이로 둡니다.
start를 ? ToIntegerOrInfinity(position)을 0과 length 사이로 제한한 결과로 둡니다.
단언: position이 undefined이면 start는 0입니다.
index를 StringIndexOf(string, searchString, start)로 둡니다.
index가 not-found이면 false를 반환합니다.
true를 반환합니다.

참고 1

searchString이 이 객체를 String으로 변환한 결과의 부분 문자열로서 position 이상인 하나 이상의 인덱스에 나타나면 이 함수는 true를 반환하고, 그렇지 않으면 false를 반환합니다. position이 undefined이면 전체 String을 검색하도록 0으로 간주합니다.

참고 2

첫 번째 인수가 RegExp이면 예외를 던지도록 명시한 것은 향후 판에서 이러한 인수 값을 허용하는 확장을 정의할 수 있도록 하기 위함입니다.

참고 3

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.9 String.prototype.indexOf ( `searchString` [ , `position` ] )

참고 1

searchString이 이 객체를 String으로 변환한 결과의 부분 문자열로서 position 이상인 하나 이상의 인덱스에 나타나면 그러한 인덱스 중 가장 작은 값을 반환하고, 그렇지 않으면 -1_𝔽을 반환합니다. position이 undefined이면 전체 String을 검색하도록 +0_𝔽으로 간주합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
searchString을 ? ToString(searchString)으로 설정합니다.
length를 string의 길이로 둡니다.
start를 ? ToIntegerOrInfinity(position)을 0과 length 사이로 제한한 결과로 둡니다.
단언: position이 undefined이면 start는 0입니다.
result를 StringIndexOf(string, searchString, start)로 둡니다.
result가 not-found이면 -1_𝔽을 반환합니다.
𝔽(result)를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.10 String.prototype.isWellFormed ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
IsStringWellFormedUnicode(string)를 반환합니다.

22.1.3.11 String.prototype.lastIndexOf ( `searchString` [ , `position` ] )

참고 1

searchString이 이 객체를 String으로 변환한 결과의 부분 문자열로서 position 이하인 하나 이상의 인덱스에 나타나면 그러한 인덱스 중 가장 큰 값을 반환하고, 그렇지 않으면 -1_𝔽을 반환합니다. position이 undefined이면 전체 String을 검색하도록 String 값의 길이로 간주합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
searchString을 ? ToString(searchString)으로 설정합니다.
numberPosition을 ? ToNumber(position)으로 둡니다.
length를 string의 길이로 둡니다.
searchLength를 searchString의 길이로 둡니다.
maxStart를 length - searchLength로 둡니다.
maxStart < 0이면 -1_𝔽을 반환합니다.
numberPosition이 NaN이면 start를 maxStart로 둡니다. 그렇지 않으면 start를 ! ToIntegerOrInfinity(numberPosition)을 0과 maxStart 사이로 제한한 결과로 둡니다.
단언: position이 undefined이면 start는 maxStart입니다.
result를 StringLastIndexOf(string, searchString, start)로 둡니다.
result가 not-found이면 -1_𝔽을 반환합니다.
𝔽(result)를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.12 String.prototype.localeCompare ( `that` [ , `reserved1` [ , `reserved2` ] ] )

이 메서드는 this 값(String string으로 변환됨)과 that(String thatValue로 변환됨)을 구현체 정의 로케일 민감 String 비교한 결과를 나타내는 NaN이 아닌 Number를 반환합니다. 결과는 호스트 환경의 현재 로케일 관례에 따른 String 값의 정렬 순서에 대응하도록 의도되며, string이 thatValue보다 앞에 정렬되면 음수, string이 thatValue보다 뒤에 정렬되면 양수, 그 밖의 모든 경우에는 0(string과 thatValue 사이에 상대적 순서가 없음을 나타냄)이 됩니다.

비교를 수행하기 전에 이 메서드는 String을 준비하기 위해 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
thatValue를 ? ToString(that)으로 둡니다.

이 메서드의 선택적 두 번째 및 세 번째 매개변수의 의미는 ECMA-402에 정의되어 있습니다. ECMA-402 지원을 포함하지 않는 구현체는 해당 매개변수 위치에 다른 해석을 부여해서는 안 됩니다.

추가 정보를 인코딩할 수 있도록 실제 반환 값은 구현체 정의이지만, 이 메서드를 두 인수의 메서드로 간주할 때 모든 String 집합에 대한 전순서를 정의하는 일관된 비교기여야 합니다. 또한 이 메서드는 유니코드 표준에 따른 정규 동등성을 인식하고 준수해야 하며, 구별 가능한 String이 정규적으로 동등한 경우 비교 시 +0_𝔽을 반환하는 것도 포함됩니다.

참고 1

이 메서드 자체는 Array.prototype.sort의 인수로 직접 사용하기에는 적합하지 않습니다. 후자는 두 인수를 받는 함수를 필요로 하기 때문입니다.

참고 2

이 메서드는 호스트 환경이 ECMAScript 환경에 제공하는 언어 및/또는 로케일 민감 비교 기능을 사용할 수 있으며, 호스트 환경의 현재 로케일 관례에 따라 비교하도록 의도됩니다. 그러나 비교 기능과 관계없이 이 메서드는 유니코드 표준에 따른 정규 동등성을 인식하고 준수해야 합니다. 예를 들어 다음 비교는 모두 +0_𝔽을 반환해야 합니다:

// Å ANGSTROM SIGN과
// Å LATIN CAPITAL LETTER A + COMBINING RING ABOVE 비교
"\u212B".localeCompare("A\u030A")

// Ω OHM SIGN과
// Ω GREEK CAPITAL LETTER OMEGA 비교
"\u2126".localeCompare("\u03A9")

// ṩ LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE와
// ṩ LATIN SMALL LETTER S + COMBINING DOT ABOVE + COMBINING DOT BELOW 비교
"\u1E69".localeCompare("s\u0307\u0323")

// ḍ̇ LATIN SMALL LETTER D WITH DOT ABOVE + COMBINING DOT BELOW와
// ḍ̇ LATIN SMALL LETTER D WITH DOT BELOW + COMBINING DOT ABOVE 비교
"\u1E0B\u0323".localeCompare("\u1E0D\u0307")

// 가 HANGUL CHOSEONG KIYEOK + HANGUL JUNGSEONG A와
// 가 HANGUL SYLLABLE GA 비교
"\u1100\u1161".localeCompare("\uAC00")

정규 동등성의 정의와 논의는 유니코드 표준 제2장 및 제3장과 Unicode Standard Annex #15, Unicode Normalization Forms 및 Unicode Technical Note #5, Canonical Equivalence in Applications를 참조하시기 바랍니다. 또한 Unicode Technical Standard #10, Unicode Collation Algorithm도 참조하시기 바랍니다.

이 메서드는 유니코드 표준 제3장 3.7절에 정의된 유니코드 호환 동등 또는 호환 분해를 준수하지 않는 것이 권장됩니다.

참고 3

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.13 String.prototype.match ( `regexpOrPattern` )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
regexpOrPattern이 Object이면, 다음을 수행합니다.
1. matcher를 ? GetMethod(regexpOrPattern, %Symbol.match%)로 둡니다.
2. matcher가 undefined가 아니면, 다음을 수행합니다.
  1. ? Call(matcher, regexpOrPattern, « thisValue »)를 반환합니다.
string을 ? ToString(thisValue)으로 둡니다.
regexp를 ? RegExpCreate(regexpOrPattern, undefined)로 둡니다.
? Invoke(regexp, %Symbol.match%, « string »)를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.14 String.prototype.matchAll ( `regexpOrPattern` )

이 메서드는 this 값을 나타내는 String과 regexpOrPattern 사이에서 정규 표현식 일치를 수행하고 일치 결과를 생성하는 반복자를 반환합니다. 각 일치 결과는 String에서 일치한 부분을 첫 번째 요소로 포함하고, 그 뒤에 캡처링 그룹이 일치한 부분이 이어지는 Array입니다. 정규 표현식이 한 번도 일치하지 않으면 반환된 반복자는 어떤 일치 결과도 생성하지 않습니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
regexpOrPattern이 Object이면, 다음을 수행합니다.
1. isRegexp를 ? IsRegExp(regexpOrPattern)로 둡니다.
2. isRegexp가 true이면, 다음을 수행합니다.
  1. flags를 ? Get(regexpOrPattern, "flags")로 둡니다.
  2. ? RequireObjectCoercible(flags)를 수행합니다.
  3. ? ToString(flags)에 "g"가 포함되어 있지 않으면 TypeError 예외를 던집니다.
3. matcher를 ? GetMethod(regexpOrPattern, %Symbol.matchAll%)로 둡니다.
4. matcher가 undefined가 아니면, 다음을 수행합니다.
  1. ? Call(matcher, regexpOrPattern, « thisValue »)를 반환합니다.
string을 ? ToString(thisValue)으로 둡니다.
regexp를 ? RegExpCreate(regexpOrPattern, "g")로 둡니다.
? Invoke(regexp, %Symbol.matchAll%, « string »)를 반환합니다.

참고 1

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

참고 2

String.prototype.split과 마찬가지로 String.prototype.matchAll은 일반적으로 입력을 변경하지 않고 동작하도록 설계되었습니다.

22.1.3.15 String.prototype.normalize ( [ `form` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
form이 undefined이면 form을 "NFC"로 설정합니다.
그렇지 않으면 form을 ? ToString(form)으로 설정합니다.
form이 "NFC", "NFD", "NFKC" 또는 "NFKD" 중 하나가 아니면 RangeError 예외를 던집니다.
normal을 최신 유니코드 표준의 정규화 형식에 명시된 대로 form이 이름을 지정하는 정규화 형식으로 string을 정규화한 결과인 String 값으로 둡니다.
normal을 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.16 String.prototype.padEnd ( `maxLength` [ , `fillString` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
? StringPaddingBuiltinsImpl(thisValue, maxLength, fillString, end)를 반환합니다.

22.1.3.17 String.prototype.padStart ( `maxLength` [ , `fillString` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
? StringPaddingBuiltinsImpl(thisValue, maxLength, fillString, start)를 반환합니다.

22.1.3.17.1 StringPaddingBuiltinsImpl ( `thisValue`, `maxLength`, `fillString`, `placement` )

추상 연산 StringPaddingBuiltinsImpl. 인수 thisValue (ECMAScript 언어 값), maxLength (ECMAScript 언어 값), fillString (ECMAScript 언어 값) 및 placement ((start 또는 end)). 반환값: (정상 완료 (값: String) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

string을 ? ToString(thisValue)으로 둡니다.
intMaxLength를 ℝ(? ToLength(maxLength))로 둡니다.
stringLength를 string의 길이로 둡니다.
intMaxLength ≤ stringLength이면 string을 반환합니다.
fillString이 undefined이면 fillString을 코드 단위 0x0020 (SPACE)만으로 구성된 String 값으로 설정합니다.
그렇지 않으면 fillString을 ? ToString(fillString)으로 설정합니다.
StringPad(string, intMaxLength, fillString, placement)를 반환합니다.

22.1.3.17.2 StringPad ( `string`, `maxLength`, `fillString`, `placement` )

추상 연산 StringPad. 인수 string (String), maxLength (음이 아닌 정수), fillString (String) 및 placement ((start 또는 end)). 반환값: String. 호출되면 다음 단계를 수행한다.

stringLength를 string의 길이로 둡니다.
maxLength ≤ stringLength이면 string을 반환합니다.
fillString이 빈 String이면 string을 반환합니다.
fillLength를 maxLength - stringLength로 둡니다.
truncatedStringFiller를 fillString의 반복된 연결을 길이 fillLength로 잘라 구성한 String 값으로 둡니다.
placement가 start이면 truncatedStringFiller와 string의 문자열 연결을 반환합니다.
string과 truncatedStringFiller의 문자열 연결을 반환합니다.

참고 1

인수 maxLength는 string의 길이보다 작아질 수 없도록 제한됩니다.

참고 2

인수 fillString의 기본값은 " " (코드 단위 0x0020 SPACE로 구성된 String 값)입니다.

22.1.3.17.3 ToZeroPaddedDecimalString ( `n`, `minLength` )

추상 연산 ToZeroPaddedDecimalString. 인수 n (음이 아닌 정수) 및 minLength (음이 아닌 정수). 반환값: String. 호출되면 다음 단계를 수행한다.

string을 십진수로 형식화한 n의 String 표현으로 둡니다.
StringPad(string, minLength, "0", start)를 반환합니다.

22.1.3.18 String.prototype.repeat ( `count` )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
n을 ? ToIntegerOrInfinity(count)로 둡니다.
n < 0 또는 n = +∞이면 RangeError 예외를 던집니다.
n = 0이면 빈 String을 반환합니다.
string의 복사본 n개를 서로 이어 붙여 만든 String 값을 반환합니다.

참고 1

이 메서드는 this 값(String으로 변환됨)의 코드 단위를 count번 반복한 String 값을 생성합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.19 String.prototype.replace ( `searchValue`, `replaceValue` )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
searchValue가 Object이면, 다음을 수행합니다.
1. replacer를 ? GetMethod(searchValue, %Symbol.replace%)로 둡니다.
2. replacer가 undefined가 아니면, 다음을 수행합니다.
  1. ? Call(replacer, searchValue, « thisValue, replaceValue »)를 반환합니다.
string을 ? ToString(thisValue)으로 둡니다.
searchString을 ? ToString(searchValue)으로 둡니다.
functionalReplace를 IsCallable(replaceValue)로 둡니다.
functionalReplace가 false이면, 다음을 수행합니다.
1. replaceValue를 ? ToString(replaceValue)으로 설정합니다.
searchLength를 searchString의 길이로 둡니다.
position을 StringIndexOf(string, searchString, 0)으로 둡니다.
position이 not-found이면 string을 반환합니다.
preceding을 string의 0부터 position까지의 부분 문자열로 둡니다.
following을 string의 position + searchLength부터의 부분 문자열로 둡니다.
functionalReplace가 true이면, 다음을 수행합니다.
1. replacement를 ? ToString(? Call(replaceValue, undefined, « searchString, 𝔽(position), string »))으로 둡니다.
그렇지 않으면,
1. 단언: replaceValue는 String입니다.
2. captures를 새로운 빈 List로 둡니다.
3. replacement를 ! GetSubstitution(searchString, string, position, captures, undefined, replaceValue)로 둡니다.
preceding, replacement 및 following의 문자열 연결을 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.19.1 GetSubstitution ( `matched`, `string`, `position`, `captures`, `namedCaptures`, `replacementTemplate` )

추상 연산 GetSubstitution. 인수 matched (String), string (String), position (음이 아닌 정수), captures (리스트 (요소: (String 또는 undefined))), namedCaptures ((Object 또는 undefined)) 및 replacementTemplate (String). 반환값: (정상 완료 (값: String) 또는 throw 완료). 이 추상 연산의 목적상 십진 숫자는 0x0030 (DIGIT ZERO)부터 0x0039 (DIGIT NINE)까지의 폐구간에 속하는 코드 단위입니다. 호출되면 다음 단계를 수행한다.

stringLength를 string의 길이로 둡니다.
단언: position ≤ stringLength입니다.
result를 빈 String으로 둡니다.
templateRemainder를 replacementTemplate로 둡니다.
templateRemainder가 빈 String이 아닌 동안 다음을 반복합니다.
1. 참고: 다음 단계는 ref(templateRemainder의 접두사)를 분리하고, refReplacement(그 치환 값)를 결정한 다음 해당 치환 값을 result에 추가합니다.
2. templateRemainder가 "$$"로 시작하면, 다음을 수행합니다.
  1. ref를 "$$"로 둡니다.
  2. refReplacement를 "$"로 둡니다.
3. 그렇지 않고 templateRemainder가 "$`"로 시작하면, 다음을 수행합니다.
  1. ref를 "$`"로 둡니다.
  2. refReplacement를 string의 0부터 position까지의 부분 문자열로 둡니다.
4. 그렇지 않고 templateRemainder가 "$&"로 시작하면, 다음을 수행합니다.
  1. ref를 "$&"로 둡니다.
  2. refReplacement를 matched로 둡니다.
5. 그렇지 않고 templateRemainder가 "$'" (0x0024 (DOLLAR SIGN) 뒤에 0x0027 (APOSTROPHE)이 이어짐)로 시작하면, 다음을 수행합니다.
  1. ref를 "$'"로 둡니다.
  2. matchLength를 matched의 길이로 둡니다.
  3. tailPosition을 position + matchLength로 둡니다.
  4. refReplacement를 string의 min(tailPosition, stringLength)부터의 부분 문자열로 둡니다.
  5. 참고: tailPosition이 stringLength를 초과할 수 있는 경우는 이 추상 연산이 "exec" 프로퍼티가 내재 %RegExp.prototype.exec%가 아닌 객체에 대해 %RegExp.prototype%의 내재 %Symbol.replace% 메서드를 호출하여 실행된 경우뿐입니다.
6. 그렇지 않고 templateRemainder가 "$" 뒤에 하나 이상의 십진 숫자가 이어지는 형태로 시작하면, 다음을 수행합니다.
  1. templateRemainder가 "$" 뒤에 둘 이상의 십진 숫자가 이어지는 형태로 시작하면 digitCount를 2로 둡니다. 그렇지 않으면 digitCount를 1로 둡니다.
  2. digits를 templateRemainder의 1부터 1 + digitCount까지의 부분 문자열로 둡니다.
  3. index를 ℝ(StringToNumber(digits))로 둡니다.
  4. 단언: 0 ≤ index ≤ 99입니다.
  5. captureLength를 captures의 요소 수로 둡니다.
  6. index > captureLength이고 digitCount = 2이면, 다음을 수행합니다.
    1. 참고: 두 자리 치환 패턴이 캡처링 그룹 수를 초과하는 인덱스를 지정하면 한 자리 치환 패턴 뒤에 리터럴 숫자가 이어진 것으로 처리합니다.
    2. digitCount를 1로 설정합니다.
    3. digits를 digits의 0부터 1까지의 부분 문자열로 설정합니다.
    4. index를 ℝ(StringToNumber(digits))로 설정합니다.
  7. ref를 templateRemainder의 0부터 1 + digitCount까지의 부분 문자열로 둡니다.
  8. 1 ≤ index ≤ captureLength이면, 다음을 수행합니다.
    1. capture를 captures[index - 1]로 둡니다.
    2. capture가 undefined이면, 다음을 수행합니다.
      1. refReplacement를 빈 String으로 둡니다.
    3. 그렇지 않으면,
      1. refReplacement를 capture로 둡니다.
  9. 그렇지 않으면,
    1. refReplacement를 ref로 둡니다.
7. 그렇지 않고 templateRemainder가 "$<"로 시작하면, 다음을 수행합니다.
  1. gtPosition을 StringIndexOf(templateRemainder, ">", 0)으로 둡니다.
  2. gtPosition이 not-found이거나 namedCaptures가 undefined이면, 다음을 수행합니다.
    1. ref를 "$<"로 둡니다.
    2. refReplacement를 ref로 둡니다.
  3. 그렇지 않으면,
    1. ref를 templateRemainder의 0부터 gtPosition + 1까지의 부분 문자열로 둡니다.
    2. groupName을 templateRemainder의 2부터 gtPosition까지의 부분 문자열로 둡니다.
    3. 단언: namedCaptures는 Object입니다.
    4. capture를 ? Get(namedCaptures, groupName)로 둡니다.
    5. capture가 undefined이면, 다음을 수행합니다.
      1. refReplacement를 빈 String으로 둡니다.
    6. 그렇지 않으면,
      1. refReplacement를 ? ToString(capture)으로 둡니다.
8. 그렇지 않으면,
  1. ref를 templateRemainder의 0부터 1까지의 부분 문자열로 둡니다.
  2. refReplacement를 ref로 둡니다.
9. refLength를 ref의 길이로 둡니다.
10. templateRemainder를 templateRemainder의 refLength부터의 부분 문자열로 설정합니다.
11. result를 result와 refReplacement의 문자열 연결로 설정합니다.
result를 반환합니다.

22.1.3.20 String.prototype.replaceAll ( `searchValue`, `replaceValue` )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
searchValue가 Object이면, 다음을 수행합니다.
1. isRegexp를 ? IsRegExp(searchValue)로 둡니다.
2. isRegexp가 true이면, 다음을 수행합니다.
  1. flags를 ? Get(searchValue, "flags")로 둡니다.
  2. ? RequireObjectCoercible(flags)를 수행합니다.
  3. ? ToString(flags)에 "g"가 포함되어 있지 않으면 TypeError 예외를 던집니다.
3. replacer를 ? GetMethod(searchValue, %Symbol.replace%)로 둡니다.
4. replacer가 undefined가 아니면, 다음을 수행합니다.
  1. ? Call(replacer, searchValue, « thisValue, replaceValue »)를 반환합니다.
string을 ? ToString(thisValue)으로 둡니다.
searchString을 ? ToString(searchValue)으로 둡니다.
functionalReplace를 IsCallable(replaceValue)로 둡니다.
functionalReplace가 false이면, 다음을 수행합니다.
1. replaceValue를 ? ToString(replaceValue)으로 설정합니다.
searchLength를 searchString의 길이로 둡니다.
advanceBy를 max(1, searchLength)로 둡니다.
matchPositions를 새로운 빈 List로 둡니다.
position을 StringIndexOf(string, searchString, 0)으로 둡니다.
position이 not-found가 아닌 동안 다음을 반복합니다.
1. position을 matchPositions에 추가합니다.
2. position을 StringIndexOf(string, searchString, position + advanceBy)로 설정합니다.
endOfLastMatch를 0으로 둡니다.
result를 빈 String으로 둡니다.
matchPositions의 각 요소 matchPosition에 대해 다음을 수행합니다.
1. preserved를 string의 endOfLastMatch부터 matchPosition까지의 부분 문자열로 둡니다.
2. functionalReplace가 true이면, 다음을 수행합니다.
  1. replacement를 ? ToString(? Call(replaceValue, undefined, « searchString, 𝔽(matchPosition), string »))으로 둡니다.
3. 그렇지 않으면,
  1. 단언: replaceValue는 String입니다.
  2. captures를 새로운 빈 List로 둡니다.
  3. replacement를 ! GetSubstitution(searchString, string, matchPosition, captures, undefined, replaceValue)로 둡니다.
4. result를 result, preserved 및 replacement의 문자열 연결로 설정합니다.
5. endOfLastMatch를 matchPosition + searchLength로 설정합니다.
endOfLastMatch < string의 길이이면, 다음을 수행합니다.
1. result를 result와 string의 endOfLastMatch부터의 부분 문자열의 문자열 연결로 설정합니다.
result를 반환합니다.

22.1.3.21 String.prototype.search ( `regexpOrPattern` )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
regexpOrPattern이 Object이면, 다음을 수행합니다.
1. searcher를 ? GetMethod(regexpOrPattern, %Symbol.search%)로 둡니다.
2. searcher가 undefined가 아니면, 다음을 수행합니다.
  1. ? Call(searcher, regexpOrPattern, « thisValue »)를 반환합니다.
string을 ? ToString(thisValue)으로 둡니다.
regexp를 ? RegExpCreate(regexpOrPattern, undefined)로 둡니다.
? Invoke(regexp, %Symbol.search%, « string »)를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.22 String.prototype.slice ( `start`, `end` )

이 메서드는 이 객체를 String으로 변환한 결과의 인덱스 start에서 시작하여 인덱스 end 직전까지 이어지는 부분 문자열(end가 undefined이면 String의 끝까지)을 반환합니다. start가 음수이면 String의 길이인 sourceLength에 대해 sourceLength + start로 처리합니다. end가 음수이면 sourceLength + end로 처리합니다. 결과는 String 객체가 아니라 String 값입니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
length를 string의 길이로 둡니다.
from을 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 to를 length로 둡니다. 그렇지 않으면 to를 ? ToClampedIndex(end, length)로 둡니다.
from ≥ to이면 빈 String을 반환합니다.
string의 from부터 to까지의 부분 문자열을 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.23 String.prototype.split ( `separator`, `limit` )

이 메서드는 이 객체를 String으로 변환한 결과의 부분 문자열을 저장한 Array를 반환합니다. 부분 문자열은 왼쪽에서 오른쪽으로 separator의 출현을 검색하여 결정합니다. 이러한 출현은 반환되는 배열 안의 어떤 String에도 포함되지 않고 String 값을 나누는 역할을 합니다. separator 값은 임의 길이의 String일 수도 있고 %Symbol.split% 메서드를 갖는 RegExp와 같은 객체일 수도 있습니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
separator가 Object이면, 다음을 수행합니다.
1. splitter를 ? GetMethod(separator, %Symbol.split%)로 둡니다.
2. splitter가 undefined가 아니면, 다음을 수행합니다.
  1. ? Call(splitter, separator, « thisValue, limit »)를 반환합니다.
string을 ? ToString(thisValue)으로 둡니다.
limit가 undefined이면 lim을 2³² - 1로 둡니다. 그렇지 않으면 lim을 ℝ(? ToUint32(limit))로 둡니다.
separatorString을 ? ToString(separator)로 둡니다.
lim = 0이면, 다음을 수행합니다.
1. CreateArrayFromList(« »)를 반환합니다.
separator가 undefined이면, 다음을 수행합니다.
1. CreateArrayFromList(« string »)를 반환합니다.
separatorLength를 separatorString의 길이로 둡니다.
separatorLength = 0이면, 다음을 수행합니다.
1. stringLength를 string의 길이로 둡니다.
2. outLength를 lim을 0과 stringLength 사이로 제한한 결과로 둡니다.
3. head를 string의 0부터 outLength까지의 부분 문자열로 둡니다.
4. codeUnits를 head의 요소인 코드 단위 시퀀스로 구성된 List로 둡니다.
5. CreateArrayFromList(codeUnits)를 반환합니다.
string이 빈 String이면 CreateArrayFromList(« string »)를 반환합니다.
substrings를 새로운 빈 List로 둡니다.
searchStart를 0으로 둡니다.
matchIndex를 StringIndexOf(string, separatorString, 0)으로 둡니다.
matchIndex가 not-found가 아닌 동안 다음을 반복합니다.
1. substring을 string의 searchStart부터 matchIndex까지의 부분 문자열로 둡니다.
2. substring을 substrings에 추가합니다.
3. substrings의 요소 수가 lim이면 CreateArrayFromList(substrings)를 반환합니다.
4. searchStart를 matchIndex + separatorLength로 설정합니다.
5. matchIndex를 StringIndexOf(string, separatorString, searchStart)로 설정합니다.
substring을 string의 searchStart부터의 부분 문자열로 둡니다.
substring을 substrings에 추가합니다.
CreateArrayFromList(substrings)를 반환합니다.

참고 1

separator 값은 빈 String일 수 있습니다. 이 경우 separator는 입력 String의 시작이나 끝에 있는 빈 부분 문자열과 일치하지 않으며, 이전 구분자 일치의 끝에 있는 빈 부분 문자열과도 일치하지 않습니다. separator가 빈 String이면 String은 개별 코드 단위 요소로 분할됩니다. 결과 배열의 길이는 String의 길이와 같고 각 부분 문자열에는 하나의 코드 단위가 포함됩니다.

this 값이 빈 String이거나 빈 String으로 변환되는 경우 결과는 separator가 빈 String과 일치할 수 있는지에 따라 달라집니다. 일치할 수 있으면 결과 배열에는 요소가 없습니다. 그렇지 않으면 결과 배열에는 빈 String인 하나의 요소가 있습니다.

separator가 undefined이면 결과 배열에는 this 값(String으로 변환됨)인 하나의 String만 포함됩니다. limit가 undefined가 아니면 출력 배열은 limit개보다 많은 요소를 포함하지 않도록 잘립니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.24 String.prototype.startsWith ( `searchString` [ , `position` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
isRegexp를 ? IsRegExp(searchString)로 둡니다.
isRegexp가 true이면 TypeError 예외를 던집니다.
searchString을 ? ToString(searchString)으로 설정합니다.
length를 string의 길이로 둡니다.
start를 ? ToIntegerOrInfinity(position)을 0과 length 사이로 제한한 결과로 둡니다.
단언: position이 undefined이면 start는 0입니다.
searchLength를 searchString의 길이로 둡니다.
searchLength = 0이면 true를 반환합니다.
end를 start + searchLength로 둡니다.
end > length이면 false를 반환합니다.
substring을 string의 start부터 end까지의 부분 문자열로 둡니다.
substring이 searchString이면 true를 반환합니다.
false를 반환합니다.

참고 1

첫 번째 인수가 RegExp이면 예외를 던지도록 명시한 것은 향후 판에서 이러한 인수 값을 허용하는 확장을 정의할 수 있도록 하기 위함입니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.25 String.prototype.substring ( `start`, `end` )

이 메서드는 이 객체를 String으로 변환한 결과의 인덱스 start에서 시작하여 String의 인덱스 end 직전까지 이어지는 부분 문자열(end가 undefined이면 String의 끝까지)을 반환합니다. 결과는 String 객체가 아니라 String 값입니다.

어느 인수든 NaN이거나 음수이면 0으로 대체되고, 어느 인수든 String의 길이보다 엄격하게 크면 String의 길이로 대체됩니다.

start가 end보다 엄격하게 크면 서로 교환됩니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
length를 string의 길이로 둡니다.
finalStart를 ? ToIntegerOrInfinity(start)을 0과 length 사이로 제한한 결과로 둡니다.
단언: start가 undefined이면 finalStart는 0입니다.
end가 undefined이면 finalEnd를 length로 둡니다. 그렇지 않으면 finalEnd를 ? ToIntegerOrInfinity(end)을 0과 length 사이로 제한한 결과로 둡니다.
from을 min(finalStart, finalEnd)으로 둡니다.
to를 max(finalStart, finalEnd)로 둡니다.
string의 from부터 to까지의 부분 문자열을 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.26 String.prototype.toLocaleLowerCase ( [ `reserved1` [ , `reserved2` ] ] )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

호스트 환경의 현재 로케일 관례에 대응하는 로케일 민감 결과를 생성하도록 의도된다는 점을 제외하면 toLowerCase와 정확히 동일하게 동작합니다. 해당 언어의 규칙이 일반적인 유니코드 대소문자 매핑과 충돌하는 소수의 경우(예: 터키어)에만 차이가 있습니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.27 String.prototype.toLocaleUpperCase ( [ `reserved1` [ , `reserved2` ] ] )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

호스트 환경의 현재 로케일 관례에 대응하는 로케일 민감 결과를 생성하도록 의도된다는 점을 제외하면 toUpperCase와 정확히 동일하게 동작합니다. 해당 언어의 규칙이 일반적인 유니코드 대소문자 매핑과 충돌하는 소수의 경우(예: 터키어)에만 차이가 있습니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.28 String.prototype.toLowerCase ( )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
sText를 StringToCodePoints(string)로 둡니다.
lowerText를 Unicode Default Case Conversion 알고리즘에 따라 toLowercase(sText)로 둡니다.
lowercaseString을 CodePointsToString(lowerText)로 둡니다.
lowercaseString을 반환합니다.

결과는 Unicode Character Database의 로케일 비민감 대소문자 매핑에 따라 파생되어야 합니다(이는 UnicodeData.txt 파일뿐만 아니라 함께 제공되는 SpecialCasing.txt 파일의 모든 로케일 비민감 매핑도 명시적으로 포함합니다).

참고 1

일부 코드 포인트의 대소문자 매핑은 여러 코드 포인트를 생성할 수 있습니다. 이 경우 결과 String의 길이는 소스 String과 같지 않을 수 있습니다. toUpperCase와 toLowerCase 모두 문맥 민감 동작을 하므로 두 메서드는 대칭적이지 않습니다. 즉, s.toUpperCase().toLowerCase()는 반드시 s.toLowerCase()와 같지는 않습니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.29 String.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

? ThisStringValue(this 값)를 반환합니다.

참고

String 객체의 경우 이 메서드는 우연히 valueOf 메서드와 동일한 것을 반환합니다.

22.1.3.30 String.prototype.toUpperCase ( )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

String이 Unicode Default Case Conversion의 toUppercase 알고리즘을 사용하여 매핑된다는 점을 제외하면 String.prototype.toLowerCase와 정확히 동일하게 동작합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.31 String.prototype.toWellFormed ( )

이 메서드는 서로게이트 쌍의 일부가 아닌 모든 선행 서로게이트와 후행 서로게이트를 U+FFFD (REPLACEMENT CHARACTER)로 대체한 이 객체의 String 표현을 반환합니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? RequireObjectCoercible(thisValue)를 수행합니다.
string을 ? ToString(thisValue)으로 둡니다.
stringLength를 string의 길이로 둡니다.
k를 0으로 둡니다.
result를 빈 String으로 둡니다.
k < stringLength인 동안 다음을 반복합니다.
1. codePoint를 CodePointAt(string, k)로 둡니다.
2. codePoint.[[IsUnpairedSurrogate]]가 true이면, 다음을 수행합니다.
  1. result를 result와 0xFFFD (REPLACEMENT CHARACTER)의 문자열 연결로 설정합니다.
3. 그렇지 않으면,
  1. result를 result와 UTF16EncodeCodePoint(codePoint.[[CodePoint]])의 문자열 연결로 설정합니다.
4. k를 k + codePoint.[[CodeUnitCount]]로 설정합니다.
result를 반환합니다.

22.1.3.32 String.prototype.trim ( )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

호출되면 다음 단계를 수행합니다:

thisValue를 this 값으로 둡니다.
? TrimString(thisValue, start+end)를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.32.1 TrimString ( `arg`, `where` )

추상 연산 TrimString. 인수 arg (ECMAScript 언어 값) 및 where ((start, end 또는 start+end)). 반환값: (정상 완료 (값: String) 또는 throw 완료). 6.1.4에 설명된 대로 arg를 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다. 호출되면 다음 단계를 수행한다.

? RequireObjectCoercible(arg)를 수행합니다.
string을 ? ToString(arg)으로 둡니다.
where가 start이면, 다음을 수행합니다.
1. trimmedString을 string의 앞쪽 공백을 제거한 복사본인 String 값으로 둡니다.
그렇지 않고 where가 end이면, 다음을 수행합니다.
1. trimmedString을 string의 뒤쪽 공백을 제거한 복사본인 String 값으로 둡니다.
그렇지 않으면,
1. 단언: where는 start+end입니다.
2. trimmedString을 string의 앞쪽과 뒤쪽 공백을 모두 제거한 복사본인 String 값으로 둡니다.
trimmedString을 반환합니다.

공백의 정의는 WhiteSpace와 LineTerminator의 합집합입니다. 유니코드 코드 포인트가 유니코드 일반 범주 “Space_Separator” (“Zs”)에 속하는지 결정할 때 코드 단위 시퀀스는 6.1.4에 명시된 대로 UTF-16 인코딩 코드 포인트 시퀀스로 해석됩니다.

22.1.3.33 String.prototype.trimEnd ( )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? TrimString(string, end)를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.34 String.prototype.trimStart ( )

이 메서드는 6.1.4에 설명된 대로 String 값을 UTF-16 인코딩 코드 포인트의 시퀀스로 해석합니다.

호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? TrimString(string, start)를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

22.1.3.35 String.prototype.valueOf ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

? ThisStringValue(this 값)를 반환합니다.

22.1.3.35.1 ThisStringValue ( `arg` )

추상 연산 ThisStringValue. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: String) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

arg가 String이면 arg를 반환합니다.
arg가 Object이고 arg에 [[StringData]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. string을 arg.[[StringData]]로 둡니다.
2. 단언: string은 String입니다.
3. string을 반환합니다.
TypeError 예외를 던집니다.

22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )

이 메서드는 String 값의 코드 포인트를 순회하면서 각 코드 포인트를 String 값으로 반환하는 반복자 객체를 반환합니다.

호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? RequireObjectCoercible(string)를 수행합니다.
string을 ? ToString(string)으로 설정합니다.
closure를 매개변수가 없고 string을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. length를 string의 길이로 둡니다.
2. position을 0으로 둡니다.
3. position < length인 동안 다음을 반복합니다.
  1. codePoint를 CodePointAt(string, position)로 둡니다.
  2. nextIndex를 position + codePoint.[[CodeUnitCount]]로 둡니다.
  3. resultString을 string의 position부터 nextIndex까지의 부분 문자열로 둡니다.
  4. position을 nextIndex로 설정합니다.
  5. ? GeneratorYield(CreateIteratorResultObject(resultString, false))를 수행합니다.
4. NormalCompletion(unused)을 반환합니다.
CreateIteratorFromClosure(closure, "%StringIteratorPrototype%", %StringIteratorPrototype%)를 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.iterator]"입니다.

22.1.4 String 인스턴스의 프로퍼티

String 인스턴스는 String 특수 객체이며 이러한 객체에 지정된 내부 메서드를 갖습니다. String 인스턴스는 String 프로토타입 객체에서 프로퍼티를 상속합니다. String 인스턴스에는 [[StringData]] 내부 슬롯도 있습니다. [[StringData]] 내부 슬롯은 이 String 객체가 나타내는 String 값입니다.

String 인스턴스는 "length" 프로퍼티와 정수 인덱스 이름을 갖는 열거 가능한 프로퍼티 집합을 갖습니다.

22.1.4.1 length

이 String 객체가 나타내는 String 값의 요소 수입니다.

String 객체가 초기화되면 이 프로퍼티는 변경되지 않습니다. 이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

22.1.5 String Iterator 객체

String Iterator는 특정 String 인스턴스 객체에 대한 특정 순회를 나타내는 객체입니다. String Iterator 객체에는 이름 있는 생성자가 없습니다. 대신 String Iterator 객체는 String 인스턴스 객체의 특정 메서드를 호출하여 생성됩니다.

22.1.5.1 %StringIteratorPrototype% 객체

%StringIteratorPrototype% 객체는:

모든 String Iterator 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

22.1.5.1.1 %StringIteratorPrototype%.next ( )

? GeneratorResume(this 값, empty, "%StringIteratorPrototype%")를 반환합니다.

22.1.5.1.2 %StringIteratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "String Iterator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

22.2 RegExp(정규 표현식) 객체

RegExp 객체는 정규 표현식과 관련 플래그를 포함합니다.

참고

정규 표현식의 형식과 기능은 Perl 5 프로그래밍 언어의 정규 표현식 기능을 모델로 합니다.

22.2.1 패턴

RegExp 생성자는 입력 패턴 String에 다음 문법을 적용합니다. 문법이 String을 Pattern의 전개로 해석할 수 없으면 오류가 발생합니다.

구문

Pattern

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Disjunction

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

Alternative

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Alternative

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Alternative

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

[empty]

Alternative

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Term

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Term

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

Assertion

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Atom

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Atom

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Quantifier

Assertion

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

(?=

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?!

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?<=

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?<!

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

Quantifier

QuantifierPrefix

{

DecimalDigits

[~Sep]

}

{

DecimalDigits

[~Sep]

{

DecimalDigits

[~Sep]

DecimalDigits

[~Sep]

}

Atom

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

PatternCharacter

AtomEscape

[?UnicodeMode, ?NamedCaptureGroups]

CharacterClass

[?UnicodeMode, ?UnicodeSetsMode]

(

GroupSpecifier

[?UnicodeMode]

opt

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

[empty]

RegularExpressionModifiers

RegularExpressionModifier

one of

SyntaxCharacter

one of

(

)

[

]

{

}

PatternCharacter

SourceCharacter

but not SyntaxCharacter

AtomEscape

[UnicodeMode, NamedCaptureGroups]

DecimalEscape

CharacterClassEscape

[?UnicodeMode]

CharacterEscape

[?UnicodeMode]

[+NamedCaptureGroups]

[?UnicodeMode]

[UnicodeMode]

[lookahead ∉ DecimalDigit]

HexEscapeSequence

RegExpUnicodeEscapeSequence

[?UnicodeMode]

[?UnicodeMode]

one of

[UnicodeMode]

[?UnicodeMode]

[UnicodeMode]

[?UnicodeMode]

[UnicodeMode]

RegExpIdentifierStart

[?UnicodeMode]

RegExpIdentifierName

[?UnicodeMode]

RegExpIdentifierPart

[?UnicodeMode]

RegExpIdentifierStart

[UnicodeMode]

IdentifierStartChar

RegExpUnicodeEscapeSequence

[+UnicodeMode]

[~UnicodeMode]

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpIdentifierPart

[UnicodeMode]

IdentifierPartChar

RegExpUnicodeEscapeSequence

[+UnicodeMode]

[~UnicodeMode]

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpUnicodeEscapeSequence

[UnicodeMode]

[+UnicodeMode]

[+UnicodeMode]

[+UnicodeMode]

[+UnicodeMode]

[~UnicodeMode]

[+UnicodeMode]

}

any Unicode code point in the inclusive interval from U+D800 to U+DBFF

UnicodeTrailSurrogate

any Unicode code point in the inclusive interval from U+DC00 to U+DFFF

연결할 u HexLeadSurrogate의 선택이 모호한 각 \u HexTrailSurrogate는 그렇지 않으면 대응하는 \u HexTrailSurrogate가 없는 가장 가까운 가능한 u HexLeadSurrogate와 연결되어야 합니다.

HexLeadSurrogate

Hex4Digits

but only if the MV of Hex4Digits is in the inclusive interval from 0xD800 to 0xDBFF

HexTrailSurrogate

Hex4Digits

but only if the MV of Hex4Digits is in the inclusive interval from 0xDC00 to 0xDFFF

HexNonSurrogate

Hex4Digits

but only if the MV of Hex4Digits is not in the inclusive interval from 0xD800 to 0xDFFF

IdentityEscape

[UnicodeMode]

[+UnicodeMode]

SyntaxCharacter

[+UnicodeMode]

[~UnicodeMode]

SourceCharacter

but not UnicodeIDContinue

DecimalEscape

NonZeroDigit

DecimalDigits

[~Sep]

opt

[lookahead ∉ DecimalDigit]

CharacterClassEscape

[UnicodeMode]

[+UnicodeMode]

UnicodePropertyValueExpression

}

[+UnicodeMode]

UnicodePropertyValueExpression

}

UnicodePropertyValueExpression

UnicodePropertyName

UnicodePropertyValue

LoneUnicodePropertyNameOrValue

UnicodePropertyName

UnicodePropertyNameCharacters

UnicodePropertyNameCharacter

UnicodePropertyNameCharacters

opt

UnicodePropertyValue

UnicodePropertyValueCharacters

LoneUnicodePropertyNameOrValue

UnicodePropertyValueCharacters

UnicodePropertyValueCharacter

UnicodePropertyValueCharacters

opt

UnicodePropertyValueCharacter

UnicodePropertyNameCharacter

DecimalDigit

UnicodePropertyNameCharacter

AsciiLetter

CharacterClass

[UnicodeMode, UnicodeSetsMode]

[

[lookahead ≠ ^]

ClassContents

[?UnicodeMode, ?UnicodeSetsMode]

]

ClassContents

[?UnicodeMode, ?UnicodeSetsMode]

]

ClassContents

[UnicodeMode, UnicodeSetsMode]

[empty]

[~UnicodeSetsMode]

NonemptyClassRanges

[?UnicodeMode]

[+UnicodeSetsMode]

[UnicodeMode]

[?UnicodeMode]

[?UnicodeMode]

NonemptyClassRangesNoDash

[?UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassContents

[?UnicodeMode, ~UnicodeSetsMode]

NonemptyClassRangesNoDash

[UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassAtomNoDash

[?UnicodeMode]

NonemptyClassRangesNoDash

[?UnicodeMode]

ClassAtomNoDash

[?UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassContents

[?UnicodeMode, ~UnicodeSetsMode]

[UnicodeMode]

[?UnicodeMode]

[UnicodeMode]

but not one of \ or ] or -

ClassEscape

[?UnicodeMode]

ClassEscape

[UnicodeMode]

[+UnicodeMode]

[?UnicodeMode]

[?UnicodeMode]

opt

opt

[lookahead ≠ &]

[lookahead ≠ &]

ClassStringDisjunction

ClassSetCharacter

NestedClass

[

[lookahead ≠ ^]

ClassContents

[+UnicodeMode, +UnicodeSetsMode]

]

ClassContents

[+UnicodeMode, +UnicodeSetsMode]

]

CharacterClassEscape

[+UnicodeMode]

참고 1

여기서 처음 두 줄은 CharacterClass와 동등합니다.

ClassStringDisjunction

\q{

ClassStringDisjunctionContents

}

ClassStringDisjunctionContents

ClassString

ClassStringDisjunctionContents

[empty]

opt

[lookahead ∉ ClassSetReservedDoublePunctuator]

SourceCharacter

but not ClassSetSyntaxCharacter

CharacterEscape

[+UnicodeMode]

ClassSetReservedPunctuator

ClassSetReservedDoublePunctuator

one of

;;

ClassSetSyntaxCharacter

one of

(

)

[

]

{

}

ClassSetReservedPunctuator

one of

;

참고 2

이 절의 여러 생성식에는 B.1.2 절에서 대체 정의가 제공됩니다.

22.2.1.1 Static Semantics: 조기 오류

참고

이 절은 B.1.2.1에서 수정됩니다.

Pattern

Disjunction

CountLeftCapturingParensWithin(Pattern) ≥ 2³² - 1이면 Syntax Error입니다.
Pattern에 서로 다른 두 GroupSpecifier x와 y가 포함되어 있고 x의 CapturingGroupName이 y의 CapturingGroupName과 같으며 MightBothParticipate(x, y)가 true이면 Syntax Error입니다.

QuantifierPrefix

{

DecimalDigits

}

첫 번째 DecimalDigits의 MV가 두 번째 DecimalDigits의 MV보다 엄격하게 크면 Syntax Error입니다.

Atom

RegularExpressionModifiers

Disjunction

)

RegularExpressionModifiers와 일치하는 소스 텍스트에 동일한 코드 포인트가 두 번 이상 포함되어 있으면 Syntax Error입니다.

Atom

RegularExpressionModifiers

Disjunction

)

첫 번째 RegularExpressionModifiers와 일치하는 소스 텍스트와 두 번째 RegularExpressionModifiers와 일치하는 소스 텍스트가 모두 비어 있으면 Syntax Error입니다.
첫 번째 RegularExpressionModifiers와 일치하는 소스 텍스트에 동일한 코드 포인트가 두 번 이상 포함되어 있으면 Syntax Error입니다.
두 번째 RegularExpressionModifiers와 일치하는 소스 텍스트에 동일한 코드 포인트가 두 번 이상 포함되어 있으면 Syntax Error입니다.
첫 번째 RegularExpressionModifiers와 일치하는 소스 텍스트의 어떤 코드 포인트가 두 번째 RegularExpressionModifiers와 일치하는 소스 텍스트에도 포함되어 있으면 Syntax Error입니다.

AtomEscape

GroupName

GroupSpecifiersThatMatch(GroupName)가 비어 있으면 Syntax Error입니다.

AtomEscape

DecimalEscape

DecimalEscape의 CapturingGroupNumber가 AtomEscape를 포함하는 Pattern의 CountLeftCapturingParensWithin보다 엄격하게 크면 Syntax Error입니다.

NonemptyClassRanges

ClassAtom

ClassContents

첫 번째 ClassAtom의 IsCharacterClass가 true이거나 두 번째 ClassAtom의 IsCharacterClass가 true이면 Syntax Error입니다.
첫 번째 ClassAtom의 IsCharacterClass가 false이고 두 번째 ClassAtom의 IsCharacterClass가 false이며 첫 번째 ClassAtom의 CharacterValue가 두 번째 ClassAtom의 CharacterValue보다 엄격하게 크면 Syntax Error입니다.

NonemptyClassRangesNoDash

ClassAtomNoDash

ClassAtom

ClassContents

ClassAtomNoDash의 IsCharacterClass가 true이거나 ClassAtom의 IsCharacterClass가 true이면 Syntax Error입니다.
ClassAtomNoDash의 IsCharacterClass가 false이고 ClassAtom의 IsCharacterClass가 false이며 ClassAtomNoDash의 CharacterValue가 ClassAtom의 CharacterValue보다 엄격하게 크면 Syntax Error입니다.

RegExpIdentifierStart

RegExpUnicodeEscapeSequence

RegExpUnicodeEscapeSequence의 CharacterValue가 IdentifierStartChar 어휘 문법 생성식과 일치하는 어떤 코드 포인트의 숫자 값도 아니면 Syntax Error입니다.

RegExpIdentifierStart

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpIdentifierStart의 RegExpIdentifierCodePoint가 UnicodeIDStart 어휘 문법 생성식과 일치하지 않으면 Syntax Error입니다.

RegExpIdentifierPart

RegExpUnicodeEscapeSequence

RegExpUnicodeEscapeSequence의 CharacterValue가 IdentifierPartChar 어휘 문법 생성식과 일치하는 어떤 코드 포인트의 숫자 값도 아니면 Syntax Error입니다.

RegExpIdentifierPart

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpIdentifierPart의 RegExpIdentifierCodePoint가 UnicodeIDContinue 어휘 문법 생성식과 일치하지 않으면 Syntax Error입니다.

UnicodePropertyValueExpression

UnicodePropertyName

UnicodePropertyValue

UnicodePropertyName과 일치하는 소스 텍스트가 표 65의 “Property name and aliases” 열에 나열된 Unicode property name 또는 프로퍼티 별칭이 아니면 Syntax Error입니다.
UnicodePropertyValue와 일치하는 소스 텍스트가 PropertyValueAliases.txt에 나열된 UnicodePropertyName과 일치하는 소스 텍스트가 지정하는 유니코드 프로퍼티 또는 프로퍼티 별칭에 대한 프로퍼티 값 또는 프로퍼티 값 별칭이 아니면 Syntax Error입니다.

UnicodePropertyValueExpression

LoneUnicodePropertyNameOrValue

LoneUnicodePropertyNameOrValue과 일치하는 소스 텍스트가 PropertyValueAliases.txt에 나열된 General_Category (gc) 프로퍼티의 유니코드 프로퍼티 값 또는 프로퍼티 값 별칭도 아니고, 표 66의 “Property name and aliases” 열에 나열된 이진 프로퍼티 또는 이진 프로퍼티 별칭도 아니며, 표 67의 “Property name” 열에 나열된 문자열의 이진 프로퍼티도 아니면 Syntax Error입니다.
둘러싸는 Pattern에 _{[UnicodeSetsMode]} 매개변수가 없고 LoneUnicodePropertyNameOrValue과 일치하는 소스 텍스트가 표 67의 “Property name” 열에 나열된 문자열의 이진 프로퍼티이면 Syntax Error입니다.

CharacterClassEscape

UnicodePropertyValueExpression

}

UnicodePropertyValueExpression의 MayContainStrings가 true이면 Syntax Error입니다.

CharacterClass

ClassContents

]

ClassContents의 MayContainStrings가 true이면 Syntax Error입니다.

NestedClass

ClassContents

]

ClassContents의 MayContainStrings가 true이면 Syntax Error입니다.

ClassSetRange

ClassSetCharacter

첫 번째 ClassSetCharacter의 CharacterValue가 두 번째 ClassSetCharacter의 CharacterValue보다 엄격하게 크면 Syntax Error입니다.

22.2.1.2 Static Semantics: CountLeftCapturingParensWithin ( `parseNode` )

추상 연산 CountLeftCapturingParensWithin. 인수 parseNode (구문 분석 노드). 반환값: 음이 아닌 정수. parseNode 안의 왼쪽 캡처링 괄호 수를 반환합니다. 왼쪽 캡처링 괄호는 Atom :: ( GroupSpecifieropt Disjunction ) 생성식의 ( 터미널과 일치하는 모든 ( 패턴 문자입니다.

참고

이 절은 B.1.2.2에서 수정됩니다.

호출되면 다음 단계를 수행한다.

단언: parseNode는 RegExp Pattern 문법에 있는 생성식의 인스턴스입니다.
parseNode 안에 포함된 Atom :: ( GroupSpecifieropt Disjunction ) Parse Node의 수를 반환합니다.

22.2.1.3 Static Semantics: CountLeftCapturingParensBefore ( `parseNode` )

추상 연산 CountLeftCapturingParensBefore. 인수 parseNode (구문 분석 노드). 반환값: 음이 아닌 정수. 둘러싸는 패턴 안에서 parseNode의 왼쪽에 나타나는 왼쪽 캡처링 괄호의 수를 반환합니다.

참고

이 절은 B.1.2.2에서 수정됩니다.

호출되면 다음 단계를 수행한다.

단언: parseNode는 RegExp Pattern 문법에 있는 생성식의 인스턴스입니다.
pattern을 parseNode를 포함하는 Pattern으로 둡니다.
pattern 안에 포함되고 parseNode보다 앞에 나타나거나 parseNode를 포함하는 Atom :: ( GroupSpecifieropt Disjunction ) Parse Node의 수를 반환합니다.

22.2.1.4 Static Semantics: MightBothParticipate ( `x`, `y` )

추상 연산 MightBothParticipate. 인수 x (구문 분석 노드) 및 y (구문 분석 노드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

단언: x와 y는 동일한 둘러싸는 Pattern을 갖습니다.
둘러싸는 Pattern에 Disjunction :: Alternative | Disjunction Parse Node가 포함되어 있고 x가 Alternative 안에 포함되며 y가 파생된 Disjunction 안에 포함되거나, x가 파생된 Disjunction 안에 포함되며 y가 Alternative 안에 포함되면 false를 반환합니다.
true를 반환합니다.

22.2.1.5 Static Semantics: CapturingGroupNumber

구문 지향 연산 CapturingGroupNumber. 인수 없음. 반환값: 양의 정수.

참고

이 절은 B.1.2.1에서 수정됩니다.

다음 생성 규칙별로 정의된다.

DecimalEscape

NonZeroDigit

NonZeroDigit의 MV를 반환합니다.

DecimalEscape

NonZeroDigit

DecimalDigits

n을 DecimalDigits의 코드 포인트 수로 둡니다.
(NonZeroDigit의 MV × 10ⁿ에 DecimalDigits의 MV를 더한 값)를 반환합니다.

“NonZeroDigit의 MV”와 “DecimalDigits의 MV” 정의는 12.9.3에 있습니다.

22.2.1.6 Static Semantics: IsCharacterClass

구문 지향 연산 IsCharacterClass. 인수 없음. 반환값: Boolean.

참고

이 절은 B.1.2.3에서 수정됩니다.

다음 생성 규칙별로 정의된다.

ClassAtom

ClassAtomNoDash

SourceCharacter

but not one of \ or ] or -

ClassEscape

CharacterEscape

false를 반환합니다.

ClassEscape

CharacterClassEscape

true를 반환합니다.

22.2.1.7 Static Semantics: CharacterValue

구문 지향 연산 CharacterValue. 인수 없음. 반환값: 음이 아닌 정수.

참고 1

이 절은 B.1.2.4에서 수정됩니다.

다음 생성 규칙별로 정의된다.

ClassAtom

U+002D (HYPHEN-MINUS)의 숫자 값을 반환합니다.

ClassAtomNoDash

SourceCharacter

but not one of \ or ] or -

codePoint를 SourceCharacter와 일치하는 코드 포인트로 둡니다.
codePoint의 숫자 값을 반환합니다.

ClassEscape

U+0008 (BACKSPACE)의 숫자 값을 반환합니다.

ClassEscape

U+002D (HYPHEN-MINUS)의 숫자 값을 반환합니다.

CharacterEscape

ControlEscape

표 63에 따른 숫자 값을 반환합니다.

표 63: ControlEscape 코드 포인트 값

ControlEscape	숫자 값	코드 포인트	유니코드 이름	기호
`t`	9	`U+0009`	CHARACTER TABULATION	<HT>
`n`	10	`U+000A`	LINE FEED (LF)	<LF>
`v`	11	`U+000B`	LINE TABULATION	<VT>
`f`	12	`U+000C`	FORM FEED (FF)	<FF>
`r`	13	`U+000D`	CARRIAGE RETURN (CR)	<CR>

CharacterEscape

AsciiLetter

codePoint를 AsciiLetter와 일치하는 코드 포인트로 둡니다.
i를 codePoint의 숫자 값으로 둡니다.
i를 32로 나눈 나머지를 반환합니다.

CharacterEscape

[lookahead ∉ DecimalDigit]

U+0000 (NULL)의 숫자 값을 반환합니다.

참고 2

\0은 <NUL> 문자를 나타내며 뒤에 십진 숫자가 올 수 없습니다.

CharacterEscape

HexEscapeSequence

HexEscapeSequence의 MV를 반환합니다.

RegExpUnicodeEscapeSequence

HexLeadSurrogate

HexTrailSurrogate

lead를 HexLeadSurrogate의 CharacterValue로 둡니다.
trail을 HexTrailSurrogate의 CharacterValue로 둡니다.
codePoint를 UTF16SurrogatePairToCodePoint(lead, trail)로 둡니다.
codePoint의 숫자 값을 반환합니다.

RegExpUnicodeEscapeSequence

Hex4Digits

Hex4Digits의 MV를 반환합니다.

RegExpUnicodeEscapeSequence

CodePoint

}

CodePoint의 MV를 반환합니다.

Hex4Digits의 MV를 반환합니다.

CharacterEscape

IdentityEscape

codePoint를 IdentityEscape와 일치하는 코드 포인트로 둡니다.
codePoint의 숫자 값을 반환합니다.

ClassSetCharacter

SourceCharacter

but not ClassSetSyntaxCharacter

codePoint를 SourceCharacter와 일치하는 코드 포인트로 둡니다.
codePoint의 숫자 값을 반환합니다.

ClassSetCharacter

ClassSetReservedPunctuator

codePoint를 ClassSetReservedPunctuator와 일치하는 코드 포인트로 둡니다.
codePoint의 숫자 값을 반환합니다.

ClassSetCharacter

U+0008 (BACKSPACE)의 숫자 값을 반환합니다.

22.2.1.8 Static Semantics: MayContainStrings

구문 지향 연산 MayContainStrings. 인수 없음. 반환값: Boolean. 다음 생성 규칙별로 정의된다.

CharacterClassEscape

UnicodePropertyValueExpression

}

UnicodePropertyValueExpression

]

[empty]

false를 반환합니다.

UnicodePropertyValueExpression

LoneUnicodePropertyNameOrValue

LoneUnicodePropertyNameOrValue과 일치하는 소스 텍스트가 표 67의 “Property name” 열에 나열된 문자열의 이진 프로퍼티이면 true를 반환합니다.
false를 반환합니다.

ClassUnion

ClassSetRange

ClassUnion

opt

ClassUnion이 존재하면 ClassUnion의 MayContainStrings를 반환합니다.
false를 반환합니다.

ClassUnion

ClassSetOperand

ClassUnion

opt

ClassSetOperand의 MayContainStrings가 true이면 true를 반환합니다.
ClassUnion이 존재하면 ClassUnion의 MayContainStrings를 반환합니다.
false를 반환합니다.

ClassIntersection

ClassSetOperand

첫 번째 ClassSetOperand의 MayContainStrings가 false이면 false를 반환합니다.
두 번째 ClassSetOperand의 MayContainStrings가 false이면 false를 반환합니다.
true를 반환합니다.

ClassIntersection

ClassSetOperand

ClassIntersection의 MayContainStrings가 false이면 false를 반환합니다.
ClassSetOperand의 MayContainStrings가 false이면 false를 반환합니다.
true를 반환합니다.

ClassSubtraction

ClassSetOperand

첫 번째 ClassSetOperand의 MayContainStrings를 반환합니다.

ClassSubtraction

ClassSetOperand

ClassSubtraction의 MayContainStrings를 반환합니다.

ClassStringDisjunctionContents

ClassString

ClassStringDisjunctionContents

ClassString의 MayContainStrings가 true이면 true를 반환합니다.
ClassStringDisjunctionContents의 MayContainStrings를 반환합니다.

ClassString

[empty]

true를 반환합니다.

ClassString

NonEmptyClassString

NonEmptyClassString의 MayContainStrings를 반환합니다.

NonEmptyClassString

ClassSetCharacter

NonEmptyClassString

opt

NonEmptyClassString이 존재하면 true를 반환합니다.
false를 반환합니다.

22.2.1.9 Static Semantics: GroupSpecifiersThatMatch ( `thisGroupName` )

추상 연산 GroupSpecifiersThatMatch. 인수 thisGroupName (a GroupName Parse Node). 반환값: 리스트 (요소: GroupSpecifier Parse Nodes). 호출되면 다음 단계를 수행한다.

name을 thisGroupName의 CapturingGroupName으로 둡니다.
pattern을 thisGroupName을 포함하는 Pattern으로 둡니다.
result를 새로운 빈 List로 둡니다.
pattern이 포함하는 각 GroupSpecifier groupSpecifier에 대해 다음을 수행합니다.
1. groupSpecifier의 CapturingGroupName이 name이면, 다음을 수행합니다.
  1. groupSpecifier를 result에 추가합니다.
result를 반환합니다.

22.2.1.10 Static Semantics: CapturingGroupName

구문 지향 연산 CapturingGroupName. 인수 없음. 반환값: String. 다음 생성 규칙별로 정의된다.

GroupName

RegExpIdentifierName

nameUnescaped를 RegExpIdentifierName의 RegExpIdentifierCodePoints로 둡니다.
CodePointsToString(nameUnescaped)을 반환합니다.

22.2.1.11 Static Semantics: RegExpIdentifierCodePoints

구문 지향 연산 RegExpIdentifierCodePoints. 인수 없음. 반환값: 리스트 (요소: 코드 포인트). 다음 생성 규칙별로 정의된다.

RegExpIdentifierName

RegExpIdentifierStart

codePoint를 RegExpIdentifierStart의 RegExpIdentifierCodePoint로 둡니다.
« codePoint »을 반환합니다.

RegExpIdentifierName

RegExpIdentifierPart

codePoints를 파생된 RegExpIdentifierName의 RegExpIdentifierCodePoints로 둡니다.
codePoint를 RegExpIdentifierPart의 RegExpIdentifierCodePoint로 둡니다.
codePoints와 « codePoint »의 목록 연결을 반환합니다.

22.2.1.12 Static Semantics: RegExpIdentifierCodePoint

구문 지향 연산 RegExpIdentifierCodePoint. 인수 없음. 반환값: 코드 포인트. 다음 생성 규칙별로 정의된다.

RegExpIdentifierStart

IdentifierStartChar

IdentifierStartChar와 일치하는 코드 포인트를 반환합니다.

RegExpIdentifierPart

IdentifierPartChar

IdentifierPartChar와 일치하는 코드 포인트를 반환합니다.

RegExpIdentifierStart

RegExpUnicodeEscapeSequence

RegExpIdentifierPart

RegExpUnicodeEscapeSequence

숫자 값이 RegExpUnicodeEscapeSequence의 CharacterValue인 코드 포인트를 반환합니다.

RegExpIdentifierStart

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpIdentifierPart

UnicodeLeadSurrogate

UnicodeTrailSurrogate

lead를 숫자 값이 UnicodeLeadSurrogate와 일치하는 코드 포인트의 숫자 값인 코드 단위로 둡니다.
trail을 숫자 값이 UnicodeTrailSurrogate와 일치하는 코드 포인트의 숫자 값인 코드 단위로 둡니다.
UTF16SurrogatePairToCodePoint(lead, trail)를 반환합니다.

22.2.2 패턴 의미론

정규 표현식 패턴은 아래에 설명된 과정을 사용하여 Abstract Closure로 변환됩니다. 결과가 동일하다면 구현체는 아래에 나열된 알고리즘보다 더 효율적인 알고리즘을 사용하는 것이 권장됩니다. Abstract Closure는 RegExp 객체의 [[RegExpMatcher]] 내부 슬롯 값으로 사용됩니다.

Pattern의 관련 플래그에 u도 v도 포함되어 있지 않으면 해당 Pattern은 BMP 패턴입니다. 그렇지 않으면 유니코드 패턴입니다. BMP 패턴은 Basic Multilingual Plane 범위의 유니코드 코드 포인트인 16비트 값의 시퀀스로 구성된 것으로 해석되는 String과 일치합니다. 유니코드 패턴은 UTF-16으로 인코딩된 유니코드 코드 포인트로 구성된 것으로 해석되는 String과 일치합니다. BMP 패턴의 동작을 설명하는 문맥에서 “문자”는 단일 16비트 유니코드 BMP 코드 포인트를 의미합니다. 유니코드 패턴의 동작을 설명하는 문맥에서 “문자”는 UTF-16 인코딩 코드 포인트(6.1.4)를 의미합니다. 어느 문맥에서든 “문자 값”은 대응하는 인코딩되지 않은 코드 포인트의 숫자 값을 의미합니다.

Pattern의 구문과 의미론은 Pattern의 소스 텍스트가 각 SourceCharacter가 하나의 유니코드 코드 포인트에 대응하는 SourceCharacter 값의 List인 것처럼 정의됩니다. BMP 패턴에 비-BMP SourceCharacter가 포함되어 있으면 전체 패턴을 UTF-16으로 인코딩하고 해당 인코딩의 개별 코드 단위를 List의 요소로 사용합니다.

참고

예를 들어 소스 텍스트에서 단일 비-BMP 문자 U+1D11E (MUSICAL SYMBOL G CLEF)로 표현된 패턴을 생각해 보시기 바랍니다. 유니코드 패턴으로 해석하면 단일 코드 포인트 U+1D11E로 구성된 단일 요소(문자) List가 됩니다. 그러나 BMP 패턴으로 해석하면 먼저 UTF-16으로 인코딩되어 코드 단위 0xD834와 0xDD1E로 구성된 두 요소 List가 생성됩니다.

패턴은 비-BMP 문자가 UTF-16으로 인코딩된 ECMAScript String 값으로 RegExp 생성자에 전달됩니다. 예를 들어 단일 문자 MUSICAL SYMBOL G CLEF 패턴을 String 값으로 표현하면 요소가 코드 단위 0xD834와 0xDD1E인 길이 2의 String입니다. 따라서 두 패턴 문자로 구성된 BMP 패턴으로 처리하기 위해 문자열을 추가로 변환할 필요는 없습니다. 그러나 유니코드 패턴으로 처리하려면 유일한 요소가 단일 패턴 문자, 즉 코드 포인트 U+1D11E인 List를 생성할 때 UTF16SurrogatePairToCodePoint를 사용해야 합니다.

구현체는 실제로 UTF-16으로 또는 UTF-16에서 이러한 변환을 수행하지 않을 수 있지만, 이 명세의 의미론은 패턴 일치 결과가 그러한 변환이 수행된 것과 같아야 함을 요구합니다.

22.2.2.1 표기법

아래 설명에서는 다음 내부 데이터 구조를 사용합니다:

CharSetElement는 다음 두 엔티티 중 하나입니다:
- regexpRecord.[[UnicodeSets]]가 false이면 CharSetElement는 위의 패턴 의미론에서 말하는 문자입니다.
- regexpRecord.[[UnicodeSets]]가 true이면 CharSetElement는 요소가 위의 패턴 의미론에서 말하는 문자인 시퀀스입니다. 여기에는 빈 시퀀스, 한 문자의 시퀀스 및 둘 이상의 문자의 시퀀스가 포함됩니다. 편의를 위해 이러한 종류의 CharSetElement를 다룰 때 개별 문자는 한 문자의 시퀀스와 상호 교환 가능하게 취급합니다.
CharSet은 CharSetElement의 수학적 집합입니다.
CaptureRange는 캡처에 포함된 문자 범위를 나타내는 Record { [[StartIndex]], [[EndIndex]] }입니다. 여기서 [[StartIndex]]는 input 안에서 범위의 시작 인덱스(포함)를 나타내는 정수이고 [[EndIndex]]는 input 안에서 범위의 끝 인덱스(제외)를 나타내는 정수입니다. 모든 CaptureRange에서 이러한 인덱스는 [[StartIndex]] ≤ [[EndIndex]]라는 불변 조건을 만족해야 합니다.
MatchState는 Record { [[Input]], [[EndIndex]], [[Captures]] }입니다. 여기서 [[Input]]은 일치 대상 String을 나타내는 문자 List이고, [[EndIndex]]는 정수이며, [[Captures]]는 패턴의 각 왼쪽 캡처링 괄호마다 하나의 값을 갖는 List입니다. MatchState는 정규 표현식 일치 알고리즘에서 부분 일치 상태를 나타내는 데 사용됩니다. [[EndIndex]]는 지금까지 패턴이 일치한 마지막 입력 문자의 인덱스에 1을 더한 값이며, [[Captures]]는 캡처링 괄호의 결과를 보관합니다. [[Captures]]의 n^th 요소는 n^th 캡처링 괄호 집합이 캡처한 문자 범위를 나타내는 CaptureRange이거나, n^th 캡처링 괄호 집합에 아직 도달하지 않은 경우 undefined입니다. 백트래킹 때문에 일치 과정 중 언제든 여러 MatchState가 사용 중일 수 있습니다.
MatcherContinuation은 하나의 MatchState 인수를 받고 MatchState 또는 failure를 반환하는 Abstract Closure입니다. MatcherContinuation은 MatchState 인수가 지정한 중간 상태에서 시작하여 input에 대해 패턴의 남은 부분(클로저가 캡처한 값으로 지정됨)을 일치시키려고 시도합니다. 일치가 성공하면 MatcherContinuation은 도달한 최종 MatchState를 반환하고, 일치가 실패하면 failure를 반환합니다.
Matcher는 두 인수, 즉 MatchState와 MatcherContinuation을 받고 MatchState 또는 failure를 반환하는 Abstract Closure입니다. Matcher는 MatchState 인수가 지정한 중간 상태에서 시작하여 MatchState의 [[Input]]에 대해 패턴의 중간 하위 패턴(클로저가 캡처한 값으로 지정됨)을 일치시키려고 시도합니다. MatcherContinuation 인수는 패턴의 나머지를 일치시키는 클로저여야 합니다. 패턴의 하위 패턴을 일치시켜 새로운 MatchState를 얻은 뒤 Matcher는 새 MatchState에 대해 MatcherContinuation을 호출하여 패턴의 나머지도 일치할 수 있는지 검사합니다. 가능하면 Matcher는 MatcherContinuation이 반환한 MatchState를 반환하고, 그렇지 않으면 선택 지점에서 다른 선택을 시도하면서 성공하거나 모든 가능성이 소진될 때까지 MatcherContinuation을 반복 호출할 수 있습니다.

22.2.2.1.1 RegExp Record

RegExp Record는 컴파일 중 및 필요한 경우 일치 중에 필요한 RegExp 정보를 저장하는 데 사용하는 Record입니다.

다음 필드를 갖습니다:

표 64: RegExp Record 필드

필드 이름	값	의미
`[[IgnoreCase]]`	a Boolean	RegExp의 플래그에 "i"가 나타나는지 나타냅니다.
`[[Multiline]]`	a Boolean	RegExp의 플래그에 "m"이 나타나는지 나타냅니다.
`[[DotAll]]`	a Boolean	RegExp의 플래그에 "s"가 나타나는지 나타냅니다.
`[[Unicode]]`	a Boolean	RegExp의 플래그에 "u"가 나타나는지 나타냅니다.
`[[UnicodeSets]]`	a Boolean	RegExp의 플래그에 "v"가 나타나는지 나타냅니다.
`[[CapturingGroupsCount]]`	a non-negative integer	RegExp 패턴의 왼쪽 캡처링 괄호 수입니다.

22.2.2.2 Runtime Semantics: CompilePattern

구문 지향 연산 CompilePattern. 인수 regexpRecord (RegExp 레코드). 반환값: an Abstract Closure that takes a List of characters and a non-negative integer and returns either a MatchState or failure. 다음 생성 규칙별로 정의된다.

Pattern

Disjunction

m을 인수 regexpRecord 및 forward를 사용한 Disjunction의 CompileSubpattern으로 둡니다.
regexpRecord와 m을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (input, index)를 갖는 새로운 Abstract Closure를 반환합니다:
1. 단언: input은 문자의 List입니다.
2. 단언: 0 ≤ index ≤ input의 요소 수입니다.
3. c를 아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. y를 반환합니다.
4. capability를 1부터 regexpRecord.[[CapturingGroupsCount]]까지 인덱싱된 regexpRecord.[[CapturingGroupsCount]]개의 undefined 값으로 구성된 List로 둡니다.
5. x를 MatchState { [[Input]]: input, [[EndIndex]]: index, [[Captures]]: capability }로 둡니다.
6. m(x, c)를 반환합니다.

참고

Pattern은 Abstract Closure 값으로 컴파일됩니다. 그런 다음 RegExpBuiltinExec는 이 프로시저를 문자 List와 해당 List 안의 오프셋에 적용하여 패턴이 List 안의 정확히 해당 오프셋에서 시작하여 일치하는지, 그리고 일치하는 경우 캡처링 괄호의 값이 무엇인지 결정할 수 있습니다. 22.2.2의 알고리즘은 패턴 컴파일이 SyntaxError 예외를 던질 수 있도록 설계되어 있습니다. 반면 패턴이 성공적으로 컴파일된 후에는 결과 Abstract Closure를 적용하여 문자 List 안에서 일치를 찾는 과정은 예외를 던질 수 없습니다(메모리 부족처럼 어디서든 발생할 수 있는 구현체 정의 예외는 제외).

22.2.2.3 Runtime Semantics: CompileSubpattern

구문 지향 연산 CompileSubpattern. 인수 regexpRecord (RegExp 레코드) 및 direction ((forward 또는 backward)). 반환값: Matcher.

참고 1

이 절은 B.1.2.5에서 수정됩니다.

다음 생성 규칙별로 정의된다.

Disjunction

Alternative

Disjunction

m1을 인수 regexpRecord 및 direction을 사용한 Alternative의 CompileSubpattern으로 둡니다.
m2를 인수 regexpRecord 및 direction을 사용한 Disjunction의 CompileSubpattern으로 둡니다.
MatchTwoAlternatives(m1, m2)를 반환합니다.

참고 2

| 정규 표현식 연산자는 두 대안을 구분합니다. 패턴은 먼저 왼쪽 Alternative(정규 표현식의 후속 부분이 이어짐)를 일치시키려고 시도하고, 실패하면 오른쪽 Disjunction(정규 표현식의 후속 부분이 이어짐)을 일치시키려고 시도합니다. 왼쪽 Alternative, 오른쪽 Disjunction 및 후속 부분에 모두 선택 지점이 있으면 왼쪽 Alternative의 다음 선택으로 이동하기 전에 후속 부분의 모든 선택을 시도합니다. 왼쪽 Alternative의 선택이 소진되면 왼쪽 Alternative 대신 오른쪽 Disjunction을 시도합니다. |에 의해 건너뛴 패턴 부분 안의 캡처링 괄호는 String 대신 undefined 값을 생성합니다. 따라서 예를 들어,

/a|ab/.exec("abc")

는 "ab"가 아니라 "a" 결과를 반환합니다. 또한,

/((a)|(ab))((c)|(bc))/.exec("abc")

는 다음 배열을 반환하고

["abc", "a", "a", undefined, "bc", undefined, "bc"]

다음 배열은 반환하지 않습니다.

["abc", "ab", undefined, "ab", "c", "c", undefined]

두 대안을 시도하는 순서는 direction 값과 무관합니다.

Alternative

[empty]

EmptyMatcher()를 반환합니다.

Alternative

Term

m1을 인수 regexpRecord 및 direction을 사용한 Alternative의 CompileSubpattern으로 둡니다.
m2를 인수 regexpRecord 및 direction을 사용한 Term의 CompileSubpattern으로 둡니다.
MatchSequence(m1, m2, direction)를 반환합니다.

참고 3

연속된 Term은 input의 연속된 부분을 동시에 일치시키려고 시도합니다. direction이 forward이고 왼쪽 Alternative, 오른쪽 Term 및 정규 표현식의 후속 부분에 모두 선택 지점이 있으면 오른쪽 Term의 다음 선택으로 이동하기 전에 후속 부분의 모든 선택을 시도하며, 왼쪽 Alternative의 다음 선택으로 이동하기 전에 오른쪽 Term의 모든 선택을 시도합니다. direction이 backward이면 Alternative와 Term의 평가 순서가 반대가 됩니다.

Term

Assertion

인수 regexpRecord를 사용한 Assertion의 CompileAssertion을 반환합니다.

참고 4

결과 Matcher는 direction과 무관합니다.

Term

Atom

인수 regexpRecord 및 direction을 사용한 Atom의 CompileAtom을 반환합니다.

Term

Atom

Quantifier

m을 인수 regexpRecord 및 direction을 사용한 Atom의 CompileAtom으로 둡니다.
q를 Quantifier의 CompileQuantifier로 둡니다.
단언: q.[[Min]] ≤ q.[[Max]]입니다.
parenIndex를 CountLeftCapturingParensBefore(Term)로 둡니다.
parenCount를 CountLeftCapturingParensWithin(Atom)로 둡니다.
m, q, parenIndex 및 parenCount를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, c)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: x는 MatchState입니다.
2. 단언: c는 MatcherContinuation입니다.
3. RepeatMatcher(m, q.[[Min]], q.[[Max]], q.[[Greedy]], x, c, parenIndex, parenCount)를 반환합니다.

22.2.2.3.1 RepeatMatcher ( `m`, `min`, `max`, `greedy`, `matchState`, `continue`, `parenIndex`, `parenCount` )

추상 연산 RepeatMatcher. 인수 m (Matcher), min (음이 아닌 정수), max ((음이 아닌 정수 또는 +∞)), greedy (Boolean), matchState (MatchState), continue (MatcherContinuation), parenIndex (음이 아닌 정수) 및 parenCount (음이 아닌 정수). 반환값: (MatchState 또는 failure). 호출되면 다음 단계를 수행한다.

max = 0이면 continue(matchState)를 반환합니다.
d를 m, min, max, greedy, matchState, continue, parenIndex 및 parenCount를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
1. 단언: y는 MatchState입니다.
2. min = 0이고 y.[[EndIndex]] = matchState.[[EndIndex]]이면 failure를 반환합니다.
3. min = 0이면 min2를 0으로 둡니다. 그렇지 않으면 min2를 min - 1로 둡니다.
4. max = +∞이면 max2를 +∞로 둡니다. 그렇지 않으면 max2를 max - 1로 둡니다.
5. RepeatMatcher(m, min2, max2, greedy, y, continue, parenIndex, parenCount)를 반환합니다.
capability를 matchState.[[Captures]]의 복사본으로 둡니다.
parenIndex + 1부터 parenIndex + parenCount까지의 폐구간에 속하는 각 정수 k에 대해 capability[k]를 undefined로 설정합니다.
input을 matchState.[[Input]]으로 둡니다.
e를 matchState.[[EndIndex]]로 둡니다.
xr를 MatchState { [[Input]]: input, [[EndIndex]]: e, [[Captures]]: capability }로 둡니다.
min ≠ 0이면 m(xr, d)를 반환합니다.
greedy가 false이면, 다음을 수행합니다.
1. z를 continue(matchState)로 둡니다.
2. z가 failure가 아니면 z를 반환합니다.
3. m(xr, d)를 반환합니다.
z를 m(xr, d)로 둡니다.
z가 failure가 아니면 z를 반환합니다.
continue(matchState)를 반환합니다.

참고 1

Quantifier가 뒤따르는 Atom은 Quantifier가 지정한 횟수만큼 반복됩니다. Quantifier는 비탐욕적일 수 있으며, 이 경우 Atom 패턴은 후속 부분과 여전히 일치하는 범위에서 가능한 한 적게 반복됩니다. 또는 탐욕적일 수 있으며, 이 경우 Atom 패턴은 후속 부분과 여전히 일치하는 범위에서 가능한 한 많이 반복됩니다. 일치하는 입력 문자 시퀀스가 아니라 Atom 패턴 자체가 반복되므로 Atom의 서로 다른 반복은 서로 다른 입력 부분 문자열과 일치할 수 있습니다.

참고 2

Atom과 정규 표현식의 후속 부분에 모두 선택 지점이 있으면 Atom은 먼저 가능한 한 많이(비탐욕적이면 가능한 한 적게) 일치합니다. 후속 부분의 모든 선택은 Atom의 마지막 반복에서 다음 선택으로 이동하기 전에 시도됩니다. Atom의 마지막(n^th) 반복의 모든 선택은 마지막에서 두 번째(n - 1)^st 반복의 다음 선택으로 이동하기 전에 시도됩니다. 이 시점에서 Atom을 더 많이 또는 더 적게 반복할 수 있음이 밝혀질 수 있으며, 이러한 가능성은 (다시 가능한 한 적게 또는 많이 시작하여) 소진된 뒤 (n - 1)^st 반복의 다음 선택으로 이동하는 식으로 계속됩니다.

다음을 비교해 보시기 바랍니다.

/a[a-z]{2,4}/.exec("abcdefghi")

이는 "abcde"를 반환하며, 다음은

/a[a-z]{2,4}?/.exec("abcdefghi")

"abc"를 반환합니다.

또한 다음도 생각해 보시기 바랍니다.

/(aa|aabaac|ba|b|c)*/.exec("aabaac")

위의 선택 지점 순서에 따라 다음 배열을 반환하고

["aaba", "ba"]

다음 중 어느 것도 반환하지 않습니다:

["aabaac", "aabaac"]
["aabaac", "c"]

위의 선택 지점 순서를 이용하면 두 숫자(단항 표기법으로 표현됨)의 최대공약수를 계산하는 정규 표현식을 작성할 수 있습니다. 다음 예는 10과 15의 최대공약수를 계산합니다:

"aaaaaaaaaa,aaaaaaaaaaaaaaa".replace(/^(a+)\1*,\1+$/, "$1")

이는 단항 표기법으로 된 최대공약수 "aaaaa"를 반환합니다.

참고 3

RepeatMatcher의 4 단계는 Atom이 반복될 때마다 Atom의 캡처를 지웁니다. 다음 정규 표현식에서 그 동작을 확인할 수 있습니다.

/(z)((a+)?(b+)?(c))*/.exec("zaacbbbcac")

이는 다음 배열을 반환하고

["zaacbbbcac", "z", "ac", "a", undefined, "c"]

다음은 반환하지 않습니다.

["zaacbbbcac", "z", "ac", "a", "bbb", "c"]

가장 바깥쪽 *의 각 반복이 수량화된 Atom 안에 포함된 모든 캡처 String을 지우기 때문이며, 이 경우 번호 2, 3, 4 및 5의 캡처 String이 포함됩니다.

참고 4

RepeatMatcher의 2.b 단계는 최소 반복 횟수가 충족된 후 빈 문자 시퀀스와 일치하는 Atom의 추가 확장은 이후 반복에서 고려하지 않는다고 명시합니다. 이는 다음과 같은 패턴에서 정규 표현식 엔진이 무한 루프에 빠지는 것을 방지합니다:

/(a*)*/.exec("b")

또는 조금 더 복잡한 다음 패턴:

/(a*)b\1+/.exec("baaaac")

이는 다음 배열을 반환합니다.

["b", ""]

22.2.2.3.2 EmptyMatcher ( )

추상 연산 EmptyMatcher. 인수 없음. 반환값: Matcher. 호출되면 다음 단계를 수행한다.

아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. continue(matchState)를 반환합니다.

22.2.2.3.3 MatchTwoAlternatives ( `m1`, `m2` )

추상 연산 MatchTwoAlternatives. 인수 m1 (Matcher) 및 m2 (Matcher). 반환값: Matcher. 호출되면 다음 단계를 수행한다.

m1과 m2를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. result를 m1(matchState, continue)로 둡니다.
4. result가 failure가 아니면 result를 반환합니다.
5. m2(matchState, continue)를 반환합니다.

22.2.2.3.4 MatchSequence ( `m1`, `m2`, `direction` )

추상 연산 MatchSequence. 인수 m1 (Matcher), m2 (Matcher) 및 direction ((forward 또는 backward)). 반환값: Matcher. 호출되면 다음 단계를 수행한다.

direction이 forward이면, 다음을 수행합니다.
1. m1과 m2를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
  1. 단언: matchState는 MatchState입니다.
  2. 단언: continue는 MatcherContinuation입니다.
  3. d를 continue와 m2를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
    1. 단언: y는 MatchState입니다.
    2. m2(y, continue)를 반환합니다.
  4. m1(matchState, d)를 반환합니다.
단언: direction은 backward입니다.
m1과 m2를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. d를 continue와 m1을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. m1(y, continue)를 반환합니다.
4. m2(matchState, d)를 반환합니다.

22.2.2.4 Runtime Semantics: CompileAssertion

구문 지향 연산 CompileAssertion. 인수 regexpRecord (RegExp 레코드). 반환값: Matcher.

참고 1

이 절은 B.1.2.6에서 수정됩니다.

다음 생성 규칙별로 정의된다.

Assertion

regexpRecord를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. input을 matchState.[[Input]]으로 둡니다.
4. e를 matchState.[[EndIndex]]로 둡니다.
5. e = 0이거나, regexpRecord.[[Multiline]]이 true이고 문자 input[e - 1]이 LineTerminator와 일치하면, 다음을 수행합니다.
  1. continue(matchState)를 반환합니다.
6. failure를 반환합니다.

참고 2

패턴에 y 플래그를 사용하는 경우에도 ^는 항상 input의 시작 또는 (regexpRecord.[[Multiline]]이 true인 경우) 줄의 시작에서만 일치합니다.

Assertion

regexpRecord를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. input을 matchState.[[Input]]으로 둡니다.
4. e를 matchState.[[EndIndex]]로 둡니다.
5. inputLength를 input의 요소 수로 둡니다.
6. e = inputLength이거나, regexpRecord.[[Multiline]]이 true이고 문자 input[e]가 LineTerminator와 일치하면, 다음을 수행합니다.
  1. continue(matchState)를 반환합니다.
7. failure를 반환합니다.

Assertion

regexpRecord를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. input을 matchState.[[Input]]으로 둡니다.
4. e를 matchState.[[EndIndex]]로 둡니다.
5. a를 IsWordChar(regexpRecord, input, e - 1)로 둡니다.
6. b를 IsWordChar(regexpRecord, input, e)로 둡니다.
7. a가 true이고 b가 false이거나, a가 false이고 b가 true이면 continue(matchState)를 반환합니다.
8. failure를 반환합니다.

Assertion

regexpRecord를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. input을 matchState.[[Input]]으로 둡니다.
4. e를 matchState.[[EndIndex]]로 둡니다.
5. a를 IsWordChar(regexpRecord, input, e - 1)로 둡니다.
6. b를 IsWordChar(regexpRecord, input, e)로 둡니다.
7. a가 true이고 b가 true이거나, a가 false이고 b가 false이면 continue(matchState)를 반환합니다.
8. failure를 반환합니다.

Assertion

(?=

Disjunction

)

m을 인수 regexpRecord 및 forward를 사용한 Disjunction의 CompileSubpattern으로 둡니다.
m을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. d를 아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. y를 반환합니다.
4. result를 m(matchState, d)로 둡니다.
5. result가 failure이면 failure를 반환합니다.
6. 단언: result는 MatchState입니다.
7. capability를 result.[[Captures]]로 둡니다.
8. input을 matchState.[[Input]]으로 둡니다.
9. xe를 matchState.[[EndIndex]]로 둡니다.
10. z를 MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: capability }로 둡니다.
11. continue(z)를 반환합니다.

참고 3

(?= Disjunction ) 형식은 너비가 0인 긍정형 전방 탐색을 지정합니다. 성공하려면 Disjunction 안의 패턴이 현재 위치에서 일치해야 하지만, 후속 부분을 일치시키기 전에 현재 위치는 전진하지 않습니다. Disjunction이 현재 위치에서 여러 방식으로 일치할 수 있으면 첫 번째 방식만 시도합니다. 다른 정규 표현식 연산자와 달리 (?= 형식 안으로 백트래킹하지 않습니다(이 비정상적인 동작은 Perl에서 상속됨). 이는 Disjunction에 캡처링 괄호가 포함되고 패턴의 후속 부분에 해당 캡처에 대한 역참조가 포함된 경우에만 중요합니다.

예를 들어,

/(?=(a+))/.exec("baaabac")

는 첫 번째 b 바로 뒤의 빈 String과 일치하므로 다음 배열을 반환합니다:

["", "aaa"]

전방 탐색 안으로 백트래킹하지 않는다는 점을 보여 주기 위해 다음을 생각해 보시기 바랍니다:

/(?=(a+))a*b\1/.exec("baaabac")

이 표현식은 다음을 반환하며

["aba", "a"]

다음은 반환하지 않습니다:

["aaaba", "a"]

Assertion

(?!

Disjunction

)

m을 인수 regexpRecord 및 forward를 사용한 Disjunction의 CompileSubpattern으로 둡니다.
m을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. d를 아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. y를 반환합니다.
4. result를 m(matchState, d)로 둡니다.
5. result가 failure가 아니면 failure를 반환합니다.
6. continue(matchState)를 반환합니다.

참고 4

(?! Disjunction ) 형식은 너비가 0인 부정형 전방 탐색을 지정합니다. 성공하려면 Disjunction 안의 패턴이 현재 위치에서 일치하지 않아야 합니다. 후속 부분을 일치시키기 전에 현재 위치는 전진하지 않습니다. Disjunction은 캡처링 괄호를 포함할 수 있지만 이에 대한 역참조는 Disjunction 자체 안에서만 의미가 있습니다. 패턴의 다른 위치에서 이러한 캡처링 괄호에 대한 역참조는 항상 undefined를 반환합니다. 패턴이 성공하려면 부정형 전방 탐색이 실패해야 하기 때문입니다. 예를 들어,

/(.*?)a(?!(a+)b\2c)\2(.*)/.exec("baaabaac")

는 바로 뒤에 양의 수 n개의 a, b, 다시 n개의 a(첫 번째 \2가 지정) 및 c가 이어지지 않는 a를 찾습니다. 두 번째 \2는 부정형 전방 탐색 밖에 있으므로 undefined와 일치하여 항상 성공합니다. 전체 표현식은 다음 배열을 반환합니다:

["baaabaac", "ba", undefined, "abaac"]

Assertion

(?<=

Disjunction

)

m을 인수 regexpRecord 및 backward를 사용한 Disjunction의 CompileSubpattern으로 둡니다.
m을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. d를 아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. y를 반환합니다.
4. result를 m(matchState, d)로 둡니다.
5. result가 failure이면 failure를 반환합니다.
6. 단언: result는 MatchState입니다.
7. capability를 result.[[Captures]]로 둡니다.
8. input을 matchState.[[Input]]으로 둡니다.
9. xe를 matchState.[[EndIndex]]로 둡니다.
10. z를 MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: capability }로 둡니다.
11. continue(z)를 반환합니다.

Assertion

(?<!

Disjunction

)

m을 인수 regexpRecord 및 backward를 사용한 Disjunction의 CompileSubpattern으로 둡니다.
m을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (matchState, continue)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: matchState는 MatchState입니다.
2. 단언: continue는 MatcherContinuation입니다.
3. d를 아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. y를 반환합니다.
4. result를 m(matchState, d)로 둡니다.
5. result가 failure가 아니면 failure를 반환합니다.
6. continue(matchState)를 반환합니다.

22.2.2.4.1 IsWordChar ( `regexpRecord`, `input`, `e` )

추상 연산 IsWordChar. 인수 regexpRecord (RegExp 레코드), input (리스트 (요소: 문자)) 및 e (정수). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

inputLength를 input의 요소 수로 둡니다.
e = -1 또는 e = inputLength이면 false를 반환합니다.
char를 문자 input[e]로 둡니다.
WordCharacters(regexpRecord)에 char가 포함되어 있으면 true를 반환합니다.
false를 반환합니다.

22.2.2.5 Runtime Semantics: CompileQuantifier

구문 지향 연산 CompileQuantifier. 인수 없음. 반환값: 레코드 (필드: [[Min]] (음이 아닌 정수), [[Max]] ((음이 아닌 정수 또는 +∞)), [[Greedy]] (Boolean)). 다음 생성 규칙별로 정의된다.

Quantifier

QuantifierPrefix

qp를 QuantifierPrefix의 CompileQuantifierPrefix로 둡니다.
Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]: true }를 반환합니다.

Quantifier

QuantifierPrefix

qp를 QuantifierPrefix의 CompileQuantifierPrefix로 둡니다.
Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]: false }를 반환합니다.

22.2.2.6 Runtime Semantics: CompileQuantifierPrefix

구문 지향 연산 CompileQuantifierPrefix. 인수 없음. 반환값: 레코드 (필드: [[Min]] (음이 아닌 정수), [[Max]] ((음이 아닌 정수 또는 +∞))). 다음 생성 규칙별로 정의된다.

QuantifierPrefix

Record { [[Min]]: 0, [[Max]]: +∞ }를 반환합니다.

QuantifierPrefix

Record { [[Min]]: 1, [[Max]]: +∞ }를 반환합니다.

QuantifierPrefix

Record { [[Min]]: 0, [[Max]]: 1 }을 반환합니다.

QuantifierPrefix

{

DecimalDigits

}

i를 DecimalDigits의 MV로 둡니다(12.9.3 참조).
Record { [[Min]]: i, [[Max]]: i }를 반환합니다.

QuantifierPrefix

{

DecimalDigits

i를 DecimalDigits의 MV로 둡니다.
Record { [[Min]]: i, [[Max]]: +∞ }를 반환합니다.

QuantifierPrefix

{

DecimalDigits

}

i를 첫 번째 DecimalDigits의 MV로 둡니다.
j를 두 번째 DecimalDigits의 MV로 둡니다.
Record { [[Min]]: i, [[Max]]: j }를 반환합니다.

22.2.2.7 Runtime Semantics: CompileAtom

구문 지향 연산 CompileAtom. 인수 regexpRecord (RegExp 레코드) 및 direction ((forward 또는 backward)). 반환값: Matcher.

참고 1

이 절은 B.1.2.7에서 수정됩니다.

다음 생성 규칙별로 정의된다.

Atom

PatternCharacter

char를 PatternCharacter와 일치하는 문자로 둡니다.
charSet을 문자 char를 포함하는 한 요소 CharSet으로 둡니다.
CharacterSetMatcher(regexpRecord, charSet, false, direction)를 반환합니다.

Atom

charSet을 AllCharacters(regexpRecord)로 둡니다.
regexpRecord.[[DotAll]]이 true가 아니면, 다음을 수행합니다.
1. LineTerminator 생성식의 오른쪽에 있는 코드 포인트에 대응하는 모든 문자를 charSet에서 제거합니다.
CharacterSetMatcher(regexpRecord, charSet, false, direction)를 반환합니다.

Atom

CharacterClass

cc를 인수 regexpRecord를 사용한 CharacterClass의 CompileCharacterClass로 둡니다.
cs를 cc.[[CharSet]]으로 둡니다.
regexpRecord.[[UnicodeSets]]가 false이거나 cs의 모든 CharSetElement가 단일 문자로 구성되어 있으면(cs가 비어 있는 경우 포함) CharacterSetMatcher(regexpRecord, cs, cc.[[Invert]], direction)를 반환합니다.
단언: cc.[[Invert]]는 false입니다.
listOfMatchers를 Matcher의 빈 List로 둡니다.
csSequences를 새로운 빈 List로 둡니다.
cs의 각 CharSetElement s에 대해 다음을 수행합니다.
1. s의 길이가 > 1이면 s를 csSequences에 추가합니다.
각 CharSetElement의 길이에 따라 csSequences를 내림차순으로 정렬합니다.
csSequences의 각 CharSetElement s에 대해 다음을 수행합니다.
1. 단언: s는 2개 이상의 코드 포인트 시퀀스입니다.
2. remaining을 s의 코드 포인트로 구성된 List로 둡니다.
3. cs2를 remaining의 마지막 요소를 포함하는 한 요소 CharSet으로 둡니다.
4. m2를 CharacterSetMatcher(regexpRecord, cs2, false, direction)로 둡니다.
5. remaining의 마지막 요소를 제거합니다.
6. remaining의 각 코드 포인트 c1에 대해 List의 역순으로 다음을 수행합니다.
  1. cs1을 c1을 포함하는 한 요소 CharSet으로 둡니다.
  2. m1을 CharacterSetMatcher(regexpRecord, cs1, false, direction)로 둡니다.
  3. m2를 MatchSequence(m1, m2, direction)로 설정합니다.
7. m2를 listOfMatchers에 추가합니다.
singles를 단일 문자로 구성된 cs의 모든 CharSetElement를 포함하는 CharSet으로 둡니다.
CharacterSetMatcher(regexpRecord, singles, false, direction)를 listOfMatchers에 추가합니다.
cs에 빈 문자 시퀀스가 포함되어 있으면 EmptyMatcher()를 listOfMatchers에 추가합니다.
m2를 listOfMatchers의 마지막 Matcher로 둡니다.
listOfMatchers의 각 Matcher m1에 대해 끝에서 두 번째 요소부터 역순으로 반복하며 다음을 수행합니다.
1. m2를 MatchTwoAlternatives(m1, m2)로 설정합니다.
m2를 반환합니다.

Atom

(

GroupSpecifier

opt

Disjunction

)

m을 인수 regexpRecord 및 direction을 사용한 Disjunction의 CompileSubpattern으로 둡니다.
parenIndex를 CountLeftCapturingParensBefore(Atom)로 둡니다.
direction, m 및 parenIndex를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, c)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: x는 MatchState입니다.
2. 단언: c는 MatcherContinuation입니다.
3. d를 x, c, direction 및 parenIndex를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (y)를 갖는 새로운 MatcherContinuation으로 둡니다:
  1. 단언: y는 MatchState입니다.
  2. capability를 y.[[Captures]]의 복사본으로 둡니다.
  3. input을 x.[[Input]]으로 둡니다.
  4. xe를 x.[[EndIndex]]로 둡니다.
  5. ye를 y.[[EndIndex]]로 둡니다.
  6. direction이 forward이면, 다음을 수행합니다.
    1. 단언: xe ≤ ye입니다.
    2. r을 CaptureRange { [[StartIndex]]: xe, [[EndIndex]]: ye }로 둡니다.
  7. 그렇지 않으면,
    1. 단언: direction은 backward입니다.
    2. 단언: ye ≤ xe입니다.
    3. r을 CaptureRange { [[StartIndex]]: ye, [[EndIndex]]: xe }로 둡니다.
  8. capability[parenIndex + 1]을 r로 설정합니다.
  9. z를 MatchState { [[Input]]: input, [[EndIndex]]: ye, [[Captures]]: capability }로 둡니다.
  10. c(z)를 반환합니다.
4. m(x, d)를 반환합니다.

참고 2

( Disjunction ) 형식의 괄호는 Disjunction 패턴의 구성 요소를 함께 그룹화하고 일치 결과를 저장하는 두 역할을 모두 합니다. 결과는 역참조(\ 뒤에 0이 아닌 십진수가 이어짐)에서 사용하거나, replace String에서 참조하거나, 정규 표현식 일치 Abstract Closure가 배열의 일부로 반환할 수 있습니다. 괄호의 캡처 동작을 억제하려면 대신 (?: Disjunction ) 형식을 사용하시기 바랍니다.

Atom

RegularExpressionModifiers

Disjunction

)

addModifiers를 RegularExpressionModifiers와 일치하는 소스 텍스트로 둡니다.
removeModifiers를 빈 String으로 둡니다.
modifiedRer를 UpdateModifiers(regexpRecord, CodePointsToString(addModifiers), removeModifiers)로 둡니다.
인수 modifiedRer 및 direction을 사용한 Disjunction의 CompileSubpattern을 반환합니다.

Atom

RegularExpressionModifiers

Disjunction

)

addModifiers를 첫 번째 RegularExpressionModifiers와 일치하는 소스 텍스트로 둡니다.
removeModifiers를 두 번째 RegularExpressionModifiers와 일치하는 소스 텍스트로 둡니다.
modifiedRer를 UpdateModifiers(regexpRecord, CodePointsToString(addModifiers), CodePointsToString(removeModifiers))로 둡니다.
인수 modifiedRer 및 direction을 사용한 Disjunction의 CompileSubpattern을 반환합니다.

AtomEscape

DecimalEscape

n을 DecimalEscape의 CapturingGroupNumber로 둡니다.
단언: n ≤ regexpRecord.[[CapturingGroupsCount]]입니다.
BackreferenceMatcher(regexpRecord, « n », direction)를 반환합니다.

참고 3

\ 뒤에 0이 아닌 십진수 n이 이어지는 형식의 이스케이프 시퀀스는 n^th 캡처링 괄호 집합(22.2.2.1)의 결과와 일치합니다. 정규 표현식에 캡처링 괄호가 n개보다 적으면 오류입니다. 정규 표현식에 캡처링 괄호가 n개 이상 있지만 n^th 괄호가 아무것도 캡처하지 않아 undefined이면 역참조는 항상 성공합니다.

AtomEscape

CharacterEscape

charValue를 CharacterEscape의 CharacterValue로 둡니다.
char를 문자 값이 charValue인 문자로 둡니다.
charSet을 문자 char를 포함하는 한 요소 CharSet으로 둡니다.
CharacterSetMatcher(regexpRecord, charSet, false, direction)를 반환합니다.

AtomEscape

CharacterClassEscape

cs를 인수 regexpRecord를 사용한 CharacterClassEscape의 CompileToCharSet으로 둡니다.
regexpRecord.[[UnicodeSets]]가 false이거나 cs의 모든 CharSetElement가 단일 문자로 구성되어 있으면(cs가 비어 있는 경우 포함) CharacterSetMatcher(regexpRecord, cs, false, direction)를 반환합니다.
listOfMatchers를 Matcher의 빈 List로 둡니다.
csSequences를 새로운 빈 List로 둡니다.
cs의 각 CharSetElement s에 대해 다음을 수행합니다.
1. s의 길이가 > 1이면 s를 csSequences에 추가합니다.
각 CharSetElement의 길이에 따라 csSequences를 내림차순으로 정렬합니다.
csSequences의 각 CharSetElement s에 대해 다음을 수행합니다.
1. 단언: s는 2개 이상의 코드 포인트 시퀀스입니다.
2. remaining을 s의 코드 포인트로 구성된 List로 둡니다.
3. cs2를 remaining의 마지막 요소를 포함하는 한 요소 CharSet으로 둡니다.
4. m2를 CharacterSetMatcher(regexpRecord, cs2, false, direction)로 둡니다.
5. remaining의 마지막 요소를 제거합니다.
6. remaining의 각 코드 포인트 c1에 대해 List의 역순으로 다음을 수행합니다.
  1. cs1을 c1을 포함하는 한 요소 CharSet으로 둡니다.
  2. m1을 CharacterSetMatcher(regexpRecord, cs1, false, direction)로 둡니다.
  3. m2를 MatchSequence(m1, m2, direction)로 설정합니다.
7. m2를 listOfMatchers에 추가합니다.
singles를 단일 문자로 구성된 cs의 모든 CharSetElement를 포함하는 CharSet으로 둡니다.
CharacterSetMatcher(regexpRecord, singles, false, direction)를 listOfMatchers에 추가합니다.
cs에 빈 문자 시퀀스가 포함되어 있으면 EmptyMatcher()를 listOfMatchers에 추가합니다.
m2를 listOfMatchers의 마지막 Matcher로 둡니다.
listOfMatchers의 각 Matcher m1에 대해 끝에서 두 번째 요소부터 역순으로 반복하며 다음을 수행합니다.
1. m2를 MatchTwoAlternatives(m1, m2)로 설정합니다.
m2를 반환합니다.

AtomEscape

GroupName

matchingGroupSpecifiers를 GroupSpecifiersThatMatch(GroupName)로 둡니다.
parenIndices를 새로운 빈 List로 둡니다.
matchingGroupSpecifiers의 각 GroupSpecifier groupSpecifier에 대해 다음을 수행합니다.
1. parenIndex를 CountLeftCapturingParensBefore(groupSpecifier)로 둡니다.
2. parenIndex를 parenIndices에 추가합니다.
BackreferenceMatcher(regexpRecord, parenIndices, direction)를 반환합니다.

22.2.2.7.1 CharacterSetMatcher ( `regexpRecord`, `charSet`, `invert`, `direction` )

추상 연산 CharacterSetMatcher. 인수 regexpRecord (RegExp 레코드), charSet (CharSet), invert (Boolean) 및 direction ((forward 또는 backward)). 반환값: Matcher. 호출되면 다음 단계를 수행한다.

regexpRecord.[[UnicodeSets]]가 true이면, 다음을 수행합니다.
1. 단언: invert는 false입니다.
2. 단언: charSet의 모든 CharSetElement는 단일 문자로 구성됩니다.
regexpRecord, charSet, invert 및 direction을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, c)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: x는 MatchState입니다.
2. 단언: c는 MatcherContinuation입니다.
3. input을 x.[[Input]]으로 둡니다.
4. endIndex를 x.[[EndIndex]]로 둡니다.
5. direction이 forward이면 f를 endIndex + 1로 둡니다.
6. 그렇지 않으면 f를 endIndex - 1로 둡니다.
7. inputLength를 input의 요소 수로 둡니다.
8. f < 0 또는 f > inputLength이면 failure를 반환합니다.
9. index를 min(endIndex, f)로 둡니다.
10. char를 문자 input[index]로 둡니다.
11. cc를 Canonicalize(regexpRecord, char)로 둡니다.
12. charSet에 정확히 하나의 문자 a를 포함하며 Canonicalize(regexpRecord, a)가 cc인 CharSetElement가 존재하면 found를 true로 둡니다. 그렇지 않으면 found를 false로 둡니다.
13. invert가 false이고 found가 false이면 failure를 반환합니다.
14. invert가 true이고 found가 true이면 failure를 반환합니다.
15. capability를 x.[[Captures]]로 둡니다.
16. y를 MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: capability }로 둡니다.
17. c(y)를 반환합니다.

22.2.2.7.2 BackreferenceMatcher ( `regexpRecord`, `ns`, `direction` )

추상 연산 BackreferenceMatcher. 인수 regexpRecord (RegExp 레코드), ns (리스트 (요소: 양의 정수)) 및 direction ((forward 또는 backward)). 반환값: Matcher. 호출되면 다음 단계를 수행한다.

regexpRecord, ns 및 direction을 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, c)를 갖는 새로운 Matcher를 반환합니다:
1. 단언: x는 MatchState입니다.
2. 단언: c는 MatcherContinuation입니다.
3. input을 x.[[Input]]으로 둡니다.
4. capability를 x.[[Captures]]로 둡니다.
5. r을 undefined로 둡니다.
6. ns의 각 정수 n에 대해 다음을 수행합니다.
  1. capability[n]이 undefined가 아니면, 다음을 수행합니다.
    1. 단언: r은 undefined입니다.
    2. r을 capability[n]으로 설정합니다.
7. r이 undefined이면 c(x)를 반환합니다.
8. endIndex를 x.[[EndIndex]]로 둡니다.
9. rs를 r.[[StartIndex]]로 둡니다.
10. re를 r.[[EndIndex]]로 둡니다.
11. length를 re - rs로 둡니다.
12. direction이 forward이면 f를 endIndex + length로 둡니다.
13. 그렇지 않으면 f를 endIndex - length로 둡니다.
14. inputLength를 input의 요소 수로 둡니다.
15. f < 0 또는 f > inputLength이면 failure를 반환합니다.
16. g를 min(endIndex, f)로 둡니다.
17. 0(포함)부터 length(제외)까지의 구간에 속하는 어떤 정수 i에 대해 Canonicalize(regexpRecord, input[rs + i])가 Canonicalize(regexpRecord, input[g + i])가 아니면 failure를 반환합니다.
18. y를 MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: capability }로 둡니다.
19. c(y)를 반환합니다.

22.2.2.7.3 Canonicalize ( `regexpRecord`, `char` )

추상 연산 Canonicalize. 인수 regexpRecord (RegExp 레코드) 및 char (문자). 반환값: 문자. 호출되면 다음 단계를 수행한다.

HasEitherUnicodeFlag(regexpRecord)이 true이고 regexpRecord.[[IgnoreCase]]가 true이면, 다음을 수행합니다.
1. Unicode Character Database의 CaseFolding.txt 파일이 char에 대한 단순 또는 공통 대소문자 폴딩 매핑을 제공하면 해당 매핑을 char에 적용한 결과를 반환합니다.
2. char를 반환합니다.
regexpRecord.[[IgnoreCase]]가 false이면 char를 반환합니다.
단언: char는 UTF-16 코드 단위입니다.
codePoint를 숫자 값이 char의 숫자 값인 코드 포인트로 둡니다.
mappedCodePoints를 Unicode Default Case Conversion 알고리즘에 따라 toUppercase(« codePoint »)로 둡니다.
CodePointsToString(mappedCodePoints)의 길이 ≠ 1이면 char를 반환합니다.
단언: mappedCodePoints의 요소 수는 1입니다.
mappedCodePoint를 mappedCodePoints의 유일한 코드 포인트 요소로 둡니다.
char의 숫자 값 ≥ 128이고 mappedCodePoint의 숫자 값 < 128이면 char를 반환합니다.
숫자 값이 mappedCodePoint의 숫자 값인 코드 단위를 반환합니다.

참고

HasEitherUnicodeFlag(regexpRecord)이 true인 대소문자 비구분 일치에서는 모든 문자를 비교하기 직전에 유니코드 표준이 제공하는 단순 매핑을 사용하여 암묵적으로 대소문자 폴딩합니다. 단순 매핑은 항상 하나의 코드 포인트로 매핑하므로 예를 들어 ß (U+00DF LATIN SMALL LETTER SHARP S)를 ss 또는 SS로 매핑하지 않습니다. 그러나 Basic Latin 블록 밖의 코드 포인트를 그 안의 코드 포인트로 매핑할 수 있습니다. 예를 들어 ſ (U+017F LATIN SMALL LETTER LONG S)는 s (U+0073 LATIN SMALL LETTER S)로 대소문자 폴딩되고 K (U+212A KELVIN SIGN)는 k (U+006B LATIN SMALL LETTER K)로 대소문자 폴딩됩니다. 이러한 코드 포인트를 포함하는 String은 /[a-z]/ui와 같은 정규 표현식과 일치합니다.

HasEitherUnicodeFlag(regexpRecord)이 false인 대소문자 비구분 일치에서는 매핑이 toCasefold가 아니라 Unicode Default Case Conversion 알고리즘의 toUppercase를 기반으로 하므로 미묘한 차이가 생깁니다. 예를 들어 Ω (U+2126 OHM SIGN)는 toUppercase에서 자기 자신으로 매핑되지만 toCasefold에서는 Ω (U+03A9 GREEK CAPITAL LETTER OMEGA)와 함께 ω (U+03C9 GREEK SMALL LETTER OMEGA)로 매핑되므로 "\u2126"은 /[ω]/ui 및 /[\u03A9]/ui와 일치하지만 /[ω]/i 또는 /[\u03A9]/i와는 일치하지 않습니다. 또한 Basic Latin 블록 밖의 어떤 코드 포인트도 그 안의 코드 포인트로 매핑되지 않으므로 "\u017F ſ" 및 "\u212A K"와 같은 String은 /[a-z]/i와 일치하지 않습니다.

22.2.2.7.4 UpdateModifiers ( `regexpRecord`, `add`, `remove` )

추상 연산 UpdateModifiers. 인수 regexpRecord (RegExp 레코드), add (String) 및 remove (String). 반환값: RegExp 레코드. 호출되면 다음 단계를 수행한다.

단언: add와 remove는 공통 요소를 갖지 않습니다.
ignoreCase를 regexpRecord.[[IgnoreCase]]로 둡니다.
multiline을 regexpRecord.[[Multiline]]으로 둡니다.
dotAll을 regexpRecord.[[DotAll]]로 둡니다.
unicode를 regexpRecord.[[Unicode]]로 둡니다.
unicodeSets를 regexpRecord.[[UnicodeSets]]로 둡니다.
capturingGroupsCount를 regexpRecord.[[CapturingGroupsCount]]로 둡니다.
remove에 "i"가 포함되어 있으면 ignoreCase를 false로 설정합니다.
그렇지 않고 add에 "i"가 포함되어 있으면 ignoreCase를 true로 설정합니다.
remove에 "m"이 포함되어 있으면 multiline을 false로 설정합니다.
그렇지 않고 add에 "m"이 포함되어 있으면 multiline을 true로 설정합니다.
remove에 "s"가 포함되어 있으면 dotAll을 false로 설정합니다.
그렇지 않고 add에 "s"가 포함되어 있으면 dotAll을 true로 설정합니다.
RegExp Record { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount }를 반환합니다.

22.2.2.8 Runtime Semantics: CompileCharacterClass

구문 지향 연산 CompileCharacterClass. 인수 regexpRecord (RegExp 레코드). 반환값: 레코드 (필드: [[CharSet]] (CharSet), [[Invert]] (Boolean)). 다음 생성 규칙별로 정의된다.

CharacterClass

[

ClassContents

]

charSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
Record { [[CharSet]]: charSet, [[Invert]]: false }를 반환합니다.

CharacterClass

ClassContents

]

charSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
regexpRecord.[[UnicodeSets]]가 true이면, 다음을 수행합니다.
1. Record { [[CharSet]]: CharacterComplement(regexpRecord, charSet), [[Invert]]: false }를 반환합니다.
Record { [[CharSet]]: charSet, [[Invert]]: true }를 반환합니다.

22.2.2.9 Runtime Semantics: CompileToCharSet

구문 지향 연산 CompileToCharSet. 인수 regexpRecord (RegExp 레코드). 반환값: CharSet.

참고 1

이 절은 B.1.2.8에서 수정됩니다.

다음 생성 규칙별로 정의된다.

ClassContents

[empty]

빈 CharSet을 반환합니다.

NonemptyClassRanges

ClassAtom

NonemptyClassRangesNoDash

charSet을 인수 regexpRecord를 사용한 ClassAtom의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 NonemptyClassRangesNoDash의 CompileToCharSet으로 둡니다.
CharSet charSet과 otherSet의 합집합을 반환합니다.

NonemptyClassRanges

ClassAtom

ClassContents

charSet을 인수 regexpRecord를 사용한 첫 번째 ClassAtom의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 두 번째 ClassAtom의 CompileToCharSet으로 둡니다.
remainingSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
rangeSet을 CharacterRange(charSet, otherSet)로 둡니다.
rangeSet과 remainingSet의 합집합을 반환합니다.

NonemptyClassRangesNoDash

ClassAtomNoDash

NonemptyClassRangesNoDash

charSet을 인수 regexpRecord를 사용한 ClassAtomNoDash의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 NonemptyClassRangesNoDash의 CompileToCharSet으로 둡니다.
CharSet charSet과 otherSet의 합집합을 반환합니다.

NonemptyClassRangesNoDash

ClassAtomNoDash

ClassAtom

ClassContents

charSet을 인수 regexpRecord를 사용한 ClassAtomNoDash의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 ClassAtom의 CompileToCharSet으로 둡니다.
remainingSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
rangeSet을 CharacterRange(charSet, otherSet)로 둡니다.
rangeSet과 remainingSet의 합집합을 반환합니다.

참고 2

ClassContents는 단일 ClassAtom 및/또는 하이픈으로 구분된 두 ClassAtom의 범위로 전개될 수 있습니다. 후자의 경우 ClassContents에는 첫 번째 ClassAtom과 두 번째 ClassAtom 사이의 모든 문자가 양 끝을 포함하여 들어갑니다. 어느 ClassAtom이든 단일 문자를 나타내지 않거나(예: 하나가 \w인 경우), 첫 번째 ClassAtom의 문자 값이 두 번째 ClassAtom의 문자 값보다 엄격하게 크면 오류가 발생합니다.

참고 3

패턴이 대소문자를 무시하더라도 범위의 양 끝에서 대소문자는 어떤 문자가 범위에 속하는지 결정할 때 중요합니다. 따라서 예를 들어 패턴 /[E-F]/i는 문자 E, F, e, f에만 일치하지만, 패턴 /[E-f]/i는 유니코드 Basic Latin 블록의 모든 대문자와 소문자뿐만 아니라 기호 [, \, ], ^, _ 및 `에도 일치합니다.

참고 4

- 문자는 리터럴로 취급할 수도 있고 범위를 나타낼 수도 있습니다. ClassContents의 첫 번째 또는 마지막 문자이거나, 범위 지정의 시작 또는 끝 경계이거나, 범위 지정 바로 뒤에 오는 경우 리터럴로 취급합니다.

ClassAtom

단일 문자 - U+002D (HYPHEN-MINUS)를 포함하는 CharSet을 반환합니다.

ClassAtomNoDash

SourceCharacter

but not one of \ or ] or -

SourceCharacter와 일치하는 문자를 포함하는 CharSet을 반환합니다.

ClassEscape

CharacterEscape

charValue를 이 ClassEscape의 CharacterValue로 둡니다.
char를 문자 값이 charValue인 문자로 둡니다.
단일 문자 char를 포함하는 CharSet을 반환합니다.

참고 5

ClassAtom은 \b, \B 및 역참조를 제외하고 정규 표현식의 나머지 부분에서 허용되는 모든 이스케이프 시퀀스를 사용할 수 있습니다. CharacterClass 안에서 \b는 백스페이스 문자를 의미하지만 \B와 역참조는 오류를 발생시킵니다. ClassAtom 안에서 역참조를 사용하면 오류가 발생합니다.

CharacterClassEscape

문자 0, 1, 2, 3, 4, 5, 6, 7, 8, 9를 포함하는 10요소 CharSet을 반환합니다.

CharacterClassEscape

charSet을 CharacterClassEscape :: d 가 반환한 CharSet으로 둡니다.
CharacterComplement(regexpRecord, charSet)를 반환합니다.

CharacterClassEscape

WhiteSpace 또는 LineTerminator 생성식의 오른쪽에 있는 코드 포인트에 대응하는 모든 문자를 포함하는 CharSet을 반환합니다.

CharacterClassEscape

charSet을 CharacterClassEscape :: s 가 반환한 CharSet으로 둡니다.
CharacterComplement(regexpRecord, charSet)를 반환합니다.

CharacterClassEscape

MaybeSimpleCaseFolding(regexpRecord, WordCharacters(regexpRecord))을 반환합니다.

CharacterClassEscape

charSet을 CharacterClassEscape :: w 가 반환한 CharSet으로 둡니다.
CharacterComplement(regexpRecord, charSet)를 반환합니다.

CharacterClassEscape

UnicodePropertyValueExpression

}

인수 regexpRecord를 사용한 UnicodePropertyValueExpression의 CompileToCharSet을 반환합니다.

CharacterClassEscape

UnicodePropertyValueExpression

}

charSet을 인수 regexpRecord를 사용한 UnicodePropertyValueExpression의 CompileToCharSet으로 둡니다.
단언: charSet은 단일 코드 포인트만 포함합니다.
CharacterComplement(regexpRecord, charSet)를 반환합니다.

UnicodePropertyValueExpression

UnicodePropertyName

UnicodePropertyValue

ps를 UnicodePropertyName과 일치하는 소스 텍스트로 둡니다.
p를 UnicodeMatchProperty(regexpRecord, ps)로 둡니다.
단언: p는 표 65의 “Property name and aliases” 열에 나열된 Unicode property name 또는 프로퍼티 별칭입니다.
vs를 UnicodePropertyValue와 일치하는 소스 텍스트로 둡니다.
v를 UnicodeMatchPropertyValue(p, vs)로 둡니다.
charSet을 문자 데이터베이스 정의에 값 v를 갖는 프로퍼티 p가 포함된 모든 유니코드 코드 포인트를 포함하는 CharSet으로 둡니다.
MaybeSimpleCaseFolding(regexpRecord, charSet)을 반환합니다.

UnicodePropertyValueExpression

LoneUnicodePropertyNameOrValue

s를 LoneUnicodePropertyNameOrValue과 일치하는 소스 텍스트로 둡니다.
UnicodeMatchPropertyValue(General_Category, s)가 PropertyValueAliases.txt에 나열된 General_Category (gc) 프로퍼티의 유니코드 프로퍼티 값 또는 프로퍼티 값 별칭이면, 다음을 수행합니다.
1. 문자 데이터베이스 정의에 값 s를 갖는 프로퍼티 “General_Category”가 포함된 모든 유니코드 코드 포인트를 포함하는 CharSet을 반환합니다.
p를 UnicodeMatchProperty(regexpRecord, s)로 둡니다.
단언: p는 표 66의 “Property name and aliases” 열에 나열된 이진 유니코드 프로퍼티 또는 이진 프로퍼티 별칭이거나, 표 67의 “Property name” 열에 나열된 문자열의 이진 유니코드 프로퍼티입니다.
charSet을 문자 데이터베이스 정의에 값 “True”를 갖는 프로퍼티 p가 포함된 모든 CharSetElement를 포함하는 CharSet으로 둡니다.
MaybeSimpleCaseFolding(regexpRecord, charSet)을 반환합니다.

ClassUnion

ClassSetRange

ClassUnion

opt

charSet을 인수 regexpRecord를 사용한 ClassSetRange의 CompileToCharSet으로 둡니다.
ClassUnion이 존재하면, 다음을 수행합니다.
1. otherSet을 인수 regexpRecord를 사용한 ClassUnion의 CompileToCharSet으로 둡니다.
2. CharSet charSet과 otherSet의 합집합을 반환합니다.
charSet을 반환합니다.

ClassUnion

ClassSetOperand

ClassUnion

opt

charSet을 인수 regexpRecord를 사용한 ClassSetOperand의 CompileToCharSet으로 둡니다.
ClassUnion이 존재하면, 다음을 수행합니다.
1. otherSet을 인수 regexpRecord를 사용한 ClassUnion의 CompileToCharSet으로 둡니다.
2. CharSet charSet과 otherSet의 합집합을 반환합니다.
charSet을 반환합니다.

ClassIntersection

ClassSetOperand

charSet을 인수 regexpRecord를 사용한 첫 번째 ClassSetOperand의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 두 번째 ClassSetOperand의 CompileToCharSet으로 둡니다.
CharSet charSet과 otherSet의 교집합을 반환합니다.

ClassIntersection

ClassSetOperand

charSet을 인수 regexpRecord를 사용한 ClassIntersection의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 ClassSetOperand의 CompileToCharSet으로 둡니다.
CharSet charSet과 otherSet의 교집합을 반환합니다.

ClassSubtraction

ClassSetOperand

charSet을 인수 regexpRecord를 사용한 첫 번째 ClassSetOperand의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 두 번째 ClassSetOperand의 CompileToCharSet으로 둡니다.
otherSet의 CharSetElement이기도 한 요소를 제외한 charSet의 CharSetElement를 포함하는 CharSet을 반환합니다.

ClassSubtraction

ClassSetOperand

charSet을 인수 regexpRecord를 사용한 ClassSubtraction의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 ClassSetOperand의 CompileToCharSet으로 둡니다.
otherSet의 CharSetElement이기도 한 요소를 제외한 charSet의 CharSetElement를 포함하는 CharSet을 반환합니다.

ClassSetRange

ClassSetCharacter

charSet을 인수 regexpRecord를 사용한 첫 번째 ClassSetCharacter의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 두 번째 ClassSetCharacter의 CompileToCharSet으로 둡니다.
MaybeSimpleCaseFolding(regexpRecord, CharacterRange(charSet, otherSet))을 반환합니다.

참고 6

결과는 흔히 둘 이상의 범위로 구성됩니다. UnicodeSets가 true이고 IgnoreCase가 true이면 MaybeSimpleCaseFolding(regexpRecord, [Ā-č])에는 해당 범위의 홀수 번호 코드 포인트만 포함됩니다.

ClassSetOperand

ClassSetCharacter

charSet을 인수 regexpRecord를 사용한 ClassSetCharacter의 CompileToCharSet으로 둡니다.
MaybeSimpleCaseFolding(regexpRecord, charSet)을 반환합니다.

ClassSetOperand

ClassStringDisjunction

charSet을 인수 regexpRecord를 사용한 ClassStringDisjunction의 CompileToCharSet으로 둡니다.
MaybeSimpleCaseFolding(regexpRecord, charSet)을 반환합니다.

ClassSetOperand

NestedClass

인수 regexpRecord를 사용한 NestedClass의 CompileToCharSet을 반환합니다.

NestedClass

[

ClassContents

]

인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet을 반환합니다.

NestedClass

ClassContents

]

charSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
CharacterComplement(regexpRecord, charSet)를 반환합니다.

NestedClass

CharacterClassEscape

인수 regexpRecord를 사용한 CharacterClassEscape의 CompileToCharSet을 반환합니다.

ClassStringDisjunction

\q{

ClassStringDisjunctionContents

}

인수 regexpRecord를 사용한 ClassStringDisjunctionContents의 CompileToCharSet을 반환합니다.

ClassStringDisjunctionContents

ClassString

s를 인수 regexpRecord를 사용한 ClassString의 CompileClassSetString으로 둡니다.
하나의 문자열 s를 포함하는 CharSet을 반환합니다.

ClassStringDisjunctionContents

ClassString

ClassStringDisjunctionContents

s를 인수 regexpRecord를 사용한 ClassString의 CompileClassSetString으로 둡니다.
charSet을 하나의 문자열 s를 포함하는 CharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 ClassStringDisjunctionContents의 CompileToCharSet으로 둡니다.
CharSet charSet과 otherSet의 합집합을 반환합니다.

ClassSetCharacter

SourceCharacter

but not ClassSetSyntaxCharacter

CharacterEscape

ClassSetReservedPunctuator

charValue를 이 ClassSetCharacter의 CharacterValue로 둡니다.
char를 문자 값이 charValue인 문자로 둡니다.
단일 문자 char를 포함하는 CharSet을 반환합니다.

ClassSetCharacter

단일 문자 U+0008 (BACKSPACE)을 포함하는 CharSet을 반환합니다.

22.2.2.9.1 CharacterRange ( `charSet`, `otherSet` )

추상 연산 CharacterRange. 인수 charSet (CharSet) 및 otherSet (CharSet). 반환값: CharSet. 호출되면 다음 단계를 수행한다.

단언: charSet과 otherSet은 각각 정확히 하나의 문자를 포함합니다.
a를 CharSet charSet의 유일한 문자로 둡니다.
b를 CharSet otherSet의 유일한 문자로 둡니다.
i를 문자 a의 문자 값으로 둡니다.
j를 문자 b의 문자 값으로 둡니다.
단언: i ≤ j입니다.
i부터 j까지의 폐구간에 속하는 문자 값을 갖는 모든 문자를 포함하는 CharSet을 반환합니다.

22.2.2.9.2 HasEitherUnicodeFlag ( `regexpRecord` )

추상 연산 HasEitherUnicodeFlag. 인수 regexpRecord (RegExp 레코드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

regexpRecord.[[Unicode]]가 true이거나 regexpRecord.[[UnicodeSets]]가 true이면 true를 반환합니다.
false를 반환합니다.

22.2.2.9.3 WordCharacters ( `regexpRecord` )

추상 연산 WordCharacters. 인수 regexpRecord (RegExp 레코드). 반환값: CharSet. \b, \B, \w 및 \W의 목적상 “단어 문자”로 간주되는 문자를 포함하는 CharSet을 반환합니다. 호출되면 다음 단계를 수행한다.

basicWordChars를 ASCII 단어 문자에 속하는 모든 문자를 포함하는 CharSet으로 둡니다.
extraWordChars를 basicWordChars에 속하지 않지만 Canonicalize(regexpRecord, c)가 basicWordChars에 속하는 모든 문자 c를 포함하는 CharSet으로 둡니다.
단언: HasEitherUnicodeFlag(regexpRecord)이 true이고 regexpRecord.[[IgnoreCase]]가 true인 경우를 제외하면 extraWordChars는 비어 있습니다.
basicWordChars와 extraWordChars의 합집합을 반환합니다.

22.2.2.9.4 AllCharacters ( `regexpRecord` )

추상 연산 AllCharacters. 인수 regexpRecord (RegExp 레코드). 반환값: CharSet. 정규 표현식 플래그에 따라 “모든 문자”의 집합을 반환합니다. 호출되면 다음 단계를 수행한다.

regexpRecord.[[UnicodeSets]]가 true이고 regexpRecord.[[IgnoreCase]]가 true이면, 다음을 수행합니다.
1. Simple Case Folding 매핑이 없는 모든 유니코드 코드 포인트 c(즉, scf(c)=c)를 포함하는 CharSet을 반환합니다.
HasEitherUnicodeFlag(regexpRecord)이 true이면, 다음을 수행합니다.
1. 모든 코드 포인트 값을 포함하는 CharSet을 반환합니다.
모든 코드 단위 값을 포함하는 CharSet을 반환합니다.

22.2.2.9.5 MaybeSimpleCaseFolding ( `regexpRecord`, `charSet` )

추상 연산 MaybeSimpleCaseFolding. 인수 regexpRecord (RegExp 레코드) 및 charSet (CharSet). 반환값: CharSet. regexpRecord.[[UnicodeSets]]가 false이거나 regexpRecord.[[IgnoreCase]]가 false이면 charSet을 반환합니다. 그렇지 않으면 Unicode Character Database의 CaseFolding.txt 파일에 있는 Simple Case Folding (scf(codePoint)) 정의(각각 단일 코드 포인트를 다른 단일 코드 포인트로 매핑함)를 사용하여 charSet의 각 CharSetElement를 문자별로 정규 형식으로 매핑하고 결과 CharSet을 반환합니다. 호출되면 다음 단계를 수행한다.

regexpRecord.[[UnicodeSets]]가 false이거나 regexpRecord.[[IgnoreCase]]가 false이면 charSet을 반환합니다.
otherSet을 새로운 빈 CharSet으로 둡니다.
charSet의 각 CharSetElement s에 대해 다음을 수행합니다.
1. t를 빈 문자 시퀀스로 둡니다.
2. s의 각 단일 코드 포인트 codePoint에 대해 다음을 수행합니다.
  1. scf(codePoint)를 t에 추가합니다.
3. t를 otherSet에 추가합니다.
otherSet을 반환합니다.

22.2.2.9.6 CharacterComplement ( `regexpRecord`, `complement` )

추상 연산 CharacterComplement. 인수 regexpRecord (RegExp 레코드) 및 complement (CharSet). 반환값: CharSet. 호출되면 다음 단계를 수행한다.

charSet을 AllCharacters(regexpRecord)로 둡니다.
complement의 CharSetElement이기도 한 요소를 제외한 charSet의 CharSetElement를 포함하는 CharSet을 반환합니다.

22.2.2.9.7 UnicodeMatchProperty ( `regexpRecord`, `p` )

추상 연산 UnicodeMatchProperty. 인수 regexpRecord (RegExp 레코드) 및 p (ECMAScript 소스 텍스트). 반환값: a Unicode property name. 호출되면 다음 단계를 수행한다.

regexpRecord.[[UnicodeSets]]가 true이고 p가 표 67의 “Property name” 열에 나열된 Unicode property name이면, 다음을 수행합니다.
1. 유니코드 코드 포인트의 List p를 반환합니다.
단언: p는 표 65 또는 표 66의 “Property name and aliases” 열에 나열된 Unicode property name 또는 프로퍼티 별칭입니다.
c를 해당 행의 “Canonical property name” 열에 제시된 p의 정규 property name으로 둡니다.
유니코드 코드 포인트의 List c를 반환합니다.

구현체는 표 65, 표 66 및 표 67에 나열된 Unicode property name과 별칭을 지원해야 합니다. 상호 운용성을 보장하기 위해 구현체는 다른 어떤 property name이나 별칭도 지원해서는 안 됩니다.

참고 1

예를 들어 Script_Extensions(property name)와 scx(프로퍼티 별칭)는 유효하지만 script_extensions 또는 Scx는 유효하지 않습니다.

참고 2

나열된 프로퍼티는 UTS18 RL1.2가 요구하는 것의 상위 집합을 구성합니다.

참고 3

이 표의 항목 철자(대소문자 포함)는 Unicode Character Database의 PropertyAliases.txt 파일에서 사용하는 철자와 일치합니다. 해당 파일의 정확한 철자는 안정적으로 유지됨이 보장됩니다.

표 65: Non-binary Unicode property aliases and their canonical property names

Property name and aliases	Canonical property name
`General_Category`	`General_Category`
`gc`	`General_Category`
`Script`	`Script`
`sc`	`Script`
`Script_Extensions`	`Script_Extensions`
`scx`	`Script_Extensions`

표 66: Binary Unicode property aliases and their canonical property names

Property name and aliases	Canonical property name
`ASCII`	`ASCII`
`ASCII_Hex_Digit`	`ASCII_Hex_Digit`
`AHex`	`ASCII_Hex_Digit`
`Alphabetic`	`Alphabetic`
`Alpha`	`Alphabetic`
`Any`	`Any`
`Assigned`	`Assigned`
`Bidi_Control`	`Bidi_Control`
`Bidi_C`	`Bidi_Control`
`Bidi_Mirrored`	`Bidi_Mirrored`
`Bidi_M`	`Bidi_Mirrored`
`Case_Ignorable`	`Case_Ignorable`
`CI`	`Case_Ignorable`
`Cased`	`Cased`
`Changes_When_Casefolded`	`Changes_When_Casefolded`
`CWCF`	`Changes_When_Casefolded`
`Changes_When_Casemapped`	`Changes_When_Casemapped`
`CWCM`	`Changes_When_Casemapped`
`Changes_When_Lowercased`	`Changes_When_Lowercased`
`CWL`	`Changes_When_Lowercased`
`Changes_When_NFKC_Casefolded`	`Changes_When_NFKC_Casefolded`
`CWKCF`	`Changes_When_NFKC_Casefolded`
`Changes_When_Titlecased`	`Changes_When_Titlecased`
`CWT`	`Changes_When_Titlecased`
`Changes_When_Uppercased`	`Changes_When_Uppercased`
`CWU`	`Changes_When_Uppercased`
`Dash`	`Dash`
`Default_Ignorable_Code_Point`	`Default_Ignorable_Code_Point`
`DI`	`Default_Ignorable_Code_Point`
`Deprecated`	`Deprecated`
`Dep`	`Deprecated`
`Diacritic`	`Diacritic`
`Dia`	`Diacritic`
`Emoji`	`Emoji`
`Emoji_Component`	`Emoji_Component`
`EComp`	`Emoji_Component`
`Emoji_Modifier`	`Emoji_Modifier`
`EMod`	`Emoji_Modifier`
`Emoji_Modifier_Base`	`Emoji_Modifier_Base`
`EBase`	`Emoji_Modifier_Base`
`Emoji_Presentation`	`Emoji_Presentation`
`EPres`	`Emoji_Presentation`
`Extended_Pictographic`	`Extended_Pictographic`
`ExtPict`	`Extended_Pictographic`
`Extender`	`Extender`
`Ext`	`Extender`
`Grapheme_Base`	`Grapheme_Base`
`Gr_Base`	`Grapheme_Base`
`Grapheme_Extend`	`Grapheme_Extend`
`Gr_Ext`	`Grapheme_Extend`
`Hex_Digit`	`Hex_Digit`
`Hex`	`Hex_Digit`
`IDS_Binary_Operator`	`IDS_Binary_Operator`
`IDSB`	`IDS_Binary_Operator`
`IDS_Trinary_Operator`	`IDS_Trinary_Operator`
`IDST`	`IDS_Trinary_Operator`
`ID_Continue`	`ID_Continue`
`IDC`	`ID_Continue`
`ID_Start`	`ID_Start`
`IDS`	`ID_Start`
`Ideographic`	`Ideographic`
`Ideo`	`Ideographic`
`Join_Control`	`Join_Control`
`Join_C`	`Join_Control`
`Logical_Order_Exception`	`Logical_Order_Exception`
`LOE`	`Logical_Order_Exception`
`Lowercase`	`Lowercase`
`Lower`	`Lowercase`
`Math`	`Math`
`Noncharacter_Code_Point`	`Noncharacter_Code_Point`
`NChar`	`Noncharacter_Code_Point`
`Pattern_Syntax`	`Pattern_Syntax`
`Pat_Syn`	`Pattern_Syntax`
`Pattern_White_Space`	`Pattern_White_Space`
`Pat_WS`	`Pattern_White_Space`
`Quotation_Mark`	`Quotation_Mark`
`QMark`	`Quotation_Mark`
`Radical`	`Radical`
`Regional_Indicator`	`Regional_Indicator`
`RI`	`Regional_Indicator`
`Sentence_Terminal`	`Sentence_Terminal`
`STerm`	`Sentence_Terminal`
`Soft_Dotted`	`Soft_Dotted`
`SD`	`Soft_Dotted`
`Terminal_Punctuation`	`Terminal_Punctuation`
`Term`	`Terminal_Punctuation`
`Unified_Ideograph`	`Unified_Ideograph`
`UIdeo`	`Unified_Ideograph`
`Uppercase`	`Uppercase`
`Upper`	`Uppercase`
`Variation_Selector`	`Variation_Selector`
`VS`	`Variation_Selector`
`White_Space`	`White_Space`
`space`	`White_Space`
`XID_Continue`	`XID_Continue`
`XIDC`	`XID_Continue`
`XID_Start`	`XID_Start`
`XIDS`	`XID_Start`

표 67: Binary Unicode properties of strings

Property name
`Basic_Emoji`
`Emoji_Keycap_Sequence`
`RGI_Emoji_Modifier_Sequence`
`RGI_Emoji_Flag_Sequence`
`RGI_Emoji_Tag_Sequence`
`RGI_Emoji_ZWJ_Sequence`
`RGI_Emoji`

22.2.2.9.8 UnicodeMatchPropertyValue ( `p`, `v` )

추상 연산 UnicodeMatchPropertyValue. 인수 p (ECMAScript 소스 텍스트) 및 v (ECMAScript 소스 텍스트). 반환값: a Unicode property value. 호출되면 다음 단계를 수행한다.

단언: p는 표 65의 “Canonical property name” 열에 나열된 정규이며 별칭이 아닌 Unicode property name입니다.
단언: v는 PropertyValueAliases.txt에 나열된 유니코드 프로퍼티 p의 프로퍼티 값 또는 프로퍼티 값 별칭입니다.
value를 해당 행의 “Canonical property value” 열에 제시된 v의 정규 프로퍼티 값으로 둡니다.
유니코드 코드 포인트의 List value를 반환합니다.

구현체는 표 65에 나열된 프로퍼티에 대해 PropertyValueAliases.txt에 나열된 유니코드 프로퍼티 값 및 프로퍼티 값 별칭을 지원해야 합니다. 상호 운용성을 보장하기 위해 구현체는 다른 프로퍼티 값이나 프로퍼티 값 별칭을 지원해서는 안 됩니다.

참고 1

예를 들어 Xpeo와 Old_Persian은 유효한 Script_Extensions 값이지만 xpeo와 Old Persian은 유효하지 않습니다.

참고 2

이 알고리즘은 UAX44에 나열된 기호 값의 일치 규칙과 다릅니다. 대소문자, 공백, U+002D (HYPHEN-MINUS) 및 U+005F (LOW LINE)는 무시되지 않으며 Is 접두사는 지원되지 않습니다.

22.2.2.10 Runtime Semantics: CompileClassSetString

구문 지향 연산 CompileClassSetString. 인수 regexpRecord (RegExp 레코드). 반환값: a sequence of characters. 다음 생성 규칙별로 정의된다.

ClassString

[empty]

빈 문자 시퀀스를 반환합니다.

ClassString

NonEmptyClassString

인수 regexpRecord를 사용한 NonEmptyClassString의 CompileClassSetString을 반환합니다.

NonEmptyClassString

ClassSetCharacter

NonEmptyClassString

opt

cs를 인수 regexpRecord를 사용한 ClassSetCharacter의 CompileToCharSet으로 둡니다.
s1을 cs의 유일한 CharSetElement인 문자 시퀀스로 둡니다.
NonEmptyClassString이 존재하면, 다음을 수행합니다.
1. s2를 인수 regexpRecord를 사용한 NonEmptyClassString의 CompileClassSetString으로 둡니다.
2. s1과 s2의 연결을 반환합니다.
s1을 반환합니다.

22.2.3 RegExp 생성을 위한 추상 연산

22.2.3.1 RegExpCreate ( `pattern`, `flags` )

추상 연산 RegExpCreate. 인수 pattern (ECMAScript 언어 값) 및 flags ((String 또는 undefined)). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

obj를 ! RegExpAlloc(%RegExp%)로 둡니다.
? RegExpInitialize(obj, pattern, flags)를 반환합니다.

22.2.3.2 RegExpAlloc ( `newTarget` )

추상 연산 RegExpAlloc. 인수 newTarget (생성자). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

obj를 ? OrdinaryCreateFromConstructor(newTarget, "%RegExp.prototype%", « [[OriginalSource]], [[OriginalFlags]], [[RegExpRecord]], [[RegExpMatcher]] »)로 둡니다.
! DefinePropertyOrThrow(obj, "lastIndex", PropertyDescriptor { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })를 수행합니다.
obj를 반환합니다.

22.2.3.3 RegExpInitialize ( `obj`, `pattern`, `flags` )

추상 연산 RegExpInitialize. 인수 obj (Object), pattern (ECMAScript 언어 값) 및 flags (ECMAScript 언어 값). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

pattern이 undefined이면 pattern을 빈 String으로 설정합니다.
그렇지 않으면 pattern을 ? ToString(pattern)으로 설정합니다.
flags가 undefined이면 flags를 빈 String으로 설정합니다.
그렇지 않으면 flags를 ? ToString(flags)으로 설정합니다.
flags에 "d", "g", "i", "m", "s", "u", "v" 또는 "y" 이외의 코드 단위가 포함되어 있으면 SyntaxError 예외를 던집니다.
flags에 어떤 코드 단위가 두 번 이상 포함되어 있으면 SyntaxError 예외를 던집니다.
flags에 "i"가 포함되어 있으면 i를 true로 둡니다. 그렇지 않으면 i를 false로 둡니다.
flags에 "m"이 포함되어 있으면 m을 true로 둡니다. 그렇지 않으면 m을 false로 둡니다.
flags에 "s"가 포함되어 있으면 s를 true로 둡니다. 그렇지 않으면 s를 false로 둡니다.
flags에 "u"가 포함되어 있으면 u를 true로 둡니다. 그렇지 않으면 u를 false로 둡니다.
flags에 "v"가 포함되어 있으면 v를 true로 둡니다. 그렇지 않으면 v를 false로 둡니다.
u가 true이거나 v가 true이면, 다음을 수행합니다.
1. patternText를 StringToCodePoints(pattern)로 둡니다.
그렇지 않으면,
1. patternText를 pattern의 각 16비트 요소를 유니코드 BMP 코드 포인트로 해석한 결과로 둡니다. 요소에는 UTF-16 디코딩을 적용하지 않습니다.
parseResult를 ParsePattern(patternText, u, v)로 둡니다.
parseResult가 SyntaxError 객체의 비어 있지 않은 List이면 SyntaxError 예외를 던집니다.
단언: parseResult는 Pattern Parse Node입니다.
obj.[[OriginalSource]]를 pattern으로 설정합니다.
obj.[[OriginalFlags]]를 flags로 설정합니다.
capturingGroupsCount를 CountLeftCapturingParensWithin(parseResult)로 둡니다.
regexpRecord를 RegExp Record { [[IgnoreCase]]: i, [[Multiline]]: m, [[DotAll]]: s, [[Unicode]]: u, [[UnicodeSets]]: v, [[CapturingGroupsCount]]: capturingGroupsCount }로 둡니다.
obj.[[RegExpRecord]]를 regexpRecord로 설정합니다.
obj.[[RegExpMatcher]]를 인수 regexpRecord를 사용한 parseResult의 CompilePattern으로 설정합니다.
? Set(obj, "lastIndex", +0_𝔽, true)를 수행합니다.
obj를 반환합니다.

22.2.3.4 Static Semantics: ParsePattern ( `patternText`, `u`, `v` )

추상 연산 ParsePattern. 인수 patternText (a sequence of Unicode code points), u (Boolean) 및 v (Boolean). 반환값: (구문 분석 노드 또는 a non-empty List of SyntaxError objects).

참고

이 절은 B.1.2.9에서 수정됩니다.

호출되면 다음 단계를 수행한다.

v가 true이고 u가 true이면, 다음을 수행합니다.
1. parseResult를 하나 이상의 SyntaxError 객체를 포함하는 List로 둡니다.
그렇지 않고 v가 true이면, 다음을 수행합니다.
1. parseResult를 ParseText(patternText, Pattern[+UnicodeMode, +UnicodeSetsMode, +NamedCaptureGroups])로 둡니다.
그렇지 않고 u가 true이면, 다음을 수행합니다.
1. parseResult를 ParseText(patternText, Pattern[+UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups])로 둡니다.
그렇지 않으면,
1. parseResult를 ParseText(patternText, Pattern[~UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups])로 둡니다.
parseResult를 반환합니다.

22.2.4 RegExp 생성자

RegExp 생성자는:

%RegExp%입니다.
전역 객체의 "RegExp" 프로퍼티 초기 값입니다.
생성자로 호출되면 새로운 RegExp 객체를 생성하고 초기화합니다.
생성자가 아니라 함수로 호출되면 새로운 RegExp 객체를 반환하거나, 유일한 인수가 RegExp 객체이면 해당 인수 자체를 반환합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 명시된 RegExp 동작을 상속하려는 하위 클래스 생성자는 필요한 내부 슬롯을 갖는 하위 클래스 인스턴스를 생성하고 초기화하기 위해 RegExp 생성자에 대한 super 호출을 포함해야 합니다.

22.2.4.1 RegExp ( `patternOrRegexp`, `flags` )

이 함수는 호출되면 다음 단계를 수행합니다:

patternIsRegExp를 ? IsRegExp(patternOrRegexp)로 둡니다.
NewTarget이 undefined이면, 다음을 수행합니다.
1. newTarget을 활성 함수 객체로 둡니다.
2. patternIsRegExp가 true이고 flags가 undefined이면, 다음을 수행합니다.
  1. patternCtor를 ? Get(patternOrRegexp, "constructor")로 둡니다.
  2. SameValue(newTarget, patternCtor)가 true이면 patternOrRegexp를 반환합니다.
그렇지 않으면,
1. newTarget을 NewTarget으로 둡니다.
patternOrRegexp가 Object이고 patternOrRegexp에 [[RegExpMatcher]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. patternSource를 patternOrRegexp.[[OriginalSource]]로 둡니다.
2. flags가 undefined이면 flags를 patternOrRegexp.[[OriginalFlags]]로 설정합니다.
그렇지 않고 patternIsRegExp가 true이면, 다음을 수행합니다.
1. patternSource를 ? Get(patternOrRegexp, "source")로 둡니다.
2. flags가 undefined이면, 다음을 수행합니다.
  1. flags를 ? Get(patternOrRegexp, "flags")로 설정합니다.
그렇지 않으면,
1. patternSource를 patternOrRegexp로 둡니다.
obj를 ? RegExpAlloc(newTarget)로 둡니다.
? RegExpInitialize(obj, patternSource, flags)를 반환합니다.

참고

pattern이 StringLiteral을 사용하여 제공되면 String이 이 함수에 의해 처리되기 전에 일반적인 이스케이프 시퀀스 치환이 수행됩니다. 이 함수가 인식해야 하는 이스케이프 시퀀스를 pattern에 포함해야 한다면, StringLiteral의 내용이 형성될 때 U+005C (REVERSE SOLIDUS) 코드 포인트가 제거되지 않도록 StringLiteral 안에서 이를 이스케이프해야 합니다.

22.2.5 RegExp 생성자의 프로퍼티

RegExp 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

22.2.5.1 RegExp.escape ( `string` )

이 함수는 정규 표현식 Pattern에서 특별할 가능성이 있는 문자를 동등한 이스케이프 시퀀스로 대체한 string의 복사본을 반환합니다.

호출되면 다음 단계를 수행합니다:

string이 String이 아니면 TypeError 예외를 던집니다.
escaped를 빈 String으로 둡니다.
codePointList를 StringToCodePoints(string)로 둡니다.
codePointList의 각 코드 포인트 codePoint에 대해 다음을 수행합니다.
1. escaped가 빈 String이고 codePoint가 DecimalDigit 또는 AsciiLetter 중 하나와 일치하면, 다음을 수행합니다.
  1. 참고: 선행 숫자를 이스케이프하면 출력이 \0 문자 이스케이프나 \1 같은 DecimalEscape 뒤에 사용될 수 있는 패턴 텍스트에 대응하면서도, 앞선 이스케이프 시퀀스의 확장으로 해석되는 대신 string과 일치하도록 보장합니다. 선행 ASCII 문자를 이스케이프하는 것도 \c 뒤의 문맥에 대해 동일한 역할을 합니다.
  2. numericValue를 codePoint의 숫자 값으로 둡니다.
  3. hex를 Number::toString(𝔽(numericValue), 16)으로 둡니다.
  4. 단언: hex의 길이는 2입니다.
  5. escaped를 코드 단위 0x005C (REVERSE SOLIDUS), "x" 및 hex의 문자열 연결로 설정합니다.
2. 그렇지 않으면,
  1. escaped를 escaped와 EncodeForRegExpEscape(codePoint)의 문자열 연결로 설정합니다.
escaped를 반환합니다.

참고

이름은 비슷하지만 EscapeRegExpPattern과 RegExp.escape는 비슷한 동작을 수행하지 않습니다. 전자는 문자열로 표현하기 위해 패턴을 이스케이프하고, 이 함수는 패턴 안에 표현하기 위해 문자열을 이스케이프합니다.

22.2.5.1.1 EncodeForRegExpEscape ( `codePoint` )

추상 연산 EncodeForRegExpEscape. 인수 codePoint (코드 포인트). 반환값: String. codePoint와 일치하는 Pattern을 나타내는 String을 반환합니다. codePoint가 공백 또는 ASCII 문장 부호이면 반환 값은 이스케이프 시퀀스입니다. 그렇지 않으면 반환 값은 codePoint 자체의 String 표현입니다. 호출되면 다음 단계를 수행한다.

codePoint가 SyntaxCharacter와 일치하거나 codePoint가 U+002F (SOLIDUS)이면, 다음을 수행합니다.
1. 0x005C (REVERSE SOLIDUS)와 UTF16EncodeCodePoint(codePoint)의 문자열 연결을 반환합니다.
codePoint가 표 63의 “Code Point” 열에 나열된 코드 포인트이면, 다음을 수행합니다.
1. 0x005C (REVERSE SOLIDUS)와 “Code Point” 열에 codePoint가 포함된 행의 “ControlEscape” 열 문자열의 문자열 연결을 반환합니다.
otherPunctuators를 ",-=<>#&!%:;@~'`"와 코드 단위 0x0022 (QUOTATION MARK)의 문자열 연결로 둡니다.
toEscape를 StringToCodePoints(otherPunctuators)로 둡니다.
toEscape에 codePoint가 포함되어 있거나, codePoint가 WhiteSpace 또는 LineTerminator 중 하나와 일치하거나, codePoint가 선행 서로게이트 또는 후행 서로게이트와 동일한 숫자 값을 가지면, 다음을 수행합니다.
1. codePointNumber를 codePoint의 숫자 값으로 둡니다.
2. codePointNumber ≤ 0xFF이면, 다음을 수행합니다.
  1. hex를 Number::toString(𝔽(codePointNumber), 16)으로 둡니다.
  2. 코드 단위 0x005C (REVERSE SOLIDUS), "x" 및 StringPad(hex, 2, "0", start)의 문자열 연결을 반환합니다.
3. escaped를 빈 String으로 둡니다.
4. codeUnits를 UTF16EncodeCodePoint(codePoint)로 둡니다.
5. codeUnits의 각 코드 단위 codeUnit에 대해 다음을 수행합니다.
  1. escaped를 escaped와 UnicodeEscape(codeUnit)의 문자열 연결로 설정합니다.
6. escaped를 반환합니다.
UTF16EncodeCodePoint(codePoint)를 반환합니다.

22.2.5.2 RegExp.prototype

RegExp.prototype의 초기 값은 RegExp 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

22.2.5.3 get RegExp [ %Symbol.species% ]

RegExp[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

RegExp 프로토타입 메서드는 일반적으로 this 값의 생성자를 사용하여 파생 객체를 생성합니다. 그러나 하위 클래스 생성자는 자신의 %Symbol.species% 프로퍼티를 재정의하여 이 기본 동작을 재정의할 수 있습니다.

22.2.6 RegExp 프로토타입 객체의 프로퍼티

RegExp 프로토타입 객체는:

%RegExp.prototype%입니다.
일반 객체입니다.
RegExp 인스턴스가 아니며 [[RegExpMatcher]] 내부 슬롯 또는 RegExp 인스턴스 객체의 다른 어떤 내부 슬롯도 갖지 않습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

참고

RegExp 프로토타입 객체는 자체 "valueOf" 프로퍼티를 갖지 않습니다. 그러나 Object 프로토타입 객체에서 "valueOf" 프로퍼티를 상속합니다.

22.2.6.1 RegExp.prototype.constructor

RegExp.prototype.constructor의 초기 값은 %RegExp%입니다.

22.2.6.2 RegExp.prototype.exec ( `string` )

이 메서드는 string에서 정규 표현식 패턴의 출현을 검색하고 일치 결과를 포함하는 Array를 반환하며, string이 일치하지 않으면 null을 반환합니다.

호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
? RequireInternalSlot(regexp, [[RegExpMatcher]])를 수행합니다.
string을 ? ToString(string)으로 설정합니다.
? RegExpBuiltinExec(regexp, string)를 반환합니다.

22.2.6.3 get RegExp.prototype.dotAll

RegExp.prototype.dotAll은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0073 (LATIN SMALL LETTER S)으로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.4 get RegExp.prototype.flags

RegExp.prototype.flags는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
codeUnits를 새로운 빈 List로 둡니다.
hasIndices를 ToBoolean(? Get(regexp, "hasIndices"))로 둡니다.
hasIndices가 true이면 코드 단위 0x0064 (LATIN SMALL LETTER D)를 codeUnits에 추가합니다.
global을 ToBoolean(? Get(regexp, "global"))로 둡니다.
global이 true이면 코드 단위 0x0067 (LATIN SMALL LETTER G)를 codeUnits에 추가합니다.
ignoreCase를 ToBoolean(? Get(regexp, "ignoreCase"))로 둡니다.
ignoreCase가 true이면 코드 단위 0x0069 (LATIN SMALL LETTER I)를 codeUnits에 추가합니다.
multiline을 ToBoolean(? Get(regexp, "multiline"))로 둡니다.
multiline이 true이면 코드 단위 0x006D (LATIN SMALL LETTER M)를 codeUnits에 추가합니다.
dotAll을 ToBoolean(? Get(regexp, "dotAll"))로 둡니다.
dotAll이 true이면 코드 단위 0x0073 (LATIN SMALL LETTER S)를 codeUnits에 추가합니다.
unicode를 ToBoolean(? Get(regexp, "unicode"))로 둡니다.
unicode가 true이면 코드 단위 0x0075 (LATIN SMALL LETTER U)를 codeUnits에 추가합니다.
unicodeSets를 ToBoolean(? Get(regexp, "unicodeSets"))로 둡니다.
unicodeSets가 true이면 코드 단위 0x0076 (LATIN SMALL LETTER V)를 codeUnits에 추가합니다.
sticky를 ToBoolean(? Get(regexp, "sticky"))로 둡니다.
sticky가 true이면 코드 단위 0x0079 (LATIN SMALL LETTER Y)를 codeUnits에 추가합니다.
코드 단위가 List codeUnits의 요소인 String 값을 반환합니다. codeUnits에 요소가 없으면 빈 String을 반환합니다.

22.2.6.4.1 RegExpHasFlag ( `regexp`, `codeUnit` )

추상 연산 RegExpHasFlag. 인수 regexp (ECMAScript 언어 값) 및 codeUnit (코드 단위). 반환값: (정상 완료 (값: (Boolean 또는 undefined)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

regexp가 Object가 아니면 TypeError 예외를 던집니다.
regexp에 [[OriginalFlags]] 내부 슬롯이 없으면, 다음을 수행합니다.
1. SameValue(regexp, %RegExp.prototype%)가 true이면 undefined를 반환합니다.
2. TypeError 예외를 던집니다.
flags를 regexp.[[OriginalFlags]]로 둡니다.
flags에 codeUnit이 포함되어 있으면 true를 반환합니다.
false를 반환합니다.

22.2.6.5 get RegExp.prototype.global

RegExp.prototype.global은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0067 (LATIN SMALL LETTER G)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.6 get RegExp.prototype.hasIndices

RegExp.prototype.hasIndices는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0064 (LATIN SMALL LETTER D)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.7 get RegExp.prototype.ignoreCase

RegExp.prototype.ignoreCase는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0069 (LATIN SMALL LETTER I)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( `string` )

이 메서드는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
string을 ? ToString(string)으로 설정합니다.
flags를 ? ToString(? Get(regexp, "flags"))로 둡니다.
flags에 "g"가 포함되어 있지 않으면 ? RegExpExec(regexp, string)를 반환합니다.
flags에 "u" 또는 "v"가 포함되어 있으면 fullUnicode를 true로 둡니다. 그렇지 않으면 fullUnicode를 false로 둡니다.
? Set(regexp, "lastIndex", +0_𝔽, true)를 수행합니다.
array를 ! ArrayCreate(0)으로 둡니다.
matchCount를 0으로 둡니다.
다음을 반복합니다.
1. result를 ? RegExpExec(regexp, string)로 둡니다.
2. result가 null이면, 다음을 수행합니다.
  1. matchCount = 0이면 null을 반환합니다.
  2. array를 반환합니다.
3. matchString을 ? ToString(? Get(result, "0"))로 둡니다.
4. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(matchCount)), matchString)을 수행합니다.
5. matchString이 빈 String이면, 다음을 수행합니다.
  1. thisIndex를 ℝ(? ToLength(? Get(regexp, "lastIndex")))로 둡니다.
  2. nextIndex를 AdvanceStringIndex(string, thisIndex, fullUnicode)로 둡니다.
  3. ? Set(regexp, "lastIndex", 𝔽(nextIndex), true)를 수행합니다.
6. matchCount를 matchCount + 1로 설정합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.match]"입니다.

참고

%Symbol.match% 프로퍼티는 IsRegExp 추상 연산이 정규 표현식의 기본 동작을 갖는 객체를 식별하는 데 사용합니다. %Symbol.match% 프로퍼티가 없거나 해당 프로퍼티의 값이 Boolean으로 강제 변환되어 true가 되지 않으면 해당 객체는 정규 표현식 객체로 사용하도록 의도되지 않은 것입니다.

22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( `string` )

이 메서드는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
string을 ? ToString(string)으로 설정합니다.
speciesCtor를 ? SpeciesConstructor(regexp, %RegExp%)로 둡니다.
flags를 ? ToString(? Get(regexp, "flags"))로 둡니다.
matcher를 ? Construct(speciesCtor, « regexp, flags »)로 둡니다.
lastIndex를 ? ToLength(? Get(regexp, "lastIndex"))로 둡니다.
? Set(matcher, "lastIndex", lastIndex, true)를 수행합니다.
flags에 "g"가 포함되어 있으면 global을 true로 둡니다.
그렇지 않으면 global을 false로 둡니다.
flags에 "u" 또는 "v"가 포함되어 있으면 fullUnicode를 true로 둡니다.
그렇지 않으면 fullUnicode를 false로 둡니다.
CreateRegExpStringIterator(matcher, string, global, fullUnicode)를 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.matchAll]"입니다.

22.2.6.10 get RegExp.prototype.multiline

RegExp.prototype.multiline은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x006D (LATIN SMALL LETTER M)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( `string`, `replaceValue` )

이 메서드는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
string을 ? ToString(string)으로 설정합니다.
stringLength를 string의 길이로 둡니다.
functionalReplace를 IsCallable(replaceValue)로 둡니다.
functionalReplace가 false이면, 다음을 수행합니다.
1. replaceValue를 ? ToString(replaceValue)으로 설정합니다.
flags를 ? ToString(? Get(regexp, "flags"))로 둡니다.
flags에 "g"가 포함되어 있으면 global을 true로 둡니다. 그렇지 않으면 global을 false로 둡니다.
global이 true이면, 다음을 수행합니다.
1. ? Set(regexp, "lastIndex", +0_𝔽, true)를 수행합니다.
results를 새로운 빈 List로 둡니다.
done을 false로 둡니다.
done이 false인 동안 다음을 반복합니다.
1. result를 ? RegExpExec(regexp, string)로 둡니다.
2. result가 null이면, 다음을 수행합니다.
  1. done을 true로 설정합니다.
3. 그렇지 않으면,
  1. result를 results에 추가합니다.
  2. global이 false이면, 다음을 수행합니다.
    1. done을 true로 설정합니다.
  3. 그렇지 않으면,
    1. matchString을 ? ToString(? Get(result, "0"))로 둡니다.
    2. matchString이 빈 String이면, 다음을 수행합니다.
      1. thisIndex를 ℝ(? ToLength(? Get(regexp, "lastIndex")))로 둡니다.
      2. flags에 "u" 또는 "v"가 포함되어 있으면 fullUnicode를 true로 둡니다. 그렇지 않으면 fullUnicode를 false로 둡니다.
      3. nextIndex를 AdvanceStringIndex(string, thisIndex, fullUnicode)로 둡니다.
      4. ? Set(regexp, "lastIndex", 𝔽(nextIndex), true)를 수행합니다.
accumulatedResult를 빈 String으로 둡니다.
nextSourcePosition을 0으로 둡니다.
results의 각 요소 result에 대해 다음을 수행합니다.
1. resultLength를 ? LengthOfArrayLike(result)로 둡니다.
2. capturesCount를 max(resultLength - 1, 0)으로 둡니다.
3. matched를 ? ToString(? Get(result, "0"))로 둡니다.
4. matchLength를 matched의 길이로 둡니다.
5. position을 ? ToIntegerOrInfinity(? Get(result, "index"))로 둡니다.
6. position을 position을 0과 stringLength 사이로 제한한 결과로 설정합니다.
7. captures를 새로운 빈 List로 둡니다.
8. captureNumber를 1로 둡니다.
9. captureNumber ≤ capturesCount인 동안 다음을 반복합니다.
  1. capture를 ? Get(result, ! ToString(𝔽(captureNumber)))로 둡니다.
  2. capture가 undefined가 아니면, 다음을 수행합니다.
    1. capture를 ? ToString(capture)으로 설정합니다.
  3. capture를 captures에 추가합니다.
  4. 참고: captureNumber = 1일 때 앞선 단계는 첫 번째 요소를 captures(인덱스 0)에 넣습니다. 더 일반적으로 captureNumber^th 캡처(captureNumber^th 캡처링 괄호 집합이 캡처한 문자)는 captures[captureNumber - 1]에 있습니다.
  5. captureNumber를 captureNumber + 1로 설정합니다.
10. namedCaptures를 ? Get(result, "groups")로 둡니다.
11. functionalReplace가 true이면, 다음을 수행합니다.
  1. replacerArgs를 « matched », captures 및 « 𝔽(position), string »의 목록 연결로 둡니다.
  2. namedCaptures가 undefined가 아니면, 다음을 수행합니다.
    1. namedCaptures를 replacerArgs에 추가합니다.
  3. replacementValue를 ? Call(replaceValue, undefined, replacerArgs)로 둡니다.
  4. replacementString을 ? ToString(replacementValue)으로 둡니다.
12. 그렇지 않으면,
  1. namedCaptures가 undefined가 아니면, 다음을 수행합니다.
    1. namedCaptures를 ? ToObject(namedCaptures)로 설정합니다.
  2. replacementString을 ? GetSubstitution(matched, string, position, captures, namedCaptures, replaceValue)로 둡니다.
13. position ≥ nextSourcePosition이면, 다음을 수행합니다.
  1. 참고: position은 일반적으로 뒤로 이동해서는 안 됩니다. 뒤로 이동하면 잘못 동작하는 RegExp 하위 클래스 또는 접근 시 발생하는 부수 효과를 이용하여 regexp의 global 플래그나 다른 특성을 변경한 것을 나타냅니다. 이러한 경우 대응하는 치환은 무시됩니다.
  2. accumulatedResult를 accumulatedResult, string의 nextSourcePosition부터 position까지의 부분 문자열 및 replacementString의 문자열 연결로 설정합니다.
  3. nextSourcePosition을 position + matchLength로 설정합니다.
nextSourcePosition ≥ stringLength이면 accumulatedResult를 반환합니다.
accumulatedResult와 string의 nextSourcePosition부터의 부분 문자열의 문자열 연결을 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.replace]"입니다.

22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( `string` )

이 메서드는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
string을 ? ToString(string)으로 설정합니다.
previousLastIndex를 ? Get(regexp, "lastIndex")로 둡니다.
previousLastIndex가 +0_𝔽이 아니면, 다음을 수행합니다.
1. ? Set(regexp, "lastIndex", +0_𝔽, true)를 수행합니다.
result를 ? RegExpExec(regexp, string)로 둡니다.
currentLastIndex를 ? Get(regexp, "lastIndex")로 둡니다.
SameValue(currentLastIndex, previousLastIndex)가 false이면, 다음을 수행합니다.
1. ? Set(regexp, "lastIndex", previousLastIndex, true)를 수행합니다.
result가 null이면 -1_𝔽을 반환합니다.
? Get(result, "index")를 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.search]"입니다.

참고

검색을 수행할 때 이 RegExp 객체의 "lastIndex" 및 "global" 프로퍼티는 무시됩니다. "lastIndex" 프로퍼티는 변경되지 않은 채 유지됩니다.

22.2.6.13 get RegExp.prototype.source

RegExp.prototype.source는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
regexp에 [[OriginalSource]] 내부 슬롯이 없으면, 다음을 수행합니다.
1. SameValue(regexp, %RegExp.prototype%)가 true이면 "(?:)"를 반환합니다.
2. TypeError 예외를 던집니다.
단언: regexp에는 [[OriginalFlags]] 내부 슬롯이 있습니다.
source를 regexp.[[OriginalSource]]로 둡니다.
flags를 regexp.[[OriginalFlags]]로 둡니다.
EscapeRegExpPattern(source, flags)을 반환합니다.

22.2.6.13.1 EscapeRegExpPattern ( `pattern`, `flags` )

추상 연산 EscapeRegExpPattern. 인수 pattern (String) 및 flags (String). 반환값: String. 호출되면 다음 단계를 수행한다.

flags에 "v"가 포함되어 있으면, 다음을 수행합니다.
1. patternSymbol을 Pattern[+UnicodeMode, +UnicodeSetsMode]로 둡니다.
그렇지 않고 flags에 "u"가 포함되어 있으면, 다음을 수행합니다.
1. patternSymbol을 Pattern[+UnicodeMode, ~UnicodeSetsMode]로 둡니다.
그렇지 않으면,
1. patternSymbol을 Pattern[~UnicodeMode, ~UnicodeSetsMode]로 둡니다.
escapedPattern을 UTF-16 인코딩 유니코드 코드 포인트(6.1.4)로 해석된 pattern과 동등한 patternSymbol 형식의 String으로 둡니다. 여기서 특정 코드 포인트는 아래 설명에 따라 이스케이프됩니다. escapedPattern은 pattern과 다를 수도 있고 다르지 않을 수도 있습니다. 그러나 escapedPattern을 patternSymbol로 평가하여 생성되는 Abstract Closure는 생성된 객체의 [[RegExpMatcher]] 내부 슬롯이 제공하는 Abstract Closure와 동일하게 동작해야 합니다. 동일한 pattern 및 flags 값으로 이 추상 연산을 여러 번 호출하면 동일한 결과를 생성해야 합니다.
패턴에 나타나는 코드 포인트 / 또는 모든 LineTerminator는 "/", escapedPattern, "/" 및 flags의 문자열 연결이 (적절한 어휘 문맥에서) 생성된 정규 표현식과 동일하게 동작하는 RegularExpressionLiteral로 파싱될 수 있도록 필요한 경우 escapedPattern에서 이스케이프해야 합니다. 예를 들어 pattern이 "/"이면 escapedPattern은 여러 가능성 중 "\/" 또는 "\u002F"일 수 있지만 "/"일 수는 없습니다. flags 뒤의 ///는 RegularExpressionLiteral이 아니라 SingleLineComment로 파싱되기 때문입니다. pattern이 빈 String이면 escapedPattern을 "(?:)"로 두어 이 명세를 충족할 수 있습니다.
escapedPattern을 반환합니다.

참고

이름은 비슷하지만 RegExp.escape와 EscapeRegExpPattern은 비슷한 동작을 수행하지 않습니다. 전자는 패턴 안에 표현하기 위해 문자열을 이스케이프하고, 이 함수는 문자열로 표현하기 위해 패턴을 이스케이프합니다.

22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( `string`, `limit` )

참고 1

이 메서드는 string을 String으로 변환한 결과의 부분 문자열을 저장한 Array를 반환합니다. 부분 문자열은 왼쪽에서 오른쪽으로 this 값 정규 표현식의 일치를 검색하여 결정됩니다. 이러한 출현은 반환되는 배열의 어떤 String에도 포함되지 않고 String 값을 나누는 역할을 합니다.

this 값은 빈 정규 표현식 또는 빈 String과 일치할 수 있는 정규 표현식일 수 있습니다. 이 경우 정규 표현식은 입력 String의 시작이나 끝에 있는 빈 부분 문자열과 일치하지 않으며 이전 구분자 일치의 끝에 있는 빈 부분 문자열과도 일치하지 않습니다. (예를 들어 정규 표현식이 빈 String과 일치하면 String은 개별 코드 단위 요소로 분할됩니다. 결과 배열의 길이는 String의 길이와 같고 각 부분 문자열에는 하나의 코드 단위가 포함됩니다.) 백트래킹을 통해 해당 인덱스에서 비어 있지 않은 부분 문자열 일치를 얻을 수 있더라도 String의 특정 인덱스에서는 첫 번째 일치만 고려합니다. (예를 들어 /a*?/[Symbol.split]("ab")는 배열 ["a", "b"]로 평가되지만 /a*/[Symbol.split]("ab")는 배열 ["","b"]로 평가됩니다.)

string이 빈 String이거나 빈 String으로 변환되는 경우 결과는 정규 표현식이 빈 String과 일치할 수 있는지에 따라 달라집니다. 일치할 수 있으면 결과 배열에는 요소가 없습니다. 그렇지 않으면 결과 배열에는 빈 String인 하나의 요소가 있습니다.

정규 표현식에 캡처링 괄호가 포함되어 있으면 separator가 일치할 때마다 캡처링 괄호의 결과(undefined 결과 포함)가 출력 배열에 삽입됩니다. 예를 들어,

/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")

는 다음 배열로 평가됩니다.

["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]

limit가 undefined가 아니면 출력 배열은 limit개보다 많은 요소를 포함하지 않도록 잘립니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
string을 ? ToString(string)으로 설정합니다.
speciesCtor를 ? SpeciesConstructor(regexp, %RegExp%)로 둡니다.
flags를 ? ToString(? Get(regexp, "flags"))로 둡니다.
flags에 "u" 또는 "v"가 포함되어 있으면 unicodeMatching을 true로 둡니다.
그렇지 않으면 unicodeMatching을 false로 둡니다.
flags에 "y"가 포함되어 있으면 newFlags를 flags로 둡니다.
그렇지 않으면 newFlags를 flags와 "y"의 문자열 연결로 둡니다.
splitter를 ? Construct(speciesCtor, « regexp, newFlags »)로 둡니다.
array를 ! ArrayCreate(0)으로 둡니다.
lengthA를 0으로 둡니다.
limit가 undefined이면 lim을 2³² - 1로 둡니다. 그렇지 않으면 lim을 ℝ(? ToUint32(limit))로 둡니다.
lim = 0이면 array를 반환합니다.
string이 빈 String이면, 다음을 수행합니다.
1. matchResult를 ? RegExpExec(splitter, string)로 둡니다.
2. matchResult가 null이 아니면 array를 반환합니다.
3. ! CreateDataPropertyOrThrow(array, "0", string)을 수행합니다.
4. array를 반환합니다.
size를 string의 길이로 둡니다.
lastMatchEnd를 0으로 둡니다.
searchIndex를 lastMatchEnd로 둡니다.
searchIndex < size인 동안 다음을 반복합니다.
1. ? Set(splitter, "lastIndex", 𝔽(searchIndex), true)를 수행합니다.
2. matchResult를 ? RegExpExec(splitter, string)로 둡니다.
3. matchResult가 null이면, 다음을 수행합니다.
  1. searchIndex를 AdvanceStringIndex(string, searchIndex, unicodeMatching)로 설정합니다.
4. 그렇지 않으면,
  1. matchEnd를 ℝ(? ToLength(? Get(splitter, "lastIndex")))로 둡니다.
  2. matchEnd를 min(matchEnd, size)로 설정합니다.
  3. matchEnd = lastMatchEnd이면, 다음을 수행합니다.
    1. searchIndex를 AdvanceStringIndex(string, searchIndex, unicodeMatching)로 설정합니다.
  4. 그렇지 않으면,
    1. substring을 string의 lastMatchEnd부터 searchIndex까지의 부분 문자열로 둡니다.
    2. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(lengthA)), substring)을 수행합니다.
    3. lengthA를 lengthA + 1로 설정합니다.
    4. lengthA = lim이면 array를 반환합니다.
    5. lastMatchEnd를 matchEnd로 설정합니다.
    6. numberOfCaptures를 ? LengthOfArrayLike(matchResult)로 둡니다.
    7. numberOfCaptures를 max(numberOfCaptures - 1, 0)으로 설정합니다.
    8. captureIndex를 1로 둡니다.
    9. captureIndex ≤ numberOfCaptures인 동안 다음을 반복합니다.
      1. nextCapture를 ? Get(matchResult, ! ToString(𝔽(captureIndex)))로 둡니다.
      2. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(lengthA)), nextCapture)를 수행합니다.
      3. captureIndex를 captureIndex + 1로 설정합니다.
      4. lengthA를 lengthA + 1로 설정합니다.
      5. lengthA = lim이면 array를 반환합니다.
    10. searchIndex를 lastMatchEnd로 설정합니다.
substring을 string의 lastMatchEnd부터 size까지의 부분 문자열로 둡니다.
! CreateDataPropertyOrThrow(array, ! ToString(𝔽(lengthA)), substring)을 수행합니다.
array를 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.split]"입니다.

참고 2

이 메서드는 이 RegExp 객체의 "global" 및 "sticky" 프로퍼티 값을 무시합니다.

22.2.6.15 get RegExp.prototype.sticky

RegExp.prototype.sticky는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0079 (LATIN SMALL LETTER Y)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.16 RegExp.prototype.test ( `string` )

이 메서드는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
string을 ? ToString(string)으로 설정합니다.
match를 ? RegExpExec(regexp, string)로 둡니다.
match가 null이면 false를 반환합니다.
true를 반환합니다.

22.2.6.17 RegExp.prototype.toString ( )

regexp를 this 값으로 둡니다.
regexp가 Object가 아니면 TypeError 예외를 던집니다.
pattern을 ? ToString(? Get(regexp, "source"))로 둡니다.
flags를 ? ToString(? Get(regexp, "flags"))로 둡니다.
result를 "/", pattern, "/" 및 flags의 문자열 연결로 둡니다.
result를 반환합니다.

참고

반환된 String은 이 객체와 동일한 동작을 하는 다른 RegExp 객체로 평가되는 RegularExpressionLiteral 형식을 갖습니다.

22.2.6.18 get RegExp.prototype.unicode

RegExp.prototype.unicode는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0075 (LATIN SMALL LETTER U)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.6.19 get RegExp.prototype.unicodeSets

RegExp.prototype.unicodeSets는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

regexp를 this 값으로 둡니다.
codeUnit을 코드 단위 0x0076 (LATIN SMALL LETTER V)로 둡니다.
? RegExpHasFlag(regexp, codeUnit)를 반환합니다.

22.2.7 RegExp 일치를 위한 추상 연산

22.2.7.1 RegExpExec ( `regexp`, `string` )

추상 연산 RegExpExec. 인수 regexp (Object) 및 string (String). 반환값: (정상 완료 (값: (Object 또는 null)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

exec을 ? Get(regexp, "exec")로 둡니다.
IsCallable(exec)이 true이면, 다음을 수행합니다.
1. result를 ? Call(exec, regexp, « string »)로 둡니다.
2. result가 Object가 아니고 result가 null도 아니면 TypeError 예외를 던집니다.
3. result를 반환합니다.
? RequireInternalSlot(regexp, [[RegExpMatcher]])를 수행합니다.
? RegExpBuiltinExec(regexp, string)를 반환합니다.

참고

호출 가능한 "exec" 프로퍼티를 찾지 못하면 이 알고리즘은 내장 RegExp 일치 알고리즘 사용을 시도하는 방식으로 대체합니다. 이는 정규 표현식을 사용하는 대부분의 내장 알고리즘이 "exec"의 동적 프로퍼티 조회를 수행하지 않았던 이전 판을 위해 작성된 코드와 호환되는 동작을 제공합니다.

22.2.7.2 RegExpBuiltinExec ( `regexp`, `string` )

추상 연산 RegExpBuiltinExec. 인수 regexp (an initialized RegExp instance) 및 string (String). 반환값: (정상 완료 (값: (Array 특수 객체 또는 null)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
lastIndex를 ℝ(? ToLength(! Get(regexp, "lastIndex")))로 둡니다.
flags를 regexp.[[OriginalFlags]]로 둡니다.
flags에 "g"가 포함되어 있으면 global을 true로 둡니다. 그렇지 않으면 global을 false로 둡니다.
flags에 "y"가 포함되어 있으면 sticky를 true로 둡니다. 그렇지 않으면 sticky를 false로 둡니다.
flags에 "d"가 포함되어 있으면 hasIndices를 true로 둡니다. 그렇지 않으면 hasIndices를 false로 둡니다.
global이 false이고 sticky가 false이면 lastIndex를 0으로 설정합니다.
matcher를 regexp.[[RegExpMatcher]]로 둡니다.
flags에 "u" 또는 "v"가 포함되어 있으면 fullUnicode를 true로 둡니다. 그렇지 않으면 fullUnicode를 false로 둡니다.
matchSucceeded를 false로 둡니다.
fullUnicode가 true이면 input을 StringToCodePoints(string)로 둡니다. 그렇지 않으면 input을 string의 요소인 코드 단위로 구성된 List로 둡니다.
참고: input의 각 요소는 문자로 간주됩니다.
matchSucceeded가 false인 동안 다음을 반복합니다.
1. lastIndex > length이면, 다음을 수행합니다.
  1. global이 true이거나 sticky가 true이면, 다음을 수행합니다.
    1. ? Set(regexp, "lastIndex", +0_𝔽, true)를 수행합니다.
  2. null을 반환합니다.
2. inputIndex를 string의 요소 lastIndex에서 얻은 문자의 input 안의 인덱스로 둡니다.
3. result를 matcher(input, inputIndex)로 둡니다.
4. result가 failure이면, 다음을 수행합니다.
  1. sticky가 true이면, 다음을 수행합니다.
    1. ? Set(regexp, "lastIndex", +0_𝔽, true)를 수행합니다.
    2. null을 반환합니다.
  2. lastIndex를 AdvanceStringIndex(string, lastIndex, fullUnicode)로 설정합니다.
5. 그렇지 않으면,
  1. 단언: result는 MatchState입니다.
  2. matchSucceeded를 true로 설정합니다.
endIndex를 result.[[EndIndex]]로 둡니다.
fullUnicode가 true이면 endIndex를 GetStringIndex(string, endIndex)로 설정합니다.
global이 true이거나 sticky가 true이면, 다음을 수행합니다.
1. ? Set(regexp, "lastIndex", 𝔽(endIndex), true)를 수행합니다.
capturingGroupsCount를 result.[[Captures]]의 요소 수로 둡니다.
단언: capturingGroupsCount = regexp.[[RegExpRecord]].[[CapturingGroupsCount]]입니다.
단언: capturingGroupsCount < 2³² - 1입니다.
array를 ! ArrayCreate(capturingGroupsCount + 1)로 둡니다.
단언: array의 "length" 프로퍼티의 수학적 값은 capturingGroupsCount + 1입니다.
! CreateDataPropertyOrThrow(array, "index", 𝔽(lastIndex))를 수행합니다.
! CreateDataPropertyOrThrow(array, "input", string)을 수행합니다.
match를 Match Record { [[StartIndex]]: lastIndex, [[EndIndex]]: endIndex }로 둡니다.
indices를 새로운 빈 List로 둡니다.
groupNames를 새로운 빈 List로 둡니다.
match를 indices에 추가합니다.
matchedSubstring을 GetMatchString(string, match)으로 둡니다.
! CreateDataPropertyOrThrow(array, "0", matchedSubstring)을 수행합니다.
regexp에 어떤 GroupName이라도 포함되어 있으면, 다음을 수행합니다.
1. groups를 OrdinaryObjectCreate(null)로 둡니다.
2. hasGroups를 true로 둡니다.
그렇지 않으면,
1. groups를 undefined로 둡니다.
2. hasGroups를 false로 둡니다.
! CreateDataPropertyOrThrow(array, "groups", groups)를 수행합니다.
matchedGroupNames를 새로운 빈 List로 둡니다.
1 ≤ i ≤ capturingGroupsCount를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
1. capture를 result.[[Captures]]의 i^th 요소로 둡니다.
2. capture가 undefined이면, 다음을 수행합니다.
  1. capturedValue를 undefined로 둡니다.
  2. undefined를 indices에 추가합니다.
3. 그렇지 않으면,
  1. captureStart를 capture.[[StartIndex]]로 둡니다.
  2. captureEnd를 capture.[[EndIndex]]로 둡니다.
  3. fullUnicode가 true이면, 다음을 수행합니다.
    1. captureStart를 GetStringIndex(string, captureStart)로 설정합니다.
    2. captureEnd를 GetStringIndex(string, captureEnd)로 설정합니다.
  4. captureRecord를 Match Record { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd }로 둡니다.
  5. capturedValue를 GetMatchString(string, captureRecord)으로 둡니다.
  6. captureRecord를 indices에 추가합니다.
4. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(i)), capturedValue)를 수행합니다.
5. regexp의 i^th 캡처가 GroupName으로 정의되어 있으면, 다음을 수행합니다.
  1. groupName을 해당 GroupName의 CapturingGroupName으로 둡니다.
  2. matchedGroupNames에 groupName이 포함되어 있으면, 다음을 수행합니다.
    1. 단언: capturedValue는 undefined입니다.
    2. undefined를 groupNames에 추가합니다.
  3. 그렇지 않으면,
    1. capturedValue가 undefined가 아니면 groupName을 matchedGroupNames에 추가합니다.
    2. 참고: 이름이 groupName인 그룹이 여러 개 있으면 이 시점에 groups가 이미 groupName 프로퍼티를 가질 수 있습니다. 그러나 groups는 모든 프로퍼티가 쓰기 가능한 데이터 프로퍼티인 일반 객체이므로 CreateDataPropertyOrThrow 호출은 그럼에도 반드시 성공합니다.
    3. ! CreateDataPropertyOrThrow(groups, groupName, capturedValue)를 수행합니다.
    4. groupName을 groupNames에 추가합니다.
6. 그렇지 않으면,
  1. undefined를 groupNames에 추가합니다.
hasIndices가 true이면, 다음을 수행합니다.
1. indicesArray를 MakeMatchIndicesIndexPairArray(string, indices, groupNames, hasGroups)로 둡니다.
2. ! CreateDataPropertyOrThrow(array, "indices", indicesArray)를 수행합니다.
array를 반환합니다.

22.2.7.3 AdvanceStringIndex ( `string`, `index`, `unicode` )

추상 연산 AdvanceStringIndex. 인수 string (String), index (음이 아닌 정수) 및 unicode (Boolean). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

단언: index ≤ 2⁵³ - 1입니다.
unicode가 false이면 index + 1을 반환합니다.
length를 string의 길이로 둡니다.
index + 1 ≥ length이면 index + 1을 반환합니다.
codePoint를 CodePointAt(string, index)로 둡니다.
index + codePoint.[[CodeUnitCount]]를 반환합니다.

22.2.7.4 GetStringIndex ( `string`, `codePointIndex` )

추상 연산 GetStringIndex. 인수 string (String) 및 codePointIndex (음이 아닌 정수). 반환값: 음이 아닌 정수. 6.1.4에 설명된 대로 string을 UTF-16 인코딩 코드 포인트 시퀀스로 해석하고, 해당 인덱스가 존재하면 코드 포인트 인덱스 codePointIndex에 대응하는 코드 단위 인덱스를 반환합니다. 그렇지 않으면 string의 길이를 반환합니다. 호출되면 다음 단계를 수행한다.

string이 빈 String이면 0을 반환합니다.
length를 string의 길이로 둡니다.
codeUnitCount를 0으로 둡니다.
codePointCount를 0으로 둡니다.
codeUnitCount < length인 동안 다음을 반복합니다.
1. codePointCount = codePointIndex이면 codeUnitCount를 반환합니다.
2. codePoint를 CodePointAt(string, codeUnitCount)로 둡니다.
3. codeUnitCount를 codeUnitCount + codePoint.[[CodeUnitCount]]로 설정합니다.
4. codePointCount를 codePointCount + 1로 설정합니다.
length를 반환합니다.

22.2.7.5 Match Record

Match Record는 정규 표현식 일치 또는 캡처의 시작 및 끝 인덱스를 캡슐화하는 데 사용하는 Record입니다.

Match Record에는 표 68에 나열된 필드가 있습니다.

표 68: Match Record 필드

필드 이름	값	의미
`[[StartIndex]]`	a non-negative integer	일치가 시작하는 문자열의 시작부터의 코드 단위 수(포함)입니다.
`[[EndIndex]]`	an integer ≥ `[[StartIndex]]`	일치가 끝나는 문자열의 시작부터의 코드 단위 수(제외)입니다.

22.2.7.6 GetMatchString ( `string`, `match` )

추상 연산 GetMatchString. 인수 string (String) 및 match (Match 레코드). 반환값: String. 호출되면 다음 단계를 수행한다.

단언: match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ string의 길이입니다.
string의 match.[[StartIndex]]부터 match.[[EndIndex]]까지의 부분 문자열을 반환합니다.

22.2.7.7 GetMatchIndexPair ( `string`, `match` )

추상 연산 GetMatchIndexPair. 인수 string (String) 및 match (Match 레코드). 반환값: Array. 호출되면 다음 단계를 수행한다.

단언: match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ string의 길이입니다.
CreateArrayFromList(« 𝔽(match.[[StartIndex]]), 𝔽(match.[[EndIndex]]) »)를 반환합니다.

22.2.7.8 MakeMatchIndicesIndexPairArray ( `string`, `indices`, `groupNames`, `hasGroups` )

추상 연산 MakeMatchIndicesIndexPairArray. 인수 string (String), indices (리스트 (요소: (Match 레코드 또는 undefined))), groupNames (리스트 (요소: (String 또는 undefined))) 및 hasGroups (Boolean). 반환값: Array. 호출되면 다음 단계를 수행한다.

n을 indices의 요소 수로 둡니다.
단언: n < 2³² - 1입니다.
단언: groupNames에는 n - 1개의 요소가 있습니다.
참고: groupNames List에는 indices[1]부터 indices List와 정렬된 요소가 포함되어 있습니다.
array를 ! ArrayCreate(n)으로 둡니다.
hasGroups가 true이면, 다음을 수행합니다.
1. groups를 OrdinaryObjectCreate(null)로 둡니다.
그렇지 않으면,
1. groups를 undefined로 둡니다.
! CreateDataPropertyOrThrow(array, "groups", groups)를 수행합니다.
0 ≤ i < n을 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
1. matchIndices를 indices[i]로 둡니다.
2. matchIndices가 undefined가 아니면, 다음을 수행합니다.
  1. matchIndexPair를 GetMatchIndexPair(string, matchIndices)로 둡니다.
3. 그렇지 않으면,
  1. matchIndexPair를 undefined로 둡니다.
4. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(i)), matchIndexPair)를 수행합니다.
5. i > 0이면, 다음을 수행합니다.
  1. name을 groupNames[i - 1]로 둡니다.
  2. name이 undefined가 아니면, 다음을 수행합니다.
    1. 단언: groups는 undefined가 아닙니다.
    2. 참고: 이름이 name인 그룹이 여러 개 있으면 이 시점에 groups가 이미 name 프로퍼티를 가질 수 있습니다. 그러나 groups는 모든 프로퍼티가 쓰기 가능한 데이터 프로퍼티인 일반 객체이므로 CreateDataPropertyOrThrow 호출은 그럼에도 반드시 성공합니다.
    3. ! CreateDataPropertyOrThrow(groups, name, matchIndexPair)를 수행합니다.
array를 반환합니다.

22.2.8 RegExp 인스턴스의 프로퍼티

RegExp 인스턴스는 RegExp 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. RegExp 인스턴스에는 [[OriginalSource]], [[OriginalFlags]], [[RegExpRecord]] 및 [[RegExpMatcher]] 내부 슬롯이 있습니다. [[RegExpMatcher]] 내부 슬롯의 값은 RegExp 객체의 Pattern을 나타내는 Abstract Closure입니다.

참고

ECMAScript 2015 이전에는 RegExp 인스턴스가 자체 데이터 프로퍼티 "source", "global", "ignoreCase" 및 "multiline"을 갖는 것으로 명시되었습니다. 이러한 프로퍼티는 이제 RegExp.prototype의 접근자 프로퍼티로 명시됩니다.

RegExp 인스턴스에는 다음 프로퍼티도 있습니다:

22.2.8.1 lastIndex

"lastIndex" 프로퍼티의 값은 다음 일치를 시작할 String 인덱스를 지정합니다. 사용될 때 정수 Number로 강제 변환됩니다(22.2.7.2 참조). 이 프로퍼티는 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false } 속성을 가져야 합니다.

22.2.9 RegExp String Iterator 객체

RegExp String Iterator는 특정 RegExp 인스턴스 객체에 대해 일치시키면서 특정 String 인스턴스 객체를 특정 방식으로 순회하는 객체입니다. RegExp String Iterator 객체에는 이름 있는 생성자가 없습니다. 대신 RegExp String Iterator 객체는 RegExp 인스턴스 객체의 특정 메서드를 호출하여 생성됩니다.

22.2.9.1 CreateRegExpStringIterator ( `regexp`, `string`, `global`, `fullUnicode` )

추상 연산 CreateRegExpStringIterator. 인수 regexp (Object), string (String), global (Boolean) 및 fullUnicode (Boolean). 반환값: Object. 호출되면 다음 단계를 수행한다.

iterator를 OrdinaryObjectCreate(%RegExpStringIteratorPrototype%, « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] »)로 둡니다.
iterator.[[IteratingRegExp]]를 regexp로 설정합니다.
iterator.[[IteratedString]]을 string으로 설정합니다.
iterator.[[Global]]을 global로 설정합니다.
iterator.[[Unicode]]를 fullUnicode로 설정합니다.
iterator.[[Done]]을 false로 설정합니다.
iterator를 반환합니다.

22.2.9.2 %RegExpStringIteratorPrototype% 객체

%RegExpStringIteratorPrototype% 객체는:

모든 RegExp String Iterator 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

22.2.9.2.1 %RegExpStringIteratorPrototype%.next ( )

iteratorObj를 this 값으로 둡니다.
iteratorObj가 Object가 아니면 TypeError 예외를 던집니다.
iteratorObj가 RegExp String Iterator Object Instance의 모든 내부 슬롯을 갖지 않으면(22.2.9.3 참조) TypeError 예외를 던집니다.
iteratorObj.[[Done]]이 true이면, 다음을 수행합니다.
1. CreateIteratorResultObject(undefined, true)를 반환합니다.
regexp를 iteratorObj.[[IteratingRegExp]]로 둡니다.
string을 iteratorObj.[[IteratedString]]으로 둡니다.
global을 iteratorObj.[[Global]]로 둡니다.
fullUnicode를 iteratorObj.[[Unicode]]로 둡니다.
match를 ? RegExpExec(regexp, string)로 둡니다.
match가 null이면, 다음을 수행합니다.
1. iteratorObj.[[Done]]을 true로 설정합니다.
2. CreateIteratorResultObject(undefined, true)를 반환합니다.
global이 false이면, 다음을 수행합니다.
1. iteratorObj.[[Done]]을 true로 설정합니다.
2. CreateIteratorResultObject(match, false)를 반환합니다.
matchString을 ? ToString(? Get(match, "0"))로 둡니다.
matchString이 빈 String이면, 다음을 수행합니다.
1. thisIndex를 ℝ(? ToLength(? Get(regexp, "lastIndex")))로 둡니다.
2. nextIndex를 AdvanceStringIndex(string, thisIndex, fullUnicode)로 둡니다.
3. ? Set(regexp, "lastIndex", 𝔽(nextIndex), true)를 수행합니다.
CreateIteratorResultObject(match, false)를 반환합니다.

22.2.9.2.2 %RegExpStringIteratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "RegExp String Iterator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

22.2.9.3 RegExp String Iterator 인스턴스의 프로퍼티

RegExp String Iterator 인스턴스는 %RegExpStringIteratorPrototype% 내재 객체에서 프로퍼티를 상속하는 일반 객체입니다. RegExp String Iterator 인스턴스는 처음에 표 69에 나열된 내부 슬롯을 갖도록 생성됩니다.

표 69: RegExp String Iterator 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[IteratingRegExp]]`	an Object	순회에 사용하는 정규 표현식입니다. IsRegExp(`[[IteratingRegExp]]`)의 초기 값은 true입니다.
`[[IteratedString]]`	a String	순회 중인 String 값입니다.
`[[Global]]`	a Boolean	`[[IteratingRegExp]]`가 전역인지 여부를 나타냅니다.
`[[Unicode]]`	a Boolean	`[[IteratingRegExp]]`가 유니코드 모드인지 여부를 나타냅니다.
`[[Done]]`	a Boolean	순회가 완료되었는지 여부를 나타냅니다.

23 인덱스 컬렉션

23.1 Array 객체

Array는 특정 종류의 프로퍼티 이름을 특별하게 처리하는 특수 객체입니다. 이러한 특별한 처리의 정의는 10.4.2를 참조하시기 바랍니다.

23.1.1 Array 생성자

Array 생성자는:

%Array%입니다.
전역 객체의 "Array" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 Array를 생성하고 초기화합니다.
생성자가 아니라 함수로 호출되는 경우에도 새로운 Array를 생성하고 초기화합니다. 따라서 함수 호출 Array(…)는 동일한 인수를 갖는 객체 생성 표현식 new Array(…)와 동등합니다.
인수의 수와 타입에 따라 동작이 달라지는 함수입니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 특수한 Array 동작을 상속하려는 하위 클래스 생성자는 Array 특수 객체인 하위 클래스 인스턴스를 초기화하기 위해 Array 생성자에 대한 super 호출을 포함해야 합니다. 그러나 대부분의 Array.prototype 메서드는 this 값이 Array 특수 객체인지에 의존하지 않는 일반 메서드입니다.

23.1.1.1 Array ( ...`values` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 newTarget을 활성 함수 객체로 둡니다. 그렇지 않으면 newTarget을 NewTarget으로 둡니다.
proto를 ? GetPrototypeFromConstructor(newTarget, "%Array.prototype%")로 둡니다.
numberOfArgs를 values의 요소 수로 둡니다.
numberOfArgs = 0이면 ! ArrayCreate(0, proto)를 반환합니다.
numberOfArgs = 1이면, 다음을 수행합니다.
1. length를 values[0]으로 둡니다.
2. array를 ! ArrayCreate(0, proto)로 둡니다.
3. length가 Number가 아니면, 다음을 수행합니다.
  1. ! CreateDataPropertyOrThrow(array, "0", length)를 수행합니다.
  2. intLength를 1_𝔽로 둡니다.
4. 그렇지 않으면,
  1. intLength를 ! ToUint32(length)로 둡니다.
  2. SameValueZero(intLength, length)가 false이면 RangeError 예외를 던집니다.
5. ! Set(array, "length", intLength, true)를 수행합니다.
6. array를 반환합니다.
단언: numberOfArgs ≥ 2입니다.
array를 ? ArrayCreate(numberOfArgs, proto)로 둡니다.
k를 0으로 둡니다.
k < numberOfArgs인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. itemK를 values[k]로 둡니다.
3. ! CreateDataPropertyOrThrow(array, propertyKey, itemK)를 수행합니다.
4. k를 k + 1로 설정합니다.
단언: array의 "length" 프로퍼티의 수학적 값은 numberOfArgs입니다.
array를 반환합니다.

23.1.2 Array 생성자의 프로퍼티

Array 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 1_𝔽인 "length" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

23.1.2.1 Array.from ( `items` [ , `mapper` [ , `thisArg` ] ] )

이 함수는 호출되면 다음 단계를 수행합니다:

ctor를 this 값으로 둡니다.
mapper가 undefined이면, 다음을 수행합니다.
1. mapping을 false로 둡니다.
그렇지 않으면,
1. IsCallable(mapper)가 false이면 TypeError 예외를 던집니다.
2. mapping을 true로 둡니다.
usingIterator를 ? GetMethod(items, %Symbol.iterator%)로 둡니다.
usingIterator가 undefined가 아니면, 다음을 수행합니다.
1. IsConstructor(ctor)가 true이면, 다음을 수행합니다.
  1. array를 ? Construct(ctor)로 둡니다.
2. 그렇지 않으면,
  1. array를 ! ArrayCreate(0)으로 둡니다.
3. iteratorRecord를 ? GetIteratorFromMethod(items, usingIterator)로 둡니다.
4. k를 0으로 둡니다.
5. 다음을 반복합니다.
  1. k ≥ 2⁵³ - 1이면, 다음을 수행합니다.
    1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
    2. ? IteratorClose(iteratorRecord, error)를 반환합니다.
  2. propertyKey를 ! ToString(𝔽(k))로 둡니다.
  3. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
  4. next가 done이면, 다음을 수행합니다.
    1. ? Set(array, "length", 𝔽(k), true)를 수행합니다.
    2. array를 반환합니다.
  5. mapping이 true이면, 다음을 수행합니다.
    1. mappedValue를 Completion(Call(mapper, thisArg, « next, 𝔽(k) »))로 둡니다.
    2. IfAbruptCloseIterator(mappedValue, iteratorRecord).
  6. 그렇지 않으면,
    1. mappedValue를 next로 둡니다.
  7. defineStatus를 Completion(CreateDataPropertyOrThrow(array, propertyKey, mappedValue))로 둡니다.
  8. IfAbruptCloseIterator(defineStatus, iteratorRecord).
  9. k를 k + 1로 설정합니다.
참고: items는 반복 가능하지 않으므로 배열과 유사한 객체라고 가정합니다.
arrayLike를 ! ToObject(items)로 둡니다.
length를 ? LengthOfArrayLike(arrayLike)로 둡니다.
IsConstructor(ctor)가 true이면, 다음을 수행합니다.
1. array를 ? Construct(ctor, « 𝔽(length) »)로 둡니다.
그렇지 않으면,
1. array를 ? ArrayCreate(length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kValue를 ? Get(arrayLike, propertyKey)로 둡니다.
3. mapping이 true이면, 다음을 수행합니다.
  1. mappedValue를 ? Call(mapper, thisArg, « kValue, 𝔽(k) »)로 둡니다.
4. 그렇지 않으면,
  1. mappedValue를 kValue로 둡니다.
5. ? CreateDataPropertyOrThrow(array, propertyKey, mappedValue)를 수행합니다.
6. k를 k + 1로 설정합니다.
? Set(array, "length", 𝔽(length), true)를 수행합니다.
array를 반환합니다.

참고

이 메서드는 의도적으로 일반적인 팩터리 메서드이며 this 값이 Array 생성자일 것을 요구하지 않습니다. 따라서 단일 숫자 인수로 호출할 수 있는 다른 모든 생성자로 옮기거나 그러한 생성자가 상속할 수 있습니다.

23.1.2.2 Array.fromAsync ( `items` [ , `mapper` [ , `thisArg` ] ] )

이 비동기 함수는 호출되면 다음 단계를 수행합니다:

ctor를 this 값으로 둡니다.
mapping을 false로 둡니다.
mapper가 undefined가 아니면, 다음을 수행합니다.
1. IsCallable(mapper)가 false이면 TypeError 예외를 던집니다.
2. mapping을 true로 설정합니다.
iteratorRecord를 undefined로 둡니다.
usingAsyncIterator를 ? GetMethod(items, %Symbol.asyncIterator%)로 둡니다.
usingAsyncIterator가 undefined이면, 다음을 수행합니다.
1. usingSyncIterator를 ? GetMethod(items, %Symbol.iterator%)로 둡니다.
2. usingSyncIterator가 undefined가 아니면, 다음을 수행합니다.
  1. iteratorRecord를 CreateAsyncFromSyncIterator(? GetIteratorFromMethod(items, usingSyncIterator))로 설정합니다.
그렇지 않으면,
1. iteratorRecord를 ? GetIteratorFromMethod(items, usingAsyncIterator)로 설정합니다.
iteratorRecord가 undefined가 아니면, 다음을 수행합니다.
1. IsConstructor(ctor)가 true이면, 다음을 수행합니다.
  1. array를 ? Construct(ctor)로 둡니다.
2. 그렇지 않으면,
  1. array를 ! ArrayCreate(0)으로 둡니다.
3. k를 0으로 둡니다.
4. 다음을 반복합니다.
  1. k ≥ 2⁵³ - 1이면, 다음을 수행합니다.
    1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
    2. ? AsyncIteratorClose(iteratorRecord, error)를 반환합니다.
  2. propertyKey를 ! ToString(𝔽(k))로 둡니다.
  3. nextResult를 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])로 둡니다.
  4. nextResult를 ? Await(nextResult)로 설정합니다.
  5. nextResult가 Object가 아니면 TypeError 예외를 던집니다.
  6. done을 ? IteratorComplete(nextResult)로 둡니다.
  7. done이 true이면, 다음을 수행합니다.
    1. ? Set(array, "length", 𝔽(k), true)를 수행합니다.
    2. array를 반환합니다.
  8. nextValue를 ? IteratorValue(nextResult)로 둡니다.
  9. mapping이 true이면, 다음을 수행합니다.
    1. mappedValue를 Completion(Call(mapper, thisArg, « nextValue, 𝔽(k) »))로 둡니다.
    2. IfAbruptCloseAsyncIterator(mappedValue, iteratorRecord).
    3. mappedValue를 Completion(Await(mappedValue))로 설정합니다.
    4. IfAbruptCloseAsyncIterator(mappedValue, iteratorRecord).
  10. 그렇지 않으면,
    1. mappedValue를 nextValue로 둡니다.
  11. defineStatus를 Completion(CreateDataPropertyOrThrow(array, propertyKey, mappedValue))로 둡니다.
  12. IfAbruptCloseAsyncIterator(defineStatus, iteratorRecord).
  13. k를 k + 1로 설정합니다.
그렇지 않으면,
1. 참고: items는 비동기 반복 가능 객체도 반복 가능 객체도 아니므로 배열과 유사한 객체라고 가정합니다.
2. arrayLike를 ! ToObject(items)로 둡니다.
3. length를 ? LengthOfArrayLike(arrayLike)로 둡니다.
4. IsConstructor(ctor)가 true이면, 다음을 수행합니다.
  1. array를 ? Construct(ctor, « 𝔽(length) »)로 둡니다.
5. 그렇지 않으면,
  1. array를 ? ArrayCreate(length)로 둡니다.
6. k를 0으로 둡니다.
7. k < length인 동안 다음을 반복합니다.
  1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
  2. kValue를 ? Get(arrayLike, propertyKey)로 둡니다.
  3. kValue를 ? Await(kValue)로 설정합니다.
  4. mapping이 true이면, 다음을 수행합니다.
    1. mappedValue를 ? Call(mapper, thisArg, « kValue, 𝔽(k) »)로 둡니다.
    2. mappedValue를 ? Await(mappedValue)로 설정합니다.
  5. 그렇지 않으면,
    1. mappedValue를 kValue로 둡니다.
  6. ? CreateDataPropertyOrThrow(array, propertyKey, mappedValue)를 수행합니다.
  7. k를 k + 1로 설정합니다.
8. ? Set(array, "length", 𝔽(length), true)를 수행합니다.
9. array를 반환합니다.

참고

23.1.2.3 Array.isArray ( `arg` )

이 함수는 호출되면 다음 단계를 수행합니다:

? IsArray(arg)를 반환합니다.

23.1.2.4 Array.of ( ...`items` )

이 메서드는 호출되면 다음 단계를 수행합니다:

length를 items의 요소 수로 둡니다.
lengthNumber를 𝔽(length)로 둡니다.
ctor를 this 값으로 둡니다.
IsConstructor(ctor)가 true이면, 다음을 수행합니다.
1. array를 ? Construct(ctor, « lengthNumber »)로 둡니다.
그렇지 않으면,
1. array를 ? ArrayCreate(length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 items[k]로 둡니다.
2. propertyKey를 ! ToString(𝔽(k))로 둡니다.
3. ? CreateDataPropertyOrThrow(array, propertyKey, kValue)를 수행합니다.
4. k를 k + 1로 설정합니다.
? Set(array, "length", lengthNumber, true)를 수행합니다.
array를 반환합니다.

참고

이 메서드는 의도적으로 일반적인 팩터리 메서드이며 this 값이 Array 생성자일 것을 요구하지 않습니다. 따라서 단일 숫자 인수로 호출할 수 있는 다른 생성자로 옮기거나 그러한 생성자가 상속할 수 있습니다.

23.1.2.5 Array.prototype

Array.prototype의 값은 Array 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

23.1.2.6 get Array [ %Symbol.species% ]

Array[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

Array 프로토타입 메서드는 일반적으로 this 값의 생성자를 사용하여 파생 객체를 생성합니다. 그러나 하위 클래스 생성자는 자신의 %Symbol.species% 프로퍼티를 재정의하여 이 기본 동작을 재정의할 수 있습니다.

23.1.3 Array 프로토타입 객체의 프로퍼티

Array 프로토타입 객체는:

%Array.prototype%입니다.
Array 특수 객체이며 그러한 객체에 지정된 내부 메서드를 갖습니다.
초기 값이 +0_𝔽이고 속성이 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false }인 "length" 프로퍼티를 갖습니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

참고

Array 프로토타입 객체가 Array 특수 객체로 지정된 것은 ECMAScript 2015 명세 이전에 작성된 ECMAScript 코드와의 호환성을 보장하기 위한 것입니다.

23.1.3.1 Array.prototype.at ( `index` )

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
k를 ? ToAbsoluteIndex(index, length)로 둡니다.
k < 0 또는 k ≥ length이면 undefined를 반환합니다.
? Get(obj, ! ToString(𝔽(k)))를 반환합니다.

23.1.3.2 Array.prototype.concat ( ...`items` )

이 메서드는 객체의 배열 요소 뒤에 각 인수의 배열 요소가 이어지는 배열을 반환합니다.

호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
array를 ? ArraySpeciesCreate(obj, 0)으로 둡니다.
nextIndex를 0으로 둡니다.
obj를 items의 앞에 추가합니다.
items의 각 요소 item에 대해 다음을 수행합니다.
1. spreadable을 ? IsConcatSpreadable(item)로 둡니다.
2. spreadable이 true이면, 다음을 수행합니다.
  1. length를 ? LengthOfArrayLike(item)로 둡니다.
  2. nextIndex + length > 2⁵³ - 1이면 TypeError 예외를 던집니다.
  3. sourceIndex를 0으로 둡니다.
  4. sourceIndex < length인 동안 다음을 반복합니다.
    1. propertyKey를 ! ToString(𝔽(sourceIndex))로 둡니다.
    2. exists를 ? HasProperty(item, propertyKey)로 둡니다.
    3. exists가 true이면, 다음을 수행합니다.
      1. subElement를 ? Get(item, propertyKey)로 둡니다.
      2. ? CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), subElement)를 수행합니다.
    4. nextIndex를 nextIndex + 1로 설정합니다.
    5. sourceIndex를 sourceIndex + 1로 설정합니다.
3. 그렇지 않으면,
  1. 참고: item은 펼쳐지지 않고 단일 항목으로 추가됩니다.
  2. nextIndex ≥ 2⁵³ - 1이면 TypeError 예외를 던집니다.
  3. ? CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), item)을 수행합니다.
  4. nextIndex를 nextIndex + 1로 설정합니다.
? Set(array, "length", 𝔽(nextIndex), true)를 수행합니다.
array를 반환합니다.

이 메서드의 "length" 프로퍼티는 1_𝔽입니다.

참고 1

6 단계에서 "length" 프로퍼티를 명시적으로 설정하는 것은 items의 마지막 비어 있지 않은 요소 뒤에 빈 슬롯이 있거나 array가 내장 Array가 아닌 경우에도 길이가 올바르도록 보장하기 위한 것입니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.2.1 IsConcatSpreadable ( `obj` )

추상 연산 IsConcatSpreadable. 인수 obj (ECMAScript 언어 값). 반환값: (정상 완료 (값: Boolean) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

obj가 Object가 아니면 false를 반환합니다.
spreadable을 ? Get(obj, %Symbol.isConcatSpreadable%)로 둡니다.
spreadable이 undefined가 아니면 ToBoolean(spreadable)을 반환합니다.
? IsArray(obj)를 반환합니다.

23.1.3.3 Array.prototype.constructor

Array.prototype.constructor의 초기 값은 %Array%입니다.

23.1.3.4 Array.prototype.copyWithin ( `target`, `start` [ , `end` ] )

참고 1

end 인수는 선택 사항입니다. 제공되지 않으면 this 값의 길이를 사용합니다.

참고 2

target이 음수이면 배열의 길이인 length에 대해 length + target으로 처리합니다. start가 음수이면 length + start로 처리합니다. end가 음수이면 length + end로 처리합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
to를 ? ToClampedIndex(target, length)로 둡니다.
from을 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 final을 length로 둡니다. 그렇지 않으면 final을 ? ToClampedIndex(end, length)로 둡니다.
count를 min(final - from, length - to)로 둡니다.
from < to이고 to < from + count이면, 다음을 수행합니다.
1. direction을 -1로 둡니다.
2. from을 from + count - 1로 설정합니다.
3. to를 to + count - 1로 설정합니다.
그렇지 않으면,
1. direction을 1로 둡니다.
count > 0인 동안 다음을 반복합니다.
1. fromKey를 ! ToString(𝔽(from))로 둡니다.
2. toKey를 ! ToString(𝔽(to))로 둡니다.
3. fromPresent를 ? HasProperty(obj, fromKey)로 둡니다.
4. fromPresent가 true이면, 다음을 수행합니다.
  1. fromValue를 ? Get(obj, fromKey)로 둡니다.
  2. ? Set(obj, toKey, fromValue, true)를 수행합니다.
5. 그렇지 않으면,
  1. 단언: fromPresent는 false입니다.
  2. ? DeletePropertyOrThrow(obj, toKey)를 수행합니다.
6. from을 from + direction으로 설정합니다.
7. to를 to + direction으로 설정합니다.
8. count를 count - 1로 설정합니다.
obj를 반환합니다.

참고 3

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.5 Array.prototype.entries ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
CreateArrayIterator(obj, key+value)를 반환합니다.

23.1.3.6 Array.prototype.every ( `callback` [ , `thisArg` ] )

참고 1

callback은 세 인수를 받고 Boolean 값으로 강제 변환할 수 있는 값을 반환하는 함수여야 합니다. every는 callback이 false를 반환하는 요소를 찾을 때까지 배열에 실제로 존재하는 각 요소에 대해 오름차순으로 callback을 한 번씩 호출합니다. 그러한 요소를 찾으면 every는 즉시 false를 반환합니다. 그렇지 않으면 every는 true를 반환합니다. callback은 배열에 실제로 존재하는 요소에 대해서만 호출되며, 존재하지 않는 요소에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 요소의 값, 요소의 인덱스, 순회 중인 객체라는 세 인수로 호출됩니다.

every는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

every가 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. every 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 변경되면 callback에 전달되는 값은 every가 해당 요소를 방문할 때의 값입니다. every 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다. every는 수학의 “모든 것에 대해” 한정자처럼 동작합니다. 특히 빈 배열에서는 true를 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. testResult를 ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »))로 둡니다.
  3. testResult가 false이면 false를 반환합니다.
4. k를 k + 1로 설정합니다.
true를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.7 Array.prototype.fill ( `value` [ , `start` [ , `end` ] ] )

참고 1

start 인수는 선택 사항입니다. 제공되지 않으면 +0_𝔽을 사용합니다.

end 인수는 선택 사항입니다. 제공되지 않으면 this 값의 길이를 사용합니다.

참고 2

start가 음수이면 배열의 길이인 length에 대해 length + start로 처리합니다. end가 음수이면 length + end로 처리합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
k를 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 final을 length로 둡니다. 그렇지 않으면 final을 ? ToClampedIndex(end, length)로 둡니다.
k < final인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. ? Set(obj, propertyKey, value, true)를 수행합니다.
3. k를 k + 1로 설정합니다.
obj를 반환합니다.

참고 3

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.8 Array.prototype.filter ( `callback` [ , `thisArg` ] )

참고 1

callback은 세 인수를 받고 Boolean 값으로 강제 변환할 수 있는 값을 반환하는 함수여야 합니다. filter는 배열의 각 요소에 대해 오름차순으로 callback을 한 번씩 호출하고 callback이 true를 반환한 모든 값으로 새로운 배열을 구성합니다. callback은 배열에 실제로 존재하는 요소에 대해서만 호출되며, 존재하지 않는 요소에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 요소의 값, 요소의 인덱스, 순회 중인 객체라는 세 인수로 호출됩니다.

filter는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

filter가 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. filter 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 변경되면 callback에 전달되는 값은 filter가 해당 요소를 방문할 때의 값입니다. filter 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
array를 ? ArraySpeciesCreate(obj, 0)으로 둡니다.
k를 0으로 둡니다.
to를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. selected를 ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »))로 둡니다.
  3. selected가 true이면, 다음을 수행합니다.
    1. ? CreateDataPropertyOrThrow(array, ! ToString(𝔽(to)), kValue)를 수행합니다.
    2. to를 to + 1로 설정합니다.
4. k를 k + 1로 설정합니다.
array를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.9 Array.prototype.find ( `predicate` [ , `thisArg` ] )

참고 1

이 메서드는 predicate가 true로 강제 변환되는 값을 반환하는 요소를 찾을 때까지 배열의 각 요소에 대해 인덱스 오름차순으로 predicate를 한 번씩 호출합니다. 그러한 요소를 찾으면 find는 즉시 해당 요소 값을 반환합니다. 그렇지 않으면 find는 undefined를 반환합니다.

추가 정보는 FindViaPredicate를 참조하시기 바랍니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, ascending, predicate, thisArg)로 둡니다.
findRecord.[[Value]]를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.10 Array.prototype.findIndex ( `predicate` [ , `thisArg` ] )

참고 1

이 메서드는 predicate가 true로 강제 변환되는 값을 반환하는 요소를 찾을 때까지 배열의 각 요소에 대해 인덱스 오름차순으로 predicate를 한 번씩 호출합니다. 그러한 요소를 찾으면 findIndex는 즉시 해당 요소 값의 인덱스를 반환합니다. 그렇지 않으면 findIndex는 -1을 반환합니다.

추가 정보는 FindViaPredicate를 참조하시기 바랍니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, ascending, predicate, thisArg)로 둡니다.
findRecord.[[Index]]를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.11 Array.prototype.findLast ( `predicate` [ , `thisArg` ] )

참고 1

이 메서드는 predicate가 true로 강제 변환되는 값을 반환하는 요소를 찾을 때까지 배열의 각 요소에 대해 인덱스 내림차순으로 predicate를 한 번씩 호출합니다. 그러한 요소를 찾으면 findLast는 즉시 해당 요소 값을 반환합니다. 그렇지 않으면 findLast는 undefined를 반환합니다.

추가 정보는 FindViaPredicate를 참조하시기 바랍니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, descending, predicate, thisArg)로 둡니다.
findRecord.[[Value]]를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.12 Array.prototype.findLastIndex ( `predicate` [ , `thisArg` ] )

참고 1

이 메서드는 predicate가 true로 강제 변환되는 값을 반환하는 요소를 찾을 때까지 배열의 각 요소에 대해 인덱스 내림차순으로 predicate를 한 번씩 호출합니다. 그러한 요소를 찾으면 findLastIndex는 즉시 해당 요소 값의 인덱스를 반환합니다. 그렇지 않으면 findLastIndex는 -1을 반환합니다.

추가 정보는 FindViaPredicate를 참조하시기 바랍니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, descending, predicate, thisArg)로 둡니다.
findRecord.[[Index]]를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array 객체일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.12.1 FindViaPredicate ( `obj`, `length`, `direction`, `predicate`, `thisArg` )

추상 연산 FindViaPredicate. 인수 obj (Object), length (음이 아닌 정수), direction ((ascending 또는 descending)), predicate (ECMAScript 언어 값) 및 thisArg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 레코드 (필드: [[Index]] (정수인 Number), [[Value]] (ECMAScript 언어 값))) 또는 throw 완료).

obj는 배열과 유사한 객체 또는 TypedArray여야 합니다. 이 연산은 predicate가 true로 강제 변환되는 값을 반환하는 요소를 찾을 때까지 direction이 나타내는 대로 인덱스 오름차순 또는 내림차순으로 obj의 각 요소에 대해 predicate를 한 번씩 호출합니다. 그러한 요소를 찾으면 이 연산은 찾은 요소의 인덱스와 값을 제공하는 Record를 반환합니다. 그러한 요소를 찾지 못하면 인덱스에 -1_𝔽, 값에 undefined를 지정하는 Record를 반환합니다.

predicate는 함수여야 합니다. 배열의 요소에 대해 호출되면 요소의 값, 요소의 인덱스, 순회 중인 객체라는 세 인수가 전달됩니다. 반환 값은 Boolean 값으로 강제 변환됩니다.

thisArg는 predicate를 호출할 때마다 this 값으로 사용됩니다.

이 연산은 호출된 객체를 직접 변경하지 않지만 predicate 호출에 의해 객체가 변경될 수 있습니다.

처리할 요소의 범위는 순회가 시작되기 직전, predicate을 처음 호출하기 전에 설정됩니다. 그 후 배열에 추가된 요소는 predicate이 방문하지 않습니다. 배열의 기존 요소가 변경되면 predicate에 전달되는 값은 이 연산이 해당 요소를 방문할 때의 값입니다. 순회가 시작된 후 방문되기 전에 삭제된 요소도 여전히 방문되며, 프로토타입에서 조회되거나 undefined가 됩니다.

호출되면 다음 단계를 수행한다.

IsCallable(predicate)이 false이면 TypeError 예외를 던집니다.
direction이 ascending이면, 다음을 수행합니다.
1. indices를 0(포함)부터 length(제외)까지의 구간에 속하는 정수를 오름차순으로 포함하는 List로 둡니다.
그렇지 않으면,
1. indices를 0(포함)부터 length(제외)까지의 구간에 속하는 정수를 내림차순으로 포함하는 List로 둡니다.
indices의 각 정수 k에 대해 다음을 수행합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. 참고: obj가 TypedArray이면 다음 Get 호출은 정상 완료를 반환합니다.
3. kValue를 ? Get(obj, propertyKey)로 둡니다.
4. testResult를 ? Call(predicate, thisArg, « kValue, 𝔽(k), obj »)로 둡니다.
5. ToBoolean(testResult)가 true이면 Record { [[Index]]: 𝔽(k), [[Value]]: kValue }를 반환합니다.
Record { [[Index]]: -1_𝔽, [[Value]]: undefined }를 반환합니다.

23.1.3.13 Array.prototype.flat ( [ `depth` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
sourceLength를 ? LengthOfArrayLike(obj)로 둡니다.
depthNumber를 1로 둡니다.
depth가 undefined가 아니면, 다음을 수행합니다.
1. depthNumber를 ? ToIntegerOrInfinity(depth)로 설정합니다.
2. depthNumber < 0이면 depthNumber를 0으로 설정합니다.
array를 ? ArraySpeciesCreate(obj, 0)으로 둡니다.
? FlattenIntoArray(array, obj, sourceLength, 0, depthNumber)를 수행합니다.
array를 반환합니다.

23.1.3.13.1 FlattenIntoArray ( `target`, `source`, `sourceLength`, `start`, `depth` [ , `mapperFunc` [ , `thisArg` ] ] )

추상 연산 FlattenIntoArray. 인수 target (Object), source (Object), sourceLength (음이 아닌 정수), start (음이 아닌 정수) 및 depth ((음이 아닌 정수 또는 +∞)) 및 선택적 인수 mapperFunc (함수 객체) 및 thisArg (ECMAScript 언어 값). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: mapperFunc가 존재하면 IsCallable(mapperFunc)은 true이고, thisArg가 존재하며, depth는 1입니다.
targetIndex를 start로 둡니다.
sourceIndex를 0으로 둡니다.
sourceIndex < sourceLength인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(sourceIndex))로 둡니다.
2. exists를 ? HasProperty(source, propertyKey)로 둡니다.
3. exists가 true이면, 다음을 수행합니다.
  1. element를 ? Get(source, propertyKey)로 둡니다.
  2. mapperFunc가 존재하면, 다음을 수행합니다.
    1. element를 ? Call(mapperFunc, thisArg, « element, 𝔽(sourceIndex), source »)로 설정합니다.
  3. shouldFlatten을 false로 둡니다.
  4. depth > 0이면, 다음을 수행합니다.
    1. shouldFlatten을 ? IsArray(element)로 설정합니다.
  5. shouldFlatten이 true이면, 다음을 수행합니다.
    1. depth = +∞이면 newDepth를 +∞로 둡니다.
    2. 그렇지 않으면 newDepth를 depth - 1로 둡니다.
    3. elementLength를 ? LengthOfArrayLike(element)로 둡니다.
    4. targetIndex를 ? FlattenIntoArray(target, element, elementLength, targetIndex, newDepth)로 설정합니다.
  6. 그렇지 않으면,
    1. targetIndex ≥ 2⁵³ - 1이면 TypeError 예외를 던집니다.
    2. ? CreateDataPropertyOrThrow(target, ! ToString(𝔽(targetIndex)), element)를 수행합니다.
    3. targetIndex를 targetIndex + 1로 설정합니다.
4. sourceIndex를 sourceIndex + 1로 설정합니다.
targetIndex를 반환합니다.

23.1.3.14 Array.prototype.flatMap ( `mapperFunc` [ , `thisArg` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
sourceLength를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(mapperFunc)이 false이면 TypeError 예외를 던집니다.
array를 ? ArraySpeciesCreate(obj, 0)으로 둡니다.
? FlattenIntoArray(array, obj, sourceLength, 0, 1, mapperFunc, thisArg)를 수행합니다.
array를 반환합니다.

23.1.3.15 Array.prototype.forEach ( `callback` [ , `thisArg` ] )

참고 1

callback은 세 인수를 받는 함수여야 합니다. forEach는 배열에 존재하는 각 요소에 대해 오름차순으로 callback을 한 번씩 호출합니다. callback은 배열에 실제로 존재하는 요소에 대해서만 호출되며, 존재하지 않는 요소에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 요소의 값, 요소의 인덱스, 순회 중인 객체라는 세 인수로 호출됩니다.

forEach는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

forEach가 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. forEach 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 변경되면 callback에 전달되는 값은 forEach가 해당 요소를 방문할 때의 값입니다. forEach 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. ? Call(callback, thisArg, « kValue, 𝔽(k), obj »)를 수행합니다.
4. k를 k + 1로 설정합니다.
undefined를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.16 Array.prototype.includes ( `searchElement` [ , `fromIndex` ] )

참고 1

이 메서드는 SameValueZero 알고리즘을 사용하여 searchElement를 배열의 요소와 오름차순으로 비교하고, 어느 위치에서든 찾으면 true를 반환합니다. 그렇지 않으면 false를 반환합니다.

선택적 두 번째 인수 fromIndex의 기본값은 +0_𝔽입니다(즉, 전체 배열을 검색합니다). 배열의 길이 이상이면 false를 반환하며, 즉 배열을 검색하지 않습니다. -0_𝔽보다 작으면 배열 끝에서의 오프셋으로 사용하여 fromIndex를 계산합니다. 계산된 인덱스가 +0_𝔽 이하이면 전체 배열을 검색합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
length = 0이면 false를 반환합니다.
k를 ? ToClampedIndex(fromIndex, length)로 둡니다.
k < length인 동안 다음을 반복합니다.
1. elementK를 ? Get(obj, ! ToString(𝔽(k)))로 둡니다.
2. SameValueZero(searchElement, elementK)가 true이면 true를 반환합니다.
3. k를 k + 1로 설정합니다.
false를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

참고 3

이 메서드는 유사한 indexOf 메서드와 의도적으로 두 가지 점에서 다릅니다. 첫째, IsStrictlyEqual 대신 SameValueZero 알고리즘을 사용하므로 NaN 배열 요소를 감지할 수 있습니다. 둘째, 존재하지 않는 배열 요소를 건너뛰지 않고 undefined로 처리합니다.

23.1.3.17 Array.prototype.indexOf ( `searchElement` [ , `fromIndex` ] )

이 메서드는 IsStrictlyEqual 알고리즘을 사용하여 searchElement를 배열의 요소와 오름차순으로 비교하고, 하나 이상의 인덱스에서 찾으면 그러한 인덱스 중 가장 작은 값을 반환합니다. 그렇지 않으면 -1_𝔽을 반환합니다.

참고 1

선택적 두 번째 인수 fromIndex의 기본값은 +0_𝔽입니다(즉, 전체 배열을 검색합니다). 배열의 길이 이상이면 -1_𝔽을 반환하며, 즉 배열을 검색하지 않습니다. -0_𝔽보다 작으면 배열 끝에서의 오프셋을 계산하는 데 사용합니다. 계산된 인덱스가 +0_𝔽 이하이면 전체 배열을 검색합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
length = 0이면 -1_𝔽을 반환합니다.
k를 ? ToClampedIndex(fromIndex, length)로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. elementK를 ? Get(obj, propertyKey)로 둡니다.
  2. IsStrictlyEqual(searchElement, elementK)가 true이면 𝔽(k)를 반환합니다.
4. k를 k + 1로 설정합니다.
-1_𝔽을 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.18 Array.prototype.join ( `separator` )

이 메서드는 배열의 요소를 String으로 변환한 다음 separator가 나타나는 것으로 구분하여 이러한 String을 연결합니다. 구분자를 제공하지 않으면 하나의 쉼표를 구분자로 사용합니다.

호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
separator가 undefined이면 separatorString을 ","로 둡니다; 그렇지 않으면 separatorString을 ? ToString(separator)으로 둡니다.
? JoinIndexedProperties(obj, length, separatorString)를 반환합니다.

참고

이 메서드는 의도적으로 범용적으로 설계되었으며, this 값이 Array일 필요는 없습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.18.1 JoinIndexedProperties ( `obj`, `length`, `separator` [ , `methodName` [ , `methodArgs` ] ] )

추상 연산 JoinIndexedProperties. 인수 obj (Object), length (음이 아닌 정수) 및 separator (String) 및 선택적 인수 methodName (프로퍼티 키) 및 methodArgs (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: String) 또는 throw 완료). 0부터 length - 1까지 양 끝을 포함하는 구간에 있는 obj의 정수 인덱스 속성을 String으로 변환한 다음(선택적으로 메서드 호출을 통해), 각 String 사이에 구분자 String을 삽입하여 연결합니다. 호출되면 다음 단계를 수행한다.

methodName이 제공되고 methodArgs가 제공되지 않았으면 methodArgs를 새로운 빈 List로 설정합니다.
result를 빈 String으로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음 단계를 반복합니다,
1. k > 0이면 result를 result와 separator를 연결한 문자열로 설정합니다.
2. 참고: obj가 TypedArray인 경우 다음 Get 호출은 정상 완료를 반환합니다.
3. element를 ? Get(obj, ! ToString(𝔽(k)))으로 둡니다.
4. element가 undefined도 null도 아니면 다음을 수행합니다.
  1. methodName이 제공된 경우 다음을 수행합니다.
    1. elementString을 ? ToString(? Invoke(element, methodName, methodArgs))으로 둡니다.
  2. 그렇지 않으면,
    1. 참고: obj가 TypedArray인 경우 다음 ToString 호출은 정상 완료를 반환합니다.
    2. elementString을 ? ToString(element)으로 둡니다.
  3. result를 result와 elementString을 연결한 문자열로 설정합니다.
5. k를 k + 1로 설정합니다.
result를 반환합니다.

참고

methodArgs 매개변수는 ECMA-402와 같이 이 연산에 의존하는 다른 명세에서 사용하기 위한 것입니다.

23.1.3.19 Array.prototype.keys ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
CreateArrayIterator(obj, key)를 반환합니다.

23.1.3.20 Array.prototype.lastIndexOf ( `searchElement` [ , `fromIndex` ] )

참고 1

이 메서드는 IsStrictlyEqual 알고리즘을 사용하여 searchElement를 배열의 요소와 내림차순으로 비교하고, 하나 이상의 인덱스에서 찾으면 그러한 인덱스 중 가장 큰 값을 반환합니다. 그렇지 않으면 -1_𝔽을 반환합니다.

선택적 두 번째 인수 fromIndex의 기본값은 배열의 길이에서 1을 뺀 값입니다(즉, 전체 배열을 검색합니다). 배열의 길이 이상이면 전체 배열을 검색합니다. -0_𝔽보다 작으면 배열 끝에서의 오프셋을 계산하는 데 사용합니다. 계산된 인덱스가 -0_𝔽보다 작으면 -1_𝔽을 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
length = 0이면 -1_𝔽을 반환합니다.
fromIndex가 존재하지 않으면 k를 length - 1로 둡니다. 그렇지 않으면 k를 min(? ToAbsoluteIndex(fromIndex, length), length - 1)로 둡니다.
k ≥ 0인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. elementK를 ? Get(obj, propertyKey)로 둡니다.
  2. IsStrictlyEqual(searchElement, elementK)가 true이면 𝔽(k)를 반환합니다.
4. k를 k - 1로 설정합니다.
-1_𝔽을 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.21 Array.prototype.map ( `callback` [ , `thisArg` ] )

참고 1

callback은 세 인수를 받는 함수여야 합니다. map은 배열의 각 요소에 대해 오름차순으로 callback을 한 번씩 호출하고 그 결과로 새로운 Array를 구성합니다. callback은 배열에 실제로 존재하는 요소에 대해서만 호출되며, 존재하지 않는 요소에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 요소의 값, 요소의 인덱스, 순회 중인 객체라는 세 인수로 호출됩니다.

map은 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

map이 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. map 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 변경되면 callback에 전달되는 값은 map이 해당 요소를 방문할 때의 값입니다. map 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
array를 ? ArraySpeciesCreate(obj, length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. mappedValue를 ? Call(callback, thisArg, « kValue, 𝔽(k), obj »)로 둡니다.
  3. ? CreateDataPropertyOrThrow(array, propertyKey, mappedValue)를 수행합니다.
4. k를 k + 1로 설정합니다.
array를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.22 Array.prototype.pop ( )

참고 1

이 메서드는 배열의 마지막 요소를 제거하고 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
length = 0이면, 다음을 수행합니다.
1. ? Set(obj, "length", +0_𝔽, true)를 수행합니다.
2. undefined를 반환합니다.
단언: length > 0입니다.
newLength를 𝔽(length - 1)로 둡니다.
index를 ! ToString(newLength)로 둡니다.
element를 ? Get(obj, index)로 둡니다.
? DeletePropertyOrThrow(obj, index)를 수행합니다.
? Set(obj, "length", newLength, true)를 수행합니다.
element를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.23 Array.prototype.push ( ...`items` )

참고 1

이 메서드는 인수를 나타나는 순서대로 배열의 끝에 추가합니다. 배열의 새로운 길이를 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
argCount를 items의 요소 수로 둡니다.
length + argCount > 2⁵³ - 1이면 TypeError 예외를 던집니다.
items의 각 요소 item에 대해 다음을 수행합니다.
1. ? Set(obj, ! ToString(𝔽(length)), item, true)를 수행합니다.
2. length를 length + 1로 설정합니다.
? Set(obj, "length", 𝔽(length), true)를 수행합니다.
𝔽(length)를 반환합니다.

이 메서드의 "length" 프로퍼티는 1_𝔽입니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.24 Array.prototype.reduce ( `callback` [ , `initialValue` ] )

참고 1

callback은 네 인수를 받는 함수여야 합니다. reduce는 배열에 존재하는 각 요소에 대해 오름차순으로 callback을 한 번씩 호출하며, initialValue가 제공되지 않은 경우 첫 번째 요소를 건너뜁니다.

callback은 previousValue(callback을 이전에 호출한 결과 값), currentValue(현재 요소의 값), currentIndex, 순회 중인 객체라는 네 인수로 호출됩니다. callback이 처음 호출될 때 previousValue와 currentValue는 두 가지 경우 중 하나가 될 수 있습니다. reduce 호출에 initialValue가 제공되었다면 previousValue는 initialValue이고 currentValue는 배열의 첫 번째 값입니다. initialValue가 제공되지 않았다면 previousValue는 배열의 첫 번째 값이고 currentValue는 두 번째 값입니다. 배열에 요소가 없고 initialValue가 제공되지 않으면 TypeError입니다.

reduce는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

reduce가 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. reduce 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 변경되면 callback에 전달되는 값은 reduce가 해당 요소를 방문할 때의 값입니다. reduce 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
length = 0이고 initialValue가 존재하지 않으면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
accumulator를 undefined로 둡니다.
initialValue가 존재하면, 다음을 수행합니다.
1. accumulator를 initialValue로 설정합니다.
그렇지 않으면,
1. kPresent를 false로 둡니다.
2. kPresent가 false이고 k < length인 동안 다음을 반복합니다.
  1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
  2. kPresent를 ? HasProperty(obj, propertyKey)로 설정합니다.
  3. kPresent가 true이면, 다음을 수행합니다.
    1. accumulator를 ? Get(obj, propertyKey)로 설정합니다.
  4. k를 k + 1로 설정합니다.
3. kPresent가 false이면 TypeError 예외를 던집니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. accumulator를 ? Call(callback, undefined, « accumulator, kValue, 𝔽(k), obj »)로 설정합니다.
4. k를 k + 1로 설정합니다.
accumulator를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.25 Array.prototype.reduceRight ( `callback` [ , `initialValue` ] )

참고 1

callback은 네 인수를 받는 함수여야 합니다. reduceRight는 배열에 존재하는 각 요소에 대해 내림차순으로 callback을 한 번씩 호출하며, initialValue가 제공되지 않은 경우 첫 번째 호출을 건너뜁니다.

callback은 previousValue(callback을 이전에 호출한 결과 값), currentValue(현재 요소의 값), currentIndex, 순회 중인 객체라는 네 인수로 호출됩니다. 함수가 처음 호출될 때 previousValue와 currentValue는 두 가지 경우 중 하나가 될 수 있습니다. reduceRight 호출에 initialValue가 제공되었다면 previousValue는 initialValue이고 currentValue는 배열의 마지막 값입니다. initialValue가 제공되지 않았다면 previousValue는 배열의 마지막 값이고 currentValue는 끝에서 두 번째 값입니다. 배열에 요소가 없고 initialValue가 제공되지 않으면 TypeError입니다.

reduceRight는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

reduceRight가 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. reduceRight 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 callback에 의해 변경되면 callback에 전달되는 값은 reduceRight가 해당 요소를 방문할 때의 값입니다. reduceRight 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
length = 0이고 initialValue가 존재하지 않으면 TypeError 예외를 던집니다.
k를 length - 1로 둡니다.
accumulator를 undefined로 둡니다.
initialValue가 존재하면, 다음을 수행합니다.
1. accumulator를 initialValue로 설정합니다.
그렇지 않으면,
1. kPresent를 false로 둡니다.
2. kPresent가 false이고 k ≥ 0인 동안 다음을 반복합니다.
  1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
  2. kPresent를 ? HasProperty(obj, propertyKey)로 설정합니다.
  3. kPresent가 true이면, 다음을 수행합니다.
    1. accumulator를 ? Get(obj, propertyKey)로 설정합니다.
  4. k를 k - 1로 설정합니다.
3. kPresent가 false이면 TypeError 예외를 던집니다.
k ≥ 0인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. accumulator를 ? Call(callback, undefined, « accumulator, kValue, 𝔽(k), obj »)로 설정합니다.
4. k를 k - 1로 설정합니다.
accumulator를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.26 Array.prototype.reverse ( )

참고 1

이 메서드는 배열 요소의 순서를 반대로 재배열합니다. 반전된 배열을 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
middle을 floor(length / 2)로 둡니다.
lower를 0으로 둡니다.
lower ≠ middle인 동안 다음을 반복합니다.
1. upper를 length - lower - 1로 둡니다.
2. upperP를 ! ToString(𝔽(upper))로 둡니다.
3. lowerP를 ! ToString(𝔽(lower))로 둡니다.
4. lowerExists를 ? HasProperty(obj, lowerP)로 둡니다.
5. lowerExists가 true이면, 다음을 수행합니다.
  1. lowerValue를 ? Get(obj, lowerP)로 둡니다.
6. upperExists를 ? HasProperty(obj, upperP)로 둡니다.
7. upperExists가 true이면, 다음을 수행합니다.
  1. upperValue를 ? Get(obj, upperP)로 둡니다.
8. lowerExists가 true이고 upperExists가 true이면, 다음을 수행합니다.
  1. ? Set(obj, lowerP, upperValue, true)를 수행합니다.
  2. ? Set(obj, upperP, lowerValue, true)를 수행합니다.
9. 그렇지 않고 lowerExists가 false이고 upperExists가 true이면, 다음을 수행합니다.
  1. ? Set(obj, lowerP, upperValue, true)를 수행합니다.
  2. ? DeletePropertyOrThrow(obj, upperP)를 수행합니다.
10. 그렇지 않고 lowerExists가 true이고 upperExists가 false이면, 다음을 수행합니다.
  1. ? DeletePropertyOrThrow(obj, lowerP)를 수행합니다.
  2. ? Set(obj, upperP, lowerValue, true)를 수행합니다.
11. 그렇지 않으면,
  1. 단언: lowerExists와 upperExists는 모두 false입니다.
  2. 참고: 어떤 동작도 필요하지 않습니다.
12. lower를 lower + 1로 설정합니다.
obj를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.27 Array.prototype.shift ( )

이 메서드는 배열의 첫 번째 요소를 제거하고 반환합니다.

호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
length = 0이면, 다음을 수행합니다.
1. ? Set(obj, "length", +0_𝔽, true)를 수행합니다.
2. undefined를 반환합니다.
first를 ? Get(obj, "0")로 둡니다.
k를 1로 둡니다.
k < length인 동안 다음을 반복합니다.
1. from을 ! ToString(𝔽(k))로 둡니다.
2. to를 ! ToString(𝔽(k - 1))로 둡니다.
3. fromPresent를 ? HasProperty(obj, from)로 둡니다.
4. fromPresent가 true이면, 다음을 수행합니다.
  1. fromValue를 ? Get(obj, from)로 둡니다.
  2. ? Set(obj, to, fromValue, true)를 수행합니다.
5. 그렇지 않으면,
  1. 단언: fromPresent는 false입니다.
  2. ? DeletePropertyOrThrow(obj, to)를 수행합니다.
6. k를 k + 1로 설정합니다.
? DeletePropertyOrThrow(obj, ! ToString(𝔽(length - 1)))를 수행합니다.
? Set(obj, "length", 𝔽(length - 1), true)를 수행합니다.
first를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.28 Array.prototype.slice ( `start`, `end` )

이 메서드는 배열의 요소 start부터 요소 end 직전까지(end가 undefined이면 배열의 끝까지)의 요소를 포함하는 배열을 반환합니다. start가 음수이면 배열의 길이인 length에 대해 length + start로 처리합니다. end가 음수이면 배열의 길이인 length에 대해 length + end로 처리합니다.

호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
k를 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 final을 length로 둡니다. 그렇지 않으면 final을 ? ToClampedIndex(end, length)로 둡니다.
count를 max(final - k, 0)으로 둡니다.
array를 ? ArraySpeciesCreate(obj, count)로 둡니다.
resultIndex를 0으로 둡니다.
k < final인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. ? CreateDataPropertyOrThrow(array, ! ToString(𝔽(resultIndex)), kValue)를 수행합니다.
4. k를 k + 1로 설정합니다.
5. resultIndex를 resultIndex + 1로 설정합니다.
? Set(array, "length", 𝔽(resultIndex), true)를 수행합니다.
array를 반환합니다.

참고 1

9 단계에서 "length" 프로퍼티를 명시적으로 설정하는 것은 array가 내장 Array가 아닌 경우에도 길이가 올바르도록 보장하기 위한 것입니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.29 Array.prototype.some ( `callback` [ , `thisArg` ] )

참고 1

callback은 세 인수를 받고 Boolean 값으로 강제 변환할 수 있는 값을 반환하는 함수여야 합니다. some은 callback이 true를 반환하는 요소를 찾을 때까지 배열에 존재하는 각 요소에 대해 오름차순으로 callback을 한 번씩 호출합니다. 그러한 요소를 찾으면 some은 즉시 true를 반환합니다. 그렇지 않으면 some은 false를 반환합니다. callback은 배열에 실제로 존재하는 요소에 대해서만 호출되며, 존재하지 않는 요소에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 요소의 값, 요소의 인덱스, 순회 중인 객체라는 세 인수로 호출됩니다.

some은 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

some이 처리할 요소의 범위는 callback을 처음 호출하기 전에 설정됩니다. some 호출이 시작된 후 배열에 추가된 요소는 callback이 방문하지 않습니다. 배열의 기존 요소가 변경되면 callback에 전달되는 값은 some이 해당 요소를 방문할 때의 값입니다. some 호출이 시작된 후 방문되기 전에 삭제된 요소는 방문되지 않습니다. some은 수학의 “존재한다” 한정자처럼 동작합니다. 특히 빈 배열에서는 false를 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ? HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. testResult를 ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »))로 둡니다.
  3. testResult가 true이면 true를 반환합니다.
4. k를 k + 1로 설정합니다.
false를 반환합니다.

참고 2

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.30 Array.prototype.sort ( `comparator` )

이 메서드는 이 배열의 요소를 정렬합니다. comparator가 undefined가 아니면 두 인수 x와 y를 받고 x < y이면 음수 Number, x > y이면 양수 Number, 그 밖의 경우 0을 반환하는 함수여야 합니다.

호출되면 다음 단계를 수행합니다:

comparator가 undefined가 아니고 IsCallable(comparator)이 false이면 TypeError 예외를 던집니다.
obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
sortCompare를 comparator를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, y)를 갖는 새로운 Abstract Closure로 둡니다:
1. ? CompareArrayElements(x, y, comparator)를 반환합니다.
sortedList를 ? SortIndexedProperties(obj, length, sortCompare, skip-holes)로 둡니다.
itemCount를 sortedList의 요소 수로 둡니다.
j를 0으로 둡니다.
j < itemCount인 동안 다음을 반복합니다.
1. ? Set(obj, ! ToString(𝔽(j)), sortedList[j], true)를 수행합니다.
2. j를 j + 1로 설정합니다.
참고: 5 단계의 SortIndexedProperties 호출은 skip-holes를 사용합니다. 감지되어 정렬에서 제외된 빈 슬롯의 수를 보존하기 위해 남은 인덱스를 삭제합니다.
j < length인 동안 다음을 반복합니다.
1. ? DeletePropertyOrThrow(obj, ! ToString(𝔽(j)))를 수행합니다.
2. j를 j + 1로 설정합니다.
obj를 반환합니다.

참고 1

존재하지 않는 프로퍼티 값은 항상 undefined 프로퍼티 값보다 큰 것으로 비교되고, undefined는 항상 다른 모든 값보다 큰 것으로 비교되므로(CompareArrayElements 참조), undefined 프로퍼티 값은 항상 결과의 끝으로 정렬되고 그 뒤에 존재하지 않는 프로퍼티 값이 옵니다.

참고 2

5 및 6 단계의 ToString 추상 연산이 수행하는 메서드 호출로 인해 sortCompare가 일관된 비교기로 동작하지 않을 수 있습니다.

참고 3

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.30.1 SortIndexedProperties ( `obj`, `length`, `sortCompare`, `holes` )

추상 연산 SortIndexedProperties. 인수 obj (Object), length (음이 아닌 정수), sortCompare (매개변수가 두 개인 추상 클로저) 및 holes ((skip-holes 또는 read-through-holes)). 반환값: (정상 완료 (값: 리스트 (요소: ECMAScript 언어 값)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

items를 새로운 빈 List로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. holes가 skip-holes이면, 다음을 수행합니다.
  1. kRead를 ? HasProperty(obj, propertyKey)로 둡니다.
3. 그렇지 않으면,
  1. 단언: holes는 read-through-holes입니다.
  2. kRead를 true로 둡니다.
4. kRead가 true이면, 다음을 수행합니다.
  1. kValue를 ? Get(obj, propertyKey)로 둡니다.
  2. kValue를 items에 추가합니다.
5. k를 k + 1로 설정합니다.
구현체 정의 순서의 sortCompare 호출을 사용하여 items를 정렬합니다. 그러한 호출 중 하나가 갑작스러운 완료를 반환하면 sortCompare에 대한 추가 호출을 수행하기 전에 중단하고 해당 Completion Record를 반환합니다.
items를 반환합니다.

정렬 순서는 위 알고리즘의 4 단계가 완료된 후의 items 순서입니다. sortCompare가 items 요소에 대해 일관된 비교기가 아니면 정렬 순서는 구현체 정의입니다. SortIndexedProperties가 Array.prototype.sort 또는 Array.prototype.toSorted에 의해 호출될 때, comparator가 undefined이고 sortCompare에 인수로 전달된 특정 값에 대한 모든 ToString 적용이 동일한 결과를 생성하지 않는 경우에도 정렬 순서는 구현체 정의입니다.

정렬 순서가 구현체 정의라고 명시되지 않는 한 다음 조건을 모두 만족해야 합니다:

itemCount보다 작은 음이 아닌 정수의 어떤 수학적 순열 π가 존재하여, itemCount보다 작은 모든 음이 아닌 정수 j에 대해 요소 old[j]가 new[π(j)]와 정확히 같아야 합니다.
그러면 각각 itemCount보다 작은 모든 음이 아닌 정수 j와 k에 대해 ℝ(sortCompare(old[j], old[k])) < 0이면 π(j) < π(k)입니다.
또한 j < k < itemCount를 만족하는 모든 음이 아닌 정수 j와 k에 대해 ℝ(sortCompare(old[j], old[k])) = 0이면 π(j) < π(k)입니다. 즉, 정렬은 안정적입니다.

여기서 표기 old[j]는 4 단계가 실행되기 전의 items[j]를, 표기 new[j]는 4 단계가 실행된 후의 items[j]를 나타내는 데 사용됩니다.

Abstract Closure 또는 함수 comparator는 집합 values 안의 모든 값 a, b, c(같은 값일 수도 있음)에 대해 아래 요구 사항을 모두 만족하면 값 집합 values의 일관된 비교기입니다. 표기 a <_C b는 ℝ(comparator(a, b)) < 0을 의미하고, a =_C b는 ℝ(comparator(a, b)) = 0을 의미하며, a >_C b는 ℝ(comparator(a, b)) > 0을 의미합니다.

특정 값 쌍 a와 b를 두 인수로 제공하면 comparator(a, b) 호출은 항상 동일한 값 v를 반환합니다. 또한 v는 Number이고 NaN이 아닙니다. 이는 주어진 a와 b 쌍에 대해 a <_C b, a =_C b, a >_C b 중 정확히 하나만 참임을 의미합니다.
comparator(a, b) 호출은 obj 또는 obj의 프로토타입 체인에 있는 어떤 객체도 변경하지 않습니다.
a =_C a (반사성)
a =_C b이면 b =_C a입니다(대칭성).
a =_C b이고 b =_C c이면 a =_C c입니다(=_C의 추이성).
a <_C b이고 b <_C c이면 a <_C c입니다(<_C의 추이성).
a >_C b이고 b >_C c이면 a >_C c입니다(>_C의 추이성).

참고

위 조건은 comparator가 집합 values를 동치류로 나누고 이러한 동치류가 전순서를 이루도록 보장하기 위한 필요충분조건입니다.

23.1.3.30.2 CompareArrayElements ( `x`, `y`, `comparator` )

추상 연산 CompareArrayElements. 인수 x (ECMAScript 언어 값), y (ECMAScript 언어 값) 및 comparator ((함수 객체 또는 undefined)). 반환값: (정상 완료 (값: Number) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

x가 undefined이고 y가 undefined이면 +0_𝔽을 반환합니다.
x가 undefined이면 1_𝔽을 반환합니다.
y가 undefined이면 -1_𝔽을 반환합니다.
comparator가 undefined가 아니면, 다음을 수행합니다.
1. result를 ? ToNumber(? Call(comparator, undefined, « x, y »))로 둡니다.
2. result가 NaN이면 +0_𝔽을 반환합니다.
3. result를 반환합니다.
xString을 ? ToString(x)로 둡니다.
yString을 ? ToString(y)로 둡니다.
xSmaller를 ! IsLessThan(xString, yString, true)로 둡니다.
xSmaller가 true이면 -1_𝔽을 반환합니다.
ySmaller를 ! IsLessThan(yString, xString, true)로 둡니다.
ySmaller가 true이면 1_𝔽을 반환합니다.
+0_𝔽을 반환합니다.

23.1.3.31 Array.prototype.splice ( `start`, `deleteCount`, ...`items` )

참고 1

이 메서드는 정수 인덱스 start에서 시작하는 배열의 deleteCount개 요소를 삭제하고 이를 items의 요소로 대체합니다. 삭제된 요소가 있으면 이를 포함하는 Array를 반환합니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
actualStart를 ? ToClampedIndex(start, length)로 둡니다.
itemCount를 items의 요소 수로 둡니다.
start가 존재하지 않으면, 다음을 수행합니다.
1. actualDeleteCount를 0으로 둡니다.
그렇지 않고 deleteCount가 존재하지 않으면, 다음을 수행합니다.
1. actualDeleteCount를 length - actualStart로 둡니다.
2. 단언: actualDeleteCount ≥ 0입니다.
그렇지 않으면,
1. dc를 ? ToIntegerOrInfinity(deleteCount)로 둡니다.
2. actualDeleteCount를 dc를 0과 length - actualStart 사이로 제한한 결과로 둡니다.
length + itemCount - actualDeleteCount > 2⁵³ - 1이면 TypeError 예외를 던집니다.
deletedArray를 ? ArraySpeciesCreate(obj, actualDeleteCount)로 둡니다.
k를 0으로 둡니다.
k < actualDeleteCount인 동안 다음을 반복합니다.
1. from을 ! ToString(𝔽(actualStart + k))로 둡니다.
2. ? HasProperty(obj, from)가 true이면, 다음을 수행합니다.
  1. fromValue를 ? Get(obj, from)로 둡니다.
  2. ? CreateDataPropertyOrThrow(deletedArray, ! ToString(𝔽(k)), fromValue)를 수행합니다.
3. k를 k + 1로 설정합니다.
? Set(deletedArray, "length", 𝔽(actualDeleteCount), true)를 수행합니다.
itemCount < actualDeleteCount이면, 다음을 수행합니다.
1. k를 actualStart로 설정합니다.
2. k < (length - actualDeleteCount)인 동안 다음을 반복합니다.
  1. from을 ! ToString(𝔽(k + actualDeleteCount))로 둡니다.
  2. to를 ! ToString(𝔽(k + itemCount))로 둡니다.
  3. ? HasProperty(obj, from)가 true이면, 다음을 수행합니다.
    1. fromValue를 ? Get(obj, from)로 둡니다.
    2. ? Set(obj, to, fromValue, true)를 수행합니다.
  4. 그렇지 않으면,
    1. ? DeletePropertyOrThrow(obj, to)를 수행합니다.
  5. k를 k + 1로 설정합니다.
3. k를 length로 설정합니다.
4. k > (length - actualDeleteCount + itemCount)인 동안 다음을 반복합니다.
  1. ? DeletePropertyOrThrow(obj, ! ToString(𝔽(k - 1)))를 수행합니다.
  2. k를 k - 1로 설정합니다.
그렇지 않고 itemCount > actualDeleteCount이면, 다음을 수행합니다.
1. k를 (length - actualDeleteCount)로 설정합니다.
2. k > actualStart인 동안 다음을 반복합니다.
  1. from을 ! ToString(𝔽(k + actualDeleteCount - 1))로 둡니다.
  2. to를 ! ToString(𝔽(k + itemCount - 1))로 둡니다.
  3. ? HasProperty(obj, from)가 true이면, 다음을 수행합니다.
    1. fromValue를 ? Get(obj, from)로 둡니다.
    2. ? Set(obj, to, fromValue, true)를 수행합니다.
  4. 그렇지 않으면,
    1. ? DeletePropertyOrThrow(obj, to)를 수행합니다.
  5. k를 k - 1로 설정합니다.
k를 actualStart로 설정합니다.
items의 각 요소 item에 대해 다음을 수행합니다.
1. ? Set(obj, ! ToString(𝔽(k)), item, true)를 수행합니다.
2. k를 k + 1로 설정합니다.
? Set(obj, "length", 𝔽(length - actualDeleteCount + itemCount), true)를 수행합니다.
deletedArray를 반환합니다.

참고 2

12 및 17 단계에서 "length" 프로퍼티를 명시적으로 설정하는 것은 객체가 내장 Array가 아닌 경우에도 길이가 올바르도록 보장하기 위한 것입니다.

참고 3

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.32 Array.prototype.toLocaleString ( [ `reserved1` [ , `reserved2` ] ] )

ECMA-402 국제화 API를 포함하는 ECMAScript 구현체는 ECMA-402에 명시된 대로 이 메서드를 구현해야 합니다. 그렇지 않으면 다음과 같은 이 메서드 명세가 사용됩니다.

참고 1

ECMA-402의 초판에는 이 메서드에 대한 대체 명세가 포함되어 있지 않았습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

array를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(array)로 둡니다.
? JoinIndexedProperties(array, length, LocalizedListSeparator(), "toLocaleString")을 반환합니다.

참고 2

이 메서드는 toString과 유사하지만, 호스트 환경의 현재 로캘 관례에 따라 로캘에 민감한 결과를 생성하도록 설계되었습니다.

참고 3

이 메서드는 의도적으로 범용적으로 설계되었으며, this 값이 Array일 필요는 없습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.32.1 LocalizedListSeparator ( )

구현 정의 추상 연산 LocalizedListSeparator. 인수 없음. 반환값: String. 호스트 환경의 현재 로캘에서 목록 구분자로 사용하기에 적합한 구현 정의 String(예: ", ")을 반환합니다.

23.1.3.33 Array.prototype.toReversed ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
array를 ? ArrayCreate(length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. from을 ! ToString(𝔽(length - k - 1))로 둡니다.
2. propertyKey를 ! ToString(𝔽(k))로 둡니다.
3. fromValue를 ? Get(obj, from)로 둡니다.
4. ! CreateDataPropertyOrThrow(array, propertyKey, fromValue)를 수행합니다.
5. k를 k + 1로 설정합니다.
array를 반환합니다.

23.1.3.34 Array.prototype.toSorted ( `comparator` )

이 메서드는 호출되면 다음 단계를 수행합니다:

comparator가 undefined가 아니고 IsCallable(comparator)이 false이면 TypeError 예외를 던집니다.
obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
array를 ? ArrayCreate(length)로 둡니다.
sortCompare를 comparator를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, y)를 갖는 새로운 Abstract Closure로 둡니다:
1. ? CompareArrayElements(x, y, comparator)를 반환합니다.
sortedList를 ? SortIndexedProperties(obj, length, sortCompare, read-through-holes)로 둡니다.
j를 0으로 둡니다.
j < length인 동안 다음을 반복합니다.
1. ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(j)), sortedList[j])를 수행합니다.
2. j를 j + 1로 설정합니다.
array를 반환합니다.

23.1.3.35 Array.prototype.toSpliced ( `start`, `skipCount`, ...`items` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
actualStart를 ? ToClampedIndex(start, length)로 둡니다.
insertCount를 items의 요소 수로 둡니다.
maxSkipCount를 length - actualStart로 둡니다.
start가 존재하지 않으면, 다음을 수행합니다.
1. actualSkipCount를 0으로 둡니다.
그렇지 않고 skipCount가 존재하지 않으면, 다음을 수행합니다.
1. actualSkipCount를 maxSkipCount로 둡니다.
그렇지 않으면,
1. actualSkipCount를 ? ToIntegerOrInfinity(skipCount)을 0과 maxSkipCount 사이로 제한한 결과로 둡니다.
newLength를 length + insertCount - actualSkipCount로 둡니다.
단언: newLength ≥ 0입니다.
newLength > 2⁵³ - 1이면 TypeError 예외를 던집니다.
newArray를 ? ArrayCreate(newLength)로 둡니다.
writeIndex를 0으로 둡니다.
readIndex를 actualStart + actualSkipCount로 둡니다.
writeIndex < actualStart인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(writeIndex))로 둡니다.
2. iValue를 ? Get(obj, propertyKey)로 둡니다.
3. ! CreateDataPropertyOrThrow(newArray, propertyKey, iValue)를 수행합니다.
4. writeIndex를 writeIndex + 1로 설정합니다.
items의 각 요소 item에 대해 다음을 수행합니다.
1. propertyKey를 ! ToString(𝔽(writeIndex))로 둡니다.
2. ! CreateDataPropertyOrThrow(newArray, propertyKey, item)을 수행합니다.
3. writeIndex를 writeIndex + 1로 설정합니다.
writeIndex < newLength인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(writeIndex))로 둡니다.
2. from을 ! ToString(𝔽(readIndex))로 둡니다.
3. fromValue를 ? Get(obj, from)로 둡니다.
4. ! CreateDataPropertyOrThrow(newArray, propertyKey, fromValue)를 수행합니다.
5. writeIndex를 writeIndex + 1로 설정합니다.
6. readIndex를 readIndex + 1로 설정합니다.
newArray를 반환합니다.

23.1.3.36 Array.prototype.toString ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

array를 ? ToObject(this 값)으로 둡니다.
func를 ? Get(array, "join")로 둡니다.
IsCallable(func)이 false이면 func를 내재 함수 %Object.prototype.toString%으로 설정합니다.
? Call(func, array)를 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.37 Array.prototype.unshift ( ...`items` )

이 메서드는 인수를 배열의 시작 부분에 추가하며, 배열 안에서의 순서는 인수 목록에 나타나는 순서와 같습니다.

호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
argCount를 items의 요소 수로 둡니다.
argCount > 0이면, 다음을 수행합니다.
1. length + argCount > 2⁵³ - 1이면 TypeError 예외를 던집니다.
2. k를 length로 둡니다.
3. k > 0인 동안 다음을 반복합니다.
  1. from을 ! ToString(𝔽(k - 1))로 둡니다.
  2. to를 ! ToString(𝔽(k + argCount - 1))로 둡니다.
  3. fromPresent를 ? HasProperty(obj, from)로 둡니다.
  4. fromPresent가 true이면, 다음을 수행합니다.
    1. fromValue를 ? Get(obj, from)로 둡니다.
    2. ? Set(obj, to, fromValue, true)를 수행합니다.
  5. 그렇지 않으면,
    1. 단언: fromPresent는 false입니다.
    2. ? DeletePropertyOrThrow(obj, to)를 수행합니다.
  6. k를 k - 1로 설정합니다.
4. j를 0으로 둡니다.
5. items의 각 요소 item에 대해 다음을 수행합니다.
  1. ? Set(obj, ! ToString(𝔽(j)), item, true)를 수행합니다.
  2. j를 j + 1로 설정합니다.
? Set(obj, "length", 𝔽(length + argCount), true)를 수행합니다.
𝔽(length + argCount)를 반환합니다.

이 메서드의 "length" 프로퍼티는 1_𝔽입니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 Array일 것을 요구하지 않습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

23.1.3.38 Array.prototype.values ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
CreateArrayIterator(obj, value)를 반환합니다.

23.1.3.39 Array.prototype.with ( `index`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 ? ToObject(this 값)으로 둡니다.
length를 ? LengthOfArrayLike(obj)로 둡니다.
actualIndex를 ? ToAbsoluteIndex(index, length)로 둡니다.
actualIndex < 0 또는 actualIndex ≥ length이면 RangeError 예외를 던집니다.
array를 ? ArrayCreate(length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. k = actualIndex이면 fromValue를 value로 둡니다.
3. 그렇지 않으면 fromValue를 ? Get(obj, propertyKey)로 둡니다.
4. ! CreateDataPropertyOrThrow(array, propertyKey, fromValue)를 수행합니다.
5. k를 k + 1로 설정합니다.
array를 반환합니다.

23.1.3.40 Array.prototype [ %Symbol.iterator% ] ( )

%Symbol.iterator% 프로퍼티의 초기 값은 23.1.3.38에 정의된 %Array.prototype.values%입니다.

23.1.3.41 Array.prototype [ %Symbol.unscopables% ]

%Symbol.unscopables% 데이터 프로퍼티의 초기 값은 다음 단계로 생성된 객체입니다:

unscopableList를 OrdinaryObjectCreate(null)로 둡니다.
! CreateDataPropertyOrThrow(unscopableList, "at", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "copyWithin", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "entries", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "fill", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "find", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "findIndex", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "findLast", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "findLastIndex", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "flat", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "flatMap", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "includes", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "keys", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "toReversed", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "toSorted", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "toSpliced", true)를 수행합니다.
! CreateDataPropertyOrThrow(unscopableList, "values", true)를 수행합니다.
unscopableList를 반환합니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

참고

이 객체의 자체 프로퍼티 이름은 ECMAScript 2015 명세 이전에 Array.prototype의 표준 프로퍼티로 포함되지 않았던 프로퍼티 이름입니다. 이러한 이름 중 하나를 외부 스코프의 바인딩으로 사용하는 기존 코드에서, 바인딩 객체가 Array인 with 문이 해당 바인딩을 가리는 경우의 동작을 보존하기 위해 이 이름들은 with 문 바인딩에서 무시됩니다.

"with"가 unscopableList에 포함되지 않은 이유는 이미 예약어이기 때문입니다.

23.1.4 Array 인스턴스의 프로퍼티

Array 인스턴스는 Array 특수 객체이며 그러한 객체에 지정된 내부 메서드를 갖습니다. Array 인스턴스는 Array 프로토타입 객체에서 프로퍼티를 상속합니다.

Array 인스턴스에는 "length" 프로퍼티와 배열 인덱스 이름을 갖는 열거 가능한 프로퍼티 집합이 있습니다.

23.1.4.1 length

Array 인스턴스의 "length" 프로퍼티는 이름이 배열 인덱스인 모든 설정 가능한 자체 프로퍼티 이름보다 항상 숫자적으로 큰 값을 갖는 데이터 프로퍼티입니다.

"length" 프로퍼티는 처음에 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

참고

"length" 프로퍼티 값을 줄이면 배열 인덱스가 이전 길이 값과 새 길이 값 사이에 있는 자체 배열 요소가 삭제되는 부수 효과가 있습니다. 그러나 설정 불가능한 프로퍼티는 삭제할 수 없습니다. Array의 "length" 프로퍼티를 배열의 기존 설정 불가능한 배열 인덱스 프로퍼티 중 가장 큰 숫자 자체 프로퍼티 이름 이하의 값으로 설정하려고 하면, 길이는 해당 설정 불가능한 숫자 자체 프로퍼티 이름보다 1 큰 숫자 값으로 설정됩니다. 10.4.2.1를 참조하시기 바랍니다.

23.1.5 Array Iterator 객체

Array Iterator는 특정 Array 인스턴스 객체에 대한 특정 순회를 나타내는 객체입니다. Array Iterator 객체에는 이름 있는 생성자가 없습니다. 대신 Array Iterator 객체는 Array 인스턴스 객체의 특정 메서드를 호출하여 생성됩니다.

23.1.5.1 CreateArrayIterator ( `array`, `kind` )

추상 연산 CreateArrayIterator. 인수 array (Object) 및 kind ((key+value, key 또는 value)). 반환값: Object. 그러한 반복자를 반환하는 Array 메서드의 반복자 객체를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

iterator를 OrdinaryObjectCreate(%ArrayIteratorPrototype%, « [[IteratedArrayLike]], [[ArrayLikeNextIndex]], [[ArrayLikeIterationKind]] »)로 둡니다.
iterator.[[IteratedArrayLike]]를 array로 설정합니다.
iterator.[[ArrayLikeNextIndex]]를 0으로 설정합니다.
iterator.[[ArrayLikeIterationKind]]를 kind로 설정합니다.
iterator를 반환합니다.

23.1.5.2 %ArrayIteratorPrototype% 객체

%ArrayIteratorPrototype% 객체는:

모든 Array Iterator 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

23.1.5.2.1 %ArrayIteratorPrototype%.next ( )

iteratorObj를 this 값으로 둡니다.
iteratorObj가 Object가 아니면 TypeError 예외를 던집니다.
iteratorObj가 Array Iterator Instance의 모든 내부 슬롯(23.1.5.3)을 갖지 않으면 TypeError 예외를 던집니다.
array를 iteratorObj.[[IteratedArrayLike]]로 둡니다.
array가 undefined이면 CreateIteratorResultObject(undefined, true)를 반환합니다.
index를 iteratorObj.[[ArrayLikeNextIndex]]로 둡니다.
kind를 iteratorObj.[[ArrayLikeIterationKind]]로 둡니다.
array에 [[TypedArrayName]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. taRecord를 ? ValidateTypedArrayBounds(array, seq-cst)로 둡니다.
2. length를 TypedArrayLength(taRecord)로 둡니다.
그렇지 않으면,
1. length를 ? LengthOfArrayLike(array)로 둡니다.
index ≥ length이면, 다음을 수행합니다.
1. iteratorObj.[[IteratedArrayLike]]를 undefined로 설정합니다.
2. CreateIteratorResultObject(undefined, true)를 반환합니다.
iteratorObj.[[ArrayLikeNextIndex]]를 index + 1로 설정합니다.
indexNumber를 𝔽(index)로 둡니다.
kind가 key이면, 다음을 수행합니다.
1. result를 indexNumber로 둡니다.
그렇지 않으면,
1. elementKey를 ! ToString(indexNumber)로 둡니다.
2. elementValue를 ? Get(array, elementKey)로 둡니다.
3. kind가 value이면, 다음을 수행합니다.
  1. result를 elementValue로 둡니다.
4. 그렇지 않으면,
  1. 단언: kind는 key+value입니다.
  2. result를 CreateArrayFromList(« indexNumber, elementValue »)로 둡니다.
CreateIteratorResultObject(result, false)를 반환합니다.

23.1.5.2.2 %ArrayIteratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Array Iterator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

23.1.5.3 Array Iterator 인스턴스의 프로퍼티

Array Iterator 인스턴스는 %ArrayIteratorPrototype% 내재 객체에서 프로퍼티를 상속하는 일반 객체입니다. Array Iterator 인스턴스는 처음에 표 70에 나열된 내부 슬롯을 갖도록 생성됩니다.

표 70: Array Iterator 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[IteratedArrayLike]]`	an Object or undefined	순회 중인 배열과 유사한 객체입니다.
`[[ArrayLikeNextIndex]]`	a non-negative integer	이 반복자가 다음에 검사할 요소의 정수 인덱스입니다.
`[[ArrayLikeIterationKind]]`	key+value, key, or value	순회의 각 요소에 대해 무엇을 반환할지 식별하는 값입니다.

23.2 TypedArray 객체

TypedArray는 기반 이진 데이터 버퍼(25.1)를 배열과 유사하게 볼 수 있도록 합니다. TypedArray 요소 타입은 TypedArray 인스턴스의 모든 요소가 갖는 기반 이진 스칼라 데이터 타입입니다. 지원되는 각 요소 타입에는 표 71에 나열된 고유한 TypedArray 생성자가 있습니다. 표 71의 각 생성자에는 대응하는 고유한 프로토타입 객체가 있습니다.

표 71: TypedArray

생성자

생성자 이름 및 내재 객체	요소 타입	요소 크기	변환 연산	설명
Int8Array %Int8Array%	int8	1	ToInt8	8비트 2의 보수 부호 있는 정수
Uint8Array %Uint8Array%	uint8	1	ToUint8	8비트 부호 없는 정수
Uint8ClampedArray %Uint8ClampedArray%	uint8clamped	1	ToUint8Clamp	8비트 부호 없는 정수(제한 변환)
Int16Array %Int16Array%	int16	2	ToInt16	16비트 2의 보수 부호 있는 정수
Uint16Array %Uint16Array%	uint16	2	ToUint16	16비트 부호 없는 정수
Int32Array %Int32Array%	int32	4	ToInt32	32비트 2의 보수 부호 있는 정수
Uint32Array %Uint32Array%	uint32	4	ToUint32	32비트 부호 없는 정수
BigInt64Array %BigInt64Array%	bigint64	8	ToBigInt64	64비트 2의 보수 부호 있는 정수
BigUint64Array %BigUint64Array%	biguint64	8	ToBigUint64	64비트 부호 없는 정수
Float16Array %Float16Array%	float16	2		16비트 IEEE 부동 소수점
Float32Array %Float32Array%	float32	4		32비트 IEEE 부동 소수점
Float64Array %Float64Array%	float64	8		64비트 IEEE 부동 소수점

아래 정의에서 TypedArray에 대한 참조는 위 표의 적절한 생성자 이름으로 대체해야 합니다.

23.2.1 %TypedArray% 내재 객체

%TypedArray% 내재 객체는:

모든 TypedArray 생성자 객체가 상속하는 생성자 함수 객체입니다.
대응하는 프로토타입 객체와 함께 모든 TypedArray 생성자 및 그 인스턴스가 상속하는 공통 프로퍼티를 제공합니다.
전역 이름을 갖지 않으며 전역 객체의 프로퍼티로 나타나지 않습니다.
여러 TypedArray 생성자의 추상 상위 클래스 역할을 합니다.
추상 클래스 생성자이므로 호출되면 오류를 던집니다. TypedArray 생성자는 이에 대한 super 호출을 수행하지 않습니다.

23.2.1.1 %TypedArray% ( )

이 함수는 호출되면 다음 단계를 수행합니다:

TypeError 예외를 던집니다.

이 함수의 "length" 프로퍼티는 +0_𝔽입니다.

23.2.2 %TypedArray% 내재 객체의 프로퍼티

%TypedArray% 내재 객체는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 "TypedArray"인 "name" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

23.2.2.1 %TypedArray%.from ( `source` [ , `mapper` [ , `thisArg` ] ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

ctor를 this 값으로 둡니다.
IsConstructor(ctor)가 false이면 TypeError 예외를 던집니다.
mapper가 undefined이면, 다음을 수행합니다.
1. mapping을 false로 둡니다.
그렇지 않으면,
1. IsCallable(mapper)가 false이면 TypeError 예외를 던집니다.
2. mapping을 true로 둡니다.
usingIterator를 ? GetMethod(source, %Symbol.iterator%)로 둡니다.
usingIterator가 undefined가 아니면, 다음을 수행합니다.
1. values를 ? IteratorToList(? GetIteratorFromMethod(source, usingIterator))로 둡니다.
2. length를 values의 요소 수로 둡니다.
3. targetObj를 ? TypedArrayCreateFromConstructor(ctor, « 𝔽(length) »)로 둡니다.
4. k를 0으로 둡니다.
5. k < length인 동안 다음을 반복합니다.
  1. kValue를 values[k]로 둡니다.
  2. mapping이 true이면, 다음을 수행합니다.
    1. mappedValue를 ? Call(mapper, thisArg, « kValue, 𝔽(k) »)로 둡니다.
  3. 그렇지 않으면,
    1. mappedValue를 kValue로 둡니다.
  4. ? TypedArraySetElement(targetObj, 𝔽(k), mappedValue)를 수행합니다.
  5. k를 k + 1로 설정합니다.
6. targetObj를 반환합니다.
참고: source는 반복 가능 객체가 아니므로 이미 배열과 유사한 객체라고 가정합니다.
arrayLike를 ! ToObject(source)로 둡니다.
length를 ? LengthOfArrayLike(arrayLike)로 둡니다.
targetObj를 ? TypedArrayCreateFromConstructor(ctor, « 𝔽(length) »)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kValue를 ? Get(arrayLike, propertyKey)로 둡니다.
3. mapping이 true이면, 다음을 수행합니다.
  1. mappedValue를 ? Call(mapper, thisArg, « kValue, 𝔽(k) »)로 둡니다.
4. 그렇지 않으면,
  1. mappedValue를 kValue로 둡니다.
5. ? TypedArraySetElement(targetObj, 𝔽(k), mappedValue)를 수행합니다.
6. k를 k + 1로 설정합니다.
targetObj를 반환합니다.

23.2.2.2 %TypedArray%.of ( ...`items` )

이 메서드는 호출되면 다음 단계를 수행합니다:

length를 items의 요소 수로 둡니다.
ctor를 this 값으로 둡니다.
IsConstructor(ctor)가 false이면 TypeError 예외를 던집니다.
newObj를 ? TypedArrayCreateFromConstructor(ctor, « 𝔽(length) »)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 items[k]로 둡니다.
2. ? TypedArraySetElement(newObj, 𝔽(k), kValue)를 수행합니다.
3. k를 k + 1로 설정합니다.
newObj를 반환합니다.

23.2.2.3 %TypedArray%.prototype

%TypedArray%.prototype의 초기 값은 %TypedArray% 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

23.2.2.4 get %TypedArray% [ %Symbol.species% ]

%TypedArray%[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

%TypedArray.prototype% 메서드는 일반적으로 this 값의 생성자를 사용하여 파생 객체를 생성합니다. 그러나 하위 클래스 생성자는 자신의 %Symbol.species% 프로퍼티를 재정의하여 이 기본 동작을 재정의할 수 있습니다.

23.2.3 %TypedArray% 프로토타입 객체의 프로퍼티

%TypedArray% 프로토타입 객체는:

값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
%TypedArray.prototype%입니다.
일반 객체입니다.
[[ViewedArrayBuffer]] 또는 TypedArray 인스턴스 객체에 고유한 다른 어떤 내부 슬롯도 갖지 않습니다.

23.2.3.1 %TypedArray%.prototype.at ( `index` )

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
k를 ? ToAbsoluteIndex(index, length)로 둡니다.
k < 0 또는 k ≥ length이면 undefined를 반환합니다.
TypedArrayGetElement(obj, 𝔽(k))를 반환합니다.

23.2.3.2 get %TypedArray%.prototype.buffer

%TypedArray%.prototype.buffer는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[TypedArrayName]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
buffer를 반환합니다.

23.2.3.3 get %TypedArray%.prototype.byteLength

%TypedArray%.prototype.byteLength는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[TypedArrayName]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
taRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsTypedArrayOutOfBounds(taRecord)가 true이면 +0_𝔽을 반환합니다.
size를 TypedArrayByteLength(taRecord)로 둡니다.
𝔽(size)를 반환합니다.

23.2.3.4 get %TypedArray%.prototype.byteOffset

%TypedArray%.prototype.byteOffset은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[TypedArrayName]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
taRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsTypedArrayOutOfBounds(taRecord)가 true이면 +0_𝔽을 반환합니다.
offset을 obj.[[ByteOffset]]으로 둡니다.
𝔽(offset)을 반환합니다.

23.2.3.5 %TypedArray%.prototype.constructor

%TypedArray%.prototype.constructor의 초기 값은 %TypedArray%입니다.

23.2.3.6 %TypedArray%.prototype.copyWithin ( `target`, `start` [ , `end` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.4에 정의된 Array.prototype.copyWithin과 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
targetIndex를 ? ToClampedIndex(target, length)로 둡니다.
startIndex를 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 endIndex를 length로 둡니다. 그렇지 않으면 endIndex를 ? ToClampedIndex(end, length)로 둡니다.
count를 min(endIndex - startIndex, length - targetIndex)로 둡니다.
count > 0이면, 다음을 수행합니다.
1. 참고: 복사는 소스 데이터의 비트 수준 인코딩을 보존하는 방식으로 수행해야 합니다.
2. buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
3. taRecord를 ? ValidateTypedArrayBounds(obj, seq-cst)로 설정합니다.
4. length를 TypedArrayLength(taRecord)로 설정합니다.
5. 참고: 위 단계의 부수 효과로 obj의 크기가 줄어들었을 수 있으며, 이 경우 여전히 적용 가능한 가장 긴 접두사에 대해 복사를 계속해야 합니다.
6. count를 min(count, length - startIndex, length - targetIndex)로 설정합니다.
7. elementSize를 TypedArrayElementSize(obj)로 둡니다.
8. byteOffset을 obj.[[ByteOffset]]으로 둡니다.
9. toByteIndex를 (targetIndex × elementSize) + byteOffset으로 둡니다.
10. fromByteIndex를 (startIndex × elementSize) + byteOffset으로 둡니다.
11. countBytes를 count × elementSize로 둡니다.
12. fromByteIndex < toByteIndex이고 toByteIndex < fromByteIndex + countBytes이면, 다음을 수행합니다.
  1. direction을 -1로 둡니다.
  2. fromByteIndex를 fromByteIndex + countBytes - 1로 설정합니다.
  3. toByteIndex를 toByteIndex + countBytes - 1로 설정합니다.
13. 그렇지 않으면,
  1. direction을 1로 둡니다.
14. countBytes > 0인 동안 다음을 반복합니다.
  1. 단언: fromByteIndex ≥ 0이고 toByteIndex ≥ 0입니다.
  2. value를 GetValueFromBuffer(buffer, fromByteIndex, uint8, true, unordered)로 둡니다.
  3. SetValueInBuffer(buffer, toByteIndex, uint8, value, true, unordered)를 수행합니다.
  4. fromByteIndex를 fromByteIndex + direction으로 설정합니다.
  5. toByteIndex를 toByteIndex + direction으로 설정합니다.
  6. countBytes를 countBytes - 1로 설정합니다.
obj를 반환합니다.

23.2.3.7 %TypedArray%.prototype.entries ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? ValidateTypedArray(obj, seq-cst)를 수행합니다.
CreateArrayIterator(obj, key+value)를 반환합니다.

23.2.3.8 %TypedArray%.prototype.every ( `callback` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.6에 정의된 Array.prototype.every와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. testResult를 ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »))로 둡니다.
3. testResult가 false이면 false를 반환합니다.
4. k를 k + 1로 설정합니다.
true를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.9 %TypedArray%.prototype.fill ( `value` [ , `start` [ , `end` ] ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.7에 정의된 Array.prototype.fill과 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
obj.[[ContentType]]이 bigint이면 value를 ? ToBigInt(value)로 설정합니다.
그렇지 않으면 value를 ? ToNumber(value)로 설정합니다.
startIndex를 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 endIndex를 length로 둡니다. 그렇지 않으면 endIndex를 ? ToClampedIndex(end, length)로 둡니다.
taRecord를 ? ValidateTypedArrayBounds(obj, seq-cst)로 설정합니다.
length를 TypedArrayLength(taRecord)로 설정합니다.
endIndex를 min(endIndex, length)로 설정합니다.
k를 startIndex로 둡니다.
k < endIndex인 동안 다음을 반복합니다.
1. ! TypedArraySetElement(obj, 𝔽(k), value)를 수행합니다.
2. k를 k + 1로 설정합니다.
obj를 반환합니다.

23.2.3.10 %TypedArray%.prototype.filter ( `callback` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.8에 정의된 Array.prototype.filter와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
kept를 새로운 빈 List로 둡니다.
captured를 0으로 둡니다.
k를 0으로 둡니다.
k < length인 동안 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. selected를 ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »))로 둡니다.
3. selected가 true이면 다음을 수행합니다.
  1. kept에 kValue를 추가합니다.
  2. captured를 captured + 1로 설정합니다.
4. k를 k + 1로 설정합니다.
result를 ? TypedArraySpeciesCreate(obj, « 𝔽(captured) »)로 둡니다.
n을 0으로 둡니다.
kept의 각 요소 element에 대해 다음을 수행합니다.
1. 참고: callback을 호출하여 obj의 기반 버퍼가 분리되거나 축소되면 element는 undefined일 수 있습니다.
2. 다음을 수행합니다: ? TypedArraySetElement(result, 𝔽(n), element).
3. n을 n + 1로 설정합니다.
result를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.11 %TypedArray%.prototype.find ( `predicate` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.9에 정의된 Array.prototype.find와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, ascending, predicate, thisArg)로 둡니다.
findRecord.[[Value]]를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.12 %TypedArray%.prototype.findIndex ( `predicate` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.10에 정의된 Array.prototype.findIndex와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, ascending, predicate, thisArg)로 둡니다.
findRecord.[[Index]]를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.13 %TypedArray%.prototype.findLast ( `predicate` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.11에 정의된 Array.prototype.findLast와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, descending, predicate, thisArg)로 둡니다.
findRecord.[[Value]]를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.14 %TypedArray%.prototype.findLastIndex ( `predicate` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.12에 정의된 Array.prototype.findLastIndex와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
findRecord를 ? FindViaPredicate(obj, length, descending, predicate, thisArg)로 둡니다.
findRecord.[[Index]]를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.15 %TypedArray%.prototype.forEach ( `callback` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.15에 정의된 Array.prototype.forEach와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. ? Call(callback, thisArg, « kValue, 𝔽(k), obj »)를 수행합니다.
3. k를 k + 1로 설정합니다.
undefined를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.16 %TypedArray%.prototype.includes ( `searchElement` [ , `fromIndex` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.16에 정의된 Array.prototype.includes와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
length = 0이면 false를 반환합니다.
k를 ? ToClampedIndex(fromIndex, length)로 둡니다.
k < length인 동안 다음을 반복합니다.
1. elementK를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. SameValueZero(searchElement, elementK)가 true이면 true를 반환합니다.
3. k를 k + 1로 설정합니다.
false를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.17 %TypedArray%.prototype.indexOf ( `searchElement` [ , `fromIndex` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.17에 정의된 Array.prototype.indexOf와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
length = 0이면 -1_𝔽을 반환합니다.
k를 ? ToClampedIndex(fromIndex, length)로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ! HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. elementK를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
  2. IsStrictlyEqual(searchElement, elementK)가 true이면 𝔽(k)를 반환합니다.
4. k를 k + 1로 설정합니다.
-1_𝔽을 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.18 %TypedArray%.prototype.join ( `separator` )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.18에 정의된 Array.prototype.join과 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
separator가 undefined이면 separatorString을 ","로 둡니다; 그렇지 않으면 separatorString을 ? ToString(separator)으로 둡니다.
? JoinIndexedProperties(obj, length, separatorString)를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.19 %TypedArray%.prototype.keys ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? ValidateTypedArray(obj, seq-cst)를 수행합니다.
CreateArrayIterator(obj, key)를 반환합니다.

23.2.3.20 %TypedArray%.prototype.lastIndexOf ( `searchElement` [ , `fromIndex` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.20에 정의된 Array.prototype.lastIndexOf와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
length = 0이면 -1_𝔽을 반환합니다.
fromIndex가 존재하지 않으면 k를 length - 1로 둡니다. 그렇지 않으면 k를 min(? ToAbsoluteIndex(fromIndex, length), length - 1)로 둡니다.
k ≥ 0인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kPresent를 ! HasProperty(obj, propertyKey)로 둡니다.
3. kPresent가 true이면, 다음을 수행합니다.
  1. elementK를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
  2. IsStrictlyEqual(searchElement, elementK)가 true이면 𝔽(k)를 반환합니다.
4. k를 k - 1로 설정합니다.
-1_𝔽을 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.21 get %TypedArray%.prototype.length

%TypedArray%.prototype.length는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[TypedArrayName]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 및 [[ArrayLength]] 내부 슬롯이 있습니다.
taRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsTypedArrayOutOfBounds(taRecord)가 true이면 +0_𝔽을 반환합니다.
length를 TypedArrayLength(taRecord)로 둡니다.
𝔽(length)를 반환합니다.

이 함수는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.22 %TypedArray%.prototype.map ( `callback` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.21에 정의된 Array.prototype.map과 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
result를 ? TypedArraySpeciesCreate(obj, « 𝔽(length) »)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. mappedValue를 ? Call(callback, thisArg, « kValue, 𝔽(k), obj »)로 둡니다.
3. ? TypedArraySetElement(result, 𝔽(k), mappedValue)를 수행합니다.
4. k를 k + 1로 설정합니다.
result를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.23 %TypedArray%.prototype.reduce ( `callback` [ , `initialValue` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.24에 정의된 Array.prototype.reduce와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
length = 0이고 initialValue가 존재하지 않으면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
accumulator를 undefined로 둡니다.
initialValue가 존재하면, 다음을 수행합니다.
1. accumulator를 initialValue로 설정합니다.
그렇지 않으면,
1. accumulator를 TypedArrayGetElement(obj, 𝔽(k))로 설정합니다.
2. k를 k + 1로 설정합니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. accumulator를 ? Call(callback, undefined, « accumulator, kValue, 𝔽(k), obj »)로 설정합니다.
3. k를 k + 1로 설정합니다.
accumulator를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.24 %TypedArray%.prototype.reduceRight ( `callback` [ , `initialValue` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.25에 정의된 Array.prototype.reduceRight와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
length = 0이고 initialValue가 존재하지 않으면 TypeError 예외를 던집니다.
k를 length - 1로 둡니다.
accumulator를 undefined로 둡니다.
initialValue가 존재하면, 다음을 수행합니다.
1. accumulator를 initialValue로 설정합니다.
그렇지 않으면,
1. accumulator를 TypedArrayGetElement(obj, 𝔽(k))로 설정합니다.
2. k를 k - 1로 설정합니다.
k ≥ 0인 동안 다음을 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. accumulator를 ? Call(callback, undefined, « accumulator, kValue, 𝔽(k), obj »)로 설정합니다.
3. k를 k - 1로 설정합니다.
accumulator를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.25 %TypedArray%.prototype.reverse ( )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.26에 정의된 Array.prototype.reverse와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
middle을 floor(length / 2)로 둡니다.
lower를 0으로 둡니다.
lower ≠ middle인 동안 다음을 반복합니다.
1. upper를 length - lower - 1로 둡니다.
2. lowerValue를 TypedArrayGetElement(obj, 𝔽(lower))로 둡니다.
3. upperValue를 TypedArrayGetElement(obj, 𝔽(upper))로 둡니다.
4. ! TypedArraySetElement(obj, 𝔽(lower), upperValue)를 수행합니다.
5. ! TypedArraySetElement(obj, 𝔽(upper), lowerValue)를 수행합니다.
6. lower를 lower + 1로 설정합니다.
obj를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.26 %TypedArray%.prototype.set ( `source` [ , `offset` ] )

이 메서드는 source에서 값을 읽어 이 TypedArray에 여러 값을 설정합니다. 세부 사항은 source의 타입에 따라 다릅니다. 선택적 offset 값은 이 TypedArray에서 값을 쓰기 시작할 첫 번째 요소 인덱스를 나타냅니다. 생략하면 0으로 간주합니다.

호출되면 다음 단계를 수행합니다:

target을 this 값으로 둡니다.
? RequireInternalSlot(target, [[TypedArrayName]])를 수행합니다.
단언: target에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
targetOffset을 ? ToIntegerOrInfinity(offset)로 둡니다.
targetOffset < 0이면 RangeError 예외를 던집니다.
source가 [[TypedArrayName]] 내부 슬롯을 갖는 Object이면, 다음을 수행합니다.
1. ? SetTypedArrayFromTypedArray(target, targetOffset, source)를 수행합니다.
그렇지 않으면,
1. ? SetTypedArrayFromArrayLike(target, targetOffset, source)를 수행합니다.
undefined를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.26.1 SetTypedArrayFromArrayLike ( `target`, `targetOffset`, `source` )

추상 연산 SetTypedArrayFromArrayLike. 인수 target (TypedArray), targetOffset ((음이 아닌 정수 또는 +∞)) 및 source (an ECMAScript language value, but not a TypedArray). 반환값: (정상 완료 (값: unused) 또는 throw 완료). source에서 값을 읽어 인덱스 targetOffset부터 시작하여 target에 여러 값을 설정합니다. 호출되면 다음 단계를 수행한다.

targetRecord를 ? ValidateTypedArrayBounds(target, seq-cst)로 둡니다.
targetLength를 TypedArrayLength(targetRecord)로 둡니다.
source를 ? ToObject(source)로 설정합니다.
sourceLength를 ? LengthOfArrayLike(source)로 둡니다.
targetOffset = +∞이면 RangeError 예외를 던집니다.
sourceLength + targetOffset > targetLength이면 RangeError 예외를 던집니다.
k를 0으로 둡니다.
k < sourceLength인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. value를 ? Get(source, propertyKey)로 둡니다.
3. targetIndex를 𝔽(targetOffset + k)로 둡니다.
4. ? TypedArraySetElement(target, targetIndex, value)를 수행합니다.
5. k를 k + 1로 설정합니다.
unused를 반환합니다.

23.2.3.26.2 SetTypedArrayFromTypedArray ( `target`, `targetOffset`, `source` )

추상 연산 SetTypedArrayFromTypedArray. 인수 target (TypedArray), targetOffset ((음이 아닌 정수 또는 +∞)) 및 source (TypedArray). 반환값: (정상 완료 (값: unused) 또는 throw 완료). source에서 값을 읽어 인덱스 targetOffset부터 시작하여 target에 여러 값을 설정합니다. 호출되면 다음 단계를 수행한다.

targetBuffer를 target.[[ViewedArrayBuffer]]로 둡니다.
targetRecord를 ? ValidateTypedArrayBounds(target, seq-cst)로 둡니다.
targetLength를 TypedArrayLength(targetRecord)로 둡니다.
sourceBuffer를 source.[[ViewedArrayBuffer]]로 둡니다.
sourceRecord를 ? ValidateTypedArrayBounds(source, seq-cst)로 둡니다.
sourceLength를 TypedArrayLength(sourceRecord)로 둡니다.
targetType을 TypedArrayElementType(target)로 둡니다.
targetElementSize를 TypedArrayElementSize(target)로 둡니다.
targetByteOffset을 target.[[ByteOffset]]으로 둡니다.
sourceType을 TypedArrayElementType(source)로 둡니다.
sourceElementSize를 TypedArrayElementSize(source)로 둡니다.
sourceByteOffset을 source.[[ByteOffset]]으로 둡니다.
targetOffset = +∞이면 RangeError 예외를 던집니다.
sourceLength + targetOffset > targetLength이면 RangeError 예외를 던집니다.
target.[[ContentType]]이 source.[[ContentType]]이 아니면 TypeError 예외를 던집니다.
IsSharedArrayBuffer(sourceBuffer)가 true이고 IsSharedArrayBuffer(targetBuffer)가 true이며 sourceBuffer.[[ArrayBufferData]]가 targetBuffer.[[ArrayBufferData]]이면 sameSharedArrayBuffer를 true로 둡니다. 그렇지 않으면 sameSharedArrayBuffer를 false로 둡니다.
SameValue(sourceBuffer, targetBuffer)가 true이거나 sameSharedArrayBuffer가 true이면, 다음을 수행합니다.
1. sourceByteLength를 TypedArrayByteLength(sourceRecord)로 둡니다.
2. sourceBuffer를 ? CloneArrayBuffer(sourceBuffer, sourceByteOffset, sourceByteLength)로 설정합니다.
3. sourceByteIndex를 0으로 둡니다.
그렇지 않으면,
1. sourceByteIndex를 sourceByteOffset으로 둡니다.
targetByteIndex를 (targetOffset × targetElementSize) + targetByteOffset으로 둡니다.
limit을 targetByteIndex + (targetElementSize × sourceLength)로 둡니다.
sourceType이 targetType이면, 다음을 수행합니다.
1. 참고: 전송은 소스 데이터의 비트 수준 인코딩을 보존하는 방식으로 수행해야 합니다.
2. targetByteIndex < limit인 동안 다음을 반복합니다.
  1. value를 GetValueFromBuffer(sourceBuffer, sourceByteIndex, uint8, true, unordered)로 둡니다.
  2. SetValueInBuffer(targetBuffer, targetByteIndex, uint8, value, true, unordered)를 수행합니다.
  3. sourceByteIndex를 sourceByteIndex + 1로 설정합니다.
  4. targetByteIndex를 targetByteIndex + 1로 설정합니다.
그렇지 않으면,
1. targetByteIndex < limit인 동안 다음을 반복합니다.
  1. value를 GetValueFromBuffer(sourceBuffer, sourceByteIndex, sourceType, true, unordered)로 둡니다.
  2. SetValueInBuffer(targetBuffer, targetByteIndex, targetType, value, true, unordered)를 수행합니다.
  3. sourceByteIndex를 sourceByteIndex + sourceElementSize로 설정합니다.
  4. targetByteIndex를 targetByteIndex + targetElementSize로 설정합니다.
unused를 반환합니다.

23.2.3.27 %TypedArray%.prototype.slice ( `start`, `end` )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.28에 정의된 Array.prototype.slice와 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
sourceArrayLength를 TypedArrayLength(taRecord)로 둡니다.
startIndex를 ? ToClampedIndex(start, sourceArrayLength)로 둡니다.
end가 undefined이면 endIndex를 sourceArrayLength로 둡니다. 그렇지 않으면 endIndex를 ? ToClampedIndex(end, sourceArrayLength)로 둡니다.
countBytes를 max(endIndex - startIndex, 0)으로 둡니다.
resultArray를 ? TypedArraySpeciesCreate(obj, « 𝔽(countBytes) »)로 둡니다.
countBytes > 0이면, 다음을 수행합니다.
1. taRecord를 ? ValidateTypedArrayBounds(obj, seq-cst)로 설정합니다.
2. endIndex를 min(endIndex, TypedArrayLength(taRecord))로 설정합니다.
3. countBytes를 max(endIndex - startIndex, 0)으로 설정합니다.
4. sourceType을 TypedArrayElementType(obj)로 둡니다.
5. targetType을 TypedArrayElementType(resultArray)로 둡니다.
6. sourceType이 targetType이면, 다음을 수행합니다.
  1. 참고: 전송은 소스 데이터의 비트 수준 인코딩을 보존하는 방식으로 수행해야 합니다.
  2. sourceBuffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
  3. targetBuffer를 resultArray.[[ViewedArrayBuffer]]로 둡니다.
  4. elementSize를 TypedArrayElementSize(obj)로 둡니다.
  5. sourceByteOffset을 obj.[[ByteOffset]]으로 둡니다.
  6. sourceByteIndex를 (startIndex × elementSize) + sourceByteOffset으로 둡니다.
  7. targetByteIndex를 resultArray.[[ByteOffset]]으로 둡니다.
  8. endByteIndex를 targetByteIndex + (countBytes × elementSize)로 둡니다.
  9. targetByteIndex < endByteIndex인 동안 다음을 반복합니다.
    1. value를 GetValueFromBuffer(sourceBuffer, sourceByteIndex, uint8, true, unordered)로 둡니다.
    2. SetValueInBuffer(targetBuffer, targetByteIndex, uint8, value, true, unordered)를 수행합니다.
    3. sourceByteIndex를 sourceByteIndex + 1로 설정합니다.
    4. targetByteIndex를 targetByteIndex + 1로 설정합니다.
7. 그렇지 않으면,
  1. n을 0으로 둡니다.
  2. k를 startIndex로 둡니다.
  3. k < endIndex인 동안 다음을 반복합니다.
    1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
    2. ! TypedArraySetElement(resultArray, 𝔽(n), kValue)를 수행합니다.
    3. k를 k + 1로 설정합니다.
    4. n을 n + 1로 설정합니다.
resultArray를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.28 %TypedArray%.prototype.some ( `callback` [ , `thisArg` ] )

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.29에 정의된 Array.prototype.some과 같습니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
2. testResult를 ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »))로 둡니다.
3. testResult가 true이면 true를 반환합니다.
4. k를 k + 1로 설정합니다.
false를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.29 %TypedArray%.prototype.sort ( `comparator` )

이 메서드는 별개의 메서드이지만 아래에 설명된 사항을 제외하면 23.1.3.30에 정의된 Array.prototype.sort와 동일한 요구 사항을 구현합니다. this 값이 고정된 길이를 가지며 정수 인덱스 프로퍼티가 희소하지 않은 객체라는 사실을 이용하여 이 메서드의 구현을 최적화할 수 있습니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

호출되면 다음 단계를 수행합니다:

comparator가 undefined가 아니고 IsCallable(comparator)이 false이면 TypeError 예외를 던집니다.
obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
참고: 다음 클로저는 23.1.3.30에서 사용하는 문자열 비교 대신 숫자 비교를 수행합니다.
sortCompare를 comparator를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, y)를 갖는 새로운 Abstract Closure로 둡니다:
1. ? CompareTypedArrayElements(x, y, comparator)를 반환합니다.
sortedList를 ? SortIndexedProperties(obj, length, sortCompare, read-through-holes)로 둡니다.
j를 0으로 둡니다.
j < length인 동안 다음을 반복합니다.
1. ! TypedArraySetElement(obj, 𝔽(j), sortedList[j])를 수행합니다.
2. j를 j + 1로 설정합니다.
obj를 반환합니다.

참고

NaN은 항상 다른 모든 값보다 큰 것으로 비교되므로(CompareTypedArrayElements 참조), comparator가 제공되지 않은 경우 NaN 프로퍼티 값은 항상 결과의 끝으로 정렬됩니다.

23.2.3.30 %TypedArray%.prototype.subarray ( `start`, `end` )

이 메서드는 요소 타입이 이 TypedArray의 요소 타입이고 ArrayBuffer가 이 TypedArray의 ArrayBuffer이며, start(포함)부터 end(제외)까지의 구간에 있는 요소를 참조하는 새로운 TypedArray를 반환합니다. start 또는 end가 음수이면 배열의 시작이 아니라 끝에서부터의 인덱스를 나타냅니다.

호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[TypedArrayName]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
sourceRecord를 MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsTypedArrayOutOfBounds(sourceRecord)가 true이면, 다음을 수행합니다.
1. sourceLength를 0으로 둡니다.
그렇지 않으면,
1. sourceLength를 TypedArrayLength(sourceRecord)로 둡니다.
startIndex를 ? ToClampedIndex(start, sourceLength)로 둡니다.
elementSize를 TypedArrayElementSize(obj)로 둡니다.
sourceByteOffset을 obj.[[ByteOffset]]으로 둡니다.
beginByteOffset을 sourceByteOffset + (startIndex × elementSize)로 둡니다.
obj.[[ArrayLength]]가 auto이고 end가 undefined이면, 다음을 수행합니다.
1. ? TypedArraySpeciesCreate(obj, « buffer, 𝔽(beginByteOffset) »)를 반환합니다.
end가 undefined이면 endIndex를 sourceLength로 둡니다. 그렇지 않으면 endIndex를 ? ToClampedIndex(end, sourceLength)로 둡니다.
newLength를 max(endIndex - startIndex, 0)으로 둡니다.
? TypedArraySpeciesCreate(obj, « buffer, 𝔽(beginByteOffset), 𝔽(newLength) »)를 반환합니다.

이 메서드는 일반적이지 않습니다. this 값은 [[TypedArrayName]] 내부 슬롯을 갖는 객체여야 합니다.

23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ `reserved1` [ , `reserved2` ] ] )

ECMA-402 국제화 API를 포함하는 ECMAScript 구현은 ECMA-402에 명시된 대로 이 메서드를 구현해야 합니다. 그렇지 않은 경우에는 다음에 제시된 이 메서드의 명세를 사용합니다.

이 메서드의 인수를 해석하고 사용하는 방식은 23.1.3.32에 정의된 Array.prototype.toLocaleString의 경우와 동일합니다.

이 메서드는 호출될 때 다음 단계를 수행합니다.

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
? JoinIndexedProperties(obj, length, LocalizedListSeparator(), "toLocaleString")을 반환합니다.

23.2.3.32 %TypedArray%.prototype.toReversed ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
resultArray를 ? TypedArrayCreateSameType(obj, length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. from을 length - k - 1로 둡니다.
2. fromValue를 TypedArrayGetElement(obj, 𝔽(from))로 둡니다.
3. ! TypedArraySetElement(resultArray, 𝔽(k), fromValue)를 수행합니다.
4. k를 k + 1로 설정합니다.
resultArray를 반환합니다.

23.2.3.33 %TypedArray%.prototype.toSorted ( `comparator` )

이 메서드는 호출되면 다음 단계를 수행합니다:

comparator가 undefined가 아니고 IsCallable(comparator)이 false이면 TypeError 예외를 던집니다.
obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
resultArray를 ? TypedArrayCreateSameType(obj, length)로 둡니다.
참고: 다음 클로저는 23.1.3.34에서 사용하는 문자열 비교 대신 숫자 비교를 수행합니다.
sortCompare를 comparator를 캡처하고 호출될 때 다음 단계를 수행하는 매개변수 (x, y)를 갖는 새로운 Abstract Closure로 둡니다:
1. ? CompareTypedArrayElements(x, y, comparator)를 반환합니다.
sortedList를 ? SortIndexedProperties(obj, length, sortCompare, read-through-holes)로 둡니다.
j를 0으로 둡니다.
j < length인 동안 다음을 반복합니다.
1. ! TypedArraySetElement(resultArray, 𝔽(j), sortedList[j])를 수행합니다.
2. j를 j + 1로 설정합니다.
resultArray를 반환합니다.

23.2.3.34 %TypedArray%.prototype.toString ( )

"toString" 프로퍼티의 초기 값은 23.1.3.36에 정의된 %Array.prototype.toString%입니다.

23.2.3.35 %TypedArray%.prototype.values ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? ValidateTypedArray(obj, seq-cst)를 수행합니다.
CreateArrayIterator(obj, value)를 반환합니다.

23.2.3.36 %TypedArray%.prototype.with ( `index`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
taRecord를 ? ValidateTypedArray(obj, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
actualIndex를 ? ToAbsoluteIndex(index, length)로 둡니다.
obj.[[ContentType]]이 bigint이면 numericValue를 ? ToBigInt(value)로 둡니다.
그렇지 않으면 numericValue를 ? ToNumber(value)로 둡니다.
IsValidIntegerIndex(obj, 𝔽(actualIndex))가 false이면 RangeError 예외를 던집니다.
resultArray를 ? TypedArrayCreateSameType(obj, length)로 둡니다.
k를 0으로 둡니다.
k < length인 동안 반복합니다.
1. k = actualIndex이면 fromValue를 numericValue로 둡니다.
2. 그렇지 않으면 fromValue를 TypedArrayGetElement(obj, 𝔽(k))로 둡니다.
3. 참고: index 또는 value가 Number나 BigInt로 변환될 때 코드를 실행하는 객체이고, 해당 코드가 obj의 기반 버퍼를 축소하면 fromValue는 undefined일 수 있습니다.
4. 다음을 수행합니다: ? TypedArraySetElement(resultArray, 𝔽(k), fromValue).
5. k를 k + 1로 설정합니다.
resultArray를 반환합니다.

23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )

%Symbol.iterator% 프로퍼티의 초기 값은 23.2.3.35에 정의된 %TypedArray.prototype.values%입니다.

23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]

%TypedArray%.prototype[%Symbol.toStringTag%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 undefined를 반환합니다.
obj에 [[TypedArrayName]] 내부 슬롯이 없으면 undefined를 반환합니다.
name을 obj.[[TypedArrayName]]으로 둡니다.
단언: name은 String입니다.
name을 반환합니다.

이 프로퍼티는 { [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

이 함수의 "name" 프로퍼티의 초기 값은 "get [Symbol.toStringTag]"입니다.

23.2.4 TypedArray 객체를 위한 추상 연산

23.2.4.1 TypedArrayCreateFromConstructor ( `ctor`, `argList` )

추상 연산 TypedArrayCreateFromConstructor. 인수 ctor (생성자) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: TypedArray) 또는 throw 완료). 생성자 함수를 사용하여 새로운 TypedArray를 생성하는 것을 명시하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

ta를 ? Construct(ctor, argList)로 둡니다.
taRecord를 ? ValidateTypedArray(ta, seq-cst)로 둡니다.
단언: ta는 TypedArray 인스턴스의 프로퍼티에서 언급된 모든 내부 슬롯을 갖습니다.
argList의 요소 수가 1이고 argList[0]이 Number이면, 다음을 수행합니다.
1. IsTypedArrayOutOfBounds(taRecord)가 true이면 TypeError 예외를 던집니다.
2. length를 TypedArrayLength(taRecord)로 둡니다.
3. length < ℝ(argList[0])이면 TypeError 예외를 던집니다.
ta를 반환합니다.

23.2.4.2 TypedArrayCreateSameType ( `exemplar`, `length` )

추상 연산 TypedArrayCreateSameType. 인수 exemplar (TypedArray) 및 length (음이 아닌 정수). 반환값: (정상 완료 (값: TypedArray) 또는 throw 완료). exemplar에서 파생된 생성자 함수를 사용하여 새로운 TypedArray를 생성하는 것을 명시하는 데 사용됩니다. %Symbol.species%를 사용하여 사용자 정의 TypedArray 하위 클래스를 생성할 수 있는 TypedArraySpeciesCreate와 달리 이 연산은 항상 내장 TypedArray 생성자 중 하나를 사용합니다. 호출되면 다음 단계를 수행한다.

ctor를 표 71에서 생성자 이름 exemplar.[[TypedArrayName]]과 연결된 내재 객체로 둡니다.
result를 ? TypedArrayCreateFromConstructor(ctor, « 𝔽(length) »)로 둡니다.
단언: result에는 [[TypedArrayName]] 및 [[ContentType]] 내부 슬롯이 있습니다.
단언: result.[[ContentType]]은 exemplar.[[ContentType]]입니다.
result를 반환합니다.

23.2.4.3 TypedArraySpeciesCreate ( `exemplar`, `argList` )

추상 연산 TypedArraySpeciesCreate. 인수 exemplar (TypedArray) 및 argList (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: TypedArray) 또는 throw 완료). exemplar에서 파생된 생성자 함수를 사용하여 새로운 TypedArray를 생성하는 것을 명시하는 데 사용됩니다. %Symbol.species%를 사용하여 Array가 아닌 객체를 생성할 수 있는 ArraySpeciesCreate와 달리 이 연산은 생성자 함수가 실제 TypedArray를 생성하도록 강제합니다. 호출되면 다음 단계를 수행한다.

defaultCtor를 표 71에서 생성자 이름 exemplar.[[TypedArrayName]]과 연결된 내재 객체로 둡니다.
ctor를 ? SpeciesConstructor(exemplar, defaultCtor)로 둡니다.
result를 ? TypedArrayCreateFromConstructor(ctor, argList)로 둡니다.
result.[[ContentType]]이 exemplar.[[ContentType]]이 아니면 TypeError 예외를 던집니다.
result를 반환합니다.

23.2.4.4 ValidateTypedArray ( `obj`, `order` )

추상 연산 ValidateTypedArray. 인수 obj (ECMAScript 언어 값) 및 order ((seq-cst 또는 unordered)). 반환값: (정상 완료 (값: TypedArray With Buffer Witness 레코드) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(obj, [[TypedArrayName]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
? ValidateTypedArrayBounds(obj, order)를 반환합니다.

23.2.4.5 ValidateTypedArrayBounds ( `ta`, `order` )

추상 연산 ValidateTypedArrayBounds. 인수 ta (TypedArray) 및 order ((seq-cst 또는 unordered)). 반환값: (정상 완료 (값: TypedArray With Buffer Witness 레코드) 또는 throw 완료). ta가 기반 버퍼의 범위를 초과하지 않는지 검증합니다. 호출되면 다음 단계를 수행한다.

taRecord를 MakeTypedArrayWithBufferWitnessRecord(ta, order)로 둡니다.
IsTypedArrayOutOfBounds(taRecord)가 true이면 TypeError 예외를 던집니다.
taRecord를 반환합니다.

23.2.4.6 TypedArrayElementSize ( `obj` )

추상 연산 TypedArrayElementSize. 인수 obj (TypedArray). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

obj.[[TypedArrayName]]에 대해 표 71에 지정된 Element Size 값을 반환합니다.

23.2.4.7 TypedArrayElementType ( `obj` )

추상 연산 TypedArrayElementType. 인수 obj (TypedArray). 반환값: TypedArray 요소 타입. 호출되면 다음 단계를 수행한다.

obj.[[TypedArrayName]]에 대해 표 71에 지정된 Element Type 값을 반환합니다.

23.2.4.8 CompareTypedArrayElements ( `x`, `y`, `comparator` )

추상 연산 CompareTypedArrayElements. 인수 x ((Number 또는 BigInt)), y ((Number 또는 BigInt)) 및 comparator ((함수 객체 또는 undefined)). 반환값: (정상 완료 (값: Number) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

단언: x가 Number이고 y가 Number이거나, x가 BigInt이고 y가 BigInt입니다.
comparator가 undefined가 아니면, 다음을 수행합니다.
1. result를 ? ToNumber(? Call(comparator, undefined, « x, y »))로 둡니다.
2. result가 NaN이면 +0_𝔽을 반환합니다.
3. result를 반환합니다.
x가 NaN이고 y가 NaN이면 +0_𝔽을 반환합니다.
x가 NaN이면 1_𝔽을 반환합니다.
y가 NaN이면 -1_𝔽을 반환합니다.
x < y이면 -1_𝔽을 반환합니다.
x > y이면 1_𝔽을 반환합니다.
x가 -0_𝔽이고 y가 +0_𝔽이면 -1_𝔽을 반환합니다.
x가 +0_𝔽이고 y가 -0_𝔽이면 1_𝔽을 반환합니다.
+0_𝔽을 반환합니다.

참고

이는 23.1.3.30.2에서 사용하는 문자열 비교 대신 숫자 비교를 수행합니다.

23.2.5 `TypedArray` 생성자

각 TypedArray 생성자는:

달리 언급된 경우를 제외하고 표 71에서 TypedArray 대신 생성자 이름으로 사용되는 이름만 다르며 아래에 설명된 구조를 갖는 내재 객체입니다.
인수의 수와 타입에 따라 동작이 달라지는 함수입니다. TypedArray 호출의 실제 동작은 전달되는 인수의 수와 종류에 따라 달라집니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 TypedArray 동작을 상속하려는 하위 클래스 생성자는 %TypedArray%.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 TypedArray 생성자에 대한 super 호출을 포함해야 합니다.

23.2.5.1 `TypedArray` ( ...`args` )

각 TypedArray 생성자는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
ctorName을 이 TypedArray 생성자에 대해 표 71에 지정된 Constructor Name 값의 String 값으로 둡니다.
proto를 "%TypedArray.prototype%"로 둡니다.
numberOfArgs를 args의 요소 수로 둡니다.
numberOfArgs = 0이면 ? AllocateTypedArray(ctorName, NewTarget, proto, 0)을 반환합니다.
firstArg를 args[0]으로 둡니다.
firstArg가 Object이면, 다음을 수행합니다.
1. obj를 ? AllocateTypedArray(ctorName, NewTarget, proto)로 둡니다.
2. firstArg에 [[TypedArrayName]] 내부 슬롯이 있으면, 다음을 수행합니다.
  1. ? InitializeTypedArrayFromTypedArray(obj, firstArg)를 수행합니다.
3. 그렇지 않고 firstArg에 [[ArrayBufferData]] 내부 슬롯이 있으면, 다음을 수행합니다.
  1. numberOfArgs > 1이면 byteOffset을 args[1]로 둡니다. 그렇지 않으면 byteOffset을 undefined로 둡니다.
  2. numberOfArgs > 2이면 length를 args[2]로 둡니다. 그렇지 않으면 length를 undefined로 둡니다.
  3. ? InitializeTypedArrayFromArrayBuffer(obj, firstArg, byteOffset, length)를 수행합니다.
4. 그렇지 않으면,
  1. 단언: firstArg는 Object이고 firstArg에는 [[TypedArrayName]] 또는 [[ArrayBufferData]] 내부 슬롯 중 어느 것도 없습니다.
  2. usingIterator를 ? GetMethod(firstArg, %Symbol.iterator%)로 둡니다.
  3. usingIterator가 undefined가 아니면, 다음을 수행합니다.
    1. values를 ? IteratorToList(? GetIteratorFromMethod(firstArg, usingIterator))로 둡니다.
    2. ? InitializeTypedArrayFromList(obj, values)를 수행합니다.
  4. 그렇지 않으면,
    1. 참고: firstArg는 반복 가능 객체가 아니므로 이미 배열과 유사한 객체라고 가정합니다.
    2. ? InitializeTypedArrayFromArrayLike(obj, firstArg)를 수행합니다.
5. obj를 반환합니다.
단언: firstArg는 Object가 아닙니다.
elementLength를 ? ToIndex(firstArg)로 둡니다.
? AllocateTypedArray(ctorName, NewTarget, proto, elementLength)를 반환합니다.

23.2.5.1.1 AllocateTypedArray ( `ctorName`, `newTarget`, `defaultProto` [ , `length` ] )

추상 연산 AllocateTypedArray. 인수 ctorName (a String which is the name of a TypedArray constructor in 표 71), newTarget (생성자) 및 defaultProto (String) 및 선택적 인수 length (음이 아닌 정수). 반환값: (정상 완료 (값: TypedArray) 또는 throw 완료). TypedArray 생성자의 인스턴스를 검증하고 생성하는 데 사용됩니다. length 인수가 전달되면 해당 길이의 ArrayBuffer도 할당하여 새로운 TypedArray 인스턴스와 연결합니다. AllocateTypedArray는 TypedArray가 사용하는 공통 의미론을 제공합니다. 호출되면 다음 단계를 수행한다.

proto를 ? GetPrototypeFromConstructor(newTarget, defaultProto)로 둡니다.
obj를 TypedArrayCreate(proto)로 둡니다.
단언: obj.[[ViewedArrayBuffer]]는 undefined입니다.
obj.[[TypedArrayName]]을 ctorName으로 설정합니다.
ctorName이 "BigInt64Array" 또는 "BigUint64Array" 중 하나이면 obj.[[ContentType]]을 bigint로 설정합니다.
그렇지 않으면 obj.[[ContentType]]을 number로 설정합니다.
length가 존재하지 않으면, 다음을 수행합니다.
1. obj.[[ByteLength]]를 0으로 설정합니다.
2. obj.[[ByteOffset]]을 0으로 설정합니다.
3. obj.[[ArrayLength]]를 0으로 설정합니다.
그렇지 않으면,
1. ? AllocateTypedArrayBuffer(obj, length)를 수행합니다.
obj를 반환합니다.

23.2.5.1.2 InitializeTypedArrayFromTypedArray ( `obj`, `sourceArray` )

추상 연산 InitializeTypedArrayFromTypedArray. 인수 obj (TypedArray) 및 sourceArray (TypedArray). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

sourceData를 sourceArray.[[ViewedArrayBuffer]]로 둡니다.
elementType을 TypedArrayElementType(obj)로 둡니다.
elementSize를 TypedArrayElementSize(obj)로 둡니다.
sourceType을 TypedArrayElementType(sourceArray)로 둡니다.
sourceElementSize를 TypedArrayElementSize(sourceArray)로 둡니다.
sourceByteOffset을 sourceArray.[[ByteOffset]]으로 둡니다.
sourceRecord를 ? ValidateTypedArrayBounds(sourceArray, seq-cst)로 둡니다.
elementLength를 TypedArrayLength(sourceRecord)로 둡니다.
byteLength를 elementSize × elementLength로 둡니다.
elementType이 sourceType이면, 다음을 수행합니다.
1. data를 ? CloneArrayBuffer(sourceData, sourceByteOffset, byteLength)로 둡니다.
그렇지 않으면,
1. data를 ? AllocateArrayBuffer(%ArrayBuffer%, byteLength)로 둡니다.
2. sourceArray.[[ContentType]]이 obj.[[ContentType]]이 아니면 TypeError 예외를 던집니다.
3. sourceByteIndex를 sourceByteOffset으로 둡니다.
4. targetByteIndex를 0으로 둡니다.
5. count를 elementLength로 둡니다.
6. count > 0인 동안 다음을 반복합니다.
  1. value를 GetValueFromBuffer(sourceData, sourceByteIndex, sourceType, true, unordered)로 둡니다.
  2. SetValueInBuffer(data, targetByteIndex, elementType, value, true, unordered)를 수행합니다.
  3. sourceByteIndex를 sourceByteIndex + sourceElementSize로 설정합니다.
  4. targetByteIndex를 targetByteIndex + elementSize로 설정합니다.
  5. count를 count - 1로 설정합니다.
obj.[[ViewedArrayBuffer]]를 data로 설정합니다.
obj.[[ByteLength]]를 byteLength로 설정합니다.
obj.[[ByteOffset]]을 0으로 설정합니다.
obj.[[ArrayLength]]를 elementLength로 설정합니다.
unused를 반환합니다.

23.2.5.1.3 InitializeTypedArrayFromArrayBuffer ( `obj`, `buffer`, `byteOffset`, `length` )

추상 연산 InitializeTypedArrayFromArrayBuffer. 인수 obj (TypedArray), buffer ((ArrayBuffer 또는 SharedArrayBuffer)), byteOffset (ECMAScript 언어 값) 및 length (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

elementSize를 TypedArrayElementSize(obj)로 둡니다.
offset을 ? ToIndex(byteOffset)로 둡니다.
offset modulo elementSize ≠ 0이면 RangeError 예외를 던집니다.
bufferIsFixedLength를 IsFixedLengthArrayBuffer(buffer)로 둡니다.
length가 undefined가 아니면, 다음을 수행합니다.
1. newLength를 ? ToIndex(length)로 둡니다.
IsDetachedBuffer(buffer)가 true이면 TypeError 예외를 던집니다.
bufferByteLength를 ArrayBufferByteLength(buffer, seq-cst)로 둡니다.
length가 undefined이고 bufferIsFixedLength가 false이면, 다음을 수행합니다.
1. offset > bufferByteLength이면 RangeError 예외를 던집니다.
2. obj.[[ByteLength]]를 auto로 설정합니다.
3. obj.[[ArrayLength]]를 auto로 설정합니다.
그렇지 않으면,
1. length가 undefined이면, 다음을 수행합니다.
  1. bufferByteLength modulo elementSize ≠ 0이면 RangeError 예외를 던집니다.
  2. newByteLength를 bufferByteLength - offset으로 둡니다.
  3. newByteLength < 0이면 RangeError 예외를 던집니다.
2. 그렇지 않으면,
  1. newByteLength를 newLength × elementSize로 둡니다.
  2. offset + newByteLength > bufferByteLength이면 RangeError 예외를 던집니다.
3. obj.[[ByteLength]]를 newByteLength로 설정합니다.
4. obj.[[ArrayLength]]를 newByteLength / elementSize로 설정합니다.
obj.[[ViewedArrayBuffer]]를 buffer로 설정합니다.
obj.[[ByteOffset]]을 offset으로 설정합니다.
unused를 반환합니다.

23.2.5.1.4 InitializeTypedArrayFromList ( `obj`, `values` )

추상 연산 InitializeTypedArrayFromList. 인수 obj (TypedArray) 및 values (리스트 (요소: ECMAScript 언어 값)). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

length를 values의 요소 수로 둡니다.
? AllocateTypedArrayBuffer(obj, length)를 수행합니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. kValue를 values[k]로 둡니다.
2. ? TypedArraySetElement(obj, 𝔽(k), kValue)를 수행합니다.
3. k를 k + 1로 설정합니다.
unused를 반환합니다.

23.2.5.1.5 InitializeTypedArrayFromArrayLike ( `obj`, `arrayLike` )

추상 연산 InitializeTypedArrayFromArrayLike. 인수 obj (TypedArray) 및 arrayLike (an Object, but not a TypedArray or an ArrayBuffer). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

length를 ? LengthOfArrayLike(arrayLike)로 둡니다.
? AllocateTypedArrayBuffer(obj, length)를 수행합니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
2. kValue를 ? Get(arrayLike, propertyKey)로 둡니다.
3. ? TypedArraySetElement(obj, 𝔽(k), kValue)를 수행합니다.
4. k를 k + 1로 설정합니다.
unused를 반환합니다.

23.2.5.1.6 AllocateTypedArrayBuffer ( `obj`, `length` )

추상 연산 AllocateTypedArrayBuffer. 인수 obj (TypedArray) 및 length (음이 아닌 정수). 반환값: (정상 완료 (값: unused) 또는 throw 완료). ArrayBuffer를 할당하여 obj와 연결합니다. 호출되면 다음 단계를 수행한다.

단언: obj.[[ViewedArrayBuffer]]는 undefined입니다.
elementSize를 TypedArrayElementSize(obj)로 둡니다.
byteLength를 elementSize × length로 둡니다.
data를 ? AllocateArrayBuffer(%ArrayBuffer%, byteLength)로 둡니다.
obj.[[ViewedArrayBuffer]]를 data로 설정합니다.
obj.[[ByteLength]]를 byteLength로 설정합니다.
obj.[[ByteOffset]]을 0으로 설정합니다.
obj.[[ArrayLength]]를 length로 설정합니다.
unused를 반환합니다.

23.2.6 `TypedArray` 생성자의 프로퍼티

각 TypedArray 생성자는:

값이 %TypedArray%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 3_𝔽인 "length" 프로퍼티를 갖습니다.
값이 표 71에서 해당 생성자에 지정된 생성자 이름의 String 값인 "name" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

23.2.6.1 `TypedArray`.BYTES_PER_ELEMENT

TypedArray.BYTES_PER_ELEMENT의 값은 TypedArray에 대해 표 71에 지정된 Element Size 값입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

23.2.6.2 `TypedArray`.prototype

TypedArray.prototype의 초기 값은 대응하는 TypedArray 프로토타입 내재 객체(23.2.7)입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

23.2.7 `TypedArray` 프로토타입 객체의 프로퍼티

각 TypedArray 프로토타입 객체는:

값이 %TypedArray.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[ViewedArrayBuffer]] 또는 TypedArray 인스턴스 객체에 고유한 다른 어떤 내부 슬롯도 갖지 않습니다.

23.2.7.1 `TypedArray`.prototype.BYTES_PER_ELEMENT

TypedArray.prototype.BYTES_PER_ELEMENT의 값은 TypedArray에 대해 표 71에 지정된 Element Size 값입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

23.2.7.2 `TypedArray`.prototype.constructor

주어진 TypedArray 생성자의 프로토타입에 있는 "constructor" 프로퍼티의 초기 값은 해당 생성자 자체입니다.

23.2.8 `TypedArray` 인스턴스의 프로퍼티

TypedArray 인스턴스는 TypedArray입니다. 각 TypedArray 인스턴스는 대응하는 TypedArray 프로토타입 객체에서 프로퍼티를 상속합니다. 각 TypedArray 인스턴스는 [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] 내부 슬롯을 갖습니다.

23.3 Uint8Array 객체

Uint8Array는 위에서 설명한 특정 종류의 TypedArray입니다. 또한 Uint8Array 생성자(23.3.1)와 Uint8Array 프로토타입 객체(23.3.2)에는 추가 메서드가 있습니다.

23.3.1 Uint8Array 생성자의 추가 프로퍼티

23.3.1.1 Uint8Array.fromBase64 ( `string` [ , `options` ] )

string이 String이 아니면 TypeError 예외를 던집니다.
optionsObj를 ? GetOptionsObject(options)로 둡니다.
alphabet을 ? Get(optionsObj, "alphabet")로 둡니다.
alphabet이 undefined이면 alphabet을 "base64"로 설정합니다.
alphabet이 "base64"도 "base64url"도 아니면 TypeError 예외를 던집니다.
lastChunkHandling을 ? Get(optionsObj, "lastChunkHandling")로 둡니다.
lastChunkHandling이 undefined이면 lastChunkHandling을 "loose"로 설정합니다.
lastChunkHandling이 "loose", "strict" 또는 "stop-before-partial" 중 하나가 아니면 TypeError 예외를 던집니다.
result를 FromBase64(string, alphabet, lastChunkHandling)로 둡니다.
result.[[Error]]가 none이 아니면, 다음을 수행합니다.
1. result.[[Error]]를 던집니다.
resultLength를 result.[[Bytes]]의 요소 수로 둡니다.
ta를 ? AllocateTypedArray("Uint8Array", %Uint8Array%, "%Uint8Array.prototype%", resultLength)로 둡니다.
단언: ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]]는 result.[[Bytes]]의 요소 수입니다.
ta.[[ViewedArrayBuffer]].[[ArrayBufferData]]의 각 인덱스 값을 result.[[Bytes]]의 대응하는 인덱스 값으로 설정합니다.
ta를 반환합니다.

23.3.1.2 Uint8Array.fromHex ( `string` )

string이 String이 아니면 TypeError 예외를 던집니다.
result를 FromHex(string)로 둡니다.
result.[[Error]]가 none이 아니면, 다음을 수행합니다.
1. result.[[Error]]를 던집니다.
resultLength를 result.[[Bytes]]의 요소 수로 둡니다.
ta를 ? AllocateTypedArray("Uint8Array", %Uint8Array%, "%Uint8Array.prototype%", resultLength)로 둡니다.
단언: ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]]는 result.[[Bytes]]의 요소 수입니다.
ta.[[ViewedArrayBuffer]].[[ArrayBufferData]]의 각 인덱스 값을 result.[[Bytes]]의 대응하는 인덱스 값으로 설정합니다.
ta를 반환합니다.

23.3.2 Uint8Array 프로토타입 객체의 추가 프로퍼티

23.3.2.1 Uint8Array.prototype.setFromBase64 ( `string` [ , `options` ] )

into를 this 값으로 둡니다.
? ValidateUint8Array(into)를 수행합니다.
string이 String이 아니면 TypeError 예외를 던집니다.
optionsObj를 ? GetOptionsObject(options)로 둡니다.
alphabet을 ? Get(optionsObj, "alphabet")로 둡니다.
alphabet이 undefined이면 alphabet을 "base64"로 설정합니다.
alphabet이 "base64"도 "base64url"도 아니면 TypeError 예외를 던집니다.
lastChunkHandling을 ? Get(optionsObj, "lastChunkHandling")로 둡니다.
lastChunkHandling이 undefined이면 lastChunkHandling을 "loose"로 설정합니다.
lastChunkHandling이 "loose", "strict" 또는 "stop-before-partial" 중 하나가 아니면 TypeError 예외를 던집니다.
taRecord를 ? ValidateTypedArrayBounds(into, seq-cst)로 둡니다.
byteLength를 TypedArrayLength(taRecord)로 둡니다.
result를 FromBase64(string, alphabet, lastChunkHandling, byteLength)로 둡니다.
bytes를 result.[[Bytes]]로 둡니다.
written을 bytes의 요소 수로 둡니다.
참고: FromBase64는 사용자 코드를 호출하지 않으므로 into의 기반 ArrayBuffer는 분리되거나 축소될 수 없습니다.
단언: written ≤ byteLength입니다.
SetUint8ArrayBytes(into, bytes)를 수행합니다.
result.[[Error]]가 none이 아니면, 다음을 수행합니다.
1. result.[[Error]]를 던집니다.
resultObj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
! CreateDataPropertyOrThrow(resultObj, "read", 𝔽(result.[[Read]]))를 수행합니다.
! CreateDataPropertyOrThrow(resultObj, "written", 𝔽(written))을 수행합니다.
resultObj를 반환합니다.

23.3.2.2 Uint8Array.prototype.setFromHex ( `string` )

into를 this 값으로 둡니다.
? ValidateUint8Array(into)를 수행합니다.
string이 String이 아니면 TypeError 예외를 던집니다.
taRecord를 ? ValidateTypedArrayBounds(into, seq-cst)로 둡니다.
byteLength를 TypedArrayLength(taRecord)로 둡니다.
result를 FromHex(string, byteLength)로 둡니다.
bytes를 result.[[Bytes]]로 둡니다.
written을 bytes의 요소 수로 둡니다.
참고: FromHex는 사용자 코드를 호출하지 않으므로 into의 기반 ArrayBuffer는 분리되거나 축소될 수 없습니다.
단언: written ≤ byteLength입니다.
SetUint8ArrayBytes(into, bytes)를 수행합니다.
result.[[Error]]가 none이 아니면, 다음을 수행합니다.
1. result.[[Error]]를 던집니다.
resultObj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
! CreateDataPropertyOrThrow(resultObj, "read", 𝔽(result.[[Read]]))를 수행합니다.
! CreateDataPropertyOrThrow(resultObj, "written", 𝔽(written))을 수행합니다.
resultObj를 반환합니다.

23.3.2.3 Uint8Array.prototype.toBase64 ( [ `options` ] )

obj를 this 값으로 둡니다.
? ValidateUint8Array(obj)를 수행합니다.
optionsObj를 ? GetOptionsObject(options)로 둡니다.
alphabet을 ? Get(optionsObj, "alphabet")로 둡니다.
alphabet이 undefined이면 alphabet을 "base64"로 설정합니다.
alphabet이 "base64"도 "base64url"도 아니면 TypeError 예외를 던집니다.
omitPadding을 ToBoolean(? Get(optionsObj, "omitPadding"))으로 둡니다.
toEncode를 ? GetUint8ArrayBytes(obj)로 둡니다.
alphabet이 "base64"이면, 다음을 수행합니다.
1. outAscii를 RFC 4648 제4절에 지정된 base64 인코딩에 따라 toEncode를 인코딩한 결과인 코드 포인트 시퀀스로 둡니다. 패딩은 omitPadding이 false인 경우에만 포함됩니다.
그렇지 않으면,
1. 단언: alphabet은 "base64url"입니다.
2. outAscii를 RFC 4648 제5절에 지정된 base64url 인코딩에 따라 toEncode를 인코딩한 결과인 코드 포인트 시퀀스로 둡니다. 패딩은 omitPadding이 false인 경우에만 포함됩니다.
CodePointsToString(outAscii)을 반환합니다.

23.3.2.4 Uint8Array.prototype.toHex ( )

obj를 this 값으로 둡니다.
? ValidateUint8Array(obj)를 수행합니다.
toEncode를 ? GetUint8ArrayBytes(obj)로 둡니다.
out을 빈 String으로 둡니다.
toEncode의 각 바이트 byte에 대해 다음을 수행합니다.
1. hex를 Number::toString(𝔽(byte), 16)으로 둡니다.
2. hex를 StringPad(hex, 2, "0", start)로 설정합니다.
3. out을 out과 hex의 문자열 연결로 설정합니다.
out을 반환합니다.

23.3.3 Uint8Array 객체를 위한 추상 연산

23.3.3.1 ValidateUint8Array ( `ta` )

추상 연산 ValidateUint8Array. 인수 ta (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(ta, [[TypedArrayName]])를 수행합니다.
ta.[[TypedArrayName]]이 "Uint8Array"가 아니면 TypeError 예외를 던집니다.
unused를 반환합니다.

23.3.3.2 GetUint8ArrayBytes ( `ta` )

추상 연산 GetUint8ArrayBytes. 인수 ta (Uint8Array). 반환값: (정상 완료 (값: 리스트 (요소: 바이트 값)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

buffer를 ta.[[ViewedArrayBuffer]]로 둡니다.
taRecord를 ? ValidateTypedArrayBounds(ta, seq-cst)로 둡니다.
length를 TypedArrayLength(taRecord)로 둡니다.
byteOffset을 ta.[[ByteOffset]]으로 둡니다.
bytes를 새로운 빈 List로 둡니다.
index를 0으로 둡니다.
index < length인 동안 다음을 반복합니다.
1. byteIndex를 byteOffset + index로 둡니다.
2. byte를 ℝ(GetValueFromBuffer(buffer, byteIndex, uint8, true, unordered))로 둡니다.
3. byte를 bytes에 추가합니다.
4. index를 index + 1로 설정합니다.
bytes를 반환합니다.

23.3.3.3 SetUint8ArrayBytes ( `into`, `bytes` )

추상 연산 SetUint8ArrayBytes. 인수 into (Uint8Array) 및 bytes (리스트 (요소: 바이트 값)). 반환값: unused. 호출되면 다음 단계를 수행한다.

offset을 into.[[ByteOffset]]으로 둡니다.
length를 bytes의 요소 수로 둡니다.
index를 0으로 둡니다.
index < length인 동안 다음을 반복합니다.
1. byte를 bytes[index]로 둡니다.
2. byteIndexInBuffer를 index + offset으로 둡니다.
3. SetValueInBuffer(into.[[ViewedArrayBuffer]], byteIndexInBuffer, uint8, 𝔽(byte), true, unordered)를 수행합니다.
4. index를 index + 1로 설정합니다.
unused를 반환합니다.

23.3.3.4 SkipAsciiWhitespace ( `string`, `index` )

추상 연산 SkipAsciiWhitespace. 인수 string (String) 및 index (음이 아닌 정수). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

length를 string의 길이로 둡니다.
index < length인 동안 다음을 반복합니다.
1. char를 string 안의 인덱스 index에 있는 코드 단위로 둡니다.
2. char가 0x0009 (TAB), 0x000A (LF), 0x000C (FF), 0x000D (CR) 또는 0x0020 (SPACE) 중 하나가 아니면, 다음을 수행합니다.
  1. index를 반환합니다.
3. index를 index + 1로 설정합니다.
index를 반환합니다.

23.3.3.5 DecodeFinalBase64Chunk ( `chunk`, `throwOnExtraBits` )

추상 연산 DecodeFinalBase64Chunk. 인수 chunk ((a String of length 2 또는 3)) 및 throwOnExtraBits (Boolean). 반환값: (정상 완료 (값: 리스트 (요소: 바이트 값)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

chunkLength를 chunk의 길이로 둡니다.
chunkLength = 2이면, 다음을 수행합니다.
1. chunk를 chunk과 "AA"의 문자열 연결로 설정합니다.
그렇지 않으면,
1. 단언: chunkLength는 3입니다.
2. chunk를 chunk과 "A"의 문자열 연결로 설정합니다.
bytes를 DecodeFullLengthBase64Chunk(chunk)로 둡니다.
chunkLength = 2이면, 다음을 수행합니다.
1. throwOnExtraBits가 true이고 bytes[1] ≠ 0이면 SyntaxError 예외를 던집니다.
2. « bytes[0] »을 반환합니다.
throwOnExtraBits가 true이고 bytes[2] ≠ 0이면 SyntaxError 예외를 던집니다.
« bytes[0], bytes[1] »을 반환합니다.

23.3.3.6 DecodeFullLengthBase64Chunk ( `chunk` )

추상 연산 DecodeFullLengthBase64Chunk. 인수 chunk (a String of length 4). 반환값: 리스트 (요소: byte values of length 3).

표준 base64 알파벳은 "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"입니다. 즉, 유니코드 Basic Latin 블록의 모든 문자와 숫자에 대응하는 코드 단위에 "+" 및 "/"를 더한 것을 요소로 갖는 String입니다.

byteSequence를 chunk를 base64로 디코딩하여 얻는 고유한 3바이트 시퀀스로 둡니다(즉, RFC 4648 제4절에 지정된 base64 인코딩을 byteSequence에 적용하면 chunk가 생성되는 시퀀스).
byteSequence의 요소를 순서대로 요소로 갖는 List를 반환합니다.

23.3.3.7 FromBase64 ( `string`, `alphabet`, `lastChunkHandling` [ , `maxLength` ] )

추상 연산 FromBase64. 인수 string (String), alphabet (("base64" 또는 "base64url")) 및 lastChunkHandling (("loose", "strict" 또는 "stop-before-partial")) 및 선택적 인수 maxLength (음이 아닌 정수). 반환값: 레코드 (필드: [[Read]] (정수), [[Bytes]] (리스트 (요소: 바이트 값)), [[Error]] ((a SyntaxError object 또는 none))). 호출되면 다음 단계를 수행한다.

maxLength가 존재하지 않으면, 다음을 수행합니다.
1. maxLength를 2⁵³ - 1로 설정합니다.
2. 참고: 입력이 String이므로 String의 길이는 2⁵³ - 1자로 제한되고, 출력에 필요한 바이트 수는 입력의 문자 수보다 많지 않으므로 이 제한에는 절대 도달할 수 없습니다. 그러나 편집상 maxLength에 유한 값을 사용하는 것이 편리합니다.
참고: 아래 알고리즘에서 검증과 디코딩의 순서는 관찰할 수 없습니다. 구현체는 가장 효율적인 순서로 수행하는 것이 권장되며, 검증과 디코딩을 서로 섞어서 수행할 수도 있습니다.
maxLength = 0이면, 다음을 수행합니다.
1. Record { [[Read]]: 0, [[Bytes]]: « », [[Error]]: none }을 반환합니다.
read를 0으로 둡니다.
bytes를 새로운 빈 List로 둡니다.
chunk을 빈 String으로 둡니다.
chunkLength를 0으로 둡니다.
index를 0으로 둡니다.
length를 string의 길이로 둡니다.
다음을 반복합니다.
1. 단언: bytes의 요소 수는 3으로 나누어떨어집니다.
2. index를 SkipAsciiWhitespace(string, index)로 설정합니다.
3. index = length이면, 다음을 수행합니다.
  1. chunkLength > 0이면, 다음을 수행합니다.
    1. lastChunkHandling이 "stop-before-partial"이면, 다음을 수행합니다.
      1. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.
    2. lastChunkHandling이 "strict"이면, 다음을 수행합니다.
      1. error를 새로 생성된 SyntaxError 객체로 둡니다.
      2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
    3. 단언: lastChunkHandling은 "loose"입니다.
    4. chunkLength = 1이면, 다음을 수행합니다.
      1. error를 새로 생성된 SyntaxError 객체로 둡니다.
      2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
    5. bytes를 bytes와 ! DecodeFinalBase64Chunk(chunk, false)의 목록 연결로 설정합니다.
  2. Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.
4. char를 string의 index부터 index + 1까지의 부분 문자열로 둡니다.
5. index를 index + 1로 설정합니다.
6. char가 "="이면, 다음을 수행합니다.
  1. chunkLength < 2이면, 다음을 수행합니다.
    1. error를 새로 생성된 SyntaxError 객체로 둡니다.
    2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
  2. index를 SkipAsciiWhitespace(string, index)로 설정합니다.
  3. chunkLength = 2이면, 다음을 수행합니다.
    1. index = length이면, 다음을 수행합니다.
      1. lastChunkHandling이 "stop-before-partial"이면, 다음을 수행합니다.
        Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.
      2. error를 새로 생성된 SyntaxError 객체로 둡니다.
      3. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
    2. char를 string의 index부터 index + 1까지의 부분 문자열로 설정합니다.
    3. char가 "="이면, 다음을 수행합니다.
      1. index를 SkipAsciiWhitespace(string, index + 1)로 설정합니다.
  4. index < length이면, 다음을 수행합니다.
    1. error를 새로 생성된 SyntaxError 객체로 둡니다.
    2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
  5. lastChunkHandling이 "strict"이면 throwOnExtraBits를 true로 둡니다. 그렇지 않으면 throwOnExtraBits를 false로 둡니다.
  6. decodeResult를 Completion(DecodeFinalBase64Chunk(chunk, throwOnExtraBits))로 둡니다.
  7. decodeResult가 갑작스러운 완료이면, 다음을 수행합니다.
    1. error를 decodeResult.[[Value]]로 둡니다.
    2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
  8. bytes를 bytes와 ! decodeResult의 목록 연결로 설정합니다.
  9. Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.
7. alphabet이 "base64url"이면, 다음을 수행합니다.
  1. char가 "+" 또는 "/" 중 하나이면, 다음을 수행합니다.
    1. error를 새로 생성된 SyntaxError 객체로 둡니다.
    2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
  2. 그렇지 않고 char가 "-"이면, 다음을 수행합니다.
    1. char를 "+"로 설정합니다.
  3. 그렇지 않고 char가 "_"이면, 다음을 수행합니다.
    1. char를 "/"로 설정합니다.
8. char의 유일한 코드 단위가 표준 base64 알파벳의 요소가 아니면, 다음을 수행합니다.
  1. error를 새로 생성된 SyntaxError 객체로 둡니다.
  2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
9. remaining을 maxLength - bytes의 요소 수로 둡니다.
10. remaining = 1이고 chunkLength = 2이거나, remaining = 2이고 chunkLength = 3이면, 다음을 수행합니다.
  1. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.
11. chunk을 chunk과 char의 문자열 연결로 설정합니다.
12. chunkLength를 chunk의 길이로 설정합니다.
13. chunkLength = 4이면, 다음을 수행합니다.
  1. bytes를 bytes와 DecodeFullLengthBase64Chunk(chunk)의 목록 연결로 설정합니다.
  2. chunk을 빈 String으로 설정합니다.
  3. chunkLength를 0으로 설정합니다.
  4. read를 index로 설정합니다.
  5. bytes의 요소 수 = maxLength이면, 다음을 수행합니다.
    1. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.

23.3.3.8 FromHex ( `string` [ , `maxLength` ] )

추상 연산 FromHex. 인수 string (String) 및 선택적 인수 maxLength (음이 아닌 정수). 반환값: 레코드 (필드: [[Read]] (정수), [[Bytes]] (리스트 (요소: 바이트 값)), [[Error]] ((a SyntaxError object 또는 none))). 호출되면 다음 단계를 수행한다.

maxLength가 존재하지 않으면 maxLength를 2⁵³ - 1로 설정합니다.
length를 string의 길이로 둡니다.
bytes를 새로운 빈 List로 둡니다.
read를 0으로 둡니다.
length modulo 2 ≠ 0이면, 다음을 수행합니다.
1. error를 새로 생성된 SyntaxError 객체로 둡니다.
2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
read < length이고 bytes의 요소 수 < maxLength인 동안 다음을 반복합니다.
1. hexits를 string의 read부터 read + 2까지의 부분 문자열로 둡니다.
2. hexits에 "0123456789abcdefABCDEF"에 포함되지 않은 코드 단위가 있으면, 다음을 수행합니다.
  1. error를 새로 생성된 SyntaxError 객체로 둡니다.
  2. Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }를 반환합니다.
3. read를 read + 2로 설정합니다.
4. byte를 16진법 표기에서 hexits가 나타내는 정수 값으로 둡니다. 값 10부터 15까지의 숫자에는 문자 A부터 F 및 a부터 f를 사용합니다.
5. byte를 bytes에 추가합니다.
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: none }을 반환합니다.

24 키 컬렉션

24.1 Map 객체

Map은 키와 값 모두 임의의 ECMAScript language value일 수 있는 키/값 쌍의 컬렉션입니다. 서로 다른 키 값은 Map의 컬렉션 안에서 하나의 키/값 쌍에만 존재할 수 있습니다. 서로 다른 키 값은 SameValueZero 비교 알고리즘의 의미론을 사용하여 구별합니다.

Map은 평균적으로 컬렉션의 요소 수에 대해 선형보다 빠른 접근 시간을 제공하는 해시 테이블이나 그 밖의 메커니즘을 사용하여 구현해야 합니다. 이 명세에서 사용하는 데이터 구조는 Map에 요구되는 관찰 가능한 의미론을 설명하기 위한 것일 뿐입니다. 실제 구현 모델로 사용하려는 것은 아닙니다.

24.1.1 Map 생성자

Map 생성자는:

%Map%입니다.
전역 객체의 "Map" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 Map을 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 Map 동작을 상속하려는 하위 클래스 생성자는 Map.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Map 생성자에 대한 super 호출을 포함해야 합니다.

24.1.1.1 Map ( [ `iterable` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
map을 ? OrdinaryCreateFromConstructor(NewTarget, "%Map.prototype%", « [[MapData]] »)로 둡니다.
map.[[MapData]]를 새로운 빈 List로 설정합니다.
iterable이 undefined 또는 null이면 map을 반환합니다.
adder를 ? Get(map, "set")으로 둡니다.
IsCallable(adder)가 false이면 TypeError 예외를 던집니다.
? AddEntriesFromIterable(map, iterable, adder)를 반환합니다.

참고

매개변수 iterable이 존재하는 경우, 첫 번째 요소는 Map 키로 사용할 값이고 두 번째 요소는 해당 키와 연결할 값인 두 요소의 배열과 유사한 객체를 생성하는 반복자 객체를 반환하는 %Symbol.iterator% 메서드를 구현한 객체일 것으로 예상됩니다.

24.1.1.2 AddEntriesFromIterable ( `target`, `iterable`, `adder` )

추상 연산 AddEntriesFromIterable. 인수 target (Object), iterable (an ECMAScript language value, but not undefined or null) 및 adder (함수 객체). 반환값: (정상 완료 (값: Object) 또는 throw 완료). adder는 target을 수신자로 하여 호출됩니다. 호출되면 다음 단계를 수행한다.

iteratorRecord를 ? GetIterator(iterable, sync)로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면 target을 반환합니다.
3. next가 Object가 아니면, 다음을 수행합니다.
  1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
  2. ? IteratorClose(iteratorRecord, error)를 반환합니다.
4. key를 Completion(Get(next, "0"))으로 둡니다.
5. IfAbruptCloseIterator(key, iteratorRecord).
6. value를 Completion(Get(next, "1"))으로 둡니다.
7. IfAbruptCloseIterator(value, iteratorRecord).
8. status를 Completion(Call(adder, target, « key, value »))로 둡니다.
9. IfAbruptCloseIterator(status, iteratorRecord).

참고

매개변수 iterable은 첫 번째 요소는 Map 키로 사용할 값이고 두 번째 요소는 해당 키와 연결할 값인 두 요소의 배열과 유사한 객체를 생성하는 반복자 객체를 반환하는 %Symbol.iterator% 메서드를 구현한 객체일 것으로 예상됩니다.

24.1.2 Map 생성자의 프로퍼티

Map 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

24.1.2.1 Map.groupBy ( `items`, `callback` )

참고

callback은 두 인수를 받는 함수여야 합니다. groupBy는 items의 각 요소에 대해 오름차순으로 callback을 한 번씩 호출하고 새로운 Map을 구성합니다. callback이 반환하는 각 값은 Map의 키로 사용됩니다. 그러한 각 키에 대해 결과 Map에는 해당 키를 키로 하고 callback이 해당 키를 반환한 모든 요소를 포함하는 배열을 값으로 하는 항목이 있습니다.

callback은 요소의 값과 요소의 인덱스라는 두 인수로 호출됩니다.

groupBy의 반환 값은 Map입니다.

이 함수는 호출되면 다음 단계를 수행합니다:

groups를 ? GroupBy(items, callback, collection)로 둡니다.
map을 ! Construct(%Map%)으로 둡니다.
groups의 각 Record { [[Key]], [[Elements]] } group에 대해 다음을 수행합니다.
1. elements를 CreateArrayFromList(group.[[Elements]])로 둡니다.
2. entry를 Record { [[Key]]: group.[[Key]], [[Value]]: elements }로 둡니다.
3. entry를 map.[[MapData]]에 추가합니다.
map을 반환합니다.

24.1.2.2 Map.prototype

Map.prototype의 초기 값은 Map 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

24.1.2.3 get Map [ %Symbol.species% ]

Map[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

파생 컬렉션 객체를 생성하는 메서드는 파생 객체를 생성하는 데 사용할 생성자를 결정하기 위해 %Symbol.species%를 호출해야 합니다. 하위 클래스 생성자는 기본 생성자 할당을 변경하기 위해 %Symbol.species%를 재정의할 수 있습니다.

24.1.3 Map 프로토타입 객체의 프로퍼티

Map 프로토타입 객체는:

%Map.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[MapData]] 내부 슬롯을 갖지 않습니다.

24.1.3.1 Map.prototype.clear ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]를 empty로 설정합니다.
2. entry.[[Value]]를 empty로 설정합니다.
undefined를 반환합니다.

참고

해당 List를 순회하는 도중 일시 중단된 기존 Map Iterator 객체가 있을 수 있으므로 기존 [[MapData]] List를 유지합니다.

24.1.3.2 Map.prototype.constructor

Map.prototype.constructor의 초기 값은 %Map%입니다.

24.1.3.3 Map.prototype.delete ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. entry.[[Key]]를 empty로 설정합니다.
  2. entry.[[Value]]를 empty로 설정합니다.
  3. true를 반환합니다.
false를 반환합니다.

참고

값 empty는 항목이 삭제되었음을 나타내기 위한 명세상의 장치로 사용됩니다. 실제 구현체는 내부 데이터 구조에서 항목을 물리적으로 제거하는 등의 다른 동작을 수행할 수 있습니다.

24.1.3.4 Map.prototype.entries ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? CreateMapIterator(map, key+value)를 반환합니다.

24.1.3.5 Map.prototype.forEach ( `callback` [ , `thisArg` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
entries를 map.[[MapData]]로 둡니다.
entriesCount를 entries의 요소 수로 둡니다.
index를 0으로 둡니다.
index < entriesCount인 동안 다음을 반복합니다.
1. entry를 entries[index]로 둡니다.
2. index를 index + 1로 설정합니다.
3. entry.[[Key]]가 empty가 아니면, 다음을 수행합니다.
  1. ? Call(callback, thisArg, « entry.[[Value]], entry.[[Key]], map »)를 수행합니다.
  2. 참고: callback 실행 중 entries의 요소 수가 증가했을 수 있습니다.
  3. entriesCount를 entries의 요소 수로 설정합니다.
undefined를 반환합니다.

참고

callback은 세 인수를 받는 함수여야 합니다. forEach는 Map에 존재하는 각 키/값 쌍에 대해 키 삽입 순서로 callback을 한 번씩 호출합니다. callback은 Map에 실제로 존재하는 키에 대해서만 호출되며 Map에서 삭제된 키에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 항목의 값, 항목의 키, 순회 중인 Map이라는 세 인수로 호출됩니다.

forEach는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다. Map의 [[MapData]]에 있는 각 항목은 한 번만 방문됩니다. forEach 호출이 시작된 후 추가된 새로운 키는 방문됩니다. 키가 방문된 후 삭제되고 forEach 호출이 완료되기 전에 다시 추가되면 해당 키를 다시 방문합니다. forEach 호출이 시작된 후 방문되기 전에 삭제된 키는 forEach 호출이 완료되기 전에 다시 추가되지 않는 한 방문되지 않습니다.

24.1.3.6 Map.prototype.get ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 entry.[[Value]]를 반환합니다.
undefined를 반환합니다.

24.1.3.7 Map.prototype.getOrInsert ( `key`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 entry.[[Value]]를 반환합니다.
entry를 Record { [[Key]]: key, [[Value]]: value }로 둡니다.
entry를 map.[[MapData]]에 추가합니다.
value를 반환합니다.

24.1.3.8 Map.prototype.getOrInsertComputed ( `key`, `callback` )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 entry.[[Value]]를 반환합니다.
value를 ? Call(callback, undefined, « key »)로 둡니다.
참고: callback 실행 중 Map이 변경되었을 수 있습니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. entry.[[Value]]를 value로 설정합니다.
  2. value를 반환합니다.
entry를 Record { [[Key]]: key, [[Value]]: value }로 둡니다.
entry를 map.[[MapData]]에 추가합니다.
value를 반환합니다.

24.1.3.9 Map.prototype.has ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 true를 반환합니다.
false를 반환합니다.

24.1.3.10 Map.prototype.keys ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? CreateMapIterator(map, key)를 반환합니다.

24.1.3.11 Map.prototype.set ( `key`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
key를 CanonicalizeKeyedCollectionKey(key)로 설정합니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. entry.[[Value]]를 value로 설정합니다.
  2. map을 반환합니다.
entry를 Record { [[Key]]: key, [[Value]]: value }로 둡니다.
entry를 map.[[MapData]]에 추가합니다.
map을 반환합니다.

24.1.3.12 get Map.prototype.size

Map.prototype.size는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? RequireInternalSlot(map, [[MapData]])를 수행합니다.
count를 0으로 둡니다.
map.[[MapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니면 count를 count + 1로 설정합니다.
𝔽(count)를 반환합니다.

24.1.3.13 Map.prototype.values ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

map을 this 값으로 둡니다.
? CreateMapIterator(map, value)를 반환합니다.

24.1.3.14 Map.prototype [ %Symbol.iterator% ] ( )

%Symbol.iterator% 프로퍼티의 초기 값은 24.1.3.4에 정의된 %Map.prototype.entries%입니다.

24.1.3.15 Map.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Map"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

24.1.4 Map 인스턴스의 프로퍼티

Map 인스턴스는 Map 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. Map 인스턴스는 [[MapData]] 내부 슬롯도 갖습니다.

24.1.5 Map Iterator 객체

Map Iterator는 특정 Map 인스턴스 객체에 대한 특정 순회를 나타내는 객체입니다. Map Iterator 객체에는 이름 있는 생성자가 없습니다. 대신 Map Iterator 객체는 Map 인스턴스 객체의 특정 메서드를 호출하여 생성됩니다.

24.1.5.1 CreateMapIterator ( `map`, `kind` )

추상 연산 CreateMapIterator. 인수 map (ECMAScript 언어 값) 및 kind ((key+value, key 또는 value)). 반환값: (정상 완료 (값: Generator) 또는 throw 완료). 그러한 반복자를 반환하는 Map 메서드의 반복자 객체를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(map, [[MapData]])를 수행합니다.
closure를 매개변수가 없고 map과 kind를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. entries를 map.[[MapData]]로 둡니다.
2. index를 0으로 둡니다.
3. entriesCount를 entries의 요소 수로 둡니다.
4. index < entriesCount인 동안 다음을 반복합니다.
  1. entry를 entries[index]로 둡니다.
  2. index를 index + 1로 설정합니다.
  3. entry.[[Key]]가 empty가 아니면, 다음을 수행합니다.
    1. kind가 key이면, 다음을 수행합니다.
      1. result를 entry.[[Key]]로 둡니다.
    2. 그렇지 않고 kind가 value이면, 다음을 수행합니다.
      1. result를 entry.[[Value]]로 둡니다.
    3. 그렇지 않으면,
      1. 단언: kind는 key+value입니다.
      2. result를 CreateArrayFromList(« entry.[[Key]], entry.[[Value]] »)로 둡니다.
    4. ? GeneratorYield(CreateIteratorResultObject(result, false))를 수행합니다.
    5. 참고: GeneratorYield에 의해 이 추상 연산의 실행이 일시 중단된 동안 entries의 요소 수가 증가했을 수 있습니다.
    6. entriesCount를 entries의 요소 수로 설정합니다.
5. NormalCompletion(unused)을 반환합니다.
CreateIteratorFromClosure(closure, "%MapIteratorPrototype%", %MapIteratorPrototype%)을 반환합니다.

24.1.5.2 %MapIteratorPrototype% 객체

%MapIteratorPrototype% 객체는:

모든 Map Iterator 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

24.1.5.2.1 %MapIteratorPrototype%.next ( )

? GeneratorResume(this 값, empty, "%MapIteratorPrototype%")를 반환합니다.

24.1.5.2.2 %MapIteratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Map Iterator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

24.2 Set 객체

Set 객체는 ECMAScript language value의 컬렉션입니다. Set은 서로 다른 각 값을 최대 한 번만 포함할 수 있습니다. 서로 다른 값은 SameValueZero 비교 알고리즘의 의미론을 사용하여 구별합니다.

Set 객체는 평균적으로 컬렉션의 요소 수에 대해 선형보다 빠른 접근 시간을 제공하는 해시 테이블이나 그 밖의 메커니즘을 사용하여 구현해야 합니다. 이 명세에서 사용하는 데이터 구조는 Set 객체에 요구되는 관찰 가능한 의미론을 설명하기 위한 것일 뿐입니다. 실제 구현 모델로 사용하려는 것은 아닙니다.

24.2.1 Set 객체를 위한 추상 연산

24.2.1.1 Set Records

Set Record는 Set 또는 유사한 객체의 인터페이스를 캡슐화하는 데 사용되는 Record입니다.

Set Records에는 표 72에 나열된 필드가 있습니다.

표 72: Set Record 필드

필드 이름	값	의미
`[[SetObject]]`	an Object	Set 또는 유사한 객체입니다.
`[[Size]]`	a non-negative integer or +∞	보고된 객체의 크기입니다.
`[[Has]]`	a function object	객체의 `has` 메서드입니다.
`[[Keys]]`	a function object	객체의 `keys` 메서드입니다.

24.2.1.2 GetSetRecord ( `obj` )

추상 연산 GetSetRecord. 인수 obj (ECMAScript 언어 값). 반환값: (정상 완료 (값: Set 레코드) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

obj가 Object가 아니면 TypeError 예외를 던집니다.
rawSize를 ? Get(obj, "size")로 둡니다.
numberSize를 ? ToNumber(rawSize)로 둡니다.
참고: rawSize가 undefined이면 numberSize는 NaN이 됩니다.
numberSize가 NaN이면 TypeError 예외를 던집니다.
intSize를 ! ToIntegerOrInfinity(numberSize)로 둡니다.
intSize < 0이면 RangeError 예외를 던집니다.
has를 ? Get(obj, "has")로 둡니다.
IsCallable(has)가 false이면 TypeError 예외를 던집니다.
keys를 ? Get(obj, "keys")로 둡니다.
IsCallable(keys)가 false이면 TypeError 예외를 던집니다.
새로운 Set Record { [[SetObject]]: obj, [[Size]]: intSize, [[Has]]: has, [[Keys]]: keys }를 반환합니다.

24.2.1.3 SetDataHas ( `setData`, `value` )

추상 연산 SetDataHas. 인수 setData (리스트 (요소: (ECMAScript 언어 값 또는 empty))) 및 value (ECMAScript 언어 값). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

SetDataIndex(setData, value)가 not-found이면 false를 반환합니다.
true를 반환합니다.

24.2.1.4 SetDataIndex ( `setData`, `value` )

추상 연산 SetDataIndex. 인수 setData (리스트 (요소: (ECMAScript 언어 값 또는 empty))) 및 value (ECMAScript 언어 값). 반환값: (음이 아닌 정수 또는 not-found). 호출되면 다음 단계를 수행한다.

value를 CanonicalizeKeyedCollectionKey(value)로 설정합니다.
size를 setData의 요소 수로 둡니다.
index를 0으로 둡니다.
index < size인 동안 다음을 반복합니다.
1. element를 setData[index]로 둡니다.
2. element가 empty가 아니고 element가 value이면, 다음을 수행합니다.
  1. index를 반환합니다.
3. index를 index + 1로 설정합니다.
not-found를 반환합니다.

24.2.1.5 SetDataSize ( `setData` )

추상 연산 SetDataSize. 인수 setData (리스트 (요소: (ECMAScript 언어 값 또는 empty))). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

count를 0으로 둡니다.
setData의 각 요소 element에 대해 다음을 수행합니다.
1. element가 empty가 아니면 count를 count + 1로 설정합니다.
count를 반환합니다.

24.2.2 Set 생성자

Set 생성자는:

%Set%입니다.
전역 객체의 "Set" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 Set 객체를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 Set 동작을 상속하려는 하위 클래스 생성자는 Set.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Set 생성자에 대한 super 호출을 포함해야 합니다.

24.2.2.1 Set ( [ `iterable` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
set을 ? OrdinaryCreateFromConstructor(NewTarget, "%Set.prototype%", « [[SetData]] »)로 둡니다.
set.[[SetData]]를 새로운 빈 List로 설정합니다.
iterable이 undefined 또는 null이면 set을 반환합니다.
adder를 ? Get(set, "add")로 둡니다.
IsCallable(adder)가 false이면 TypeError 예외를 던집니다.
iteratorRecord를 ? GetIterator(iterable, sync)로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면 set을 반환합니다.
3. status를 Completion(Call(adder, set, « next »))로 둡니다.
4. IfAbruptCloseIterator(status, iteratorRecord).

24.2.3 Set 생성자의 프로퍼티

Set 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

24.2.3.1 Set.prototype

Set.prototype의 초기 값은 Set 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

24.2.3.2 get Set [ %Symbol.species% ]

Set[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

24.2.4 Set 프로토타입 객체의 프로퍼티

Set 프로토타입 객체는:

%Set.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[SetData]] 내부 슬롯을 갖지 않습니다.

24.2.4.1 Set.prototype.add ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
value를 CanonicalizeKeyedCollectionKey(value)로 설정합니다.
set.[[SetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. entry가 empty가 아니고 SameValue(entry, value)가 true이면, 다음을 수행합니다.
  1. set을 반환합니다.
value를 set.[[SetData]]에 추가합니다.
set을 반환합니다.

24.2.4.2 Set.prototype.clear ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
set.[[SetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. 값이 entry인 set.[[SetData]]의 요소를 값이 empty인 요소로 대체합니다.
undefined를 반환합니다.

참고

해당 List를 순회하는 도중 일시 중단된 기존 Set Iterator 객체가 있을 수 있으므로 기존 [[SetData]] List를 유지합니다.

24.2.4.3 Set.prototype.constructor

Set.prototype.constructor의 초기 값은 %Set%입니다.

24.2.4.4 Set.prototype.delete ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
value를 CanonicalizeKeyedCollectionKey(value)로 설정합니다.
set.[[SetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. entry가 empty가 아니고 SameValue(entry, value)가 true이면, 다음을 수행합니다.
  1. 값이 entry인 set.[[SetData]]의 요소를 값이 empty인 요소로 대체합니다.
  2. true를 반환합니다.
false를 반환합니다.

참고

24.2.4.5 Set.prototype.difference ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
resultSetData를 set.[[SetData]]의 복사본으로 둡니다.
SetDataSize(set.[[SetData]]) ≤ otherRecord.[[Size]]이면, 다음을 수행합니다.
1. thisSize를 set.[[SetData]]의 요소 수로 둡니다.
2. index를 0으로 둡니다.
3. index < thisSize인 동안 다음을 반복합니다.
  1. entry를 resultSetData[index]로 둡니다.
  2. entry가 empty가 아니면, 다음을 수행합니다.
    1. inOther를 ToBoolean(? Call(otherRecord.[[Has]], otherRecord.[[SetObject]], « entry »))로 둡니다.
    2. inOther가 true이면, 다음을 수행합니다.
      1. resultSetData[index]를 empty로 설정합니다.
  3. index를 index + 1로 설정합니다.
그렇지 않으면,
1. keysIterator를 ? GetIteratorFromMethod(otherRecord.[[SetObject]], otherRecord.[[Keys]])로 둡니다.
2. next를 not-started로 둡니다.
3. next가 done이 아닌 동안 다음을 반복합니다.
  1. next를 ? IteratorStepValue(keysIterator)로 설정합니다.
  2. next가 done이 아니면, 다음을 수행합니다.
    1. next를 CanonicalizeKeyedCollectionKey(next)로 설정합니다.
    2. valueIndex를 SetDataIndex(resultSetData, next)로 둡니다.
    3. valueIndex가 not-found가 아니면, 다음을 수행합니다.
      1. resultSetData[valueIndex]를 empty로 설정합니다.
result를 OrdinaryObjectCreate(%Set.prototype%, « [[SetData]] »)로 둡니다.
result.[[SetData]]를 resultSetData로 설정합니다.
result를 반환합니다.

24.2.4.6 Set.prototype.entries ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? CreateSetIterator(set, key+value)를 반환합니다.

참고

순회 목적에서 Set은 각 항목의 키와 값이 동일한 Map과 유사하게 보입니다.

24.2.4.7 Set.prototype.forEach ( `callback` [ , `thisArg` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
entries를 set.[[SetData]]로 둡니다.
entriesCount를 entries의 요소 수로 둡니다.
index를 0으로 둡니다.
index < entriesCount인 동안 다음을 반복합니다.
1. entry를 entries[index]로 둡니다.
2. index를 index + 1로 설정합니다.
3. entry가 empty가 아니면, 다음을 수행합니다.
  1. ? Call(callback, thisArg, « entry, entry, set »)를 수행합니다.
  2. 참고: callback 실행 중 entries의 요소 수가 증가했을 수 있습니다.
  3. entriesCount를 entries의 요소 수로 설정합니다.
undefined를 반환합니다.

참고

callback은 세 인수를 받는 함수여야 합니다. forEach는 Set 객체에 존재하는 각 값에 대해 값 삽입 순서로 callback을 한 번씩 호출합니다. callback은 Set에 실제로 존재하는 값에 대해서만 호출되며 Set에서 삭제된 키에 대해서는 호출되지 않습니다.

thisArg 매개변수가 제공되면 callback을 호출할 때마다 this 값으로 사용됩니다. 제공되지 않으면 대신 undefined를 사용합니다.

callback은 세 인수로 호출됩니다. 처음 두 인수는 Set에 포함된 값입니다. 두 인수 모두에 동일한 값이 전달됩니다. 순회 중인 Set 객체는 세 번째 인수로 전달됩니다.

callback은 Map 및 Array의 forEach 메서드가 사용하는 콜백 함수와 일관성을 유지하기 위해 세 인수로 호출됩니다. Set에서는 각 항목 값이 키이자 값으로 간주됩니다.

forEach는 호출된 객체를 직접 변경하지 않지만 callback 호출에 의해 객체가 변경될 수 있습니다.

각 값은 일반적으로 한 번만 방문됩니다. 그러나 값이 방문된 후 삭제되고 forEach 호출이 완료되기 전에 다시 추가되면 다시 방문됩니다. forEach 호출이 시작된 후 방문되기 전에 삭제된 값은 forEach 호출이 완료되기 전에 다시 추가되지 않는 한 방문되지 않습니다. forEach 호출이 시작된 후 추가된 새로운 값은 방문됩니다.

24.2.4.8 Set.prototype.has ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
value를 CanonicalizeKeyedCollectionKey(value)로 설정합니다.
set.[[SetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. entry가 empty가 아니고 SameValue(entry, value)가 true이면 true를 반환합니다.
false를 반환합니다.

24.2.4.9 Set.prototype.intersection ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
resultSetData를 새로운 빈 List로 둡니다.
SetDataSize(set.[[SetData]]) ≤ otherRecord.[[Size]]이면, 다음을 수행합니다.
1. thisSize를 set.[[SetData]]의 요소 수로 둡니다.
2. index를 0으로 둡니다.
3. index < thisSize인 동안 다음을 반복합니다.
  1. entry를 set.[[SetData]][index]로 둡니다.
  2. index를 index + 1로 설정합니다.
  3. entry가 empty가 아니면, 다음을 수행합니다.
    1. inOther를 ToBoolean(? Call(otherRecord.[[Has]], otherRecord.[[SetObject]], « entry »))로 둡니다.
    2. inOther가 true이면, 다음을 수행합니다.
      1. 참고: 이전의 otherRecord.[[Has]] 호출이 set.[[SetData]]의 요소를 제거한 뒤 다시 추가할 수 있으므로 이 순회 중 동일한 요소를 두 번 방문할 수 있습니다.
      2. SetDataHas(resultSetData, entry)가 false이면, 다음을 수행합니다.
        entry를 resultSetData에 추가합니다.
    3. 참고: otherRecord.[[Has]] 실행 중 set.[[SetData]]의 요소 수가 증가했을 수 있습니다.
    4. thisSize를 set.[[SetData]]의 요소 수로 설정합니다.
그렇지 않으면,
1. keysIterator를 ? GetIteratorFromMethod(otherRecord.[[SetObject]], otherRecord.[[Keys]])로 둡니다.
2. next를 not-started로 둡니다.
3. next가 done이 아닌 동안 다음을 반복합니다.
  1. next를 ? IteratorStepValue(keysIterator)로 설정합니다.
  2. next가 done이 아니면, 다음을 수행합니다.
    1. next를 CanonicalizeKeyedCollectionKey(next)로 설정합니다.
    2. inThis를 SetDataHas(set.[[SetData]], next)로 둡니다.
    3. inThis가 true이면, 다음을 수행합니다.
      1. 참고: other는 임의의 객체이므로 해당 "keys" 반복자가 동일한 값을 두 번 이상 생성할 수 있습니다.
      2. SetDataHas(resultSetData, next)가 false이면, 다음을 수행합니다.
        next를 resultSetData에 추가합니다.
result를 OrdinaryObjectCreate(%Set.prototype%, « [[SetData]] »)로 둡니다.
result.[[SetData]]를 resultSetData로 설정합니다.
result를 반환합니다.

24.2.4.10 Set.prototype.isDisjointFrom ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
SetDataSize(set.[[SetData]]) ≤ otherRecord.[[Size]]이면, 다음을 수행합니다.
1. thisSize를 set.[[SetData]]의 요소 수로 둡니다.
2. index를 0으로 둡니다.
3. index < thisSize인 동안 다음을 반복합니다.
  1. entry를 set.[[SetData]][index]로 둡니다.
  2. index를 index + 1로 설정합니다.
  3. entry가 empty가 아니면, 다음을 수행합니다.
    1. inOther를 ToBoolean(? Call(otherRecord.[[Has]], otherRecord.[[SetObject]], « entry »))로 둡니다.
    2. inOther가 true이면 false를 반환합니다.
    3. 참고: otherRecord.[[Has]] 실행 중 set.[[SetData]]의 요소 수가 증가했을 수 있습니다.
    4. thisSize를 set.[[SetData]]의 요소 수로 설정합니다.
그렇지 않으면,
1. keysIterator를 ? GetIteratorFromMethod(otherRecord.[[SetObject]], otherRecord.[[Keys]])로 둡니다.
2. next를 not-started로 둡니다.
3. next가 done이 아닌 동안 다음을 반복합니다.
  1. next를 ? IteratorStepValue(keysIterator)로 설정합니다.
  2. next가 done이 아니면, 다음을 수행합니다.
    1. SetDataHas(set.[[SetData]], next)가 true이면, 다음을 수행합니다.
      1. ? IteratorClose(keysIterator, NormalCompletion(unused))를 수행합니다.
      2. false를 반환합니다.
true를 반환합니다.

24.2.4.11 Set.prototype.isSubsetOf ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
SetDataSize(set.[[SetData]]) > otherRecord.[[Size]]이면 false를 반환합니다.
thisSize를 set.[[SetData]]의 요소 수로 둡니다.
index를 0으로 둡니다.
index < thisSize인 동안 다음을 반복합니다.
1. entry를 set.[[SetData]][index]로 둡니다.
2. index를 index + 1로 설정합니다.
3. entry가 empty가 아니면, 다음을 수행합니다.
  1. inOther를 ToBoolean(? Call(otherRecord.[[Has]], otherRecord.[[SetObject]], « entry »))로 둡니다.
  2. inOther가 false이면 false를 반환합니다.
  3. 참고: otherRecord.[[Has]] 실행 중 set.[[SetData]]의 요소 수가 증가했을 수 있습니다.
  4. thisSize를 set.[[SetData]]의 요소 수로 설정합니다.
true를 반환합니다.

24.2.4.12 Set.prototype.isSupersetOf ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
SetDataSize(set.[[SetData]]) < otherRecord.[[Size]]이면 false를 반환합니다.
keysIterator를 ? GetIteratorFromMethod(otherRecord.[[SetObject]], otherRecord.[[Keys]])로 둡니다.
next를 not-started로 둡니다.
next가 done이 아닌 동안 다음을 반복합니다.
1. next를 ? IteratorStepValue(keysIterator)로 설정합니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. SetDataHas(set.[[SetData]], next)가 false이면, 다음을 수행합니다.
    1. ? IteratorClose(keysIterator, NormalCompletion(unused))를 수행합니다.
    2. false를 반환합니다.
true를 반환합니다.

24.2.4.13 Set.prototype.keys ( )

"keys" 프로퍼티의 초기 값은 24.2.4.17에 정의된 %Set.prototype.values%입니다.

참고

순회 목적에서 Set은 각 항목의 키와 값이 동일한 Map과 유사하게 보입니다.

24.2.4.14 get Set.prototype.size

Set.prototype.size는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
size를 SetDataSize(set.[[SetData]])로 둡니다.
𝔽(size)를 반환합니다.

24.2.4.15 Set.prototype.symmetricDifference ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
keysIterator를 ? GetIteratorFromMethod(otherRecord.[[SetObject]], otherRecord.[[Keys]])로 둡니다.
resultSetData를 set.[[SetData]]의 복사본으로 둡니다.
next를 not-started로 둡니다.
next가 done이 아닌 동안 다음을 반복합니다.
1. next를 ? IteratorStepValue(keysIterator)로 설정합니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. next를 CanonicalizeKeyedCollectionKey(next)로 설정합니다.
  2. resultIndex를 SetDataIndex(resultSetData, next)로 둡니다.
  3. resultIndex가 not-found이면 alreadyInResult를 false로 둡니다. 그렇지 않으면 alreadyInResult를 true로 둡니다.
  4. SetDataHas(set.[[SetData]], next)가 true이면, 다음을 수행합니다.
    1. alreadyInResult가 true이면 resultSetData[resultIndex]를 empty로 설정합니다.
  5. 그렇지 않으면,
    1. alreadyInResult가 false이면 next를 resultSetData에 추가합니다.
result를 OrdinaryObjectCreate(%Set.prototype%, « [[SetData]] »)로 둡니다.
result.[[SetData]]를 resultSetData로 설정합니다.
result를 반환합니다.

24.2.4.16 Set.prototype.union ( `other` )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? RequireInternalSlot(set, [[SetData]])를 수행합니다.
otherRecord를 ? GetSetRecord(other)로 둡니다.
keysIterator를 ? GetIteratorFromMethod(otherRecord.[[SetObject]], otherRecord.[[Keys]])로 둡니다.
resultSetData를 set.[[SetData]]의 복사본으로 둡니다.
next를 not-started로 둡니다.
next가 done이 아닌 동안 다음을 반복합니다.
1. next를 ? IteratorStepValue(keysIterator)로 설정합니다.
2. next가 done이 아니면, 다음을 수행합니다.
  1. next를 CanonicalizeKeyedCollectionKey(next)로 설정합니다.
  2. SetDataHas(resultSetData, next)가 false이면, 다음을 수행합니다.
    1. next를 resultSetData에 추가합니다.
result를 OrdinaryObjectCreate(%Set.prototype%, « [[SetData]] »)로 둡니다.
result.[[SetData]]를 resultSetData로 설정합니다.
result를 반환합니다.

24.2.4.17 Set.prototype.values ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

set을 this 값으로 둡니다.
? CreateSetIterator(set, value)를 반환합니다.

24.2.4.18 Set.prototype [ %Symbol.iterator% ] ( )

%Symbol.iterator% 프로퍼티의 초기 값은 24.2.4.17에 정의된 %Set.prototype.values%입니다.

24.2.4.19 Set.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Set"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

24.2.5 Set 인스턴스의 프로퍼티

Set 인스턴스는 Set 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. Set 인스턴스는 [[SetData]] 내부 슬롯도 갖습니다.

24.2.6 Set Iterator 객체

Set Iterator는 아래에 정의된 구조를 가지며 특정 Set 인스턴스 객체에 대한 특정 순회를 나타내는 일반 객체입니다. Set Iterator 객체에는 이름 있는 생성자가 없습니다. 대신 Set Iterator 객체는 Set 인스턴스 객체의 특정 메서드를 호출하여 생성됩니다.

24.2.6.1 CreateSetIterator ( `set`, `kind` )

추상 연산 CreateSetIterator. 인수 set (ECMAScript 언어 값) 및 kind ((key+value 또는 value)). 반환값: (정상 완료 (값: Generator) 또는 throw 완료). 그러한 반복자를 반환하는 Set 메서드의 반복자 객체를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(set, [[SetData]])를 수행합니다.
closure를 매개변수가 없고 set과 kind를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. index를 0으로 둡니다.
2. entries를 set.[[SetData]]로 둡니다.
3. entriesCount를 entries의 요소 수로 둡니다.
4. index < entriesCount인 동안 다음을 반복합니다.
  1. entry를 entries[index]로 둡니다.
  2. index를 index + 1로 설정합니다.
  3. entry가 empty가 아니면, 다음을 수행합니다.
    1. kind가 key+value이면, 다음을 수행합니다.
      1. result를 CreateArrayFromList(« entry, entry »)로 둡니다.
      2. ? GeneratorYield(CreateIteratorResultObject(result, false))를 수행합니다.
    2. 그렇지 않으면,
      1. 단언: kind는 value입니다.
      2. ? GeneratorYield(CreateIteratorResultObject(entry, false))를 수행합니다.
    3. 참고: GeneratorYield에 의해 이 추상 연산의 실행이 일시 중단된 동안 entries의 요소 수가 증가했을 수 있습니다.
    4. entriesCount를 entries의 요소 수로 설정합니다.
5. NormalCompletion(unused)을 반환합니다.
CreateIteratorFromClosure(closure, "%SetIteratorPrototype%", %SetIteratorPrototype%)을 반환합니다.

24.2.6.2 %SetIteratorPrototype% 객체

%SetIteratorPrototype% 객체는:

모든 Set Iterator 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

24.2.6.2.1 %SetIteratorPrototype%.next ( )

? GeneratorResume(this 값, empty, "%SetIteratorPrototype%")를 반환합니다.

24.2.6.2.2 %SetIteratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Set Iterator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

24.3 WeakMap 객체

WeakMap은 키가 객체 및/또는 Symbol이고 값은 임의의 ECMAScript language value일 수 있는 키/값 쌍의 컬렉션입니다. WeakMap에 특정 키를 갖는 키/값 쌍이 포함되어 있는지 조회할 수 있지만, 키로 보유하는 값을 열거하는 메커니즘은 제공되지 않습니다. 특정 조건에서는 9.9.3에 설명된 대로 생존하지 않는 값이 WeakMap 키에서 제거됩니다.

구현체는 WeakMap의 키/값 쌍에 접근할 수 없게 된 시점과 해당 키/값 쌍이 WeakMap에서 제거되는 시점 사이에 임의로 정한 지연 시간을 둘 수 있습니다. 이 지연 시간을 ECMAScript 프로그램이 관찰할 수 있다면 프로그램 실행에 영향을 줄 수 있는 비결정성의 원인이 됩니다. 따라서 ECMAScript 구현체는 관찰자가 관찰 대상 키를 제시하지 않고도 WeakMap의 키를 관찰할 수 있는 수단을 제공해서는 안 됩니다.

WeakMap은 평균적으로 컬렉션의 키/값 쌍 수에 대해 선형보다 빠른 접근 시간을 제공하는 해시 테이블이나 그 밖의 메커니즘을 사용하여 구현해야 합니다. 이 명세에서 사용하는 데이터 구조는 WeakMap에 요구되는 관찰 가능한 의미론을 설명하기 위한 것일 뿐입니다. 실제 구현 모델로 사용하려는 것은 아닙니다.

참고

WeakMap과 WeakSet은 WeakMap 또는 WeakSet 인스턴스가 없었다면 객체나 Symbol에 더 이상 접근할 수 없게 되어 구현체의 가비지 컬렉션 메커니즘에 의해 리소스 회수 대상이 되었을 경우 메모리 리소스를 “누수”하지 않는 방식으로 객체 또는 Symbol에 상태를 동적으로 연결하는 메커니즘을 제공하기 위한 것입니다. 이 특성은 객체/Symbol별로 WeakMap 또는 WeakSet 인스턴스를 키에 역매핑하는 방식을 사용하여 달성할 수 있습니다. 또는 각 WeakMap이나 WeakSet 인스턴스가 내부적으로 키와 값 데이터를 저장할 수도 있지만, 이 접근 방식은 WeakMap 또는 WeakSet 구현체와 가비지 컬렉터 사이의 조정이 필요합니다. 다음 참고 문헌에서는 WeakMap과 WeakSet 구현체에 유용할 수 있는 메커니즘을 설명합니다:

Barry Hayes. 1997. Ephemerons: a new finalization mechanism. In Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (Ed.). ACM, New York, NY, USA, 176-183, http://doi.acm.org/10.1145/263698.263733.

Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no. 21, pp. 3481-3497, 2008, http://www.jucs.org/jucs_14_21/eliminating_cycles_in_weak

24.3.1 WeakMap 생성자

WeakMap 생성자는:

%WeakMap%입니다.
전역 객체의 "WeakMap" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 WeakMap을 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 WeakMap 동작을 상속하려는 하위 클래스 생성자는 WeakMap.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 WeakMap 생성자에 대한 super 호출을 포함해야 합니다.

24.3.1.1 WeakMap ( [ `iterable` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
map을 ? OrdinaryCreateFromConstructor(NewTarget, "%WeakMap.prototype%", « [[WeakMapData]] »)로 둡니다.
map.[[WeakMapData]]를 새로운 빈 List로 설정합니다.
iterable이 undefined 또는 null이면 map을 반환합니다.
adder를 ? Get(map, "set")으로 둡니다.
IsCallable(adder)가 false이면 TypeError 예외를 던집니다.
? AddEntriesFromIterable(map, iterable, adder)를 반환합니다.

참고

매개변수 iterable이 존재하는 경우, 첫 번째 요소는 WeakMap 키로 사용할 값이고 두 번째 요소는 해당 키와 연결할 값인 두 요소의 배열과 유사한 객체를 생성하는 반복자 객체를 반환하는 %Symbol.iterator% 메서드를 구현한 객체일 것으로 예상됩니다.

24.3.2 WeakMap 생성자의 프로퍼티

WeakMap 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

24.3.2.1 WeakMap.prototype

WeakMap.prototype의 초기 값은 WeakMap 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

24.3.3 WeakMap 프로토타입 객체의 프로퍼티

WeakMap 프로토타입 객체는:

%WeakMap.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[WeakMapData]] 내부 슬롯을 갖지 않습니다.

24.3.3.1 WeakMap.prototype.constructor

WeakMap.prototype.constructor의 초기 값은 %WeakMap%입니다.

24.3.3.2 WeakMap.prototype.delete ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakMap을 this 값으로 둡니다.
? RequireInternalSlot(weakMap, [[WeakMapData]])를 수행합니다.
CanBeHeldWeakly(key)가 false이면 false를 반환합니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. entry.[[Key]]를 empty로 설정합니다.
  2. entry.[[Value]]를 empty로 설정합니다.
  3. true를 반환합니다.
false를 반환합니다.

참고

24.3.3.3 WeakMap.prototype.get ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakMap을 this 값으로 둡니다.
? RequireInternalSlot(weakMap, [[WeakMapData]])를 수행합니다.
CanBeHeldWeakly(key)가 false이면 undefined를 반환합니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 entry.[[Value]]를 반환합니다.
undefined를 반환합니다.

24.3.3.4 WeakMap.prototype.getOrInsert ( `key`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakMap을 this 값으로 둡니다.
? RequireInternalSlot(weakMap, [[WeakMapData]])를 수행합니다.
CanBeHeldWeakly(key)가 false이면 TypeError 예외를 던집니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 entry.[[Value]]를 반환합니다.
entry를 Record { [[Key]]: key, [[Value]]: value }로 둡니다.
entry를 weakMap.[[WeakMapData]]에 추가합니다.
value를 반환합니다.

24.3.3.5 WeakMap.prototype.getOrInsertComputed ( `key`, `callback` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakMap을 this 값으로 둡니다.
? RequireInternalSlot(weakMap, [[WeakMapData]])를 수행합니다.
CanBeHeldWeakly(key)가 false이면 TypeError 예외를 던집니다.
IsCallable(callback)이 false이면 TypeError 예외를 던집니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 entry.[[Value]]를 반환합니다.
value를 ? Call(callback, undefined, « key »)로 둡니다.
참고: callback 실행 중 WeakMap이 변경되었을 수 있습니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. entry.[[Value]]를 value로 설정합니다.
  2. value를 반환합니다.
entry를 Record { [[Key]]: key, [[Value]]: value }로 둡니다.
entry를 weakMap.[[WeakMapData]]에 추가합니다.
value를 반환합니다.

24.3.3.6 WeakMap.prototype.has ( `key` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakMap을 this 값으로 둡니다.
? RequireInternalSlot(weakMap, [[WeakMapData]])를 수행합니다.
CanBeHeldWeakly(key)가 false이면 false를 반환합니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면 true를 반환합니다.
false를 반환합니다.

24.3.3.7 WeakMap.prototype.set ( `key`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakMap을 this 값으로 둡니다.
? RequireInternalSlot(weakMap, [[WeakMapData]])를 수행합니다.
CanBeHeldWeakly(key)가 false이면 TypeError 예외를 던집니다.
weakMap.[[WeakMapData]]의 각 Record { [[Key]], [[Value]] } entry에 대해 다음을 수행합니다.
1. entry.[[Key]]가 empty가 아니고 SameValue(entry.[[Key]], key)가 true이면, 다음을 수행합니다.
  1. entry.[[Value]]를 value로 설정합니다.
  2. weakMap을 반환합니다.
entry를 Record { [[Key]]: key, [[Value]]: value }로 둡니다.
entry를 weakMap.[[WeakMapData]]에 추가합니다.
weakMap을 반환합니다.

24.3.3.8 WeakMap.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "WeakMap"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

24.3.4 WeakMap 인스턴스의 프로퍼티

WeakMap 인스턴스는 WeakMap 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. WeakMap 인스턴스는 [[WeakMapData]] 내부 슬롯도 갖습니다.

24.4 WeakSet 객체

WeakSet은 객체 및/또는 Symbol의 컬렉션입니다. 서로 다른 객체나 Symbol은 WeakSet의 컬렉션에 요소로 한 번만 나타날 수 있습니다. WeakSet에 특정 값이 포함되어 있는지 조회할 수 있지만, 보유하는 값을 열거하는 메커니즘은 제공되지 않습니다. 특정 조건에서는 9.9.3에 설명된 대로 생존하지 않는 값이 WeakSet 요소에서 제거됩니다.

구현체는 WeakSet에 포함된 값에 접근할 수 없게 된 시점과 해당 값이 WeakSet에서 제거되는 시점 사이에 임의로 정한 지연 시간을 둘 수 있습니다. 이 지연 시간을 ECMAScript 프로그램이 관찰할 수 있다면 프로그램 실행에 영향을 줄 수 있는 비결정성의 원인이 됩니다. 따라서 ECMAScript 구현체는 관찰자가 관찰 대상 값을 제시하지 않고도 WeakSet에 특정 값이 포함되어 있는지 판단할 수 있는 수단을 제공해서는 안 됩니다.

WeakSet은 평균적으로 컬렉션의 요소 수에 대해 선형보다 빠른 접근 시간을 제공하는 해시 테이블이나 그 밖의 메커니즘을 사용하여 구현해야 합니다. 이 명세에서 사용하는 데이터 구조는 WeakSet에 요구되는 관찰 가능한 의미론을 설명하기 위한 것일 뿐입니다. 실제 구현 모델로 사용하려는 것은 아닙니다.

참고

24.3의 참고를 참조하시기 바랍니다.

24.4.1 WeakSet 생성자

WeakSet 생성자는:

%WeakSet%입니다.
전역 객체의 "WeakSet" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 WeakSet을 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 WeakSet 동작을 상속하려는 하위 클래스 생성자는 WeakSet.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 WeakSet 생성자에 대한 super 호출을 포함해야 합니다.

24.4.1.1 WeakSet ( [ `iterable` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
set을 ? OrdinaryCreateFromConstructor(NewTarget, "%WeakSet.prototype%", « [[WeakSetData]] »)로 둡니다.
set.[[WeakSetData]]를 새로운 빈 List로 설정합니다.
iterable이 undefined 또는 null이면 set을 반환합니다.
adder를 ? Get(set, "add")로 둡니다.
IsCallable(adder)가 false이면 TypeError 예외를 던집니다.
iteratorRecord를 ? GetIterator(iterable, sync)로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면 set을 반환합니다.
3. status를 Completion(Call(adder, set, « next »))로 둡니다.
4. IfAbruptCloseIterator(status, iteratorRecord).

24.4.2 WeakSet 생성자의 프로퍼티

WeakSet 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

24.4.2.1 WeakSet.prototype

WeakSet.prototype의 초기 값은 WeakSet 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

24.4.3 WeakSet 프로토타입 객체의 프로퍼티

WeakSet 프로토타입 객체는:

%WeakSet.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[WeakSetData]] 내부 슬롯을 갖지 않습니다.

24.4.3.1 WeakSet.prototype.add ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakSet을 this 값으로 둡니다.
? RequireInternalSlot(weakSet, [[WeakSetData]])를 수행합니다.
CanBeHeldWeakly(value)가 false이면 TypeError 예외를 던집니다.
weakSet.[[WeakSetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. entry가 empty가 아니고 SameValue(entry, value)가 true이면, 다음을 수행합니다.
  1. weakSet을 반환합니다.
value를 weakSet.[[WeakSetData]]에 추가합니다.
weakSet을 반환합니다.

24.4.3.2 WeakSet.prototype.constructor

WeakSet.prototype.constructor의 초기 값은 %WeakSet%입니다.

24.4.3.3 WeakSet.prototype.delete ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakSet을 this 값으로 둡니다.
? RequireInternalSlot(weakSet, [[WeakSetData]])를 수행합니다.
CanBeHeldWeakly(value)가 false이면 false를 반환합니다.
weakSet.[[WeakSetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. entry가 empty가 아니고 SameValue(entry, value)가 true이면, 다음을 수행합니다.
  1. 값이 entry인 weakSet.[[WeakSetData]]의 요소를 값이 empty인 요소로 대체합니다.
  2. true를 반환합니다.
false를 반환합니다.

참고

24.4.3.4 WeakSet.prototype.has ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakSet을 this 값으로 둡니다.
? RequireInternalSlot(weakSet, [[WeakSetData]])를 수행합니다.
CanBeHeldWeakly(value)가 false이면 false를 반환합니다.
weakSet.[[WeakSetData]]의 각 요소 entry에 대해 다음을 수행합니다.
1. entry가 empty가 아니고 SameValue(entry, value)가 true이면 true를 반환합니다.
false를 반환합니다.

24.4.3.5 WeakSet.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "WeakSet"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

24.4.4 WeakSet 인스턴스의 프로퍼티

WeakSet 인스턴스는 WeakSet 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. WeakSet 인스턴스는 [[WeakSetData]] 내부 슬롯도 갖습니다.

24.5 키 컬렉션을 위한 추상 연산

24.5.1 CanonicalizeKeyedCollectionKey ( `key` )

추상 연산 CanonicalizeKeyedCollectionKey. 인수 key (ECMAScript 언어 값). 반환값: ECMAScript 언어 값. 호출되면 다음 단계를 수행한다.

key가 -0_𝔽이면 +0_𝔽을 반환합니다.
key를 반환합니다.

25 구조화된 데이터

25.1 ArrayBuffer 객체

25.1.1 표기법

이 절, 25.4, 29의 아래 설명에서는 read-modify-write 수정 함수 내부 데이터 구조를 사용합니다.

read-modify-write 수정 함수는 바이트 값의 두 List를 인수로 받고 바이트 값의 List를 반환하는 Abstract Closure로 표현되는 수학적 함수입니다. 이러한 Abstract Closure는 다음 프로퍼티를 모두 만족합니다:

모든 알고리즘 단계를 원자적으로 수행합니다.
개별 알고리즘 단계는 관찰할 수 없습니다.

참고

read-modify-write 수정 함수의 알고리즘 단계가 순수한 수학적 함수를 구성하는지 검증하는 데 도움이 되도록 다음 편집 관례를 권장합니다:

직접적으로든 호출된 추상 연산과 Abstract Closure를 통해 간접적으로든, 매개변수와 캡처한 값 이외의 언어 또는 명세 값에 접근하지 않습니다.
Completion Record를 반환하는 추상 연산과 Abstract Closure를 직접 또는 간접적으로 호출하지 않습니다.
Completion Record를 반환하지 않습니다.

25.1.2 고정 길이 및 크기 조절 가능한 ArrayBuffer 객체

고정 길이 ArrayBuffer는 생성된 후 바이트 길이를 변경할 수 없는 ArrayBuffer입니다.

크기 조절 가능한 ArrayBuffer는 ArrayBuffer.prototype.resize ( newLength ) 호출을 통해 생성 후 바이트 길이를 변경할 수 있는 ArrayBuffer입니다.

생성되는 ArrayBuffer 객체의 종류는 ArrayBuffer ( length [ , options ] )에 전달되는 인수에 따라 달라집니다.

25.1.3 ArrayBuffer 객체를 위한 추상 연산

25.1.3.1 AllocateArrayBuffer ( `ctor`, `byteLength` [ , `maxByteLength` ] )

추상 연산 AllocateArrayBuffer. 인수 ctor (생성자) 및 byteLength (음이 아닌 정수) 및 선택적 인수 maxByteLength ((음이 아닌 정수 또는 empty)). 반환값: (정상 완료 (값: ArrayBuffer) 또는 throw 완료). ArrayBuffer를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

slots를 « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] »로 둡니다.
maxByteLength가 존재하고 maxByteLength가 empty가 아니면 allocatingResizableBuffer를 true로 두고, 그렇지 않으면 allocatingResizableBuffer를 false로 둡니다.
allocatingResizableBuffer가 true이면, 다음을 수행합니다.
1. byteLength > maxByteLength이면 RangeError 예외를 던집니다.
2. slots에 [[ArrayBufferMaxByteLength]]를 추가합니다.
obj를 ? OrdinaryCreateFromConstructor(ctor, "%ArrayBuffer.prototype%", slots)로 둡니다.
block을 ? CreateByteDataBlock(byteLength)으로 둡니다.
obj.[[ArrayBufferData]]를 block으로 설정합니다.
obj.[[ArrayBufferByteLength]]를 byteLength로 설정합니다.
allocatingResizableBuffer가 true이면, 다음을 수행합니다.
1. maxByteLength 바이트로 구성된 Data Block block을 생성할 수 없으면 RangeError 예외를 던집니다.
2. 참고: 크기 조절 가능한 ArrayBuffer는 제자리 확장으로 구현할 수 있도록 설계되었습니다. 예를 들어 가상 메모리를 미리 예약할 수 없는 경우 구현체는 예외를 던질 수 있습니다.
3. obj.[[ArrayBufferMaxByteLength]]를 maxByteLength로 설정합니다.
obj를 반환합니다.

25.1.3.2 ArrayBufferByteLength ( `arrayBuffer`, `order` )

추상 연산 ArrayBufferByteLength. 인수 arrayBuffer ((ArrayBuffer 또는 SharedArrayBuffer)) 및 order ((seq-cst 또는 unordered)). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

IsGrowableSharedArrayBuffer(arrayBuffer)가 true이면, 다음을 수행합니다.
1. bufferByteLengthBlock을 arrayBuffer.[[ArrayBufferByteLengthData]]로 둡니다.
2. rawLength를 GetRawBytesFromSharedBlock(bufferByteLengthBlock, 0, biguint64, true, order)로 둡니다.
3. agentRecord를 주변 에이전트의 Agent Record로 둡니다.
4. isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다.
5. ℝ(RawBytesToNumeric(biguint64, rawLength, isLittleEndian))을 반환합니다.
단언: IsDetachedBuffer(arrayBuffer)는 false입니다.
arrayBuffer.[[ArrayBufferByteLength]]를 반환합니다.

25.1.3.3 ArrayBufferCopyAndDetach ( `arrayBuffer`, `newLength`, `preserveResizability` )

추상 연산 ArrayBufferCopyAndDetach. 인수 arrayBuffer (ECMAScript 언어 값), newLength (ECMAScript 언어 값) 및 preserveResizability ((preserve-resizability 또는 fixed-length)). 반환값: (정상 완료 (값: ArrayBuffer) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(arrayBuffer, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(arrayBuffer)가 true이면 TypeError 예외를 던집니다.
newLength가 undefined이면, 다음을 수행합니다.
1. newByteLength를 arrayBuffer.[[ArrayBufferByteLength]]로 둡니다.
그렇지 않으면,
1. newByteLength를 ? ToIndex(newLength)로 둡니다.
IsDetachedBuffer(arrayBuffer)가 true이면 TypeError 예외를 던집니다.
preserveResizability가 preserve-resizability이고 IsFixedLengthArrayBuffer(arrayBuffer)가 false이면, 다음을 수행합니다.
1. newMaxByteLength를 arrayBuffer.[[ArrayBufferMaxByteLength]]로 둡니다.
그렇지 않으면,
1. newMaxByteLength를 empty로 둡니다.
arrayBuffer.[[ArrayBufferDetachKey]]가 undefined가 아니면 TypeError 예외를 던집니다.
newBuffer를 ? AllocateArrayBuffer(%ArrayBuffer%, newByteLength, newMaxByteLength)로 둡니다.
copyLength를 min(newByteLength, arrayBuffer.[[ArrayBufferByteLength]])로 둡니다.
fromBlock을 arrayBuffer.[[ArrayBufferData]]로 둡니다.
toBlock을 newBuffer.[[ArrayBufferData]]로 둡니다.
CopyDataBlockBytes(toBlock, 0, fromBlock, 0, copyLength)를 수행합니다.
참고: 새로운 Data Block 생성과 이전 Data Block에서 복사하는 작업은 모두 관찰할 수 없습니다. 구현체는 이 메서드를 복사 없는 이동 또는 realloc로 구현할 수 있습니다.
! DetachArrayBuffer(arrayBuffer)를 수행합니다.
newBuffer를 반환합니다.

25.1.3.4 IsDetachedBuffer ( `arrayBuffer` )

추상 연산 IsDetachedBuffer. 인수 arrayBuffer ((ArrayBuffer 또는 SharedArrayBuffer)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

arrayBuffer.[[ArrayBufferData]]가 null이면 true를 반환합니다.
false를 반환합니다.

25.1.3.5 DetachArrayBuffer ( `arrayBuffer` [ , `key` ] )

추상 연산 DetachArrayBuffer. 인수 arrayBuffer (ArrayBuffer) 및 선택적 인수 key (임의의 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

단언: IsSharedArrayBuffer(arrayBuffer)는 false입니다.
key가 존재하지 않으면 key를 undefined로 설정합니다.
arrayBuffer.[[ArrayBufferDetachKey]]가 key가 아니면 TypeError 예외를 던집니다.
arrayBuffer.[[ArrayBufferData]]를 null로 설정합니다.
arrayBuffer.[[ArrayBufferByteLength]]를 0으로 설정합니다.
unused를 반환합니다.

참고

ArrayBuffer 인스턴스를 분리하면 기반 저장소로 사용되는 Data Block을 인스턴스와 분리하고 버퍼의 바이트 길이를 0으로 설정합니다.

25.1.3.6 CloneArrayBuffer ( `sourceBuffer`, `sourceByteOffset`, `sourceLength` )

추상 연산 CloneArrayBuffer. 인수 sourceBuffer ((ArrayBuffer 또는 SharedArrayBuffer)), sourceByteOffset (음이 아닌 정수) 및 sourceLength (음이 아닌 정수). 반환값: (정상 완료 (값: ArrayBuffer) 또는 throw 완료). sourceByteOffset에서 시작하여 sourceLength 바이트 동안의 sourceBuffer 데이터를 복사한 데이터를 갖는 새로운 ArrayBuffer를 생성합니다. 호출되면 다음 단계를 수행한다.

단언: IsDetachedBuffer(sourceBuffer)는 false입니다.
targetBuffer를 ? AllocateArrayBuffer(%ArrayBuffer%, sourceLength)로 둡니다.
sourceBlock을 sourceBuffer.[[ArrayBufferData]]로 둡니다.
targetBlock을 targetBuffer.[[ArrayBufferData]]로 둡니다.
CopyDataBlockBytes(targetBlock, 0, sourceBlock, sourceByteOffset, sourceLength)를 수행합니다.
targetBuffer를 반환합니다.

25.1.3.7 GetArrayBufferMaxByteLengthOption ( `options` )

추상 연산 GetArrayBufferMaxByteLengthOption. 인수 options (ECMAScript 언어 값). 반환값: (정상 완료 (값: (음이 아닌 정수 또는 empty)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

options가 Object가 아니면 empty를 반환합니다.
maxByteLength를 ? Get(options, "maxByteLength")로 둡니다.
maxByteLength가 undefined이면 empty를 반환합니다.
? ToIndex(maxByteLength)를 반환합니다.

25.1.3.8 HostResizeArrayBuffer ( `buffer`, `newByteLength` )

호스트 정의 추상 연산 HostResizeArrayBuffer. 인수 buffer (ArrayBuffer) 및 newByteLength (음이 아닌 정수). 반환값: (정상 완료 (값: (handled 또는 unhandled)) 또는 throw 완료). 호스트가 buffer의 구현체 정의 크기 조절을 수행할 기회를 제공합니다. 호스트가 buffer의 크기 조절을 처리하지 않기로 선택하면 기본 동작을 위해 unhandled를 반환할 수 있습니다.

HostResizeArrayBuffer의 구현은 다음 요구 사항을 준수해야 합니다:

추상 연산은 buffer를 분리하지 않습니다.
추상 연산이 handled로 정상 완료되면 buffer.[[ArrayBufferByteLength]]는 newByteLength입니다.

HostResizeArrayBuffer의 기본 구현은 NormalCompletion(unhandled)을 반환하는 것입니다.

25.1.3.9 IsFixedLengthArrayBuffer ( `arrayBuffer` )

추상 연산 IsFixedLengthArrayBuffer. 인수 arrayBuffer ((ArrayBuffer 또는 SharedArrayBuffer)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

arrayBuffer에 [[ArrayBufferMaxByteLength]] 내부 슬롯이 있으면 false를 반환합니다.
true를 반환합니다.

25.1.3.10 IsUnsignedElementType ( `type` )

추상 연산 IsUnsignedElementType. 인수 type (TypedArray 요소 타입). 반환값: Boolean. 인수 type이 부호 없는 TypedArray 요소 타입인지 검증합니다. 호출되면 다음 단계를 수행한다.

type이 uint8, uint8clamped, uint16, uint32, biguint64 중 하나이면 true를 반환합니다.
false를 반환합니다.

25.1.3.11 IsUnclampedIntegerElementType ( `type` )

추상 연산 IsUnclampedIntegerElementType. 인수 type (TypedArray 요소 타입). 반환값: Boolean. 인수 type이 uint8clamped를 제외한 Integer TypedArray 요소 타입인지 검증합니다. 호출되면 다음 단계를 수행한다.

type이 int8, uint8, int16, uint16, int32, uint32 중 하나이면 true를 반환합니다.
false를 반환합니다.

25.1.3.12 IsBigIntElementType ( `type` )

추상 연산 IsBigIntElementType. 인수 type (TypedArray 요소 타입). 반환값: Boolean. 인수 type이 BigInt TypedArray 요소 타입인지 검증합니다. 호출되면 다음 단계를 수행한다.

type이 biguint64 또는 bigint64이면 true를 반환합니다.
false를 반환합니다.

25.1.3.13 IsNoTearConfiguration ( `type`, `order` )

추상 연산 IsNoTearConfiguration. 인수 type (TypedArray 요소 타입) 및 order ((seq-cst, unordered 또는 init)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

IsUnclampedIntegerElementType(type)이 true이면 true를 반환합니다.
IsBigIntElementType(type)이 true이고 order가 seq-cst이면 true를 반환합니다.
false를 반환합니다.

25.1.3.14 RawBytesToNumeric ( `type`, `rawBytes`, `isLittleEndian` )

추상 연산 RawBytesToNumeric. 인수 type (TypedArray 요소 타입), rawBytes (리스트 (요소: 바이트 값)) 및 isLittleEndian (Boolean). 반환값: (Number 또는 BigInt). 호출되면 다음 단계를 수행한다.

elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
isLittleEndian이 false이면 rawBytes 요소의 순서를 뒤집습니다.
type이 float16이면, 다음을 수행합니다.
1. value를 rawBytes의 바이트 요소를 연결하고 IEEE 754-2019 binary16 값의 리틀 엔디언 비트 문자열 인코딩으로 해석한 값으로 둡니다.
2. value가 NaN이면 NaN을 반환합니다.
3. value에 대응하는 Number 값을 반환합니다.
type이 float32이면, 다음을 수행합니다.
1. value를 rawBytes의 바이트 요소를 연결하고 IEEE 754-2019 binary32 값의 리틀 엔디언 비트 문자열 인코딩으로 해석한 값으로 둡니다.
2. value가 NaN이면 NaN을 반환합니다.
3. value에 대응하는 Number 값을 반환합니다.
type이 float64이면, 다음을 수행합니다.
1. value를 rawBytes의 바이트 요소를 연결하고 IEEE 754-2019 binary64 값의 리틀 엔디언 비트 문자열 인코딩으로 해석한 값으로 둡니다.
2. value가 NaN이면 NaN을 반환합니다.
3. value에 대응하는 Number 값을 반환합니다.
IsUnsignedElementType(type)이 true이면, 다음을 수행합니다.
1. intValue를 rawBytes의 바이트 요소를 연결하고 부호 없는 리틀 엔디언 이진수의 비트 문자열 인코딩으로 해석한 값으로 둡니다.
그렇지 않으면,
1. intValue를 rawBytes의 바이트 요소를 연결하고 비트 길이가 elementSize × 8인 이진 리틀 엔디언 2의 보수 수의 비트 문자열 인코딩으로 해석한 값으로 둡니다.
IsBigIntElementType(type)이 true이면 intValue에 대응하는 BigInt 값을 반환합니다.
intValue에 대응하는 Number 값을 반환합니다.

25.1.3.15 GetRawBytesFromSharedBlock ( `block`, `byteIndex`, `type`, `isTypedArray`, `order` )

추상 연산 GetRawBytesFromSharedBlock. 인수 block (공유 데이터 블록), byteIndex (음이 아닌 정수), type (TypedArray 요소 타입), isTypedArray (Boolean) 및 order ((seq-cst 또는 unordered)). 반환값: 리스트 (요소: 바이트 값). 호출되면 다음 단계를 수행한다.

elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
isTypedArray가 true이고 IsNoTearConfiguration(type, order)이 true이면 noTear를 true로 둡니다. 그렇지 않으면 noTear를 false로 둡니다.
rawValue를 요소가 비결정적으로 선택된 바이트 값인 길이 elementSize의 List로 둡니다.
참고: 구현체에서 rawValue는 기반 하드웨어의 비원자적 또는 원자적 읽기 명령 결과입니다. 비결정성은 약한 일관성을 갖는 하드웨어의 관찰 가능한 동작을 설명하기 위한 메모리 모델의 의미론적 규정입니다.
readEvent를 ReadSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize }로 둡니다.
readEvent를 eventsRecord.[[EventList]]에 추가합니다.
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: rawValue }를 execution.[[ChosenValues]]에 추가합니다.
rawValue를 반환합니다.

25.1.3.16 GetValueFromBuffer ( `arrayBuffer`, `byteIndex`, `type`, `isTypedArray`, `order` [ , `isLittleEndian` ] )

추상 연산 GetValueFromBuffer. 인수 arrayBuffer ((ArrayBuffer 또는 SharedArrayBuffer)), byteIndex (음이 아닌 정수), type (TypedArray 요소 타입), isTypedArray (Boolean) 및 order ((seq-cst 또는 unordered)) 및 선택적 인수 isLittleEndian (Boolean). 반환값: (Number 또는 BigInt). 호출되면 다음 단계를 수행한다.

단언: IsDetachedBuffer(arrayBuffer)는 false입니다.
단언: arrayBuffer에는 byteIndex부터 시작하여 type 값을 표현하기에 충분한 바이트가 있습니다.
block을 arrayBuffer.[[ArrayBufferData]]로 둡니다.
elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
IsSharedArrayBuffer(arrayBuffer)가 true이면, 다음을 수행합니다.
1. 단언: block은 Shared Data Block입니다.
2. rawValue를 GetRawBytesFromSharedBlock(block, byteIndex, type, isTypedArray, order)로 둡니다.
그렇지 않으면,
1. rawValue를 byteIndex(포함)부터 byteIndex + elementSize(제외)까지 구간의 인덱스에서 block의 바이트를 요소로 갖는 List로 둡니다.
단언: rawValue의 요소 수는 elementSize입니다.
isLittleEndian이 존재하지 않으면, 다음을 수행합니다.
1. agentRecord를 주변 에이전트의 Agent Record로 둡니다.
2. isLittleEndian을 agentRecord.[[LittleEndian]]으로 설정합니다.
RawBytesToNumeric(type, rawValue, isLittleEndian)을 반환합니다.

25.1.3.17 NumericToRawBytes ( `type`, `value`, `isLittleEndian` )

추상 연산 NumericToRawBytes. 인수 type (TypedArray 요소 타입), value ((Number 또는 BigInt)) 및 isLittleEndian (Boolean). 반환값: 리스트 (요소: 바이트 값). 호출되면 다음 단계를 수행한다.

type이 float16이면, 다음을 수행합니다.
1. rawBytes를 roundTiesToEven 모드를 사용하여 value를 IEEE 754-2019 binary16 형식으로 변환한 결과인 2바이트를 요소로 갖는 List로 둡니다. 바이트는 리틀 엔디언 순서로 배열됩니다. value가 NaN이면 rawBytes를 구현체가 선택한 임의의 IEEE 754-2019 binary16 형식 NaN 인코딩으로 설정할 수 있습니다. 구현체는 구현체에서 구별 가능한 각 NaN 값에 대해 항상 동일한 인코딩을 선택해야 합니다.
그렇지 않고 type이 float32이면, 다음을 수행합니다.
1. rawBytes를 roundTiesToEven 모드를 사용하여 value를 IEEE 754-2019 binary32 형식으로 변환한 결과인 4바이트를 요소로 갖는 List로 둡니다. 바이트는 리틀 엔디언 순서로 배열됩니다. value가 NaN이면 rawBytes를 구현체가 선택한 임의의 IEEE 754-2019 binary32 형식 NaN 인코딩으로 설정할 수 있습니다. 구현체는 구현체에서 구별 가능한 각 NaN 값에 대해 항상 동일한 인코딩을 선택해야 합니다.
그렇지 않고 type이 float64이면, 다음을 수행합니다.
1. rawBytes를 value의 IEEE 754-2019 binary64 형식 인코딩인 8바이트를 요소로 갖는 List로 둡니다. 바이트는 리틀 엔디언 순서로 배열됩니다. value가 NaN이면 rawBytes를 구현체가 선택한 임의의 IEEE 754-2019 binary64 형식 NaN 인코딩으로 설정할 수 있습니다. 구현체는 구현체에서 구별 가능한 각 NaN 값에 대해 항상 동일한 인코딩을 선택해야 합니다.
그렇지 않으면,
1. n을 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
2. conversionOperation을 Element Type type에 대해 표 71의 “Conversion Operation” 열에 명명된 추상 연산으로 둡니다.
3. intValue를 ℝ(! conversionOperation(value))로 둡니다.
4. intValue ≥ 0이면, 다음을 수행합니다.
  1. rawBytes를 intValue의 n바이트 이진 인코딩을 요소로 갖는 List로 둡니다. 바이트는 리틀 엔디언 순서로 배열됩니다.
5. 그렇지 않으면,
  1. rawBytes를 intValue의 n바이트 이진 2의 보수 인코딩을 요소로 갖는 List로 둡니다. 바이트는 리틀 엔디언 순서로 배열됩니다.
isLittleEndian이 false이면 rawBytes 요소의 순서를 뒤집습니다.
rawBytes를 반환합니다.

25.1.3.18 SetValueInBuffer ( `arrayBuffer`, `byteIndex`, `type`, `value`, `isTypedArray`, `order` [ , `isLittleEndian` ] )

추상 연산 SetValueInBuffer. 인수 arrayBuffer ((ArrayBuffer 또는 SharedArrayBuffer)), byteIndex (음이 아닌 정수), type (TypedArray 요소 타입), value ((Number 또는 BigInt)), isTypedArray (Boolean) 및 order ((seq-cst, unordered 또는 init)) 및 선택적 인수 isLittleEndian (Boolean). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: IsDetachedBuffer(arrayBuffer)는 false입니다.
단언: arrayBuffer에는 byteIndex부터 시작하여 type 값을 표현하기에 충분한 바이트가 있습니다.
단언: IsBigIntElementType(type)이 true이면 value는 BigInt이고, 그렇지 않으면 value는 Number입니다.
block을 arrayBuffer.[[ArrayBufferData]]로 둡니다.
elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
isLittleEndian이 존재하지 않으면, 다음을 수행합니다.
1. isLittleEndian을 agentRecord.[[LittleEndian]]으로 설정합니다.
rawBytes를 NumericToRawBytes(type, value, isLittleEndian)로 둡니다.
IsSharedArrayBuffer(arrayBuffer)가 true이면, 다음을 수행합니다.
1. execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
2. eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
3. isTypedArray가 true이고 IsNoTearConfiguration(type, order)이 true이면 noTear를 true로 둡니다. 그렇지 않으면 noTear를 false로 둡니다.
4. WriteSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes }를 eventsRecord.[[EventList]]에 추가합니다.
그렇지 않으면,
1. rawBytes의 개별 바이트를 block[byteIndex]에서 시작하여 block에 저장합니다.
unused를 반환합니다.

25.1.3.19 GetModifySetValueInBuffer ( `arrayBuffer`, `byteIndex`, `type`, `value`, `op` )

추상 연산 GetModifySetValueInBuffer. 인수 arrayBuffer ((ArrayBuffer 또는 SharedArrayBuffer)), byteIndex (음이 아닌 정수), type (TypedArray 요소 타입), value ((Number 또는 BigInt)) 및 op (a read-modify-write modification function). 반환값: (Number 또는 BigInt). 호출되면 다음 단계를 수행한다.

단언: IsDetachedBuffer(arrayBuffer)는 false입니다.
단언: arrayBuffer에는 byteIndex부터 시작하여 type 값을 표현하기에 충분한 바이트가 있습니다.
단언: IsBigIntElementType(type)이 true이면 value는 BigInt이고, 그렇지 않으면 value는 Number입니다.
block을 arrayBuffer.[[ArrayBufferData]]로 둡니다.
elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다.
rawBytes를 NumericToRawBytes(type, value, isLittleEndian)로 둡니다.
IsSharedArrayBuffer(arrayBuffer)가 true이면, 다음을 수행합니다.
1. execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
2. eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
3. rawBytesRead를 요소가 비결정적으로 선택된 바이트 값인 길이 elementSize의 List로 둡니다.
4. 참고: 구현체에서 rawBytesRead는 기반 하드웨어의 load-link, load-exclusive 또는 read-modify-write 명령의 피연산자 결과입니다. 비결정성은 약한 일관성을 갖는 하드웨어의 관찰 가능한 동작을 설명하기 위한 메모리 모델의 의미론적 규정입니다.
5. rmwEvent를 ReadModifyWriteSharedMemory { [[Order]]: seq-cst, [[NoTear]]: true, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes, [[ModifyOp]]: op }로 둡니다.
6. rmwEvent를 eventsRecord.[[EventList]]에 추가합니다.
7. Chosen Value Record { [[Event]]: rmwEvent, [[ChosenValue]]: rawBytesRead }를 execution.[[ChosenValues]]에 추가합니다.
그렇지 않으면,
1. rawBytesRead를 block[byteIndex]부터 시작하는 elementSize개의 바이트 시퀀스를 요소로 갖는 길이 elementSize의 List로 둡니다.
2. rawBytesModified를 op(rawBytesRead, rawBytes)로 둡니다.
3. rawBytesModified의 개별 바이트를 block[byteIndex]에서 시작하여 block에 저장합니다.
RawBytesToNumeric(type, rawBytesRead, isLittleEndian)을 반환합니다.

25.1.4 ArrayBuffer 생성자

ArrayBuffer 생성자는:

%ArrayBuffer%입니다.
전역 객체의 "ArrayBuffer" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 ArrayBuffer를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 ArrayBuffer 동작을 상속하려는 하위 클래스 생성자는 ArrayBuffer.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 ArrayBuffer 생성자에 대한 super 호출을 포함해야 합니다.

25.1.4.1 ArrayBuffer ( `length` [ , `options` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
byteLength를 ? ToIndex(length)로 둡니다.
requestedMaxByteLength를 ? GetArrayBufferMaxByteLengthOption(options)로 둡니다.
? AllocateArrayBuffer(NewTarget, byteLength, requestedMaxByteLength)를 반환합니다.

25.1.5 ArrayBuffer 생성자의 프로퍼티

ArrayBuffer 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

25.1.5.1 ArrayBuffer.isView ( `arg` )

이 함수는 호출되면 다음 단계를 수행합니다:

arg가 Object가 아니면 false를 반환합니다.
arg에 [[ViewedArrayBuffer]] 내부 슬롯이 있으면 true를 반환합니다.
false를 반환합니다.

25.1.5.2 ArrayBuffer.prototype

ArrayBuffer.prototype의 초기 값은 ArrayBuffer 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

25.1.5.3 get ArrayBuffer [ %Symbol.species% ]

ArrayBuffer[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

ArrayBuffer.prototype.slice ( start, end )는 일반적으로 this 값의 생성자를 사용하여 파생 객체를 생성합니다. 그러나 하위 클래스 생성자는 자신의 %Symbol.species% 프로퍼티를 재정의하여 ArrayBuffer.prototype.slice ( start, end ) 메서드의 기본 동작을 재정의할 수 있습니다.

25.1.6 ArrayBuffer 프로토타입 객체의 프로퍼티

ArrayBuffer 프로토타입 객체는:

%ArrayBuffer.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[ArrayBufferData]] 또는 [[ArrayBufferByteLength]] 내부 슬롯을 갖지 않습니다.

25.1.6.1 get ArrayBuffer.prototype.byteLength

ArrayBuffer.prototype.byteLength는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 true이면 TypeError 예외를 던집니다.
IsDetachedBuffer(obj)가 true이면 +0_𝔽을 반환합니다.
length를 obj.[[ArrayBufferByteLength]]로 둡니다.
𝔽(length)를 반환합니다.

25.1.6.2 ArrayBuffer.prototype.constructor

ArrayBuffer.prototype.constructor의 초기 값은 %ArrayBuffer%입니다.

25.1.6.3 get ArrayBuffer.prototype.detached

ArrayBuffer.prototype.detached는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 true이면 TypeError 예외를 던집니다.
IsDetachedBuffer(obj)를 반환합니다.

25.1.6.4 get ArrayBuffer.prototype.maxByteLength

ArrayBuffer.prototype.maxByteLength는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 true이면 TypeError 예외를 던집니다.
IsDetachedBuffer(obj)가 true이면 +0_𝔽을 반환합니다.
IsFixedLengthArrayBuffer(obj)가 true이면, 다음을 수행합니다.
1. length를 obj.[[ArrayBufferByteLength]]로 둡니다.
그렇지 않으면,
1. length를 obj.[[ArrayBufferMaxByteLength]]로 둡니다.
𝔽(length)를 반환합니다.

25.1.6.5 get ArrayBuffer.prototype.resizable

ArrayBuffer.prototype.resizable은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 true이면 TypeError 예외를 던집니다.
IsFixedLengthArrayBuffer(obj)가 false이면 true를 반환합니다.
false를 반환합니다.

25.1.6.6 ArrayBuffer.prototype.resize ( `newLength` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferMaxByteLength]])를 수행합니다.
IsSharedArrayBuffer(obj)가 true이면 TypeError 예외를 던집니다.
newByteLength를 ? ToIndex(newLength)로 둡니다.
IsDetachedBuffer(obj)가 true이면 TypeError 예외를 던집니다.
newByteLength > obj.[[ArrayBufferMaxByteLength]]이면 RangeError 예외를 던집니다.
hostHandled를 ? HostResizeArrayBuffer(obj, newByteLength)로 둡니다.
hostHandled가 handled이면 undefined를 반환합니다.
oldBlock을 obj.[[ArrayBufferData]]로 둡니다.
newBlock을 ? CreateByteDataBlock(newByteLength)로 둡니다.
copyLength를 min(newByteLength, obj.[[ArrayBufferByteLength]])로 둡니다.
CopyDataBlockBytes(newBlock, 0, oldBlock, 0, copyLength)를 수행합니다.
참고: 새로운 Data Block 생성과 이전 Data Block에서 복사하는 작업은 모두 관찰할 수 없습니다. 구현체는 이 메서드를 제자리 확장 또는 축소로 구현할 수 있습니다.
obj.[[ArrayBufferData]]를 newBlock으로 설정합니다.
obj.[[ArrayBufferByteLength]]를 newByteLength로 설정합니다.
undefined를 반환합니다.

25.1.6.7 ArrayBuffer.prototype.slice ( `start`, `end` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 true이면 TypeError 예외를 던집니다.
IsDetachedBuffer(obj)가 true이면 TypeError 예외를 던집니다.
length를 obj.[[ArrayBufferByteLength]]로 둡니다.
first를 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 final을 length로 둡니다. 그렇지 않으면 final을 ? ToClampedIndex(end, length)로 둡니다.
newLength를 max(final - first, 0)으로 둡니다.
ctor를 ? SpeciesConstructor(obj, %ArrayBuffer%)로 둡니다.
new를 ? Construct(ctor, « 𝔽(newLength) »)로 둡니다.
? RequireInternalSlot(new, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(new)가 true이면 TypeError 예외를 던집니다.
IsDetachedBuffer(new)가 true이면 TypeError 예외를 던집니다.
SameValue(new, obj)가 true이면 TypeError 예외를 던집니다.
new.[[ArrayBufferByteLength]] < newLength이면 TypeError 예외를 던집니다.
참고: 위 단계의 부수 효과로 obj가 분리되거나 크기가 조절되었을 수 있습니다.
IsDetachedBuffer(obj)가 true이면 TypeError 예외를 던집니다.
fromBlock을 obj.[[ArrayBufferData]]로 둡니다.
toBlock을 new.[[ArrayBufferData]]로 둡니다.
currentLength를 obj.[[ArrayBufferByteLength]]로 둡니다.
maxCount를 currentLength - first로 둡니다.
maxCount > 0이면, 다음을 수행합니다.
1. count를 min(newLength, maxCount)로 둡니다.
2. CopyDataBlockBytes(toBlock, 0, fromBlock, first, count)를 수행합니다.
new를 반환합니다.

25.1.6.8 ArrayBuffer.prototype.transfer ( [ `newLength` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? ArrayBufferCopyAndDetach(obj, newLength, preserve-resizability)를 반환합니다.

25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ `newLength` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? ArrayBufferCopyAndDetach(obj, newLength, fixed-length)를 반환합니다.

25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "ArrayBuffer"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

25.1.7 ArrayBuffer 인스턴스의 프로퍼티

ArrayBuffer 인스턴스는 ArrayBuffer 프로토타입 객체에서 프로퍼티를 상속합니다. 각 ArrayBuffer 인스턴스에는 [[ArrayBufferData]] 내부 슬롯, [[ArrayBufferByteLength]] 내부 슬롯, [[ArrayBufferDetachKey]] 내부 슬롯이 있습니다. 크기 조절 가능한 각 ArrayBuffer 인스턴스에는 [[ArrayBufferMaxByteLength]] 내부 슬롯도 있습니다.

[[ArrayBufferData]]가 null인 ArrayBuffer 인스턴스는 분리된 것으로 간주되며, ArrayBuffer 인스턴스에 포함된 데이터에 접근하거나 수정하는 모든 연산자는 실패합니다.

[[ArrayBufferDetachKey]]가 undefined 이외의 값으로 설정된 ArrayBuffer 인스턴스는 모든 DetachArrayBuffer 호출에서 동일한 “detach key”를 인수로 전달해야 하며, 그렇지 않으면 TypeError가 발생합니다. 이 내부 슬롯은 이 명세의 알고리즘이 아니라 특정 임베딩 환경에 의해서만 설정됩니다.

25.1.8 크기 조절 가능한 ArrayBuffer 지침

참고 1

다음은 크기 조절 가능한 ArrayBuffer를 사용하는 ECMAScript 프로그래머를 위한 지침입니다.

가능한 경우 프로그램을 배포 환경에서 테스트할 것을 권장합니다. 사용 가능한 물리 메모리의 양은 하드웨어 장치마다 크게 다릅니다. 마찬가지로 가상 메모리 하위 시스템도 하드웨어 장치와 운영 체제에 따라 크게 다릅니다. 64비트 데스크톱 웹 브라우저에서 메모리 부족 오류 없이 실행되는 애플리케이션이 32비트 모바일 웹 브라우저에서는 메모리 부족이 발생할 수 있습니다.

크기 조절 가능한 ArrayBuffer의 "maxByteLength" 옵션 값을 선택할 때는 애플리케이션에 가능한 가장 작은 크기를 선택할 것을 권장합니다. "maxByteLength"가 1,073,741,824(2³⁰바이트 또는 1GiB)를 초과하지 않을 것을 권장합니다.

특정 최대 크기로 크기 조절 가능한 ArrayBuffer를 성공적으로 생성했다고 해서 이후의 크기 조절도 성공한다는 보장은 없다는 점에 유의하시기 바랍니다.

참고 2

다음은 크기 조절 가능한 ArrayBuffer를 구현하는 ECMAScript 구현자를 위한 지침입니다.

크기 조절 가능한 ArrayBuffer는 크기 조절 시 복사하는 방식, 가상 메모리를 미리 예약하여 제자리 확장하는 방식, 또는 생성자의 "maxByteLength" 옵션 값에 따라 두 방식을 조합하여 구현할 수 있습니다.

웹 브라우저처럼 호스트가 다중 테넌트인 경우(즉, 여러 ECMAScript 애플리케이션을 동시에 실행하는 경우), 구현체가 가상 메모리를 예약하여 제자리 확장을 구현하기로 선택한다면 32비트와 64비트 구현 모두 "maxByteLength" ≥ 1GiB~1.5GiB인 값에 대해 예외를 던질 것을 권장합니다. 이는 하나의 애플리케이션이 가상 메모리 주소 공간을 고갈시킬 가능성을 줄이고 상호 운용성 위험을 줄이기 위한 것입니다.

MMU가 없는 임베디드 장치에서 실행되는 경우처럼 호스트에 가상 메모리가 없거나 호스트가 복사 방식으로만 크기 조절을 구현하는 경우 "maxByteLength" 옵션에 대해 임의의 Number value for 값을 허용할 수 있습니다. 그러나 요청한 크기의 메모리 블록을 절대로 할당할 수 없는 경우 RangeError를 던질 것을 권장합니다. 예를 들어 요청 크기가 장치에서 사용할 수 있는 최대 메모리 양보다 큰 경우입니다.

25.2 SharedArrayBuffer 객체

25.2.1 고정 길이 및 확장 가능한 SharedArrayBuffer 객체

고정 길이 SharedArrayBuffer는 생성된 후 바이트 길이를 변경할 수 없는 SharedArrayBuffer입니다.

확장 가능한 SharedArrayBuffer는 SharedArrayBuffer.prototype.grow ( newLength ) 호출을 통해 생성 후 바이트 길이를 늘릴 수 있는 SharedArrayBuffer입니다.

생성되는 SharedArrayBuffer 객체의 종류는 SharedArrayBuffer ( length [ , options ] )에 전달되는 인수에 따라 달라집니다.

25.2.2 SharedArrayBuffer 객체를 위한 추상 연산

25.2.2.1 AllocateSharedArrayBuffer ( `ctor`, `byteLength` [ , `maxByteLength` ] )

추상 연산 AllocateSharedArrayBuffer. 인수 ctor (생성자) 및 byteLength (음이 아닌 정수) 및 선택적 인수 maxByteLength ((음이 아닌 정수 또는 empty)). 반환값: (정상 완료 (값: SharedArrayBuffer) 또는 throw 완료). SharedArrayBuffer를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

slots를 « [[ArrayBufferData]] »로 둡니다.
maxByteLength가 존재하고 maxByteLength가 empty가 아니면 allocatingGrowableBuffer를 true로 두고, 그렇지 않으면 allocatingGrowableBuffer를 false로 둡니다.
allocatingGrowableBuffer가 true이면, 다음을 수행합니다.
1. byteLength > maxByteLength이면 RangeError 예외를 던집니다.
2. slots에 [[ArrayBufferByteLengthData]] 및 [[ArrayBufferMaxByteLength]]를 추가합니다.
그렇지 않으면,
1. slots에 [[ArrayBufferByteLength]]를 추가합니다.
obj를 ? OrdinaryCreateFromConstructor(ctor, "%SharedArrayBuffer.prototype%", slots)로 둡니다.
allocatingGrowableBuffer가 true이면 allocationLength를 maxByteLength로 두고, 그렇지 않으면 allocationLength를 byteLength로 둡니다.
block을 ? CreateSharedByteDataBlock(allocationLength)으로 둡니다.
obj.[[ArrayBufferData]]를 block으로 설정합니다.
allocatingGrowableBuffer가 true이면, 다음을 수행합니다.
1. 단언: byteLength ≤ maxByteLength입니다.
2. byteLengthBlock을 ? CreateSharedByteDataBlock(8)로 둡니다.
3. SetValueInBuffer(byteLengthBlock, 0, biguint64, ℤ(byteLength), true, seq-cst)를 수행합니다.
4. obj.[[ArrayBufferByteLengthData]]를 byteLengthBlock으로 설정합니다.
5. obj.[[ArrayBufferMaxByteLength]]를 maxByteLength로 설정합니다.
그렇지 않으면,
1. obj.[[ArrayBufferByteLength]]를 byteLength로 설정합니다.
obj를 반환합니다.

25.2.2.2 IsSharedArrayBuffer ( `obj` )

추상 연산 IsSharedArrayBuffer. 인수 obj ((ArrayBuffer 또는 SharedArrayBuffer)). 반환값: Boolean. 객체가 SharedArrayBuffer인지 검사합니다. 호출되면 다음 단계를 수행한다.

obj.[[ArrayBufferData]]가 Shared Data Block이면 true를 반환합니다.
false를 반환합니다.

25.2.2.3 IsGrowableSharedArrayBuffer ( `obj` )

추상 연산 IsGrowableSharedArrayBuffer. 인수 obj ((ArrayBuffer 또는 SharedArrayBuffer)). 반환값: Boolean. 객체가 확장 가능한 SharedArrayBuffer인지 검사합니다. 호출되면 다음 단계를 수행한다.

IsSharedArrayBuffer(obj)가 true이고 obj에 [[ArrayBufferByteLengthData]] 내부 슬롯이 있으면 true를 반환합니다.
false를 반환합니다.

25.2.2.4 HostGrowSharedArrayBuffer ( `buffer`, `newByteLength` )

호스트 정의 추상 연산 HostGrowSharedArrayBuffer. 인수 buffer (SharedArrayBuffer) 및 newByteLength (음이 아닌 정수). 반환값: (정상 완료 (값: (handled 또는 unhandled)) 또는 throw 완료). 호스트가 buffer의 구현체 정의 확장을 수행할 기회를 제공합니다. 호스트가 buffer 확장을 처리하지 않기로 선택하면 기본 동작을 위해 unhandled를 반환할 수 있습니다.

HostGrowSharedArrayBuffer의 구현은 다음 요구 사항을 준수해야 합니다:

추상 연산이 unhandled로 정상 완료되지 않고 newByteLength < buffer의 현재 바이트 길이이거나 newByteLength > buffer.[[ArrayBufferMaxByteLength]]이면 RangeError 예외를 던집니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다. isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다. 추상 연산이 handled로 정상 완료되면 [[Order]]가 seq-cst, [[Payload]]가 NumericToRawBytes(biguint64, newByteLength, isLittleEndian), [[Block]]이 buffer.[[ArrayBufferByteLengthData]], [[ByteIndex]]가 0, [[ElementSize]]가 8인 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트가 주변 에이전트의 후보 실행에 추가되어, SharedArrayBuffer.prototype.grow ( newLength )에 대한 경합 호출이 “유실”되지 않도록 해야 합니다. 즉, 아무 일도 하지 않고 조용히 끝나서는 안 됩니다.

참고

위의 두 번째 요구 사항은 buffer의 현재 바이트 길이를 언제 또는 어떻게 읽는지 의도적으로 모호하게 규정합니다. 바이트 길이는 기반 하드웨어의 원자적 read-modify-write 연산을 통해 업데이트해야 하므로 load-link/store-conditional 또는 load-exclusive/store-exclusive 명령 쌍을 사용하는 아키텍처에서는 쌍을 이루는 명령을 명령 스트림에서 가까이 유지하고자 할 수 있습니다. 따라서 SharedArrayBuffer.prototype.grow ( newLength ) 자체는 HostGrowSharedArrayBuffer를 호출하기 전에 newByteLength에 대한 범위 검사를 수행하지 않으며 현재 바이트 길이를 언제 읽어야 하는지에 대한 요구 사항도 없습니다.

이는 0 ≤ newByteLength ≤ buffer.[[ArrayBufferMaxByteLength]]가 보장되는 HostResizeArrayBuffer와 대조적입니다.

HostGrowSharedArrayBuffer의 기본 구현은 NormalCompletion(unhandled)을 반환하는 것입니다.

25.2.3 SharedArrayBuffer 생성자

SharedArrayBuffer 생성자는:

%SharedArrayBuffer%입니다.
해당 프로퍼티가 존재하는 경우 전역 객체의 "SharedArrayBuffer" 프로퍼티의 초기 값입니다(아래 참조).
생성자로 호출되면 새로운 SharedArrayBuffer를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 SharedArrayBuffer 동작을 상속하려는 하위 클래스 생성자는 SharedArrayBuffer.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 SharedArrayBuffer 생성자에 대한 super 호출을 포함해야 합니다.

호스트가 SharedArrayBuffer에 대한 동시 접근을 제공하지 않는 경우 전역 객체의 "SharedArrayBuffer" 프로퍼티를 생략할 수 있습니다.

참고

ArrayBuffer와 달리 SharedArrayBuffer는 분리될 수 없으며 내부 [[ArrayBufferData]] 슬롯은 절대 null이 되지 않습니다.

25.2.3.1 SharedArrayBuffer ( `length` [ , `options` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
byteLength를 ? ToIndex(length)로 둡니다.
requestedMaxByteLength를 ? GetArrayBufferMaxByteLengthOption(options)로 둡니다.
? AllocateSharedArrayBuffer(NewTarget, byteLength, requestedMaxByteLength)를 반환합니다.

25.2.4 SharedArrayBuffer 생성자의 프로퍼티

SharedArrayBuffer 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

25.2.4.1 SharedArrayBuffer.prototype

SharedArrayBuffer.prototype의 초기 값은 SharedArrayBuffer 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

25.2.4.2 get SharedArrayBuffer [ %Symbol.species% ]

SharedArrayBuffer[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

25.2.5 SharedArrayBuffer 프로토타입 객체의 프로퍼티

SharedArrayBuffer 프로토타입 객체는:

%SharedArrayBuffer.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[ArrayBufferData]] 또는 [[ArrayBufferByteLength]] 내부 슬롯을 갖지 않습니다.

25.2.5.1 get SharedArrayBuffer.prototype.byteLength

SharedArrayBuffer.prototype.byteLength는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 false이면 TypeError 예외를 던집니다.
length를 ArrayBufferByteLength(obj, seq-cst)로 둡니다.
𝔽(length)를 반환합니다.

25.2.5.2 SharedArrayBuffer.prototype.constructor

SharedArrayBuffer.prototype.constructor의 초기 값은 %SharedArrayBuffer%입니다.

25.2.5.3 SharedArrayBuffer.prototype.grow ( `newLength` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferMaxByteLength]])를 수행합니다.
IsSharedArrayBuffer(obj)가 false이면 TypeError 예외를 던집니다.
newByteLength를 ? ToIndex(newLength)로 둡니다.
hostHandled를 ? HostGrowSharedArrayBuffer(obj, newByteLength)로 둡니다.
hostHandled가 handled이면 undefined를 반환합니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다.
byteLengthBlock을 obj.[[ArrayBufferByteLengthData]]로 둡니다.
currentByteLengthRawBytes를 GetRawBytesFromSharedBlock(byteLengthBlock, 0, biguint64, true, seq-cst)로 둡니다.
newByteLengthRawBytes를 NumericToRawBytes(biguint64, ℤ(newByteLength), isLittleEndian)로 둡니다.
다음을 반복합니다.
1. 참고: 이는 동일한 버퍼에 대한 병렬 경합 확장이 전순서화되고 유실되지 않으며 아무 일도 하지 않고 조용히 끝나지 않도록 보장하는 compare-and-exchange 루프입니다. 경합 없이 확장을 시도할 수 있으면 루프를 종료합니다.
2. currentByteLength를 ℝ(RawBytesToNumeric(biguint64, currentByteLengthRawBytes, isLittleEndian))로 둡니다.
3. newByteLength = currentByteLength이면 undefined를 반환합니다.
4. newByteLength < currentByteLength이거나 newByteLength > obj.[[ArrayBufferMaxByteLength]]이면 RangeError 예외를 던집니다.
5. byteLengthDelta를 newByteLength - currentByteLength로 둡니다.
6. byteLengthDelta 바이트로 구성된 새로운 Shared Data Block 값을 생성할 수 없으면 RangeError 예외를 던집니다.
7. 참고: 여기서는 새로운 Shared Data Block을 실제로 생성하여 사용하지 않습니다. 확장 가능한 SharedArrayBuffer의 관찰 가능한 동작은 생성 시 최대 크기의 Shared Data Block을 할당하는 방식으로 명시되며, 이 단계는 메모리가 부족한 구현체가 RangeError를 던져야 한다는 요구 사항을 나타냅니다.
8. readByteLengthRawBytes를 AtomicCompareExchangeInSharedBlock(byteLengthBlock, 0, 8, currentByteLengthRawBytes, newByteLengthRawBytes)로 둡니다.
9. ByteListEqual(readByteLengthRawBytes, currentByteLengthRawBytes)이 true이면 undefined를 반환합니다.
10. currentByteLengthRawBytes를 readByteLengthRawBytes로 설정합니다.

참고

길이를 업데이트하는 compare-exchange의 허위 실패는 금지됩니다. 새 길이에 대한 범위 검사를 통과하고 구현체의 메모리가 부족하지 않으면 ReadModifyWriteSharedMemory 이벤트(즉, 성공한 compare-exchange)가 항상 후보 실행에 추가됩니다.

SharedArrayBuffer.prototype.grow의 병렬 호출은 전순서화됩니다. 예를 들어 서로 경합하는 두 호출 sab.grow(10)과 sab.grow(20)을 생각해 보십시오. 두 호출 중 하나가 반드시 경합에서 이깁니다. sab.grow(20)이 먼저 발생한 경우에도 sab.grow(10) 호출은 절대 sab를 축소하지 않으며, 대신 RangeError를 던집니다.

25.2.5.4 get SharedArrayBuffer.prototype.growable

SharedArrayBuffer.prototype.growable은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 false이면 TypeError 예외를 던집니다.
IsFixedLengthArrayBuffer(obj)가 false이면 true를 반환합니다.
false를 반환합니다.

25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength

SharedArrayBuffer.prototype.maxByteLength는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 false이면 TypeError 예외를 던집니다.
IsFixedLengthArrayBuffer(obj)가 true이면, 다음을 수행합니다.
1. length를 obj.[[ArrayBufferByteLength]]로 둡니다.
그렇지 않으면,
1. length를 obj.[[ArrayBufferMaxByteLength]]로 둡니다.
𝔽(length)를 반환합니다.

25.2.5.6 SharedArrayBuffer.prototype.slice ( `start`, `end` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(obj)가 false이면 TypeError 예외를 던집니다.
length를 ArrayBufferByteLength(obj, seq-cst)로 둡니다.
first를 ? ToClampedIndex(start, length)로 둡니다.
end가 undefined이면 final을 length로 둡니다. 그렇지 않으면 final을 ? ToClampedIndex(end, length)로 둡니다.
newLength를 max(final - first, 0)으로 둡니다.
ctor를 ? SpeciesConstructor(obj, %SharedArrayBuffer%)로 둡니다.
new를 ? Construct(ctor, « 𝔽(newLength) »)로 둡니다.
? RequireInternalSlot(new, [[ArrayBufferData]])를 수행합니다.
IsSharedArrayBuffer(new)가 false이면 TypeError 예외를 던집니다.
new.[[ArrayBufferData]]가 obj.[[ArrayBufferData]]이면 TypeError 예외를 던집니다.
ArrayBufferByteLength(new, seq-cst) < newLength이면 TypeError 예외를 던집니다.
fromBlock을 obj.[[ArrayBufferData]]로 둡니다.
toBlock을 new.[[ArrayBufferData]]로 둡니다.
CopyDataBlockBytes(toBlock, 0, fromBlock, first, newLength)를 수행합니다.
new를 반환합니다.

25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "SharedArrayBuffer"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

25.2.6 SharedArrayBuffer 인스턴스의 프로퍼티

SharedArrayBuffer 인스턴스는 SharedArrayBuffer 프로토타입 객체에서 프로퍼티를 상속합니다. 각 SharedArrayBuffer 인스턴스에는 [[ArrayBufferData]] 내부 슬롯이 있습니다. 확장 가능하지 않은 각 SharedArrayBuffer 인스턴스에는 [[ArrayBufferByteLength]] 내부 슬롯이 있습니다. 확장 가능한 각 SharedArrayBuffer 인스턴스에는 [[ArrayBufferByteLengthData]] 내부 슬롯과 [[ArrayBufferMaxByteLength]] 내부 슬롯이 있습니다.

참고

SharedArrayBuffer 인스턴스는 ArrayBuffer 인스턴스와 달리 절대 분리되지 않습니다.

25.2.7 확장 가능한 SharedArrayBuffer 지침

참고 1

다음은 확장 가능한 SharedArrayBuffer를 사용하는 ECMAScript 프로그래머를 위한 지침입니다.

확장 가능한 SharedArrayBuffer의 "maxByteLength" 옵션 값을 선택할 때는 애플리케이션에 가능한 가장 작은 크기를 선택할 것을 권장합니다. "maxByteLength"가 1073741824, 즉 1GiB를 초과하지 않을 것을 권장합니다.

특정 최대 크기로 확장 가능한 SharedArrayBuffer를 성공적으로 생성했다고 해서 이후의 확장도 성공한다는 보장은 없다는 점에 유의하시기 바랍니다.

확장 가능한 SharedArrayBuffer의 길이를 읽는 모든 로드가 동기화 seq-cst 로드는 아닙니다. 예를 들어 u8[idx]와 같은 정수 인덱스 프로퍼티 접근의 범위 검사를 위한 길이 로드는 동기화되지 않습니다. 일반적으로 명시적 동기화가 없으면 한 프로퍼티 접근이 범위 안에 있다는 사실이 동일한 에이전트의 이후 프로퍼티 접근도 범위 안에 있음을 의미하지 않습니다. 반대로 SharedArrayBuffer, %TypedArray%.prototype, DataView.prototype의 length 및 byteLength getter를 통한 명시적 길이 로드는 동기화됩니다. TypedArray가 완전히 범위를 벗어났는지 검사하기 위해 내장 메서드가 수행하는 길이 로드도 동기화됩니다.

참고 2

다음은 확장 가능한 SharedArrayBuffer를 구현하는 ECMAScript 구현자를 위한 지침입니다.

확장 가능한 SharedArrayBuffer는 가상 메모리를 미리 예약하여 제자리 확장하는 방식으로 구현할 것을 권장합니다.

확장 연산은 확장 가능한 SharedArrayBuffer에 대한 메모리 접근과 병렬로 발생할 수 있으므로 메모리 모델의 제약 조건은 순서 없는 접근조차 “찢어짐”이 발생하지 않도록 요구합니다(값의 비트가 서로 섞이지 않아야 합니다). 실제로 이는 확장 가능한 SharedArrayBuffer의 기반 데이터 블록을 전 세계를 중지하지 않고 복사하여 확장할 수 없음을 의미합니다. 구현 전략으로 전 세계를 중지하는 방식은 직렬화 지점을 도입하고 느리므로 권장하지 않습니다.

확장된 메모리는 병렬로 경합하는 접근을 포함하여 생성되는 순간부터 0으로 채워진 것으로 보여야 합니다. 이는 필요 시 0으로 채워지는 가상 메모리 페이지를 사용하거나, 메모리를 수동으로 0으로 채우는 경우 주의 깊은 동기화를 사용하여 달성할 수 있습니다.

확장 가능한 SharedArrayBuffer의 TypedArray 뷰에 대한 정수 인덱스 프로퍼티 접근은 확장 불가능한 SharedArrayBuffer의 TypedArray 뷰에 대한 접근과 유사하게 최적화할 수 있도록 의도됩니다. 이는 정수 인덱스 프로퍼티 로드가 기반 버퍼의 길이에 대해 동기화되지 않기 때문입니다(위의 프로그래머 지침 참조). 예를 들어 프로퍼티 접근의 범위 검사를 여전히 루프 밖으로 끌어올릴 수 있습니다.

MMU가 없는 임베디드 장치에서 실행되는 경우처럼 가상 메모리가 없는 호스트에서는 확장 가능한 SharedArrayBuffer를 복사 방식으로 구현하기가 실제로 어렵습니다. 이러한 호스트에서 확장 가능한 SharedArrayBuffer의 메모리 사용 동작은 가상 메모리를 갖는 호스트와 크게 다를 수 있습니다. 이러한 호스트는 사용자에게 메모리 사용 예상치를 명확히 전달해야 합니다.

25.3 DataView 객체

25.3.1 DataView 객체를 위한 추상 연산

25.3.1.1 DataView With Buffer Witness Records

DataView With Buffer Witness Record는 DataView와 뷰가 참조하는 버퍼의 캐시된 바이트 길이를 함께 캡슐화하는 데 사용되는 Record입니다. 뷰가 참조하는 버퍼가 확장 가능한 SharedArrayBuffer일 때 바이트 길이 데이터 블록에 대한 ReadSharedMemory 이벤트가 하나만 존재하도록 보장하는 데 도움을 주기 위해 사용됩니다.

DataView With Buffer Witness Records에는 표 73에 나열된 필드가 있습니다.

표 73: DataView With Buffer Witness Record 필드

필드 이름	값	의미
`[[Object]]`	a DataView	버퍼의 바이트 길이를 로드하는 DataView 객체입니다.
`[[CachedBufferByteLength]]`	a non-negative integer or detached	Record가 생성될 때 객체의 `[[ViewedArrayBuffer]]`의 바이트 길이입니다.

25.3.1.2 MakeDataViewWithBufferWitnessRecord ( `obj`, `order` )

추상 연산 MakeDataViewWithBufferWitnessRecord. 인수 obj (DataView) 및 order ((seq-cst 또는 unordered)). 반환값: DataView With Buffer Witness 레코드. 호출되면 다음 단계를 수행한다.

buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
IsDetachedBuffer(buffer)가 true이면, 다음을 수행합니다.
1. byteLength를 detached로 둡니다.
그렇지 않으면,
1. byteLength를 ArrayBufferByteLength(buffer, order)로 둡니다.
DataView With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }를 반환합니다.

25.3.1.3 GetViewByteLength ( `viewRecord` )

추상 연산 GetViewByteLength. 인수 viewRecord (DataView With Buffer Witness 레코드). 반환값: 음이 아닌 정수. 호출되면 다음 단계를 수행한다.

단언: IsViewOutOfBounds(viewRecord)는 false입니다.
view를 viewRecord.[[Object]]로 둡니다.
view.[[ByteLength]]가 auto가 아니면 view.[[ByteLength]]를 반환합니다.
단언: IsFixedLengthArrayBuffer(view.[[ViewedArrayBuffer]])는 false입니다.
byteOffset을 view.[[ByteOffset]]으로 둡니다.
byteLength를 viewRecord.[[CachedBufferByteLength]]로 둡니다.
단언: byteLength는 detached가 아닙니다.
byteLength - byteOffset을 반환합니다.

25.3.1.4 IsViewOutOfBounds ( `viewRecord` )

추상 연산 IsViewOutOfBounds. 인수 viewRecord (DataView With Buffer Witness 레코드). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

view를 viewRecord.[[Object]]로 둡니다.
bufferByteLength를 viewRecord.[[CachedBufferByteLength]]로 둡니다.
IsDetachedBuffer(view.[[ViewedArrayBuffer]])가 true이면, 다음을 수행합니다.
1. 단언: bufferByteLength는 detached입니다.
2. true를 반환합니다.
단언: bufferByteLength는 음이 아닌 정수입니다.
byteOffsetStart를 view.[[ByteOffset]]으로 둡니다.
view.[[ByteLength]]가 auto이면, 다음을 수행합니다.
1. byteOffsetEnd를 bufferByteLength로 둡니다.
그렇지 않으면,
1. byteOffsetEnd를 byteOffsetStart + view.[[ByteLength]]로 둡니다.
참고: [[ByteOffset]]이 bufferByteLength인 길이 0의 DataView는 범위를 벗어난 것으로 간주하지 않습니다.
byteOffsetStart > bufferByteLength이거나 byteOffsetEnd > bufferByteLength이면 true를 반환합니다.
false를 반환합니다.

25.3.1.5 GetViewValue ( `view`, `requestIndex`, `isLittleEndian`, `type` )

추상 연산 GetViewValue. 인수 view (ECMAScript 언어 값), requestIndex (ECMAScript 언어 값), isLittleEndian (ECMAScript 언어 값) 및 type (TypedArray 요소 타입). 반환값: (정상 완료 (값: (Number 또는 BigInt)) 또는 throw 완료). DataView 인스턴스의 함수가 뷰의 버퍼에서 값을 가져오는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(view, [[DataView]])를 수행합니다.
단언: view에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
getIndex를 ? ToIndex(requestIndex)로 둡니다.
isLittleEndian을 ToBoolean(isLittleEndian)으로 설정합니다.
viewOffset을 view.[[ByteOffset]]으로 둡니다.
viewRecord를 MakeDataViewWithBufferWitnessRecord(view, unordered)로 둡니다.
참고: view의 기반 버퍼가 확장 가능한 SharedArrayBuffer일 때 범위 검사는 동기화 연산이 아닙니다.
IsViewOutOfBounds(viewRecord)가 true이면 TypeError 예외를 던집니다.
viewSize를 GetViewByteLength(viewRecord)로 둡니다.
elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
getIndex + elementSize > viewSize이면 RangeError 예외를 던집니다.
bufferIndex를 getIndex + viewOffset으로 둡니다.
GetValueFromBuffer(view.[[ViewedArrayBuffer]], bufferIndex, type, false, unordered, isLittleEndian)을 반환합니다.

25.3.1.6 SetViewValue ( `view`, `requestIndex`, `isLittleEndian`, `type`, `value` )

추상 연산 SetViewValue. 인수 view (ECMAScript 언어 값), requestIndex (ECMAScript 언어 값), isLittleEndian (ECMAScript 언어 값), type (TypedArray 요소 타입) 및 value (ECMAScript 언어 값). 반환값: (정상 완료 (값: unused) 또는 throw 완료). DataView 인스턴스의 함수가 뷰의 버퍼에 값을 저장하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(view, [[DataView]])를 수행합니다.
단언: view에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
getIndex를 ? ToIndex(requestIndex)로 둡니다.
IsBigIntElementType(type)이 true이면 number를 ? ToBigInt(value)로 둡니다.
그렇지 않으면 number를 ? ToNumber(value)로 둡니다.
isLittleEndian을 ToBoolean(isLittleEndian)으로 설정합니다.
viewOffset을 view.[[ByteOffset]]으로 둡니다.
viewRecord를 MakeDataViewWithBufferWitnessRecord(view, unordered)로 둡니다.
참고: view의 기반 버퍼가 확장 가능한 SharedArrayBuffer일 때 범위 검사는 동기화 연산이 아닙니다.
IsViewOutOfBounds(viewRecord)가 true이면 TypeError 예외를 던집니다.
viewSize를 GetViewByteLength(viewRecord)로 둡니다.
elementSize를 Element Type type에 대해 표 71에 지정된 Element Size 값으로 둡니다.
getIndex + elementSize > viewSize이면 RangeError 예외를 던집니다.
bufferIndex를 getIndex + viewOffset으로 둡니다.
SetValueInBuffer(view.[[ViewedArrayBuffer]], bufferIndex, type, number, false, unordered, isLittleEndian)을 수행합니다.
unused를 반환합니다.

25.3.2 DataView 생성자

DataView 생성자는:

%DataView%입니다.
전역 객체의 "DataView" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 DataView를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 DataView 동작을 상속하려는 하위 클래스 생성자는 DataView.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태를 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 DataView 생성자에 대한 super 호출을 포함해야 합니다.

25.3.2.1 DataView ( `buffer` [ , `byteOffset` [ , `byteLength` ] ] )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
? RequireInternalSlot(buffer, [[ArrayBufferData]])를 수행합니다.
offset을 ? ToIndex(byteOffset)로 둡니다.
IsDetachedBuffer(buffer)가 true이면 TypeError 예외를 던집니다.
bufferByteLength를 ArrayBufferByteLength(buffer, seq-cst)로 둡니다.
offset > bufferByteLength이면 RangeError 예외를 던집니다.
bufferIsFixedLength를 IsFixedLengthArrayBuffer(buffer)로 둡니다.
byteLength가 undefined이면, 다음을 수행합니다.
1. bufferIsFixedLength가 true이면, 다음을 수행합니다.
  1. viewByteLength를 bufferByteLength - offset으로 둡니다.
2. 그렇지 않으면,
  1. viewByteLength를 auto로 둡니다.
그렇지 않으면,
1. viewByteLength를 ? ToIndex(byteLength)로 둡니다.
2. offset + viewByteLength > bufferByteLength이면 RangeError 예외를 던집니다.
obj를 ? OrdinaryCreateFromConstructor(NewTarget, "%DataView.prototype%", « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] »)로 둡니다.
IsDetachedBuffer(buffer)가 true이면 TypeError 예외를 던집니다.
bufferByteLength를 ArrayBufferByteLength(buffer, seq-cst)로 설정합니다.
offset > bufferByteLength이면 RangeError 예외를 던집니다.
byteLength가 undefined가 아니면, 다음을 수행합니다.
1. offset + viewByteLength > bufferByteLength이면 RangeError 예외를 던집니다.
obj.[[ViewedArrayBuffer]]를 buffer로 설정합니다.
obj.[[ByteLength]]를 viewByteLength로 설정합니다.
obj.[[ByteOffset]]을 offset으로 설정합니다.
obj를 반환합니다.

25.3.3 DataView 생성자의 프로퍼티

DataView 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

25.3.3.1 DataView.prototype

DataView.prototype의 초기 값은 DataView 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

25.3.4 DataView 프로토타입 객체의 프로퍼티

DataView 프로토타입 객체는:

%DataView.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] 내부 슬롯을 갖지 않습니다.

25.3.4.1 get DataView.prototype.buffer

DataView.prototype.buffer는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[DataView]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
buffer를 obj.[[ViewedArrayBuffer]]로 둡니다.
buffer를 반환합니다.

25.3.4.2 get DataView.prototype.byteLength

DataView.prototype.byteLength는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[DataView]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
viewRecord를 MakeDataViewWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsViewOutOfBounds(viewRecord)가 true이면 TypeError 예외를 던집니다.
size를 GetViewByteLength(viewRecord)로 둡니다.
𝔽(size)를 반환합니다.

25.3.4.3 get DataView.prototype.byteOffset

DataView.prototype.byteOffset은 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[DataView]])를 수행합니다.
단언: obj에는 [[ViewedArrayBuffer]] 내부 슬롯이 있습니다.
viewRecord를 MakeDataViewWithBufferWitnessRecord(obj, seq-cst)로 둡니다.
IsViewOutOfBounds(viewRecord)가 true이면 TypeError 예외를 던집니다.
offset을 obj.[[ByteOffset]]으로 둡니다.
𝔽(offset)을 반환합니다.

25.3.4.4 DataView.prototype.constructor

DataView.prototype.constructor의 초기 값은 %DataView%입니다.

25.3.4.5 DataView.prototype.getBigInt64 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? GetViewValue(view, byteOffset, littleEndian, bigint64)를 반환합니다.

25.3.4.6 DataView.prototype.getBigUint64 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? GetViewValue(view, byteOffset, littleEndian, biguint64)를 반환합니다.

25.3.4.7 DataView.prototype.getFloat16 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, float16)를 반환합니다.

25.3.4.8 DataView.prototype.getFloat32 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, float32)를 반환합니다.

25.3.4.9 DataView.prototype.getFloat64 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, float64)를 반환합니다.

25.3.4.10 DataView.prototype.getInt8 ( `byteOffset` )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? GetViewValue(view, byteOffset, true, int8)를 반환합니다.

25.3.4.11 DataView.prototype.getInt16 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, int16)를 반환합니다.

25.3.4.12 DataView.prototype.getInt32 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, int32)를 반환합니다.

25.3.4.13 DataView.prototype.getUint8 ( `byteOffset` )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? GetViewValue(view, byteOffset, true, uint8)를 반환합니다.

25.3.4.14 DataView.prototype.getUint16 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, uint16)를 반환합니다.

25.3.4.15 DataView.prototype.getUint32 ( `byteOffset` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? GetViewValue(view, byteOffset, littleEndian, uint32)를 반환합니다.

25.3.4.16 DataView.prototype.setBigInt64 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? SetViewValue(view, byteOffset, littleEndian, bigint64, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.17 DataView.prototype.setBigUint64 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? SetViewValue(view, byteOffset, littleEndian, biguint64, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.18 DataView.prototype.setFloat16 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, float16, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.19 DataView.prototype.setFloat32 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, float32, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.20 DataView.prototype.setFloat64 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, float64, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.21 DataView.prototype.setInt8 ( `byteOffset`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? SetViewValue(view, byteOffset, true, int8, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.22 DataView.prototype.setInt16 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, int16, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.23 DataView.prototype.setInt32 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, int32, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.24 DataView.prototype.setUint8 ( `byteOffset`, `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
? SetViewValue(view, byteOffset, true, uint8, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.25 DataView.prototype.setUint16 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, uint16, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.26 DataView.prototype.setUint32 ( `byteOffset`, `value` [ , `littleEndian` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

view를 this 값으로 둡니다.
littleEndian이 존재하지 않으면 littleEndian을 false로 설정합니다.
? SetViewValue(view, byteOffset, littleEndian, uint32, value)를 수행합니다.
undefined를 반환합니다.

25.3.4.27 DataView.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "DataView"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

25.3.5 DataView 인스턴스의 프로퍼티

DataView 인스턴스는 DataView 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. 각 DataView 인스턴스에는 [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] 내부 슬롯이 있습니다.

참고

[[DataView]] 내부 슬롯의 값은 이 명세 안에서 사용되지 않습니다. 해당 내부 슬롯이 존재한다는 사실 자체가 명세에서 DataView 생성자를 사용하여 생성된 객체를 식별하는 데 사용됩니다.

25.4 Atomics 객체

Atomics 객체는:

%Atomics%입니다.
전역 객체의 "Atomics" 프로퍼티의 초기 값입니다.
일반 객체입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
[[Construct]] 내부 메서드를 갖지 않으므로 new 연산자와 함께 생성자로 사용할 수 없습니다.
[[Call]] 내부 메서드를 갖지 않으므로 함수로 호출할 수 없습니다.

Atomics 객체는 공유 메모리 배열 셀에 대해 분할 불가능하게(원자적으로) 동작하는 함수와 에이전트가 기본 이벤트를 기다리고 디스패치하도록 하는 함수를 제공합니다. 규율 있게 사용하면 Atomics 함수는 공유 메모리를 통해 통신하는 다중 에이전트 프로그램이 병렬 CPU에서도 잘 정의된 순서로 실행되도록 합니다. 공유 메모리 통신을 지배하는 규칙은 아래에 정의된 메모리 모델에서 제공합니다.

참고

ECMAScript에서 공유 메모리를 프로그래밍하고 구현하기 위한 정보 제공용 지침은 메모리 모델 절 끝의 참고를 참조하시기 바랍니다.

25.4.1 Waiter Record

Waiter Record는 Atomics.wait 또는 Atomics.waitAsync의 특정 호출을 나타내는 데 사용되는 Record입니다.

Waiter Record에는 표 74에 나열된 필드가 있습니다.

표 74: Waiter Record 필드

필드 이름	값	의미
`[[AgentSignifier]]`	an agent signifier	`Atomics.wait` 또는 `Atomics.waitAsync`를 호출한 에이전트입니다.
`[[PromiseCapability]]`	a PromiseCapability Record or blocking	`Atomics.waitAsync` 호출을 나타내는 경우 결과 promise이며, 그렇지 않으면 blocking입니다.
`[[TimeoutTime]]`	a non-negative extended mathematical value	타임아웃이 트리거될 수 있는 가장 이른 시간이며 시간 값을 사용하여 계산합니다.
`[[Result]]`	"ok" or "timed-out"	호출의 반환 값입니다.

25.4.2 WaiterList Records

WaiterList Record는 Atomics.wait, Atomics.waitAsync, Atomics.notify를 통한 에이전트의 대기 및 알림을 설명하는 데 사용됩니다.

WaiterList Record에는 표 75에 나열된 필드가 있습니다.

표 75: WaiterList Record 필드

필드 이름	값	의미
`[[Waiters]]`	a List of Waiter Records	이 WaiterList와 연결된 위치에서 대기 중인 `Atomics.wait` 또는 `Atomics.waitAsync` 호출입니다.
`[[MostRecentLeaveEvent]]`	a Synchronize event or empty	임계 구역에서 가장 최근에 나간 이벤트이며, 임계 구역에 한 번도 들어간 적이 없으면 empty입니다.

동일한 agent signifier를 갖는 여러 Waiter Record가 하나의 WaiterList에 있을 수 있습니다.

에이전트 클러스터에는 WaiterList Records 저장소가 있습니다. 이 저장소는 (block, i)로 인덱싱되며, 여기서 block은 Shared Data Block이고 i는 block 메모리 안의 바이트 오프셋입니다. WaiterList Records는 에이전트와 독립적입니다. WaiterList Records 저장소에서 (block, i)로 조회하면 에이전트 클러스터의 어떤 에이전트에서도 동일한 WaiterList Record가 결과로 나옵니다.

각 WaiterList Record에는 평가 중 해당 WaiterList Record에 대한 배타적 접근을 제어하는 임계 구역이 있습니다. 한 번에 하나의 에이전트만 WaiterList Record의 임계 구역에 들어갈 수 있습니다. WaiterList Record의 임계 구역에 들어가고 나가는 것은 추상 연산 EnterCriticalSection 및 LeaveCriticalSection이 제어합니다. WaiterList Record에 대한 연산—대기 중인 에이전트 추가 및 제거, 에이전트 목록 순회, 목록의 에이전트 일시 중단 및 알림, Synchronize 이벤트 설정 및 가져오기—은 WaiterList Record의 임계 구역에 들어간 에이전트만 수행할 수 있습니다.

25.4.3 Atomics를 위한 추상 연산

25.4.3.1 ValidateIntegerTypedArray ( `ta`, `waitable` )

추상 연산 ValidateIntegerTypedArray. 인수 ta (ECMAScript 언어 값) 및 waitable (Boolean). 반환값: (정상 완료 (값: TypedArray With Buffer Witness 레코드) 또는 throw 완료). %Atomics% 함수와 함께 사용할 수 있는 TypedArray, 특히 공유 메모리와의 원자적 상호작용을 보장할 수 있는 TypedArray를 제한하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

참고: ta의 기반 버퍼가 확장 가능한 SharedArrayBuffer일 때 범위 검사는 동기화 연산이 아닙니다.
taRecord를 ? ValidateTypedArray(ta, unordered)로 둡니다.
elementType을 TypedArrayElementType(ta)로 둡니다.
IsNoTearConfiguration(elementType, seq-cst)이 false이면 TypeError 예외를 던집니다.
waitable이 true이고 elementType이 int32도 bigint64도 아니면 TypeError 예외를 던집니다.
taRecord를 반환합니다.

25.4.3.2 ValidateAtomicAccess ( `taRecord`, `requestIndex` )

추상 연산 ValidateAtomicAccess. 인수 taRecord (TypedArray With Buffer Witness 레코드) 및 requestIndex (ECMAScript 언어 값). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

length를 TypedArrayLength(taRecord)로 둡니다.
accessIndex를 ? ToIndex(requestIndex)로 둡니다.
단언: accessIndex ≥ 0입니다.
accessIndex ≥ length이면 RangeError 예외를 던집니다.
ta를 taRecord.[[Object]]로 둡니다.
elementSize를 TypedArrayElementSize(ta)로 둡니다.
offset을 ta.[[ByteOffset]]으로 둡니다.
(accessIndex × elementSize) + offset을 반환합니다.

25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( `ta`, `requestIndex` )

추상 연산 ValidateAtomicAccessOnIntegerTypedArray. 인수 ta (ECMAScript 언어 값) 및 requestIndex (ECMAScript 언어 값). 반환값: (정상 완료 (값: 음이 아닌 정수) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

taRecord를 ? ValidateIntegerTypedArray(ta, false)로 둡니다.
? ValidateAtomicAccess(taRecord, requestIndex)를 반환합니다.

25.4.3.4 RevalidateAtomicAccess ( `ta`, `byteIndexInBuffer` )

추상 연산 RevalidateAtomicAccess. 인수 ta (TypedArray) 및 byteIndexInBuffer (음이 아닌 정수). 반환값: (정상 완료 (값: unused) 또는 throw 완료). Atomics 메서드에서 모든 인수 강제 변환이 수행된 후 원자적 연산을 위해 기반 버퍼 안의 인덱스를 다시 검증합니다. 인수 강제 변환은 임의의 부수 효과를 가질 수 있어 버퍼가 범위를 벗어나게 할 수 있기 때문입니다. 이 연산은 ta의 기반 버퍼가 SharedArrayBuffer인 경우 예외를 던지지 않습니다. 호출되면 다음 단계를 수행한다.

참고: ta의 기반 버퍼가 확장 가능한 SharedArrayBuffer인 경우, 경계 검사는 동기화 작업이 아닙니다.
taRecord를 ? ValidateTypedArrayBounds(ta, unordered)로 설정합니다.
단언: byteIndexInBuffer ≥ ta.[[ByteOffset]].
elementSize를 TypedArrayElementSize(ta)로 설정합니다.
elementLastByteIndex를 byteIndexInBuffer + elementSize - 1로 설정합니다.
elementLastByteIndex ≥ taRecord.[[CachedBufferByteLength]]이면 RangeError 예외를 던집니다.
unused를 반환합니다.

25.4.3.5 GetWaiterList ( `block`, `i` )

추상 연산 GetWaiterList. 인수 block (공유 데이터 블록) 및 i (a non-negative integer that is evenly divisible by 4). 반환값: WaiterList 레코드. 호출되면 다음 단계를 수행한다.

단언: i와 i + 3은 block 메모리 안의 유효한 바이트 오프셋입니다.
쌍 (block, i)가 참조하는 WaiterList Record를 반환합니다.

25.4.3.6 EnterCriticalSection ( `waiterList` )

추상 연산 EnterCriticalSection. 인수 waiterList (WaiterList 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 어떤 WaiterList Record의 임계 구역에도 들어가 있지 않습니다.
어떤 에이전트도 waiterList의 임계 구역에 있지 않을 때까지 기다린 다음, 다른 에이전트가 들어가는 것을 허용하지 않고 waiterList의 임계 구역에 들어갑니다.
waiterList.[[MostRecentLeaveEvent]]가 empty가 아니면, 다음을 수행합니다.
1. 참고: 임계 구역에 한 번 이상 들어간 waiterList에는 LeaveCriticalSection이 설정한 Synchronize 이벤트가 있습니다.
2. agentRecord를 주변 에이전트의 Agent Record로 둡니다.
3. execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
4. eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
5. enterEvent를 새로운 Synchronize 이벤트로 둡니다.
6. enterEvent를 eventsRecord.[[EventList]]에 추가합니다.
7. (waiterList.[[MostRecentLeaveEvent]], enterEvent)를 eventsRecord.[[AgentSynchronizesWith]]에 추가합니다.
unused를 반환합니다.

EnterCriticalSection은 임계 구역에 들어가려는 에이전트가 다른 에이전트가 나갈 때까지 기다려야 할 때 경합이 발생합니다. 경합이 없으면 EnterCriticalSection 호출의 FIFO 순서를 관찰할 수 있습니다. 경합이 있는 경우 구현체는 임의의 순서를 선택할 수 있지만 에이전트를 무기한 기다리게 해서는 안 됩니다.

25.4.3.7 LeaveCriticalSection ( `waiterList` )

추상 연산 LeaveCriticalSection. 인수 waiterList (WaiterList 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 waiterList의 임계 구역 안에 있습니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
leaveEvent를 새로운 Synchronize 이벤트로 둡니다.
leaveEvent를 eventsRecord.[[EventList]]에 추가합니다.
waiterList.[[MostRecentLeaveEvent]]를 leaveEvent로 설정합니다.
waiterList의 임계 구역에서 나갑니다.
unused를 반환합니다.

25.4.3.8 AddWaiter ( `waiterList`, `waiterRecord` )

추상 연산 AddWaiter. 인수 waiterList (WaiterList 레코드) 및 waiterRecord (Waiter 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 waiterList의 임계 구역 안에 있습니다.
단언: waiterList.[[Waiters]]에는 [[PromiseCapability]] 필드가 waiterRecord.[[PromiseCapability]]이고 [[AgentSignifier]] 필드가 waiterRecord.[[AgentSignifier]]인 Waiter Record가 없습니다.
waiterRecord를 waiterList.[[Waiters]]에 추가합니다.
unused를 반환합니다.

25.4.3.9 RemoveWaiter ( `waiterList`, `waiterRecord` )

추상 연산 RemoveWaiter. 인수 waiterList (WaiterList 레코드) 및 waiterRecord (Waiter 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 waiterList의 임계 구역 안에 있습니다.
단언: waiterList.[[Waiters]]에는 waiterRecord가 포함되어 있습니다.
waiterRecord를 waiterList.[[Waiters]]에서 제거합니다.
unused를 반환합니다.

25.4.3.10 RemoveWaiters ( `waiterList`, `count` )

추상 연산 RemoveWaiters. 인수 waiterList (WaiterList 레코드) 및 count ((음이 아닌 정수 또는 +∞)). 반환값: 리스트 (요소: Waiter 레코드). 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 waiterList의 임계 구역 안에 있습니다.
length를 waiterList.[[Waiters]]의 요소 수로 둡니다.
count를 min(count, length)로 설정합니다.
waiters를 waiterList.[[Waiters]]의 처음 count개 요소를 요소로 갖는 List로 둡니다.
waiterList.[[Waiters]]의 처음 count개 요소를 제거합니다.
waiters를 반환합니다.

25.4.3.11 SuspendThisAgent ( `waiterList`, `waiterRecord` )

추상 연산 SuspendThisAgent. 인수 waiterList (WaiterList 레코드) 및 waiterRecord (Waiter 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 waiterList의 임계 구역 안에 있습니다.
단언: waiterList.[[Waiters]]에는 waiterRecord가 포함되어 있습니다.
thisAgent를 AgentSignifier()로 둡니다.
단언: waiterRecord.[[AgentSignifier]]는 thisAgent입니다.
단언: waiterRecord.[[PromiseCapability]]은 blocking입니다.
단언: AgentCanSuspend()는 true입니다.
LeaveCriticalSection(waiterList)을 수행하고 시간이 waiterRecord.[[TimeoutTime]]이 될 때까지 주변 에이전트를 일시 중단합니다. 이 두 연산은 임계 구역을 나간 후 일시 중단이 실제로 적용되기 전에 도착한 알림이 유실되지 않는 방식으로 결합하여 수행합니다. 주변 에이전트는 타임아웃 또는 다른 에이전트가 waiterList와 thisAgent를 인수로 NotifyWaiter를 호출하는 경우에만 일시 중단에서 깨어날 수 있습니다(즉, Atomics.notify 호출을 통해).
EnterCriticalSection(waiterList)을 수행합니다.
unused를 반환합니다.

25.4.3.12 NotifyWaiter ( `waiterList`, `waiterRecord` )

추상 연산 NotifyWaiter. 인수 waiterList (WaiterList 레코드) 및 waiterRecord (Waiter 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: 주변 에이전트는 waiterList의 임계 구역 안에 있습니다.
waiterRecord.[[PromiseCapability]]이 blocking이면, 다음을 수행합니다.
1. signifier가 waiterRecord.[[AgentSignifier]]인 에이전트를 일시 중단에서 깨웁니다.
2. 참고: 이로 인해 에이전트는 SuspendThisAgent에서 실행을 재개합니다.
그렇지 않고 AgentSignifier()가 waiterRecord.[[AgentSignifier]]이면, 다음을 수행합니다.
1. promiseCapability을 waiterRecord.[[PromiseCapability]]로 둡니다.
2. ! Call(promiseCapability.[[Resolve]], undefined, « waiterRecord.[[Result]] »)를 수행합니다.
그렇지 않으면,
1. EnqueueResolveInAgentJob(waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]])을 수행합니다.
unused를 반환합니다.

참고

에이전트는 다른 에이전트의 promise capability를 호스트에 전달하는 것 이외의 어떠한 방식으로도 접근해서는 안 됩니다.

25.4.3.13 EnqueueResolveInAgentJob ( `agentSignifier`, `promiseCapability`, `resolution` )

추상 연산 EnqueueResolveInAgentJob. 인수 agentSignifier (an agent signifier), promiseCapability (PromiseCapability 레코드) 및 resolution (("ok" 또는 "timed-out")). 반환값: unused. 호출되면 다음 단계를 수행한다.

resolveJob을 매개변수가 없고 agentSignifier, promiseCapability, resolution을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Job Abstract Closure로 둡니다:
1. 단언: AgentSignifier()는 agentSignifier입니다.
2. ! Call(promiseCapability.[[Resolve]], undefined, « resolution »)를 수행합니다.
3. unused를 반환합니다.
realmInTargetAgent를 ! GetFunctionRealm(promiseCapability.[[Resolve]])로 둡니다.
단언: agentSignifier는 realmInTargetAgent.[[AgentSignifier]]입니다.
HostEnqueueGenericJob(resolveJob, realmInTargetAgent)을 수행합니다.
unused를 반환합니다.

25.4.3.14 DoWait ( `mode`, `ta`, `index`, `value`, `timeout` )

추상 연산 DoWait. 인수 mode ((sync 또는 async)), ta (ECMAScript 언어 값), index (ECMAScript 언어 값), value (ECMAScript 언어 값) 및 timeout (ECMAScript 언어 값). 반환값: (정상 완료 (값: (Object, "not-equal", "timed-out" 또는 "ok")) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

taRecord를 ? ValidateIntegerTypedArray(ta, true)로 둡니다.
buffer를 taRecord.[[Object]].[[ViewedArrayBuffer]]로 둡니다.
IsSharedArrayBuffer(buffer)가 false이면 TypeError 예외를 던집니다.
byteIndexInBuffer를 ? ValidateAtomicAccess(taRecord, index)로 둡니다.
elementType을 TypedArrayElementType(ta)로 둡니다.
단언: elementType은 bigint64 또는 int32입니다.
elementType이 bigint64이면 expected를 ? ToBigInt64(value)로 둡니다. 그렇지 않으면 expected를 ? ToInt32(value)로 둡니다.
timeoutNumber를 ? ToNumber(timeout)로 둡니다.
timeoutNumber가 NaN 또는 +∞_𝔽이면 realTimeout을 +∞로 둡니다.
그렇지 않고 timeoutNumber가 -∞_𝔽이면 realTimeout을 0으로 둡니다.
그렇지 않으면 realTimeout을 max(ℝ(timeoutNumber), 0)으로 둡니다.
mode가 sync이고 AgentCanSuspend()가 false이면 TypeError 예외를 던집니다.
block을 buffer.[[ArrayBufferData]]로 둡니다.
waiterList를 GetWaiterList(block, byteIndexInBuffer)로 둡니다.
mode가 sync이면, 다음을 수행합니다.
1. promiseCapability을 blocking으로 둡니다.
2. resultObj를 undefined로 둡니다.
그렇지 않으면,
1. promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
2. resultObj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
EnterCriticalSection(waiterList)을 수행합니다.
witness를 GetValueFromBuffer(buffer, byteIndexInBuffer, elementType, true, seq-cst)로 둡니다.
expected ≠ witness이면, 다음을 수행합니다.
1. LeaveCriticalSection(waiterList)을 수행합니다.
2. mode가 sync이면 "not-equal"을 반환합니다.
3. ! CreateDataPropertyOrThrow(resultObj, "async", false)를 수행합니다.
4. ! CreateDataPropertyOrThrow(resultObj, "value", "not-equal")를 수행합니다.
5. resultObj를 반환합니다.
realTimeout = 0이고 mode가 async이면, 다음을 수행합니다.
1. 참고: 동기식 즉시 타임아웃에는 특별한 처리가 없습니다. 비동기식 즉시 타임아웃은 빠르게 실패하고 불필요한 Promise job을 피하기 위해 특별히 처리됩니다.
2. LeaveCriticalSection(waiterList)을 수행합니다.
3. ! CreateDataPropertyOrThrow(resultObj, "async", false)를 수행합니다.
4. ! CreateDataPropertyOrThrow(resultObj, "value", "timed-out")를 수행합니다.
5. resultObj를 반환합니다.
thisAgent를 AgentSignifier()로 둡니다.
now를 현재 시간을 식별하는 시간 값(UTC)으로 둡니다.
additionalTimeout을 구현체 정의 음이 아닌 수학적 값으로 둡니다.
timeoutTime을 ℝ(now) + realTimeout + additionalTimeout으로 둡니다.
참고: realTimeout이 +∞이면 timeoutTime도 +∞입니다.
waiterRecord를 새로운 Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]: "ok" }로 둡니다.
AddWaiter(waiterList, waiterRecord)을 수행합니다.
mode가 sync이면, 다음을 수행합니다.
1. SuspendThisAgent(waiterList, waiterRecord)을 수행합니다.
그렇지 않고 timeoutTime이 유한하면, 다음을 수행합니다.
1. EnqueueAtomicsWaitAsyncTimeoutJob(waiterList, waiterRecord)을 수행합니다.
LeaveCriticalSection(waiterList)을 수행합니다.
mode가 sync이면 waiterRecord.[[Result]]를 반환합니다.
! CreateDataPropertyOrThrow(resultObj, "async", true)를 수행합니다.
! CreateDataPropertyOrThrow(resultObj, "value", promiseCapability.[[Promise]])를 수행합니다.
resultObj를 반환합니다.

참고

additionalTimeout은 전력 소비를 줄이거나 타이밍 공격을 완화하기 위해 타이머 해상도를 낮추는 등 필요한 경우 구현체가 타임아웃을 늘릴 수 있게 합니다. 이 값은 DoWait 호출마다 달라질 수 있습니다.

25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( `waiterList`, `waiterRecord` )

추상 연산 EnqueueAtomicsWaitAsyncTimeoutJob. 인수 waiterList (WaiterList 레코드) 및 waiterRecord (Waiter 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

timeoutJob을 매개변수가 없고 waiterList와 waiterRecord를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Job Abstract Closure로 둡니다:
1. EnterCriticalSection(waiterList)을 수행합니다.
2. waiterList.[[Waiters]]에 waiterRecord가 포함되어 있으면, 다음을 수행합니다.
  1. timeOfJobExecution을 현재 시간을 식별하는 시간 값(UTC)으로 둡니다.
  2. 단언: ℝ(timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]]입니다(시간 값의 잠재적인 비단조성은 무시합니다).
  3. waiterRecord.[[Result]]를 "timed-out"으로 설정합니다.
  4. RemoveWaiter(waiterList, waiterRecord)을 수행합니다.
  5. NotifyWaiter(waiterList, waiterRecord)을 수행합니다.
3. LeaveCriticalSection(waiterList)을 수행합니다.
4. unused를 반환합니다.
now를 현재 시간을 식별하는 시간 값(UTC)으로 둡니다.
currentRealm을 현재 Realm Record로 둡니다.
HostEnqueueTimeoutJob(timeoutJob, currentRealm, 𝔽(waiterRecord.[[TimeoutTime]]) - now)을 수행합니다.
unused를 반환합니다.

25.4.3.16 AtomicCompareExchangeInSharedBlock ( `block`, `byteIndexInBuffer`, `elementSize`, `expectedBytes`, `replacementBytes` )

추상 연산 AtomicCompareExchangeInSharedBlock. 인수 block (공유 데이터 블록), byteIndexInBuffer (정수), elementSize (음이 아닌 정수), expectedBytes (리스트 (요소: 바이트 값)) 및 replacementBytes (리스트 (요소: 바이트 값)). 반환값: 리스트 (요소: 바이트 값). 호출되면 다음 단계를 수행한다.

agentRecord를 주변 에이전트의 Agent Record로 둡니다.
execution을 agentRecord.[[CandidateExecution]]으로 둡니다.
eventsRecord를 [[AgentSignifier]]가 AgentSignifier()인 execution.[[EventsRecords]]의 Agent Events Record로 둡니다.
rawBytesRead를 요소가 비결정적으로 선택된 바이트 값인 길이 elementSize의 List로 둡니다.
참고: 구현체에서 rawBytesRead는 기반 하드웨어의 load-link, load-exclusive 또는 read-modify-write 명령의 피연산자 결과입니다. 비결정성은 약한 일관성을 갖는 하드웨어의 관찰 가능한 동작을 설명하기 위한 메모리 모델의 의미론적 규정입니다.
참고: 기대 값과 읽은 값의 비교는 기대 값이 읽은 값과 같지 않을 때 불필요하게 강한 동기화를 피하기 위해 read-modify-write 수정 함수 밖에서 수행됩니다.
ByteListEqual(rawBytesRead, expectedBytes)이 true이면, 다음을 수행합니다.
1. second를 아무것도 캡처하지 않고 매개변수 (oldBytes, newBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
  1. newBytes를 반환합니다.
2. event를 ReadModifyWriteSharedMemory { [[Order]]: seq-cst, [[NoTear]]: true, [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize, [[Payload]]: replacementBytes, [[ModifyOp]]: second }로 둡니다.
그렇지 않으면,
1. event를 ReadSharedMemory { [[Order]]: seq-cst, [[NoTear]]: true, [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize }로 둡니다.
event를 eventsRecord.[[EventList]]에 추가합니다.
Chosen Value Record { [[Event]]: event, [[ChosenValue]]: rawBytesRead }를 execution.[[ChosenValues]]에 추가합니다.
rawBytesRead를 반환합니다.

25.4.3.17 AtomicReadModifyWrite ( `ta`, `index`, `value`, `op` )

추상 연산 AtomicReadModifyWrite. 인수 ta (ECMAScript 언어 값), index (ECMAScript 언어 값), value (ECMAScript 언어 값) 및 op (a read-modify-write modification function). 반환값: (정상 완료 (값: (Number 또는 BigInt)) 또는 throw 완료). op는 바이트 값의 두 List 인수를 받고 바이트 값의 List를 반환합니다. 이 연산은 값을 원자적으로 로드하고 다른 값과 결합한 다음 결합 결과를 저장합니다. 로드한 값을 반환합니다. 호출되면 다음 단계를 수행한다.

byteIndexInBuffer를 ? ValidateAtomicAccessOnIntegerTypedArray(ta, index)로 둡니다.
ta.[[ContentType]]이 bigint이면 coerced를 ? ToBigInt(value)로 둡니다.
그렇지 않으면 coerced를 𝔽(? ToIntegerOrInfinity(value))로 둡니다.
? RevalidateAtomicAccess(ta, byteIndexInBuffer)를 수행합니다.
buffer를 ta.[[ViewedArrayBuffer]]로 둡니다.
elementType을 TypedArrayElementType(ta)로 둡니다.
GetModifySetValueInBuffer(buffer, byteIndexInBuffer, elementType, coerced, op)를 반환합니다.

25.4.3.18 ByteListBitwiseOp ( `op`, `xBytes`, `yBytes` )

추상 연산 ByteListBitwiseOp. 인수 op ((&, ^ 또는 |)), xBytes (리스트 (요소: 바이트 값)) 및 yBytes (리스트 (요소: 바이트 값)). 반환값: 리스트 (요소: 바이트 값). 이 연산은 인수의 모든 바이트 값에 대해 비트 연산을 원자적으로 수행하고 바이트 값의 List를 반환합니다. 호출되면 다음 단계를 수행한다.

단언: xBytes와 yBytes의 요소 수는 같습니다.
result를 새로운 빈 List로 둡니다.
i를 0으로 둡니다.
xBytes의 각 요소 xByte에 대해 다음을 수행합니다.
1. yByte를 yBytes[i]로 둡니다.
2. op가 &이면,
  1. resultByte를 xByte와 yByte에 비트 단위 AND 연산을 적용한 결과로 둡니다.
3. 그렇지 않고 op가 ^이면,
  1. resultByte를 xByte와 yByte에 비트 단위 XOR(배타적 OR) 연산을 적용한 결과로 둡니다.
4. 그렇지 않으면,
  1. 단언: op는 |입니다.
  2. resultByte를 xByte와 yByte에 비트 단위 OR(포괄적 OR) 연산을 적용한 결과로 둡니다.
5. i를 i + 1로 설정합니다.
6. result에 resultByte를 추가합니다.
result를 반환합니다.

25.4.3.19 ByteListEqual ( `xBytes`, `yBytes` )

추상 연산 ByteListEqual. 인수 xBytes (리스트 (요소: 바이트 값)) 및 yBytes (리스트 (요소: 바이트 값)). 반환값: Boolean. 호출되면 다음 단계를 수행한다.

xBytes와 yBytes의 요소 수가 같지 않으면 false를 반환합니다.
i를 0으로 둡니다.
xBytes의 각 요소 xByte에 대해 다음을 수행합니다.
1. yByte를 yBytes[i]로 둡니다.
2. xByte ≠ yByte이면 false를 반환합니다.
3. i를 i + 1로 설정합니다.
true를 반환합니다.

25.4.4 Atomics.add ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

add를 ta를 캡처하고 매개변수 (xBytes, yBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
1. type을 TypedArrayElementType(ta)로 둡니다.
2. agentRecord를 주변 에이전트의 Agent Record로 둡니다.
3. isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다.
4. x를 RawBytesToNumeric(type, xBytes, isLittleEndian)으로 둡니다.
5. y를 RawBytesToNumeric(type, yBytes, isLittleEndian)으로 둡니다.
6. x가 Number이면, 다음을 수행합니다.
  1. sum을 Number::add(x, y)로 둡니다.
7. 그렇지 않으면,
  1. 단언: x는 BigInt입니다.
  2. sum을 BigInt::add(x, y)로 둡니다.
8. sumBytes를 NumericToRawBytes(type, sum, isLittleEndian)로 둡니다.
9. 단언: sumBytes, xBytes, yBytes의 요소 수는 같습니다.
10. sumBytes를 반환합니다.
? AtomicReadModifyWrite(ta, index, value, add)를 반환합니다.

25.4.5 Atomics.and ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

and를 아무것도 캡처하지 않고 매개변수 (xBytes, yBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
1. ByteListBitwiseOp(&, xBytes, yBytes)를 반환합니다.
? AtomicReadModifyWrite(ta, index, value, and)를 반환합니다.

25.4.6 Atomics.compareExchange ( `ta`, `index`, `expectedValue`, `replacementValue` )

이 함수는 호출되면 다음 단계를 수행합니다:

byteIndexInBuffer를 ? ValidateAtomicAccessOnIntegerTypedArray(ta, index)로 둡니다.
buffer를 ta.[[ViewedArrayBuffer]]로 둡니다.
block을 buffer.[[ArrayBufferData]]로 둡니다.
ta.[[ContentType]]이 bigint이면, 다음을 수행합니다.
1. expected를 ? ToBigInt(expectedValue)로 둡니다.
2. replacement를 ? ToBigInt(replacementValue)로 둡니다.
그렇지 않으면,
1. expected를 𝔽(? ToIntegerOrInfinity(expectedValue))로 둡니다.
2. replacement를 𝔽(? ToIntegerOrInfinity(replacementValue))로 둡니다.
? RevalidateAtomicAccess(ta, byteIndexInBuffer)를 수행합니다.
elementType을 TypedArrayElementType(ta)로 둡니다.
elementSize를 TypedArrayElementSize(ta)로 둡니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다.
expectedBytes를 NumericToRawBytes(elementType, expected, isLittleEndian)로 둡니다.
replacementBytes를 NumericToRawBytes(elementType, replacement, isLittleEndian)로 둡니다.
IsSharedArrayBuffer(buffer)가 true이면, 다음을 수행합니다.
1. rawBytesRead를 AtomicCompareExchangeInSharedBlock(block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes)로 둡니다.
그렇지 않으면,
1. rawBytesRead를 block[byteIndexInBuffer]부터 시작하는 elementSize개의 바이트 시퀀스를 요소로 갖는 길이 elementSize의 List로 둡니다.
2. ByteListEqual(rawBytesRead, expectedBytes)이 true이면, 다음을 수행합니다.
  1. replacementBytes의 개별 바이트를 block[byteIndexInBuffer]에서 시작하여 block에 저장합니다.
RawBytesToNumeric(elementType, rawBytesRead, isLittleEndian)을 반환합니다.

25.4.7 Atomics.exchange ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

second를 아무것도 캡처하지 않고 매개변수 (oldBytes, newBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
1. newBytes를 반환합니다.
? AtomicReadModifyWrite(ta, index, value, second)를 반환합니다.

25.4.8 Atomics.isLockFree ( `size` )

이 함수는 호출되면 다음 단계를 수행합니다:

n을 ? ToIntegerOrInfinity(size)로 둡니다.
agentRecord를 주변 에이전트의 Agent Record로 둡니다.
n = 1이면 agentRecord.[[IsLockFree1]]을 반환합니다.
n = 2이면 agentRecord.[[IsLockFree2]]를 반환합니다.
n = 4이면 true를 반환합니다.
n = 8이면 agentRecord.[[IsLockFree8]]을 반환합니다.
false를 반환합니다.

참고

이 함수는 최적화 프리미티브입니다. 직관적으로 크기 n바이트인 데이터에 대한 원자적 프리미티브(compareExchange, load, store, add, sub, and, or, xor, exchange)의 원자적 단계가 데이터를 구성하는 n바이트 밖에서 주변 에이전트가 락을 획득하지 않고 수행된다면 Atomics.isLockFree(n)은 true를 반환합니다. 고성능 알고리즘은 이 함수를 사용하여 임계 구역에서 락을 사용할지 원자적 연산을 사용할지 결정합니다. 원자적 프리미티브가 lock-free가 아니면 알고리즘이 자체 락을 제공하는 것이 더 효율적인 경우가 많습니다.

Atomics.isLockFree(4)는 알려진 모든 관련 하드웨어에서 지원할 수 있으므로 항상 true를 반환합니다. 이를 가정할 수 있으면 일반적으로 프로그램을 단순화할 수 있습니다.

이 함수가 반환하는 값과 관계없이 모든 원자적 연산은 원자성이 보장됩니다. 예를 들어 연산 중간에 관찰 가능한 동작이 발생하는 일(예: “tearing”)은 절대 없습니다.

25.4.9 Atomics.load ( `ta`, `index` )

이 함수는 호출되면 다음 단계를 수행합니다:

byteIndexInBuffer를 ? ValidateAtomicAccessOnIntegerTypedArray(ta, index)로 둡니다.
? RevalidateAtomicAccess(ta, byteIndexInBuffer)를 수행합니다.
buffer를 ta.[[ViewedArrayBuffer]]로 둡니다.
elementType을 TypedArrayElementType(ta)로 둡니다.
GetValueFromBuffer(buffer, byteIndexInBuffer, elementType, true, seq-cst)를 반환합니다.

25.4.10 Atomics.notify ( `ta`, `index`, `count` )

이 함수는 대기 큐에서 잠들어 있는 일부 에이전트에 알립니다.

호출되면 다음 단계를 수행합니다:

taRecord를 ? ValidateIntegerTypedArray(ta, true)로 설정합니다.
byteIndexInBuffer를 ? ValidateAtomicAccess(taRecord, index)로 설정합니다.
count가 undefined이면,
1. count를 +∞로 설정합니다.
그렇지 않으면,
1. intCount를 ? ToIntegerOrInfinity(count)로 설정합니다.
2. count를 max(intCount, 0)으로 설정합니다.
buffer를 ta.[[ViewedArrayBuffer]]로 설정합니다.
IsSharedArrayBuffer(buffer)가 false이면, +0_𝔽를 반환합니다.
block을 buffer.[[ArrayBufferData]]로 설정합니다.
waiterList를 GetWaiterList(block, byteIndexInBuffer)로 설정합니다.
EnterCriticalSection(waiterList)을 수행합니다.
waiters를 RemoveWaiters(waiterList, count)로 설정합니다.
waiters의 각 요소 waiterRecord에 대해 다음을 수행합니다.
1. NotifyWaiter(waiterList, waiterRecord)를 수행합니다.
LeaveCriticalSection(waiterList)를 수행합니다.
waitersCount를 waiters의 요소 수로 설정합니다.
𝔽(waitersCount)를 반환합니다.

25.4.11 Atomics.or ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

or를 아무것도 캡처하지 않고 매개변수 (xBytes, yBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
1. ByteListBitwiseOp(|, xBytes, yBytes)를 반환합니다.
? AtomicReadModifyWrite(ta, index, value, or)를 반환합니다.

25.4.12 Atomics.pause ( )

이 함수는 프로그램이 값을 기다리며 스핀 루프 중이라는 힌트를 CPU에 제공합니다.

호출되면 다음 단계를 수행합니다:

ECMAScript 구현체의 실행 환경이 현재 실행 중인 코드가 스핀 대기 루프에 있다는 사실을 운영 체제나 CPU에 알리는 것을 지원하면 해당 신호를 보냅니다.
undefined를 반환합니다.

참고 1

이 메서드는 mutex 내부의 spinlock 빠른 경로와 같은 스핀 대기 루프를 구현하는 프로그램이 값을 기다리며 스핀 중이라는 힌트를 CPU에 제공하도록 설계되었습니다. 타이밍 외에는 관찰 가능한 동작이 없습니다.

기반 아키텍처의 모범 사례가 스핀 루프에서 pause 또는 yield 명령을 권장하는 경우 구현체가 그러한 명령을 구현할 것으로 예상됩니다. 예를 들어 Intel Optimization Manual에서는 pause 명령을 권장합니다.

구현체는 일시 중단되는 최대 시간에 대해 수십~수백 나노초 정도의 내부 상한을 두는 것이 권장됩니다.

참고 2

함수 호출의 오버헤드 때문에 최적화 컴파일러에서 이 메서드에 대한 인라인 호출이 인라인되지 않은 호출과 다른 시간 동안 기다리는 것은 합리적입니다.

25.4.13 Atomics.store ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

byteIndexInBuffer를 ? ValidateAtomicAccessOnIntegerTypedArray(ta, index)로 둡니다.
ta.[[ContentType]]이 bigint이면 coerced를 ? ToBigInt(value)로 둡니다.
그렇지 않으면 coerced를 𝔽(? ToIntegerOrInfinity(value))로 둡니다.
? RevalidateAtomicAccess(ta, byteIndexInBuffer)를 수행합니다.
buffer를 ta.[[ViewedArrayBuffer]]로 둡니다.
elementType을 TypedArrayElementType(ta)로 둡니다.
SetValueInBuffer(buffer, byteIndexInBuffer, elementType, coerced, true, seq-cst)를 수행합니다.
coerced를 반환합니다.

25.4.14 Atomics.sub ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

subtract를 ta를 캡처하고 매개변수 (xBytes, yBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
1. type을 TypedArrayElementType(ta)로 둡니다.
2. agentRecord를 주변 에이전트의 Agent Record로 둡니다.
3. isLittleEndian을 agentRecord.[[LittleEndian]]으로 둡니다.
4. x를 RawBytesToNumeric(type, xBytes, isLittleEndian)으로 둡니다.
5. y를 RawBytesToNumeric(type, yBytes, isLittleEndian)으로 둡니다.
6. x가 Number이면, 다음을 수행합니다.
  1. difference를 Number::subtract(x, y)로 둡니다.
7. 그렇지 않으면,
  1. 단언: x는 BigInt입니다.
  2. difference를 BigInt::subtract(x, y)로 둡니다.
8. differenceBytes를 NumericToRawBytes(type, difference, isLittleEndian)로 둡니다.
9. 단언: differenceBytes, xBytes, yBytes의 요소 수는 같습니다.
10. differenceBytes를 반환합니다.
? AtomicReadModifyWrite(ta, index, value, subtract)를 반환합니다.

25.4.15 Atomics.wait ( `ta`, `index`, `value`, `timeout` )

이 함수는 주변 에이전트를 대기 큐에 넣고 알림을 받거나 대기 시간이 초과될 때까지 일시 중단한 다음, 이러한 경우를 구별하는 String을 반환합니다.

호출되면 다음 단계를 수행합니다:

? DoWait(sync, ta, index, value, timeout)를 반환합니다.

25.4.16 Atomics.waitAsync ( `ta`, `index`, `value`, `timeout` )

이 함수는 호출 에이전트가 알림을 받거나 타임아웃에 도달하면 이행되는 Promise를 반환합니다.

호출되면 다음 단계를 수행합니다:

? DoWait(async, ta, index, value, timeout)를 반환합니다.

25.4.17 Atomics.xor ( `ta`, `index`, `value` )

이 함수는 호출되면 다음 단계를 수행합니다:

xor를 아무것도 캡처하지 않고 매개변수 (xBytes, yBytes)를 가지며 호출될 때 다음 단계를 원자적으로 수행하는 새로운 read-modify-write 수정 함수로 둡니다:
1. ByteListBitwiseOp(^, xBytes, yBytes)를 반환합니다.
? AtomicReadModifyWrite(ta, index, value, xor)를 반환합니다.

25.4.18 Atomics [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Atomics"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

25.5 JSON 객체

JSON 객체는:

%JSON%입니다.
전역 객체의 "JSON" 프로퍼티의 초기 값입니다.
일반 객체입니다.
JSON 텍스트를 파싱하고 구성하는 데 사용하는 두 함수 parse와 stringify를 포함합니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
[[Construct]] 내부 메서드를 갖지 않으므로 new 연산자와 함께 생성자로 사용할 수 없습니다.
[[Call]] 내부 메서드를 갖지 않으므로 함수로 호출할 수 없습니다.

JSON 데이터 교환 형식은 ECMA-404에 정의되어 있습니다. 이 명세에서 사용하는 JSON 교환 형식은 ECMA-404에 설명된 것과 정확히 같습니다. JSON.parse 및 JSON.stringify의 적합한 구현체는 형식에서 삭제하거나 확장하지 않고 ECMA-404에 설명된 정확한 교환 형식을 지원해야 합니다.

25.5.1 JSON.isRawJSON ( `obj` )

이 함수는 호출되면 다음 단계를 수행합니다:

obj가 Object이고 obj에 [[IsRawJSON]] 내부 슬롯이 있으면 true를 반환합니다.
false를 반환합니다.

25.5.2 JSON.parse ( `text` [ , `reviver` ] )

이 함수는 JSON 텍스트(JSON 형식의 String)를 파싱하고 ECMAScript language value를 생성합니다. JSON 형식은 ECMAScript 리터럴, Array Initializer, Object Initializer의 구문과 유사한 구문으로 리터럴, 배열, 객체를 나타냅니다. 파싱 후 JSON 객체는 ECMAScript 객체로 실체화됩니다. JSON 배열은 ECMAScript Array 인스턴스로 실체화됩니다. JSON 문자열, 숫자, 불리언, null은 ECMAScript String, Number, Boolean, null로 실체화됩니다.

선택적 reviver 매개변수는 결과를 필터링하고 변환할 수 있는 함수입니다. 파싱으로 생성된 각 값에 대해 reviver는 세 인수(연결된 프로퍼티 키, 값, 컨텍스트 객체)로 호출됩니다. 프로퍼티가 수정되지 않았고 값이 프리미티브이면 제공된 컨텍스트 객체에는 대응하는 Parse Node의 소스 텍스트를 포함하는 "source" 프로퍼티가 있습니다. 호출이 undefined를 반환하면 프로퍼티를 삭제합니다. 그렇지 않으면 반환 값을 사용하도록 프로퍼티를 다시 정의합니다.

jsonString을 ? ToString(text)로 둡니다.
parseResult를 ? ParseJSON(jsonString)으로 둡니다.
unfiltered를 parseResult.[[Value]]로 둡니다.
IsCallable(reviver)가 false이면 unfiltered를 반환합니다.
root를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
rootName을 빈 String으로 둡니다.
! CreateDataPropertyOrThrow(root, rootName, unfiltered)를 수행합니다.
snapshot을 CreateJSONParseRecord(parseResult.[[ParseNode]], rootName, unfiltered)로 둡니다.
? InternalizeJSONProperty(root, rootName, reviver, snapshot)을 반환합니다.

이 함수의 "length" 프로퍼티는 2_𝔽입니다.

25.5.2.1 ParseJSON ( `text` )

추상 연산 ParseJSON. 인수 text (String). 반환값: (정상 완료 (값: 레코드 (필드: [[ParseNode]] (구문 분석 노드), [[Value]] (ECMAScript 언어 값))) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

StringToCodePoints(text)가 ECMA-404에 지정된 유효한 JSON 텍스트가 아니면 SyntaxError 예외를 던집니다.
scriptString을 "(", text, ");"의 문자열 연결로 둡니다.
script를 ParseText(scriptString, Script)로 둡니다.
참고: 13.2.5.1에 정의된 early error 규칙은 위 ParseText 호출에 대해 특별하게 처리됩니다.
단언: script는 Parse Node입니다.
result를 ! Evaluation of script로 둡니다.
참고: 13.2.5.6에 정의된 PropertyDefinitionEvaluation 의미론은 위 평가에 대해 특별하게 처리됩니다.
단언: result는 String, Number, Boolean, ArrayLiteral 또는 ObjectLiteral 중 하나에 의해 정의된 Object, 또는 null입니다.
Record { [[ParseNode]]: script, [[Value]]: result }를 반환합니다.

적합한 JSON.parse 구현체가 JSON 문법을 확장하는 것은 허용되지 않습니다. 구현체가 수정되거나 확장된 JSON 교환 형식을 지원하려면 다른 parse 함수를 정의하여 수행해야 합니다.

참고 1

유효한 JSON 텍스트는 ECMAScript PrimaryExpression 구문의 부분집합입니다. 1 단계는 jsonString이 해당 부분집합을 준수하는지 검증하고, 8 단계는 평가가 적절한 타입의 값을 반환하는지 단언합니다.

그러나 13.2.5.6이 ParseJSON 중에는 다르게 동작하므로 동일한 소스 텍스트를 JSON이 아니라 PrimaryExpression으로 평가하면 다른 결과가 생성될 수 있습니다. 또한 객체 리터럴의 중복 "__proto__" 프로퍼티에 대한 Early Error 역시 ParseJSON 중에는 적용되지 않으므로, 문법과 일치하더라도 ParseJSON이 허용하는 모든 텍스트가 PrimaryExpression으로 유효한 것은 아닙니다.

참고 2

객체 안에 중복된 이름의 String이 있는 경우 어휘적으로 앞선 동일 키의 값은 덮어써야 합니다.

25.5.2.2 JSON Parse Record

JSON Parse Record는 JSON 텍스트에서 파싱된 값의 초기 상태를 설명하는 데 사용되는 Record입니다.

JSON Parse Records에는 표 76에 나열된 필드가 있습니다.

표 76: JSON Parse Record 필드

필드 이름	값	의미
`[[ParseNode]]`	a Parse Node	컨텍스트 Parse Node입니다.
`[[Key]]`	a property name	`[[Value]]`와 연결된 프로퍼티 이름입니다.
`[[Value]]`	an ECMAScript language value	`[[ParseNode]]` 평가로 생성된 값입니다.
`[[Elements]]`	a List of JSON Parse Records	`[[Value]]`가 Array이면 `[[Value]]`의 요소에 대응하는 JSON Parse Records를 포함합니다. 그렇지 않으면 빈 List입니다.
`[[Entries]]`	a List of JSON Parse Records	`[[Value]]`가 Array가 아닌 Object이면 `[[Value]]`의 항목에 대응하는 JSON Parse Records를 포함합니다. 그렇지 않으면 빈 List입니다.

25.5.2.3 CreateJSONParseRecord ( `parseNode`, `key`, `value` )

추상 연산 CreateJSONParseRecord. 인수 parseNode (구문 분석 노드), key (프로퍼티 이름) 및 value (ECMAScript 언어 값). 반환값: JSON Parse 레코드. JSON 텍스트에서 파싱한 parseNode와 그 평가로 생성된 value를 재귀적으로 결합합니다. 호출되면 다음 단계를 수행한다.

typedValueNode를 ShallowestContainedJSONValue(parseNode)로 둡니다.
단언: typedValueNode는 empty가 아닙니다.
elements를 새로운 빈 List로 둡니다.
entries를 새로운 빈 List로 둡니다.
value가 Object이면, 다음을 수행합니다.
1. isArray를 ! IsArray(value)로 둡니다.
2. isArray가 true이면, 다음을 수행합니다.
  1. 단언: typedValueNode는 ArrayLiteral Parse Node입니다.
  2. contentNodes를 typedValueNode의 JSONArrayLiteralContentNodes로 둡니다.
  3. length를 contentNodes의 요소 수로 둡니다.
  4. valueLength를 ! LengthOfArrayLike(value)로 둡니다.
  5. 단언: valueLength는 length입니다.
  6. index를 0으로 둡니다.
  7. index < length인 동안 다음을 반복합니다.
    1. propertyName을 ! ToString(𝔽(index))로 둡니다.
    2. elementParseRecord를 CreateJSONParseRecord(contentNodes[index], propertyName, ! Get(value, propertyName))로 둡니다.
    3. elementParseRecord를 elements에 추가합니다.
    4. index를 index + 1로 설정합니다.
3. 그렇지 않으면,
  1. 단언: typedValueNode는 ObjectLiteral Parse Node입니다.
  2. propertyNodes를 typedValueNode의 PropertyDefinitionNodes로 둡니다.
  3. 참고: value는 JSON 텍스트에서 생성되었고 수정되지 않았으므로 모든 프로퍼티 키는 String이며 빠짐없이 열거됩니다.
  4. keys를 ! EnumerableOwnProperties(value, key)로 둡니다.
  5. keys의 각 String propertyKey에 대해 다음을 수행합니다.
    1. 참고: JSON 텍스트가 단일 객체에 같은 이름을 갖는 여러 이름/값 쌍을 지정하는 경우(예: {"a":"lost","a":"kept"}) 결과 ECMAScript 객체의 대응하는 프로퍼티 값은 해당 이름을 갖는 마지막 쌍으로 지정됩니다.
    2. propertyDefinition을 empty로 둡니다.
    3. propertyNodes의 각 Parse Node propertyNode에 대해 다음을 수행합니다.
      1. propertyName을 propertyNode의 PropName으로 둡니다.
      2. propertyName이 propertyKey이면 propertyDefinition을 propertyNode로 설정합니다.
    4. 단언: propertyDefinition은 PropertyDefinition : PropertyName : AssignmentExpression 입니다.
    5. propertyValueNode를 propertyDefinition의 AssignmentExpression로 둡니다.
    6. entryParseRecord를 CreateJSONParseRecord(propertyValueNode, propertyKey, ! Get(value, propertyKey))로 둡니다.
    7. entryParseRecord를 entries에 추가합니다.
그렇지 않으면,
1. 단언: typedValueNode는 ArrayLiteral Parse Node도 ObjectLiteral Parse Node도 아닙니다.
JSON Parse Record { [[ParseNode]]: typedValueNode, [[Key]]: key, [[Value]]: value, [[Elements]]: elements, [[Entries]]: entries }를 반환합니다.

25.5.2.4 InternalizeJSONProperty ( `holder`, `name`, `reviver`, `parseRecord` )

추상 연산 InternalizeJSONProperty. 인수 holder (Object), name (String), reviver (함수 객체) 및 parseRecord ((JSON Parse 레코드 또는 empty)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료).

참고

이 알고리즘은 [[Delete]] 또는 CreateDataProperty가 false를 반환하더라도 의도적으로 예외를 던지지 않습니다.

호출되면 다음 단계를 수행합니다:

value를 ? Get(holder, name)로 둡니다.
context를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
parseRecord가 JSON Parse Record이고 SameValue(parseRecord.[[Value]], value)가 true이면, 다음을 수행합니다.
1. value가 Object가 아니면, 다음을 수행합니다.
  1. parseNode를 parseRecord.[[ParseNode]]로 둡니다.
  2. 단언: parseNode는 ArrayLiteral Parse Node도 ObjectLiteral Parse Node도 아닙니다.
  3. sourceText를 parseNode가 일치한 소스 텍스트로 둡니다.
  4. ! CreateDataPropertyOrThrow(context, "source", CodePointsToString(sourceText))를 수행합니다.
2. elementRecords를 parseRecord.[[Elements]]로 둡니다.
3. entryRecords를 parseRecord.[[Entries]]로 둡니다.
그렇지 않으면,
1. elementRecords를 새로운 빈 List로 둡니다.
2. entryRecords를 새로운 빈 List로 둡니다.
value가 Object이면, 다음을 수행합니다.
1. isArray를 ? IsArray(value)로 둡니다.
2. isArray가 true이면, 다음을 수행합니다.
  1. elementRecordsLength를 elementRecords의 요소 수로 둡니다.
  2. length를 ? LengthOfArrayLike(value)로 둡니다.
  3. index를 0으로 둡니다.
  4. index < length인 동안 다음을 반복합니다.
    1. propertyKey를 ! ToString(𝔽(index))로 둡니다.
    2. index < elementRecordsLength이면 elementRecord를 elementRecords[index]로 둡니다. 그렇지 않으면 elementRecord를 empty로 둡니다.
    3. newElement를 ? InternalizeJSONProperty(value, propertyKey, reviver, elementRecord)로 둡니다.
    4. newElement가 undefined이면, 다음을 수행합니다.
      1. ? value.[[Delete]](propertyKey)를 수행합니다.
    5. 그렇지 않으면,
      1. ? CreateDataProperty(value, propertyKey, newElement)를 수행합니다.
    6. index를 index + 1로 설정합니다.
3. 그렇지 않으면,
  1. keys를 ? EnumerableOwnProperties(value, key)로 둡니다.
  2. keys의 각 String propertyKey에 대해 다음을 수행합니다.
    1. entryRecords에 [[Key]]가 propertyKey인 요소 entry가 존재하면 entryRecord를 entry로 둡니다. 그렇지 않으면 entryRecord를 empty로 둡니다.
    2. newElement를 ? InternalizeJSONProperty(value, propertyKey, reviver, entryRecord)로 둡니다.
    3. newElement가 undefined이면, 다음을 수행합니다.
      1. ? value.[[Delete]](propertyKey)를 수행합니다.
    4. 그렇지 않으면,
      1. ? CreateDataProperty(value, propertyKey, newElement)를 수행합니다.
? Call(reviver, holder, « name, value, context »)를 반환합니다.

25.5.2.5 Static Semantics: ShallowestContainedJSONValue ( `root` )

추상 연산 ShallowestContainedJSONValue. 인수 root (구문 분석 노드). 반환값: (구문 분석 노드 또는 empty). root를 루트로 하는 파스 트리에 대해 너비 우선 탐색을 수행하고 JSON 값에 대응하는 비단말의 인스턴스인 첫 번째 노드를 반환하며, 그러한 노드가 없으면 empty를 반환합니다. 호출되면 다음 단계를 수행한다.

activeFunc를 활성 함수 객체로 둡니다.
단언: activeFunc는 JSON.parse 내장 함수 객체입니다(JSON.parse 참조).
types를 « NullLiteral, BooleanLiteral, NumericLiteral, StringLiteral, ArrayLiteral, ObjectLiteral, UnaryExpression »로 둡니다.
unaryExpr를 empty로 둡니다.
queue를 « root »로 둡니다.
queue가 비어 있지 않은 동안 다음을 반복합니다.
1. candidate를 queue의 첫 번째 요소로 둡니다.
2. queue에서 첫 번째 요소를 제거합니다.
3. queuedChildren을 false로 둡니다.
4. types의 각 비단말 type에 대해 다음을 수행합니다.
  1. candidate가 type의 인스턴스이면, 다음을 수행합니다.
    1. 참고: JSON 문법에서 number 토큰은 음수 값을 나타낼 수 있습니다. ECMAScript에서 부정은 UnaryExpression이 - 뒤에 파생된 UnaryExpression이 오는 형태로 파싱되는 단항 연산으로 표현됩니다.
    2. type이 UnaryExpression이면, 다음을 수행합니다.
      1. candidate의 부모가 UnaryExpression Parse Node가 아니면 unaryExpr를 candidate로 설정합니다.
    3. 그렇지 않고 type이 NumericLiteral이면, 다음을 수행합니다.
      1. 단언: candidate는 unaryExpr 안에 포함되어 있습니다.
      2. unaryExpr를 반환합니다.
    4. 그렇지 않으면,
      1. candidate를 반환합니다.
  2. queuedChildren이 false이고 candidate가 비단말의 인스턴스이며 candidate Contains type이 true이면, 다음을 수행합니다.
    1. children을 candidate의 각 자식 노드를 순서대로 포함하는 List로 둡니다.
    2. queue를 queue와 children의 목록 연결로 설정합니다.
    3. queuedChildren을 true로 설정합니다.
empty를 반환합니다.

25.5.2.6 Static Semantics: JSONArrayLiteralContentNodes

구문 지향 연산 JSONArrayLiteralContentNodes. 인수 없음. 반환값: 리스트 (요소: 구문 분석 노드). 다음 생성 규칙별로 정의된다.

ArrayLiteral

[

Elision

opt

]

[

ElementList

]

[

ElementList

Elision

opt

]

단언: Elision은 존재하지 않습니다.
ElementList가 존재하지 않으면 새로운 빈 List를 반환합니다.
ElementList의 JSONArrayLiteralContentNodes를 반환합니다.

ElementList

Elision

opt

AssignmentExpression

단언: Elision은 존재하지 않습니다.
« AssignmentExpression »을 반환합니다.

ElementList

Elision

opt

AssignmentExpression

단언: Elision은 존재하지 않습니다.
elements를 파생된 ElementList의 JSONArrayLiteralContentNodes로 둡니다.
elements와 « AssignmentExpression »의 목록 연결을 반환합니다.

opt

opt

참고: ECMA-404에 지정된 JSON 텍스트에는 SpreadElement가 포함되지 않습니다.
단언: 이 단계에는 절대 도달하지 않습니다.

25.5.3 JSON.rawJSON ( `text` )

이 함수는 문자열, 숫자, 불리언 또는 null 값의 원시 JSON 텍스트를 나타내는 객체를 반환합니다.

jsonString을 ? ToString(text)로 둡니다.
jsonString이 빈 String이면 SyntaxError 예외를 던집니다.
jsonString의 첫 번째 코드 단위가 ASCII 소문자 코드 단위(0x0061부터 0x007A까지 포함), ASCII 숫자 코드 단위(0x0030부터 0x0039까지 포함), 0x0022 (QUOTATION MARK), 0x002D (HYPHEN-MINUS) 중 하나가 아니면 SyntaxError 예외를 던집니다.
jsonString의 마지막 코드 단위가 ASCII 소문자 코드 단위(0x0061부터 0x007A까지 포함), ASCII 숫자 코드 단위(0x0030부터 0x0039까지 포함), 0x0022 (QUOTATION MARK) 중 하나가 아니면 SyntaxError 예외를 던집니다.
parseResult를 ? ParseJSON(jsonString)으로 둡니다.
단언: parseResult.[[Value]]는 String, Number, Boolean 또는 null입니다.
internalSlotsList를 « [[IsRawJSON]] »로 둡니다.
obj를 OrdinaryObjectCreate(null, internalSlotsList)로 둡니다.
! CreateDataPropertyOrThrow(obj, "rawJSON", jsonString)을 수행합니다.
! SetIntegrityLevel(obj, frozen)을 수행합니다.
obj를 반환합니다.

25.5.4 JSON.stringify ( `value` [ , `replacer` [ , `space` ] ] )

이 함수는 ECMAScript language value를 나타내는 UTF-16 인코딩 JSON 형식의 String 또는 undefined를 반환합니다. 세 매개변수를 받을 수 있습니다. value 매개변수는 ECMAScript language value이며 일반적으로 객체 또는 배열이지만 String, Boolean, Number 또는 null일 수도 있습니다. 선택적 replacer 매개변수는 객체와 배열을 문자열화하는 방식을 변경하는 함수이거나, 문자열화할 객체 프로퍼티를 선택하기 위한 포함 목록 역할을 하는 String 및 Number의 배열입니다. 선택적 space 매개변수는 사람이 읽기 쉽도록 결과에 공백을 삽입할 수 있게 하는 String 또는 Number입니다.

호출되면 다음 단계를 수행합니다:

stack을 새로운 빈 List로 둡니다.
indent를 빈 String으로 둡니다.
propertyList를 undefined로 둡니다.
replacerFunc를 undefined로 둡니다.
replacer가 Object이면, 다음을 수행합니다.
1. IsCallable(replacer)가 true이면, 다음을 수행합니다.
  1. replacerFunc를 replacer로 설정합니다.
2. 그렇지 않으면,
  1. isArray를 ? IsArray(replacer)로 둡니다.
  2. isArray가 true이면, 다음을 수행합니다.
    1. propertyList를 새로운 빈 List로 설정합니다.
    2. length를 ? LengthOfArrayLike(replacer)로 둡니다.
    3. k를 0으로 둡니다.
    4. k < length인 동안 다음을 반복합니다.
      1. propertyKey를 ! ToString(𝔽(k))로 둡니다.
      2. propertyValue를 ? Get(replacer, propertyKey)로 둡니다.
      3. item을 undefined로 둡니다.
      4. propertyValue가 String이면, 다음을 수행합니다.
        item을 propertyValue로 설정합니다.
      5. 그렇지 않고 propertyValue가 Number이면, 다음을 수행합니다.
        item을 ! ToString(propertyValue)로 설정합니다.
      6. 그렇지 않고 propertyValue가 Object이면, 다음을 수행합니다.
        propertyValue에 [[StringData]] 또는 [[NumberData]] 내부 슬롯이 있으면 item을 ? ToString(propertyValue)로 설정합니다.
      7. item이 undefined가 아니고 propertyList에 item이 포함되어 있지 않으면, 다음을 수행합니다.
        item을 propertyList에 추가합니다.
      8. k를 k + 1로 설정합니다.
space가 Object이면, 다음을 수행합니다.
1. space에 [[NumberData]] 내부 슬롯이 있으면, 다음을 수행합니다.
  1. space를 ? ToNumber(space)로 설정합니다.
2. 그렇지 않고 space에 [[StringData]] 내부 슬롯이 있으면, 다음을 수행합니다.
  1. space를 ? ToString(space)로 설정합니다.
space가 Number이면, 다음을 수행합니다.
1. spaceMV를 ! ToIntegerOrInfinity(space)로 둡니다.
2. spaceMV를 min(10, spaceMV)로 설정합니다.
3. spaceMV < 1이면 gap을 빈 String으로 둡니다. 그렇지 않으면 gap을 코드 단위 0x0020 (SPACE)이 spaceMV번 나타나는 String 값으로 둡니다.
그렇지 않고 space가 String이면, 다음을 수행합니다.
1. space의 길이가 10 이하이면 gap을 space로 둡니다. 그렇지 않으면 gap을 space의 0부터 10까지의 부분 문자열로 둡니다.
그렇지 않으면,
1. gap을 빈 String으로 둡니다.
wrapper를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
! CreateDataPropertyOrThrow(wrapper, 빈 String, value)을 수행합니다.
state를 JSON Serialization Record { [[ReplacerFunction]]: replacerFunc, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: propertyList }로 둡니다.
? SerializeJSONProperty(state, 빈 String, wrapper)을 반환합니다.

이 함수의 "length" 프로퍼티는 3_𝔽입니다.

참고 1

JSON 구조는 임의의 깊이로 중첩될 수 있지만 순환해서는 안 됩니다. value가 순환 구조이거나 순환 구조를 포함하면 이 함수는 TypeError 예외를 던져야 합니다. 다음은 문자열화할 수 없는 값의 예입니다:

a = [];
a[0] = a;
my_text = JSON.stringify(a); // 이는 TypeError를 던져야 합니다.

참고 2

기호적 프리미티브 값은 다음과 같이 렌더링됩니다:

null 값은 JSON 텍스트에서 String 값 "null"로 렌더링됩니다.
undefined 값은 렌더링되지 않습니다.
true 값은 JSON 텍스트에서 String 값 "true"로 렌더링됩니다.
false 값은 JSON 텍스트에서 String 값 "false"로 렌더링됩니다.

참고 3

String 값은 QUOTATION MARK (") 코드 단위로 감쌉니다. 코드 단위 " 및 \는 \ 접두사를 사용하여 이스케이프합니다. 제어 문자 코드 단위는 이스케이프 시퀀스 \uHHHH 또는 더 짧은 형식인 \b (BACKSPACE), \f (FORM FEED), \n (LINE FEED), \r (CARRIAGE RETURN), \t (CHARACTER TABULATION)로 대체합니다.

참고 4

각 유한 Number는 ToString(number)을 호출한 것처럼 문자열로 변환됩니다. NaN, +∞_𝔽, -∞_𝔽는 String 값 "null"로 나타냅니다.

참고 5

JSON 표현이 없는 값(예: undefined 및 함수)은 String을 생성하지 않습니다. 대신 undefined 값을 생성합니다. 배열에서 이러한 값은 String 값 "null"로 나타냅니다. 객체에서 표현할 수 없는 값은 해당 프로퍼티가 문자열화에서 제외되도록 합니다.

참고 6

객체는 U+007B (LEFT CURLY BRACKET) 뒤에 0개 이상의 프로퍼티를 U+002C (COMMA)로 구분하여 배치하고 U+007D (RIGHT CURLY BRACKET)로 닫아 렌더링합니다. 프로퍼티는 프로퍼티 이름을 나타내는 따옴표로 감싼 String, U+003A (COLON), 문자열화된 프로퍼티 값으로 구성됩니다. 배열은 여는 U+005B (LEFT SQUARE BRACKET) 뒤에 0개 이상의 값을 U+002C (COMMA)로 구분하여 배치하고 U+005D (RIGHT SQUARE BRACKET)로 닫아 렌더링합니다.

25.5.4.1 JSON Serialization Record

JSON Serialization Record는 JSON 형식으로 직렬화할 수 있도록 하는 데 사용되는 Record입니다.

JSON Serialization Records에는 표 77에 나열된 필드가 있습니다.

표 77: JSON Serialization Record 필드

필드 이름	값	의미
`[[ReplacerFunction]]`	a function object or undefined	객체 프로퍼티에 대한 대체 값을 제공할 수 있는 함수입니다(JSON.stringify의 `replacer` 매개변수에서 가져옵니다).
`[[PropertyList]]`	either a List of Strings or undefined	배열이 아닌 객체를 직렬화할 때 포함할 프로퍼티 이름입니다(JSON.stringify의 `replacer` 매개변수에서 가져옵니다).
`[[Gap]]`	a String	들여쓰기 단위입니다(JSON.stringify의 `space` 매개변수에서 가져옵니다).
`[[Stack]]`	a List of Objects	직렬화 중인 중첩 객체의 집합입니다. 순환 구조를 감지하는 데 사용합니다.
`[[Indent]]`	a String	현재 들여쓰기입니다.

25.5.4.2 SerializeJSONProperty ( `state`, `key`, `holder` )

추상 연산 SerializeJSONProperty. 인수 state (JSON Serialization 레코드), key (String) 및 holder (Object). 반환값: (정상 완료 (값: (String 또는 undefined)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

value를 ? Get(holder, key)로 둡니다.
value가 Object 또는 BigInt이면 다음을 수행합니다.
1. toJSON을 ? GetV(value, "toJSON")으로 둡니다.
2. IsCallable(toJSON)이 true이면 다음을 수행합니다.
  1. value를 ? Call(toJSON, value, « key »)로 설정합니다.
state.[[ReplacerFunction]]이 undefined가 아니면 다음을 수행합니다.
1. value를 ? Call(state.[[ReplacerFunction]], holder, « key, value »)로 설정합니다.
value가 Object이면 다음을 수행합니다.
1. value에 [[IsRawJSON]] 내부 슬롯이 있으면 다음을 수행합니다.
  1. rawJSON을 ! Get(value, "rawJSON")으로 둡니다.
  2. 단언: rawJSON은 String입니다.
  3. rawJSON을 반환합니다.
2. value에 [[NumberData]] 내부 슬롯이 있으면 다음을 수행합니다.
  1. value를 ? ToNumber(value)로 설정합니다.
3. 그렇지 않고 value에 [[StringData]] 내부 슬롯이 있으면 다음을 수행합니다.
  1. value를 ? ToString(value)으로 설정합니다.
4. 그렇지 않고 value에 [[BooleanData]] 내부 슬롯이 있으면 다음을 수행합니다.
  1. value를 value.[[BooleanData]]로 설정합니다.
5. 그렇지 않고 value에 [[BigIntData]] 내부 슬롯이 있으면 다음을 수행합니다.
  1. value를 value.[[BigIntData]]로 설정합니다.
value가 null이면 "null"을 반환합니다.
value가 true이면 "true"를 반환합니다.
value가 false이면 "false"를 반환합니다.
value가 String이면 QuoteJSONString(value)을 반환합니다.
value가 Number이면 다음을 수행합니다.
1. value가 유한 Number이면 ! ToString(value)을 반환합니다.
2. "null"을 반환합니다.
value가 BigInt이면 TypeError 예외를 던집니다.
value가 Object이고 IsCallable(value)이 false이면 다음을 수행합니다.
1. isArray를 ? IsArray(value)로 둡니다.
2. isArray가 true이면 다음을 수행합니다.
  1. ? SerializeJSONArray(state, value)을 반환합니다.
3. ? SerializeJSONObject(state, value)을 반환합니다.
undefined를 반환합니다.

25.5.4.3 QuoteJSONString ( `value` )

추상 연산 QuoteJSONString. 인수 value (String). 반환값: String. value를 0x0022 (QUOTATION MARK) 코드 단위로 감싸고 그 안의 특정 다른 코드 단위를 이스케이프합니다. 이 연산은 6.1.4에 설명된 대로 value를 UTF-16으로 인코딩된 코드 포인트 시퀀스로 해석합니다. 호출되면 다음 단계를 수행한다.

product를 코드 단위 0x0022 (QUOTATION MARK) 하나로만 구성된 String 값으로 둡니다.
StringToCodePoints(value)의 각 코드 포인트 codePoint에 대해 다음을 수행합니다.
1. codePoint가 표 78의 “Code Point” 열에 나열되어 있으면, 다음을 수행합니다.
  1. product를 product와 대응하는 행의 “Escape Sequence” 열에 지정된 codePoint의 이스케이프 시퀀스의 문자열 연결로 설정합니다.
2. 그렇지 않고 codePoint의 숫자 값이 0x0020 (SPACE)보다 작거나 codePoint가 leading surrogate 또는 trailing surrogate와 동일한 숫자 값을 가지면, 다음을 수행합니다.
  1. unit을 숫자 값이 codePoint의 숫자 값인 코드 단위로 둡니다.
  2. product를 product와 UnicodeEscape(unit)의 문자열 연결로 설정합니다.
3. 그렇지 않으면,
  1. product를 product와 UTF16EncodeCodePoint(codePoint)의 문자열 연결로 설정합니다.
product를 product와 코드 단위 0x0022 (QUOTATION MARK)의 문자열 연결로 설정합니다.
product를 반환합니다.

표 78: JSON 단일 문자 이스케이프 시퀀스

코드 포인트	유니코드 문자 이름	이스케이프 시퀀스
U+0008	BACKSPACE	`\b`
U+0009	CHARACTER TABULATION	`\t`
U+000A	LINE FEED (LF)	`\n`
U+000C	FORM FEED (FF)	`\f`
U+000D	CARRIAGE RETURN (CR)	`\r`
U+0022	QUOTATION MARK	`\"`
U+005C	REVERSE SOLIDUS	`\\`

25.5.4.4 UnicodeEscape ( `codeUnit` )

추상 연산 UnicodeEscape. 인수 codeUnit (코드 단위). 반환값: String. codeUnit을 유니코드 이스케이프 시퀀스로 나타냅니다. 호출되면 다음 단계를 수행한다.

n을 codeUnit의 숫자 값으로 둡니다.
단언: n ≤ 0xFFFF입니다.
hex를 n을 소문자 16진수로 형식화한 String 표현으로 둡니다.
코드 단위 0x005C (REVERSE SOLIDUS), "u", StringPad(hex, 4, "0", start)의 문자열 연결을 반환합니다.

25.5.4.5 SerializeJSONObject ( `state`, `value` )

추상 연산 SerializeJSONObject. 인수 state (JSON Serialization 레코드) 및 value (Object). 반환값: (정상 완료 (값: String) 또는 throw 완료). 객체를 직렬화합니다. 호출되면 다음 단계를 수행한다.

state.[[Stack]]에 value가 포함되어 있으면 구조가 순환하므로 TypeError 예외를 던집니다.
value를 state.[[Stack]]에 추가합니다.
stepBack을 state.[[Indent]]로 둡니다.
state.[[Indent]]를 state.[[Indent]]와 state.[[Gap]]의 문자열 연결로 설정합니다.
state.[[PropertyList]]가 undefined가 아니면, 다음을 수행합니다.
1. keys를 state.[[PropertyList]]로 둡니다.
그렇지 않으면,
1. keys를 ? EnumerableOwnProperties(value, key)로 둡니다.
partial을 새로운 빈 List로 둡니다.
keys의 각 요소 propertyKey에 대해 다음을 수행합니다.
1. stringP를 ? SerializeJSONProperty(state, propertyKey, value)로 둡니다.
2. stringP가 undefined가 아니면, 다음을 수행합니다.
  1. member를 QuoteJSONString(propertyKey)로 둡니다.
  2. member를 member와 ":"의 문자열 연결로 설정합니다.
  3. state.[[Gap]]이 빈 String이 아니면, 다음을 수행합니다.
    1. member를 member와 코드 단위 0x0020 (SPACE)의 문자열 연결로 설정합니다.
  4. member를 member와 stringP의 문자열 연결로 설정합니다.
  5. member를 partial에 추가합니다.
partial이 비어 있으면, 다음을 수행합니다.
1. final을 "{}"로 둡니다.
그렇지 않으면,
1. state.[[Gap]]이 빈 String이면, 다음을 수행합니다.
  1. properties를 partial의 모든 요소 String을 연결하되 인접한 각 String 쌍 사이를 코드 단위 0x002C (COMMA)로 구분하여 만든 String 값으로 둡니다. 첫 번째 String 앞이나 마지막 String 뒤에는 쉼표를 삽입하지 않습니다.
  2. final을 "{", properties, "}"의 문자열 연결로 둡니다.
2. 그렇지 않으면,
  1. separator를 코드 단위 0x002C (COMMA), 코드 단위 0x000A (LINE FEED), state.[[Indent]]의 문자열 연결로 둡니다.
  2. properties를 partial의 모든 요소 String을 연결하되 인접한 각 String 쌍 사이를 separator로 구분하여 만든 String 값으로 둡니다. separator String은 첫 번째 String 앞이나 마지막 String 뒤에 삽입하지 않습니다.
  3. final을 "{", 코드 단위 0x000A (LINE FEED), state.[[Indent]], properties, 코드 단위 0x000A (LINE FEED), stepBack, "}"의 문자열 연결로 둡니다.
state.[[Stack]]의 마지막 요소를 제거합니다.
state.[[Indent]]를 stepBack으로 설정합니다.
final을 반환합니다.

25.5.4.6 SerializeJSONArray ( `state`, `value` )

추상 연산 SerializeJSONArray. 인수 state (JSON Serialization 레코드) 및 value (Object). 반환값: (정상 완료 (값: String) 또는 throw 완료). 배열을 직렬화합니다. 호출되면 다음 단계를 수행한다.

state.[[Stack]]에 value가 포함되어 있으면 구조가 순환하므로 TypeError 예외를 던집니다.
value를 state.[[Stack]]에 추가합니다.
stepBack을 state.[[Indent]]로 둡니다.
state.[[Indent]]를 state.[[Indent]]와 state.[[Gap]]의 문자열 연결로 설정합니다.
partial을 새로운 빈 List로 둡니다.
length를 ? LengthOfArrayLike(value)로 둡니다.
index를 0으로 둡니다.
index < length인 동안 다음을 반복합니다.
1. stringP를 ? SerializeJSONProperty(state, ! ToString(𝔽(index)), value)로 둡니다.
2. stringP가 undefined이면, 다음을 수행합니다.
  1. "null"을 partial에 추가합니다.
3. 그렇지 않으면,
  1. stringP를 partial에 추가합니다.
4. index를 index + 1로 설정합니다.
partial이 비어 있으면, 다음을 수행합니다.
1. final을 "[]"로 둡니다.
그렇지 않으면,
1. state.[[Gap]]이 빈 String이면, 다음을 수행합니다.
  1. properties를 partial의 모든 요소 String을 연결하되 인접한 각 String 쌍 사이를 코드 단위 0x002C (COMMA)로 구분하여 만든 String 값으로 둡니다. 첫 번째 String 앞이나 마지막 String 뒤에는 쉼표를 삽입하지 않습니다.
  2. final을 "[", properties, "]"의 문자열 연결로 둡니다.
2. 그렇지 않으면,
  1. separator를 코드 단위 0x002C (COMMA), 코드 단위 0x000A (LINE FEED), state.[[Indent]]의 문자열 연결로 둡니다.
  2. properties를 partial의 모든 요소 String을 연결하되 인접한 각 String 쌍 사이를 separator로 구분하여 만든 String 값으로 둡니다. separator String은 첫 번째 String 앞이나 마지막 String 뒤에 삽입하지 않습니다.
  3. final을 "[", 코드 단위 0x000A (LINE FEED), state.[[Indent]], properties, 코드 단위 0x000A (LINE FEED), stepBack, "]"의 문자열 연결로 둡니다.
state.[[Stack]]의 마지막 요소를 제거합니다.
state.[[Indent]]를 stepBack으로 설정합니다.
final을 반환합니다.

참고

배열 표현에는 +0_𝔽(포함)부터 array.length(제외)까지 구간의 요소만 포함됩니다. 키가 배열 인덱스가 아닌 프로퍼티는 문자열화에서 제외됩니다. 배열은 여는 LEFT SQUARE BRACKET, COMMA로 구분한 요소, 닫는 RIGHT SQUARE BRACKET으로 문자열화됩니다.

25.5.5 JSON [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "JSON"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

26 메모리 관리

26.1 WeakRef 객체

WeakRef는 대상 객체 또는 Symbol이 가비지 컬렉션되지 않도록 유지하지 않으면서 이를 참조하는 데 사용되는 객체입니다. 대상이 가비지 컬렉션에 의해 회수되지 않았다면 WeakRef를 역참조하여 대상 값에 접근할 수 있습니다.

26.1.1 WeakRef 생성자

WeakRef 생성자는:

%WeakRef%입니다.
전역 객체의 "WeakRef" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 WeakRef를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 WeakRef 동작을 상속하려는 하위 클래스 생성자는 WeakRef.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태로 하위 클래스 인스턴스를 생성하고 초기화하기 위해 WeakRef 생성자에 대한 super 호출을 포함해야 합니다.

26.1.1.1 WeakRef ( `target` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
CanBeHeldWeakly(target)이 false이면 TypeError 예외를 던집니다.
weakRef를 ? OrdinaryCreateFromConstructor(NewTarget, "%WeakRef.prototype%", « [[WeakRefTarget]] »)로 둡니다.
AddToKeptObjects(target)를 수행합니다.
weakRef.[[WeakRefTarget]]을 target으로 설정합니다.
weakRef를 반환합니다.

26.1.2 WeakRef 생성자의 프로퍼티

WeakRef 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

26.1.2.1 WeakRef.prototype

WeakRef.prototype의 초기 값은 WeakRef 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

26.1.3 WeakRef 프로토타입 객체의 프로퍼티

WeakRef 프로토타입 객체는:

%WeakRef.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[WeakRefTarget]] 내부 슬롯을 갖지 않습니다.

규정 선택 사항

26.1.3.1 WeakRef.prototype.constructor

WeakRef.prototype.constructor의 초기 값은 %WeakRef%입니다.

26.1.3.2 WeakRef.prototype.deref ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

weakRef를 this 값으로 둡니다.
? RequireInternalSlot(weakRef, [[WeakRefTarget]])을 수행합니다.
WeakRefDeref(weakRef)를 반환합니다.

참고

WeakRef가 undefined가 아닌 target 값을 반환하면 현재 ECMAScript 코드 실행이 완료될 때까지 이 target 값은 가비지 컬렉션되어서는 안 됩니다. AddToKeptObjects 연산은 읽기 일관성이 유지되도록 합니다.

let target = { foo() {} };
let weakRef = new WeakRef(target);

// ... 나중에 ...

if (weakRef.deref()) {
  weakRef.deref().foo();
}

위 예에서 첫 번째 deref가 undefined로 평가되지 않으면 두 번째 deref도 undefined로 평가될 수 없습니다.

26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "WeakRef"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

26.1.4 WeakRef 추상 연산

26.1.4.1 WeakRefDeref ( `weakRef` )

추상 연산 WeakRefDeref. 인수 weakRef (WeakRef). 반환값: ECMAScript 언어 값. 호출되면 다음 단계를 수행한다.

target을 weakRef.[[WeakRefTarget]]으로 둡니다.
target이 empty가 아니면, 다음을 수행합니다.
1. AddToKeptObjects(target)를 수행합니다.
2. target을 반환합니다.
undefined를 반환합니다.

참고

이 추상 연산은 생존성을 간결하게 정의할 수 있도록 하기 위해서만 WeakRef.prototype.deref와 별도로 정의됩니다.

26.1.5 WeakRef 인스턴스의 프로퍼티

WeakRef 인스턴스는 WeakRef 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. WeakRef 인스턴스는 [[WeakRefTarget]] 내부 슬롯도 갖습니다.

26.2 FinalizationRegistry 객체

FinalizationRegistry는 대상 객체와 Symbol이 가비지 컬렉션될 때 수행되는 정리 연산의 등록 및 등록 해제를 관리하는 객체입니다.

26.2.1 FinalizationRegistry 생성자

FinalizationRegistry 생성자는:

%FinalizationRegistry%입니다.
전역 객체의 "FinalizationRegistry" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 FinalizationRegistry를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 FinalizationRegistry 동작을 상속하려는 하위 클래스 생성자는 FinalizationRegistry.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태로 하위 클래스 인스턴스를 생성하고 초기화하기 위해 FinalizationRegistry 생성자에 대한 super 호출을 포함해야 합니다.

26.2.1.1 FinalizationRegistry ( `cleanupCallback` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
IsCallable(cleanupCallback)이 false이면 TypeError 예외를 던집니다.
finalizationRegistry를 ? OrdinaryCreateFromConstructor(NewTarget, "%FinalizationRegistry.prototype%", « [[Realm]], [[CleanupCallback]], [[Cells]] »)로 둡니다.
activeFunc를 활성 함수 객체로 둡니다.
finalizationRegistry.[[Realm]]을 activeFunc.[[Realm]]으로 설정합니다.
finalizationRegistry.[[CleanupCallback]]을 HostMakeJobCallback(cleanupCallback)으로 설정합니다.
finalizationRegistry.[[Cells]]를 새로운 빈 List로 설정합니다.
finalizationRegistry를 반환합니다.

26.2.2 FinalizationRegistry 생성자의 프로퍼티

FinalizationRegistry 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

26.2.2.1 FinalizationRegistry.prototype

FinalizationRegistry.prototype의 초기 값은 FinalizationRegistry 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

26.2.3 FinalizationRegistry 프로토타입 객체의 프로퍼티

FinalizationRegistry 프로토타입 객체는:

%FinalizationRegistry.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[Cells]] 및 [[CleanupCallback]] 내부 슬롯을 갖지 않습니다.

26.2.3.1 FinalizationRegistry.prototype.constructor

FinalizationRegistry.prototype.constructor의 초기 값은 %FinalizationRegistry%입니다.

26.2.3.2 FinalizationRegistry.prototype.register ( `target`, `heldValue` [ , `unregisterToken` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

finalizationRegistry를 this 값으로 둡니다.
? RequireInternalSlot(finalizationRegistry, [[Cells]])를 수행합니다.
CanBeHeldWeakly(target)이 false이면 TypeError 예외를 던집니다.
SameValue(target, heldValue)이 true이면 TypeError 예외를 던집니다.
CanBeHeldWeakly(unregisterToken)이 false이면, 다음을 수행합니다.
1. unregisterToken이 undefined가 아니면 TypeError 예외를 던집니다.
2. unregisterToken을 empty로 설정합니다.
cell을 Record { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken }로 둡니다.
cell을 finalizationRegistry.[[Cells]]에 추가합니다.
undefined를 반환합니다.

참고

이 명세의 알고리즘과 정의에 따르면 finalizationRegistry.[[Cells]]에 cell이 포함되어 있을 때 cell.[[HeldValue]]는 생존합니다. 그러나 이것이 반드시 cell.[[UnregisterToken]] 또는 cell.[[Target]]도 생존한다는 의미는 아닙니다. 예를 들어 객체 자체를 unregister token으로 사용하여 등록해도 그 객체가 영원히 생존하도록 유지되지는 않습니다.

26.2.3.3 FinalizationRegistry.prototype.unregister ( `unregisterToken` )

이 메서드는 호출되면 다음 단계를 수행합니다:

finalizationRegistry를 this 값으로 둡니다.
? RequireInternalSlot(finalizationRegistry, [[Cells]])를 수행합니다.
CanBeHeldWeakly(unregisterToken)이 false이면 TypeError 예외를 던집니다.
removed를 false로 둡니다.
finalizationRegistry.[[Cells]]의 각 Record { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cell에 대해 다음을 수행합니다.
1. cell.[[UnregisterToken]]이 empty가 아니고 SameValue(cell.[[UnregisterToken]], unregisterToken)이 true이면, 다음을 수행합니다.
  1. cell을 finalizationRegistry.[[Cells]]에서 제거합니다.
  2. removed를 true로 설정합니다.
removed를 반환합니다.

26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "FinalizationRegistry"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

26.2.4 FinalizationRegistry 인스턴스의 프로퍼티

FinalizationRegistry 인스턴스는 FinalizationRegistry 프로토타입 객체에서 프로퍼티를 상속하는 일반 객체입니다. FinalizationRegistry 인스턴스는 [[Cells]] 및 [[CleanupCallback]] 내부 슬롯도 갖습니다.

27 제어 추상화 객체

27.1 순회

27.1.1 공통 순회 인터페이스

인터페이스는 연결된 값이 특정 명세와 일치하는 프로퍼티 키의 집합입니다. 인터페이스의 명세에 설명된 모든 프로퍼티를 제공하는 객체는 해당 인터페이스를 준수합니다. 인터페이스는 별도의 객체로 표현되지 않습니다. 어떤 인터페이스든 이를 준수하는 여러 개별 구현 객체가 있을 수 있습니다. 하나의 객체가 여러 인터페이스를 준수할 수도 있습니다.

27.1.1.1 Iterable 인터페이스

iterable 인터페이스에는 표 79에 설명된 프로퍼티가 포함됩니다:

표 79: Iterable 인터페이스 필수 프로퍼티

프로퍼티	값	요구 사항
`%Symbol.iterator%`	a function that returns an iterator object	반환된 객체는 iterator 인터페이스를 준수해야 합니다.

27.1.1.2 Iterator 인터페이스

iterator 인터페이스를 구현하는 객체는 표 80의 프로퍼티를 포함해야 합니다. 이러한 객체는 표 81의 프로퍼티도 구현할 수 있습니다.

표 80: Iterator 인터페이스 필수 프로퍼티

프로퍼티	값	요구 사항
"next"	a function that returns an IteratorResult object	반환된 객체는 IteratorResult 인터페이스를 준수해야 합니다. iterator의 `next` 메서드에 대한 이전 호출이 "done" 프로퍼티가 true인 IteratorResult 객체를 반환했다면, 해당 객체의 `next` 메서드에 대한 이후의 모든 호출도 "done" 프로퍼티가 true인 IteratorResult 객체를 반환해야 합니다. 그러나 이 요구 사항은 강제되지 않습니다.

참고 1

next 함수에 인수를 전달할 수 있지만 그 해석과 유효성은 대상 iterator에 따라 달라집니다. for-of 문과 iterator의 다른 일반적인 사용자는 인수를 전달하지 않으므로 그러한 방식으로 사용될 것으로 예상되는 iterator 객체는 인수 없이 호출되는 경우를 처리할 준비가 되어 있어야 합니다.

표 81: Iterator 인터페이스 선택적 프로퍼티

프로퍼티	값	요구 사항
"return"	a function that returns an IteratorResult object	반환된 객체는 IteratorResult 인터페이스를 준수해야 합니다. 이 메서드를 호출하면 호출자가 해당 iterator에 대해 더 이상 `next` 메서드를 호출하지 않을 것임을 iterator 객체에 알립니다. 반환되는 IteratorResult 객체는 일반적으로 값이 true인 "done" 프로퍼티와 `return` 메서드의 인수로 전달된 값을 갖는 "value" 프로퍼티를 갖습니다. 그러나 이 요구 사항은 강제되지 않습니다.
"throw"	a function that returns an IteratorResult object	반환된 객체는 IteratorResult 인터페이스를 준수해야 합니다. 이 메서드를 호출하면 호출자가 오류 조건을 감지했음을 iterator 객체에 알립니다. 인수는 오류 조건을 식별하는 데 사용할 수 있으며 일반적으로 예외 객체입니다. 일반적인 응답은 인수로 전달된 값을 `throw`하는 것입니다. 메서드가 `throw`하지 않으면 반환된 IteratorResult 객체는 일반적으로 값이 true인 "done" 프로퍼티를 갖습니다.

참고 2

일반적으로 이러한 메서드의 호출자는 메서드를 호출하기 전에 존재 여부를 확인해야 합니다. for-of, yield*, 배열 구조 분해를 포함한 특정 ECMAScript 언어 기능은 존재 여부를 확인한 후 이러한 메서드를 호출합니다. iterable 객체를 인수로 받는 대부분의 ECMAScript 라이브러리 함수도 조건부로 이러한 메서드를 호출합니다.

27.1.1.3 Async Iterable 인터페이스

async iterable 인터페이스에는 표 82에 설명된 프로퍼티가 포함됩니다:

표 82: Async Iterable 인터페이스 필수 프로퍼티

프로퍼티	값	요구 사항
`%Symbol.asyncIterator%`	a function that returns an async iterator object	반환된 객체는 async iterator 인터페이스를 준수해야 합니다.

27.1.1.4 Async Iterator 인터페이스

async iterator 인터페이스를 구현하는 객체는 표 83의 프로퍼티를 포함해야 합니다. 이러한 객체는 표 84의 프로퍼티도 구현할 수 있습니다.

표 83: Async Iterator 인터페이스 필수 프로퍼티

프로퍼티 값 요구 사항

"next"

a function that returns a promise for an IteratorResult object

반환된 promise가 이행되면 IteratorResult 인터페이스를 준수하는 객체로 이행되어야 합니다. async iterator의 next 메서드에 대한 이전 호출이 "done" 프로퍼티가 true인 IteratorResult 객체의 promise를 반환했다면, 해당 객체의 next 메서드에 대한 이후의 모든 호출도 "done" 프로퍼티가 true인 IteratorResult 객체의 promise를 반환해야 합니다. 그러나 이 요구 사항은 강제되지 않습니다.

또한 이행 값으로 사용되는 IteratorResult 객체에는 값이 promise(또는 “thenable”)가 아닌 "value" 프로퍼티가 있어야 합니다. 그러나 이 요구 사항 역시 강제되지 않습니다.

참고 1

next 함수에 인수를 전달할 수 있지만 그 해석과 유효성은 대상 async iterator에 따라 달라집니다. for-await-of 문과 async iterator의 다른 일반적인 사용자는 인수를 전달하지 않으므로 그러한 방식으로 사용될 것으로 예상되는 async iterator 객체는 인수 없이 호출되는 경우를 처리할 준비가 되어 있어야 합니다.

표 84: Async Iterator 인터페이스 선택적 프로퍼티

프로퍼티 값 요구 사항

"return"

a function that returns a promise for an IteratorResult object

반환된 promise가 이행되면 IteratorResult 인터페이스를 준수하는 객체로 이행되어야 합니다. 이 메서드를 호출하면 호출자가 해당 async iterator에 대해 더 이상 next 메서드를 호출하지 않을 것임을 async iterator 객체에 알립니다. 반환된 promise는 일반적으로 값이 true인 "done" 프로퍼티와 return 메서드의 인수로 전달된 값을 갖는 "value" 프로퍼티가 있는 IteratorResult 객체로 이행됩니다. 그러나 이 요구 사항은 강제되지 않습니다.

또한 이행 값으로 사용되는 IteratorResult 객체에는 값이 promise(또는 “thenable”)가 아닌 "value" 프로퍼티가 있어야 합니다. 인수 값이 일반적인 방식으로 사용되는 경우, 거부된 promise라면 같은 이유로 거부되는 promise가 반환되어야 하며, 이행된 promise라면 그 이행 값을 반환 promise의 IteratorResult 객체 이행 값의 "value" 프로퍼티로 사용해야 합니다. 그러나 이러한 요구 사항 역시 강제되지 않습니다.

"throw"

a function that returns a promise for an IteratorResult object

반환된 promise가 이행되면 IteratorResult 인터페이스를 준수하는 객체로 이행되어야 합니다. 이 메서드를 호출하면 호출자가 오류 조건을 감지했음을 async iterator 객체에 알립니다. 인수는 오류 조건을 식별하는 데 사용할 수 있으며 일반적으로 예외 객체입니다. 일반적인 응답은 인수로 전달된 값을 이유로 거부되는 promise를 반환하는 것입니다.

반환된 promise가 이행되면 IteratorResult 객체 이행 값은 일반적으로 값이 true인 "done" 프로퍼티를 갖습니다. 또한 값이 promise(또는 “thenable”)가 아닌 "value" 프로퍼티를 가져야 하지만 이 요구 사항은 강제되지 않습니다.

참고 2

일반적으로 이러한 메서드의 호출자는 메서드를 호출하기 전에 존재 여부를 확인해야 합니다. for-await-of 및 yield*를 포함한 특정 ECMAScript 언어 기능은 존재 여부를 확인한 후 이러한 메서드를 호출합니다.

27.1.1.5 IteratorResult 인터페이스

IteratorResult 인터페이스에는 표 85에 나열된 프로퍼티가 포함됩니다:

표 85: IteratorResult 인터페이스 프로퍼티

프로퍼티	값	요구 사항
"done"	a Boolean	이는 iterator `next` 메서드 호출의 결과 상태입니다. iterator의 끝에 도달하면 "done"은 true입니다. 끝에 도달하지 않았다면 "done"은 false이며 값을 사용할 수 있습니다. "done" 프로퍼티(자체 또는 상속된 프로퍼티)가 존재하지 않으면 값이 false인 것으로 간주합니다.
"value"	an ECMAScript language value	done이 false이면 현재 순회 요소 값입니다. done이 true이면 iterator가 반환 값을 제공한 경우 그 반환 값입니다. iterator에 반환 값이 없으면 "value"는 undefined입니다. 이 경우 명시적인 "value" 프로퍼티를 상속하지 않는다면 준수 객체에 "value" 프로퍼티가 없을 수 있습니다.

27.1.2 Iterator Helper 객체

Iterator Helper 객체는 특정 소스 iterator 객체의 지연 변환을 나타내는 일반 객체입니다. Iterator Helper 객체에는 이름 있는 생성자가 없습니다. 대신 Iterator Helper 객체는 Iterator 인스턴스 객체의 특정 메서드를 호출하여 생성됩니다.

27.1.2.1 %IteratorHelperPrototype% 객체

%IteratorHelperPrototype% 객체는:

모든 Iterator Helper 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

27.1.2.1.1 %IteratorHelperPrototype%.next ( )

? GeneratorResume(this 값, undefined, "Iterator Helper")를 반환합니다.

27.1.2.1.2 %IteratorHelperPrototype%.return ( )

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[UnderlyingIterators]])를 수행합니다.
단언: obj에는 [[GeneratorState]] 내부 슬롯이 있습니다.
obj.[[GeneratorState]]가 suspended-start이면, 다음을 수행합니다.
1. obj.[[GeneratorState]]를 completed로 설정합니다.
2. 참고: generator가 completed 상태에 들어가면 다시 벗어나지 않으며 연결된 실행 컨텍스트는 다시 재개되지 않습니다. obj와 연결된 모든 실행 상태는 이 시점에 폐기할 수 있습니다.
3. ? IteratorCloseAll(obj.[[UnderlyingIterators]], NormalCompletion(unused))을 수행합니다.
4. CreateIteratorResultObject(undefined, true)를 반환합니다.
completion을 ReturnCompletion(undefined)로 둡니다.
? GeneratorResumeAbrupt(obj, completion, "Iterator Helper")를 반환합니다.

27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Iterator Helper"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.1.3 Iterator 객체

27.1.3.1 Iterator 생성자

Iterator 생성자는:

%Iterator%입니다.
전역 객체의 "Iterator" 프로퍼티의 초기 값입니다.
하위 클래스를 만들 수 있도록 설계되었습니다. 클래스 정의의 extends 절 값으로 사용할 수 있습니다.

27.1.3.1.1 Iterator ( )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이거나 활성 함수 객체이면 TypeError 예외를 던집니다.
? OrdinaryCreateFromConstructor(NewTarget, "%Iterator.prototype%")를 반환합니다.

27.1.3.2 Iterator 생성자의 프로퍼티

Iterator 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

27.1.3.2.1 Iterator.concat ( ...`items` )

iterables를 새로운 빈 List로 둡니다.
items의 각 요소 item에 대해 다음을 수행합니다.
1. item이 Object가 아니면 TypeError 예외를 던집니다.
2. method를 ? GetMethod(item, %Symbol.iterator%)로 둡니다.
3. method가 undefined이면 TypeError 예외를 던집니다.
4. Record { [[OpenMethod]]: method, [[Iterable]]: item }를 iterables에 추가합니다.
closure를 매개변수가 없고 iterables를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. iterables의 각 Record iterable에 대해 다음을 수행합니다.
  1. iterator를 ? Call(iterable.[[OpenMethod]], iterable.[[Iterable]])로 둡니다.
  2. iterator가 Object가 아니면 TypeError 예외를 던집니다.
  3. iteratorRecord를 ? GetIteratorDirect(iterator)로 둡니다.
  4. innerAlive를 true로 둡니다.
  5. innerAlive가 true인 동안 다음을 반복합니다.
    1. innerValue를 ? IteratorStepValue(iteratorRecord)로 둡니다.
    2. innerValue가 done이면, 다음을 수행합니다.
      1. innerAlive를 false로 설정합니다.
    3. 그렇지 않으면,
      1. completion을 Completion(Yield(innerValue))으로 둡니다.
      2. completion이 abrupt completion이면, 다음을 수행합니다.
        ? IteratorClose(iteratorRecord, completion)을 반환합니다.
2. ReturnCompletion(undefined)을 반환합니다.
gen을 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
gen.[[UnderlyingIterators]]를 새로운 빈 List로 설정합니다.
gen을 반환합니다.

27.1.3.2.2 Iterator.from ( `obj` )

iteratorRecord를 ? GetIteratorFlattenable(obj, iterate-string-primitives)로 둡니다.
hasInstance를 ? OrdinaryHasInstance(%Iterator%, iteratorRecord.[[Iterator]])로 둡니다.
hasInstance가 true이면, 다음을 수행합니다.
1. iteratorRecord.[[Iterator]]를 반환합니다.
wrapper를 OrdinaryObjectCreate(%WrapForValidIteratorPrototype%, « [[Iterated]] »)로 둡니다.
wrapper.[[Iterated]]를 iteratorRecord로 설정합니다.
wrapper를 반환합니다.

27.1.3.2.2.1 %WrapForValidIteratorPrototype% 객체

%WrapForValidIteratorPrototype% 객체는:

일반 객체입니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

27.1.3.2.2.1.1 %WrapForValidIteratorPrototype%.next ( )

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[Iterated]])를 수행합니다.
iteratorRecord를 obj.[[Iterated]]로 둡니다.
? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])를 반환합니다.

27.1.3.2.2.1.2 %WrapForValidIteratorPrototype%.return ( )

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[Iterated]])를 수행합니다.
iterator를 obj.[[Iterated]].[[Iterator]]로 둡니다.
단언: iterator는 Object입니다.
returnMethod를 ? GetMethod(iterator, "return")으로 둡니다.
returnMethod가 undefined이면, 다음을 수행합니다.
1. CreateIteratorResultObject(undefined, true)를 반환합니다.
? Call(returnMethod, iterator)를 반환합니다.

27.1.3.2.3 Iterator.prototype

Iterator.prototype의 초기 값은 Iterator 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.1.3.2.4 Iterator.zip ( `iterables` [ , `options` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

iterables가 Object가 아니면 TypeError 예외를 던집니다.
options를 ? GetOptionsObject(options)로 설정합니다.
mode를 ? Get(options, "mode")로 둡니다.
mode가 undefined이면 mode를 "shortest"로 설정합니다.
mode가 "shortest", "longest", "strict" 중 하나가 아니면 TypeError 예외를 던집니다.
paddingOption을 undefined로 둡니다.
mode가 "longest"이면, 다음을 수행합니다.
1. paddingOption을 ? Get(options, "padding")으로 설정합니다.
2. paddingOption이 undefined가 아니고 Object도 아니면 TypeError 예외를 던집니다.
iters를 새로운 빈 List로 둡니다.
padding을 새로운 빈 List로 둡니다.
inputIter를 ? GetIterator(iterables, sync)로 둡니다.
next를 not-started로 둡니다.
next가 done이 아닌 동안 다음을 반복합니다.
1. next를 Completion(IteratorStepValue(inputIter))으로 설정합니다.
2. IfAbruptCloseIterators(next, iters).
3. next가 done이 아니면, 다음을 수행합니다.
  1. iter를 Completion(GetIteratorFlattenable(next, reject-primitives))으로 둡니다.
  2. needClosing을 « inputIter »와 iters의 목록 연결로 둡니다.
  3. IfAbruptCloseIterators(iter, needClosing).
  4. iter를 iters에 추가합니다.
iterCount를 iters의 요소 수로 둡니다.
mode가 "longest"이면, 다음을 수행합니다.
1. paddingOption이 undefined이면, 다음을 수행합니다.
  1. iterCount번 반복합니다:
    1. undefined를 padding에 추가합니다.
2. 그렇지 않으면,
  1. paddingIter를 Completion(GetIterator(paddingOption, sync))으로 둡니다.
  2. IfAbruptCloseIterators(paddingIter, iters).
  3. usingIterator를 true로 둡니다.
  4. iterCount번 반복합니다:
    1. usingIterator가 true이면, 다음을 수행합니다.
      1. next를 Completion(IteratorStepValue(paddingIter))으로 설정합니다.
      2. IfAbruptCloseIterators(next, iters).
      3. next가 done이면, 다음을 수행합니다.
        usingIterator를 false로 설정합니다.
      4. 그렇지 않으면,
        next를 padding에 추가합니다.
    2. usingIterator가 false이면 undefined를 padding에 추가합니다.
  5. usingIterator가 true이면, 다음을 수행합니다.
    1. completion을 Completion(IteratorClose(paddingIter, NormalCompletion(unused)))으로 둡니다.
    2. IfAbruptCloseIterators(completion, iters).
finishResults를 매개변수 (results)를 가지며 아무것도 캡처하지 않고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. CreateArrayFromList(results)를 반환합니다.
IteratorZip(iters, mode, padding, finishResults)를 반환합니다.

27.1.3.2.5 Iterator.zipKeyed ( `iterables` [ , `options` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

iterables가 Object가 아니면 TypeError 예외를 던집니다.
options를 ? GetOptionsObject(options)로 설정합니다.
mode를 ? Get(options, "mode")로 둡니다.
mode가 undefined이면 mode를 "shortest"로 설정합니다.
mode가 "shortest", "longest", "strict" 중 하나가 아니면 TypeError 예외를 던집니다.
paddingOption을 undefined로 둡니다.
mode가 "longest"이면, 다음을 수행합니다.
1. paddingOption을 ? Get(options, "padding")으로 설정합니다.
2. paddingOption이 undefined가 아니고 Object도 아니면 TypeError 예외를 던집니다.
iters를 새로운 빈 List로 둡니다.
padding을 새로운 빈 List로 둡니다.
allKeys를 ? iterables.[[OwnPropertyKeys]]()로 둡니다.
keys를 새로운 빈 List로 둡니다.
allKeys의 각 요소 key에 대해 다음을 수행합니다.
1. propertyDesc를 Completion(iterables.[[GetOwnProperty]](key))으로 둡니다.
2. IfAbruptCloseIterators(propertyDesc, iters).
3. propertyDesc가 undefined가 아니고 propertyDesc.[[Enumerable]]이 true이면, 다음을 수행합니다.
  1. value를 Completion(Get(iterables, key))으로 둡니다.
  2. IfAbruptCloseIterators(value, iters).
  3. value가 undefined가 아니면, 다음을 수행합니다.
    1. key를 keys에 추가합니다.
    2. iter를 Completion(GetIteratorFlattenable(value, reject-primitives))으로 둡니다.
    3. IfAbruptCloseIterators(iter, iters).
    4. iter를 iters에 추가합니다.
iterCount를 iters의 요소 수로 둡니다.
mode가 "longest"이면, 다음을 수행합니다.
1. paddingOption이 undefined이면, 다음을 수행합니다.
  1. iterCount번 반복합니다:
    1. undefined를 padding에 추가합니다.
2. 그렇지 않으면,
  1. keys의 각 요소 key에 대해 다음을 수행합니다.
    1. value를 Completion(Get(paddingOption, key))으로 둡니다.
    2. IfAbruptCloseIterators(value, iters).
    3. value를 padding에 추가합니다.
finishResults를 매개변수 (results)를 가지며 keys와 iterCount를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. obj를 OrdinaryObjectCreate(null)로 둡니다.
2. 0 ≤ i < iterCount를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
  1. ! CreateDataPropertyOrThrow(obj, keys[i], results[i])를 수행합니다.
3. obj를 반환합니다.
IteratorZip(iters, mode, padding, finishResults)를 반환합니다.

27.1.3.3 Iterator 프로토타입 객체의 프로퍼티

Iterator 프로토타입 객체는:

%Iterator.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.

참고

이 명세에서 정의되고 iterator 인터페이스를 구현하는 모든 객체는 %Iterator.prototype%에서도 상속합니다. ECMAScript 코드도 %Iterator.prototype%에서 상속하는 객체를 정의할 수 있습니다. %Iterator.prototype%은 모든 iterator 객체에 적용할 수 있는 추가 메서드를 추가할 수 있는 위치를 제공합니다.

다음 표현식은 ECMAScript 코드가 %Iterator.prototype% 객체에 접근할 수 있는 한 가지 방법입니다:

Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))

27.1.3.3.1 Iterator.prototype.chunks ( `chunkSize` )

이 메서드는 호출될 때 다음 단계를 수행합니다.

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator 레코드 { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
chunkSize가 정수인 Number가 아니면 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
chunkSize가 1_𝔽부터 𝔽(2³² - 1)까지 양 끝을 포함하는 구간에 있지 않으면 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 iterated와 chunkSize를 캡처하고 매개변수가 없으며 호출될 때 다음 단계를 수행하는 새로운 추상 클로저로 둡니다.
1. buffer를 새로운 빈 List로 둡니다.
2. 다음 단계를 반복합니다.
  1. value를 ? IteratorStepValue(iterated)로 둡니다.
  2. value가 done이면 다음을 수행합니다.
    1. buffer가 비어 있지 않으면 다음을 수행합니다.
      1. Completion(Yield(CreateArrayFromList(buffer)))을 수행합니다.
    2. ReturnCompletion(undefined)를 반환합니다.
  3. value를 buffer에 추가합니다.
  4. buffer의 요소 수가 ℝ(chunkSize)이면 다음을 수행합니다.
    1. completion을 Completion(Yield(CreateArrayFromList(buffer)))으로 둡니다.
    2. IfAbruptCloseIterator(completion, iterated)를 수행합니다.
    3. buffer를 새로운 빈 List로 설정합니다.
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.2 Iterator.prototype.constructor

Iterator.prototype.constructor는 { [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖는 접근자 프로퍼티입니다. [[Getter]] 및 [[Setter]] 속성은 다음과 같이 정의됩니다:

27.1.3.3.2.1 get Iterator.prototype.constructor

[[Getter]] 속성의 값은 인수를 요구하지 않는 내장 함수입니다. 호출되면 다음 단계를 수행합니다:

%Iterator%를 반환합니다.

27.1.3.3.2.2 set Iterator.prototype.constructor

[[Setter]] 속성의 값은 인수 v를 받는 내장 함수입니다. 호출되면 다음 단계를 수행합니다:

? SetterThatIgnoresPrototypeProperties(this 값, %Iterator.prototype%, "constructor", v)를 수행합니다.
undefined를 반환합니다.

참고

대부분의 내장 프로토타입의 "constructor" 프로퍼티와 달리 웹 호환성을 위해 이 프로퍼티는 접근자여야 합니다.

27.1.3.3.3 Iterator.prototype.drop ( `limit` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
numberLimit을 Completion(ToNumber(limit))으로 둡니다.
IfAbruptCloseIterator(numberLimit, iterated).
numberLimit이 NaN이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
numberLimit이 유한하고 numberLimit > 𝔽(2⁵³ - 1)이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
intLimit을 ! ToIntegerOrInfinity(numberLimit)로 둡니다.
intLimit < 0이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 매개변수가 없고 iterated와 intLimit을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. remaining을 𝔽(intLimit)로 둡니다.
2. remaining > +0_𝔽인 동안 다음을 반복합니다.
  1. remaining을 remaining - 1_𝔽로 설정합니다.
  2. next를 ? IteratorStep(iterated)로 둡니다.
  3. next가 done이면 ReturnCompletion(undefined)을 반환합니다.
3. 다음을 반복합니다.
  1. value를 ? IteratorStepValue(iterated)로 둡니다.
  2. value가 done이면 ReturnCompletion(undefined)을 반환합니다.
  3. completion을 Completion(Yield(value))으로 둡니다.
  4. IfAbruptCloseIterator(completion, iterated).
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.4 Iterator.prototype.every ( `predicate` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(predicate)이 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
counter를 +0_𝔽으로 둡니다.
다음을 반복합니다.
1. value를 ? IteratorStepValue(iterated)로 둡니다.
2. value가 done이면 true를 반환합니다.
3. result를 Completion(Call(predicate, undefined, « value, counter »))으로 둡니다.
4. IfAbruptCloseIterator(result, iterated).
5. ToBoolean(result)이 false이면 ? IteratorClose(iterated, NormalCompletion(false))를 반환합니다.
6. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
7. counter를 counter + 1_𝔽로 설정합니다.

27.1.3.3.5 Iterator.prototype.filter ( `predicate` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(predicate)이 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 매개변수가 없고 iterated와 predicate를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. counter를 +0_𝔽으로 둡니다.
2. 다음을 반복합니다.
  1. value를 ? IteratorStepValue(iterated)로 둡니다.
  2. value가 done이면 ReturnCompletion(undefined)을 반환합니다.
  3. selected를 Completion(Call(predicate, undefined, « value, counter »))으로 둡니다.
  4. IfAbruptCloseIterator(selected, iterated).
  5. ToBoolean(selected)이 true이면, 다음을 수행합니다.
    1. completion을 Completion(Yield(value))으로 둡니다.
    2. IfAbruptCloseIterator(completion, iterated).
  6. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
  7. counter를 counter + 1_𝔽로 설정합니다.
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.6 Iterator.prototype.find ( `predicate` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(predicate)이 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
counter를 +0_𝔽으로 둡니다.
다음을 반복합니다.
1. value를 ? IteratorStepValue(iterated)로 둡니다.
2. value가 done이면 undefined를 반환합니다.
3. result를 Completion(Call(predicate, undefined, « value, counter »))으로 둡니다.
4. IfAbruptCloseIterator(result, iterated).
5. ToBoolean(result)이 true이면 ? IteratorClose(iterated, NormalCompletion(value))를 반환합니다.
6. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
7. counter를 counter + 1_𝔽로 설정합니다.

27.1.3.3.7 Iterator.prototype.flatMap ( `mapper` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(mapper)가 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 매개변수가 없고 iterated와 mapper를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. counter를 +0_𝔽으로 둡니다.
2. 다음을 반복합니다.
  1. value를 ? IteratorStepValue(iterated)로 둡니다.
  2. value가 done이면 ReturnCompletion(undefined)을 반환합니다.
  3. mapped를 Completion(Call(mapper, undefined, « value, counter »))으로 둡니다.
  4. IfAbruptCloseIterator(mapped, iterated).
  5. innerIterator를 Completion(GetIteratorFlattenable(mapped, reject-primitives))으로 둡니다.
  6. IfAbruptCloseIterator(innerIterator, iterated).
  7. innerAlive를 true로 둡니다.
  8. innerAlive가 true인 동안 다음을 반복합니다.
    1. innerValue를 Completion(IteratorStepValue(innerIterator))으로 둡니다.
    2. IfAbruptCloseIterator(innerValue, iterated).
    3. innerValue가 done이면, 다음을 수행합니다.
      1. innerAlive를 false로 설정합니다.
    4. 그렇지 않으면,
      1. completion을 Completion(Yield(innerValue))으로 둡니다.
      2. completion이 abrupt completion이면, 다음을 수행합니다.
        backupCompletion을 Completion(IteratorClose(innerIterator, completion))으로 둡니다.
        IfAbruptCloseIterator(backupCompletion, iterated).
        ? IteratorClose(iterated, completion)을 반환합니다.
  9. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
  10. counter를 counter + 1_𝔽로 설정합니다.
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.8 Iterator.prototype.forEach ( `procedure` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(procedure)이 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
counter를 +0_𝔽으로 둡니다.
다음을 반복합니다.
1. value를 ? IteratorStepValue(iterated)로 둡니다.
2. value가 done이면 undefined를 반환합니다.
3. result를 Completion(Call(procedure, undefined, « value, counter »))으로 둡니다.
4. IfAbruptCloseIterator(result, iterated).
5. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
6. counter를 counter + 1_𝔽로 설정합니다.

27.1.3.3.9 Iterator.prototype.join ( `separator` )

이 메서드는 반복자의 값을 String으로 변환한 다음, separator가 나타나는 부분으로 구분하여 이 String들을 연결합니다. 구분자가 제공되지 않으면 단일 쉼표가 구분자로 사용됩니다.

호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둔다.
obj가 Object가 아니면 TypeError 예외를 던진다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둔다.
separator가 undefined이면,
1. separatorString을 ","로 둔다.
그렇지 않으면,
1. separatorString을 Completion(ToString(separator))으로 둔다.
2. IfAbruptCloseIterator(separatorString, iterated).
iterated를 ? GetIteratorDirect(obj)로 설정한다.
result를 빈 String으로 둔다.
first를 true로 둔다.
반복한다,
1. value를 ? IteratorStepValue(iterated)로 둔다.
2. value가 done이면 result를 반환한다.
3. first가 true이면,
  1. first를 false로 설정한다.
4. 그렇지 않으면,
  1. result를 result와 separatorString의 string-concatenation으로 설정한다.
5. value가 undefined도 null도 아니면,
  1. valueString을 Completion(ToString(value))으로 둔다.
  2. IfAbruptCloseIterator(valueString, iterated).
  3. result를 result와 valueString의 string-concatenation으로 설정한다.

27.1.3.3.10 Iterator.prototype.map ( `mapper` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(mapper)가 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 매개변수가 없고 iterated와 mapper를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. counter를 +0_𝔽으로 둡니다.
2. 다음을 반복합니다.
  1. value를 ? IteratorStepValue(iterated)로 둡니다.
  2. value가 done이면 ReturnCompletion(undefined)을 반환합니다.
  3. mapped를 Completion(Call(mapper, undefined, « value, counter »))으로 둡니다.
  4. IfAbruptCloseIterator(mapped, iterated).
  5. completion을 Completion(Yield(mapped))으로 둡니다.
  6. IfAbruptCloseIterator(completion, iterated).
  7. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
  8. counter를 counter + 1_𝔽로 설정합니다.
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.11 Iterator.prototype.reduce ( `reducer` [ , `initialValue` ] )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(reducer)가 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
initialValue가 존재하지 않으면, 다음을 수행합니다.
1. accumulator를 ? IteratorStepValue(iterated)로 둡니다.
2. accumulator가 done이면 TypeError 예외를 던집니다.
3. counter를 1_𝔽로 둡니다.
그렇지 않으면,
1. accumulator를 initialValue로 둡니다.
2. counter를 +0_𝔽으로 둡니다.
다음을 반복합니다.
1. value를 ? IteratorStepValue(iterated)로 둡니다.
2. value가 done이면 accumulator를 반환합니다.
3. result를 Completion(Call(reducer, undefined, « accumulator, value, counter »))으로 둡니다.
4. IfAbruptCloseIterator(result, iterated).
5. accumulator를 result로 설정합니다.
6. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
7. counter를 counter + 1_𝔽로 설정합니다.

27.1.3.3.12 Iterator.prototype.some ( `predicate` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
IsCallable(predicate)이 false이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
counter를 +0_𝔽으로 둡니다.
다음을 반복합니다.
1. value를 ? IteratorStepValue(iterated)로 둡니다.
2. value가 done이면 false를 반환합니다.
3. result를 Completion(Call(predicate, undefined, « value, counter »))으로 둡니다.
4. IfAbruptCloseIterator(result, iterated).
5. ToBoolean(result)이 true이면 ? IteratorClose(iterated, NormalCompletion(true))를 반환합니다.
6. 참고: 다음 단계는 counter가 2⁵³_𝔽에 도달하면 더 이상 counter를 변경하지 않습니다.
7. counter를 counter + 1_𝔽로 설정합니다.

27.1.3.3.13 Iterator.prototype.take ( `limit` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator Record { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
numberLimit을 Completion(ToNumber(limit))으로 둡니다.
IfAbruptCloseIterator(numberLimit, iterated).
numberLimit이 NaN이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
numberLimit이 유한하고 numberLimit > 𝔽(2⁵³ - 1)이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
intLimit을 ! ToIntegerOrInfinity(numberLimit)로 둡니다.
intLimit < 0이면, 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 매개변수가 없고 iterated와 intLimit을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. remaining을 𝔽(intLimit)로 둡니다.
2. 다음을 반복합니다.
  1. remaining이 +0_𝔽이면, 다음을 수행합니다.
    1. ? IteratorClose(iterated, ReturnCompletion(undefined))를 반환합니다.
  2. remaining을 remaining - 1_𝔽로 설정합니다.
  3. value를 ? IteratorStepValue(iterated)로 둡니다.
  4. value가 done이면 ReturnCompletion(undefined)을 반환합니다.
  5. completion을 Completion(Yield(value))으로 둡니다.
  6. IfAbruptCloseIterator(completion, iterated).
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.14 Iterator.prototype.toArray ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 ? GetIteratorDirect(obj)로 둡니다.
items를 새로운 빈 List로 둡니다.
다음을 반복합니다.
1. value를 ? IteratorStepValue(iterated)로 둡니다.
2. value가 done이면 CreateArrayFromList(items)를 반환합니다.
3. value를 items에 추가합니다.

27.1.3.3.15 Iterator.prototype.windows ( `windowSize` [ , `undersized` ] )

이 메서드는 호출될 때 다음 단계를 수행합니다.

obj를 this 값으로 둡니다.
obj가 Object가 아니면 TypeError 예외를 던집니다.
iterated를 Iterator 레코드 { [[Iterator]]: obj, [[NextMethod]]: undefined, [[Done]]: false }로 둡니다.
windowSize가 정수인 Number가 아니면 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
windowSize가 1_𝔽부터 𝔽(2³² - 1)까지 양 끝을 포함하는 구간에 있지 않으면 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 RangeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
undersized가 undefined이면 undersized를 "only-full"로 설정합니다.
undersized가 "only-full"도 "allow-partial"도 아니면 다음을 수행합니다.
1. error를 ThrowCompletion(새로 생성된 TypeError 객체)로 둡니다.
2. ? IteratorClose(iterated, error)를 반환합니다.
iterated를 ? GetIteratorDirect(obj)로 설정합니다.
closure를 iterated, windowSize, undersized를 캡처하고 매개변수가 없으며 호출될 때 다음 단계를 수행하는 새로운 추상 클로저로 둡니다.
1. buffer를 새로운 빈 List로 둡니다.
2. 다음 단계를 반복합니다.
  1. value를 ? IteratorStepValue(iterated)로 둡니다.
  2. value가 done이면 다음을 수행합니다.
    1. undersized가 "allow-partial"이고 buffer가 비어 있지 않으며 buffer의 요소 수가 < ℝ(windowSize)이면 다음을 수행합니다.
      1. Completion(Yield(CreateArrayFromList(buffer)))을 수행합니다.
    2. ReturnCompletion(undefined)를 반환합니다.
  3. buffer의 요소 수가 ℝ(windowSize)이면 다음을 수행합니다.
    1. buffer에서 첫 번째 요소를 제거합니다.
  4. value를 buffer에 추가합니다.
  5. buffer의 요소 수가 ℝ(windowSize)이면 다음을 수행합니다.
    1. completion을 Completion(Yield(CreateArrayFromList(buffer)))으로 둡니다.
    2. IfAbruptCloseIterator(completion, iterated)를 수행합니다.
result를 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
result.[[UnderlyingIterators]]를 « iterated »로 설정합니다.
result를 반환합니다.

27.1.3.3.16 Iterator.prototype [ %Symbol.dispose% ] ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
return을 ? GetMethod(obj, "return")으로 둡니다.
return이 undefined가 아니면, 다음을 수행합니다.
1. ? Call(return, obj)를 수행합니다.
undefined를 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.dispose]"입니다.

27.1.3.3.17 Iterator.prototype [ %Symbol.iterator% ] ( )

이 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "[Symbol.iterator]"입니다.

27.1.3.3.18 Iterator.prototype [ %Symbol.toStringTag% ]

Iterator.prototype[%Symbol.toStringTag%]는 { [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖는 접근자 프로퍼티입니다. [[Getter]] 및 [[Setter]] 속성은 다음과 같이 정의됩니다:

27.1.3.3.18.1 get Iterator.prototype [ %Symbol.toStringTag% ]

[[Getter]] 속성의 값은 인수를 요구하지 않는 내장 함수입니다. 호출되면 다음 단계를 수행합니다:

"Iterator"를 반환합니다.

27.1.3.3.18.2 set Iterator.prototype [ %Symbol.toStringTag% ]

[[Setter]] 속성의 값은 인수 v를 받는 내장 함수입니다. 호출되면 다음 단계를 수행합니다:

? SetterThatIgnoresPrototypeProperties(this 값, %Iterator.prototype%, %Symbol.toStringTag%, v)를 수행합니다.
undefined를 반환합니다.

참고

대부분의 내장 프로토타입의 %Symbol.toStringTag% 프로퍼티와 달리 웹 호환성을 위해 이 프로퍼티는 접근자여야 합니다.

27.1.3.4 Iterator를 위한 추상 연산

27.1.3.4.1 IteratorZip ( `iters`, `mode`, `padding`, `finishResults` )

추상 연산 IteratorZip. 인수 iters (리스트 (요소: Iterator 레코드)), mode (("shortest", "longest" 또는 "strict")), padding (리스트 (요소: ECMAScript 언어 값)) 및 finishResults (an Abstract Closure that takes a List of ECMAScript language values and returns an ECMAScript language value). 반환값: Generator. 호출되면 다음 단계를 수행한다.

iterCount를 iters의 요소 수로 둡니다.
openIters를 iters의 복사본으로 둡니다.
closure를 매개변수가 없고 iters, iterCount, openIters, mode, padding, finishResults를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. iterCount = 0이면 ReturnCompletion(undefined)을 반환합니다.
2. 다음을 반복합니다.
  1. results를 새로운 빈 List로 둡니다.
  2. 단언: openIters는 비어 있지 않습니다.
  3. 0 ≤ i < iterCount를 만족하는 각 정수 i에 대해 오름차순으로 다음을 수행합니다.
    1. iter를 iters[i]로 둡니다.
    2. iter가 null이면, 다음을 수행합니다.
      1. 단언: mode는 "longest"입니다.
      2. result를 padding[i]로 둡니다.
    3. 그렇지 않으면,
      1. result를 Completion(IteratorStepValue(iter))으로 둡니다.
      2. result가 abrupt completion이면, 다음을 수행합니다.
        iter를 openIters에서 제거합니다.
        ? IteratorCloseAll(openIters, result)을 반환합니다.
      3. result를 ! result로 설정합니다.
      4. result가 done이면, 다음을 수행합니다.
        iter를 openIters에서 제거합니다.
        mode가 "shortest"이면, 다음을 수행합니다.
        ? IteratorCloseAll(openIters, ReturnCompletion(undefined))을 반환합니다.
        그렇지 않고 mode가 "strict"이면, 다음을 수행합니다.
        i ≠ 0이면, 다음을 수행합니다.
        ? IteratorCloseAll(openIters, ThrowCompletion(새로 생성된 TypeError 객체))를 반환합니다.
        1 ≤ k < iterCount를 만족하는 각 정수 k에 대해 오름차순으로 다음을 수행합니다.
        단언: iters[k]는 null이 아닙니다.
        open을 Completion(IteratorStep(iters[k]))으로 둡니다.
        open이 abrupt completion이면, 다음을 수행합니다.
        iters[k]를 openIters에서 제거합니다.
        ? IteratorCloseAll(openIters, open)을 반환합니다.
        open을 ! open으로 설정합니다.
        open이 done이면, 다음을 수행합니다.
        iters[k]를 openIters에서 제거합니다.
        그렇지 않으면,
        ? IteratorCloseAll(openIters, ThrowCompletion(새로 생성된 TypeError 객체))를 반환합니다.
        ReturnCompletion(undefined)을 반환합니다.
        그렇지 않으면,
        단언: mode는 "longest"입니다.
        openIters가 비어 있으면 ReturnCompletion(undefined)을 반환합니다.
        iters[i]를 null로 설정합니다.
        result를 padding[i]로 설정합니다.
    4. result를 results에 추가합니다.
  4. results를 finishResults(results)로 설정합니다.
  5. completion을 Completion(Yield(results))으로 둡니다.
  6. IfAbruptCloseIterators(completion, openIters).
gen을 CreateIteratorFromClosure(closure, "Iterator Helper", %IteratorHelperPrototype%, « [[UnderlyingIterators]] »)로 둡니다.
gen.[[UnderlyingIterators]]를 openIters로 설정합니다.
gen을 반환합니다.

27.1.4 %AsyncIteratorPrototype% 객체

%AsyncIteratorPrototype% 객체는:

값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.

참고

이 명세에서 정의되고 async iterator 인터페이스를 구현하는 모든 객체는 %AsyncIteratorPrototype%에서도 상속합니다. ECMAScript 코드도 %AsyncIteratorPrototype%에서 상속하는 객체를 정의할 수 있습니다. %AsyncIteratorPrototype% 객체는 모든 async iterator 객체에 적용할 수 있는 추가 메서드를 추가할 수 있는 위치를 제공합니다.

27.1.4.1 %AsyncIteratorPrototype% [ %Symbol.asyncDispose% ] ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
return을 Completion(GetMethod(obj, "return"))으로 둡니다.
IfAbruptRejectPromise(return, promiseCapability).
return이 undefined이면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Resolve]], undefined, « undefined »)를 수행합니다.
그렇지 않으면,
1. result를 Completion(Call(return, obj, « »))으로 둡니다.
2. IfAbruptRejectPromise(result, promiseCapability).
3. resultWrapper를 Completion(PromiseResolve(%Promise%, result))으로 둡니다.
4. IfAbruptRejectPromise(resultWrapper, promiseCapability).
5. unwrap을 매개변수가 없고 아무것도 캡처하지 않으며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. undefined를 반환합니다.
6. onFulfilled를 CreateBuiltinFunction(unwrap, 1, "", « »)로 둡니다.
7. PerformPromiseThen(resultWrapper, onFulfilled, undefined, promiseCapability)을 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

이 메서드의 "name" 프로퍼티 값은 "[Symbol.asyncDispose]"입니다.

27.1.4.2 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )

이 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "[Symbol.asyncIterator]"입니다.

27.1.5 Async-from-Sync Iterator 객체

Async-from-Sync Iterator 객체는 특정 동기 iterator를 적응시키는 async iterator입니다. Async-from-Sync Iterator 객체는 ECMAScript 코드에서 직접 접근할 수 없습니다. Async-from-Sync Iterator 객체에는 이름 있는 생성자가 없습니다. 대신 필요할 때 CreateAsyncFromSyncIterator 추상 연산이 Async-from-Sync Iterator 객체를 생성합니다.

27.1.5.1 CreateAsyncFromSyncIterator ( `syncIteratorRecord` )

추상 연산 CreateAsyncFromSyncIterator. 인수 syncIteratorRecord (Iterator 레코드). 반환값: Iterator 레코드. 동기 Iterator Record에서 async Iterator Record를 생성하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

asyncIterator를 OrdinaryObjectCreate(%AsyncFromSyncIteratorPrototype%, « [[SyncIteratorRecord]] »)로 둡니다.
asyncIterator.[[SyncIteratorRecord]]를 syncIteratorRecord로 설정합니다.
nextMethod를 ! Get(asyncIterator, "next")로 둡니다.
iteratorRecord를 Iterator Record { [[Iterator]]: asyncIterator, [[NextMethod]]: nextMethod, [[Done]]: false }로 둡니다.
iteratorRecord를 반환합니다.

27.1.5.2 %AsyncFromSyncIteratorPrototype% 객체

%AsyncFromSyncIteratorPrototype% 객체는:

모든 Async-from-Sync Iterator 객체가 상속하는 프로퍼티를 갖습니다.
일반 객체입니다.
값이 %AsyncIteratorPrototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
ECMAScript 코드에서 직접 접근할 수 없습니다.
다음 프로퍼티를 갖습니다:

27.1.5.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ `value` ] )

obj를 this 값으로 둡니다.
단언: obj는 [[SyncIteratorRecord]] 내부 슬롯을 갖는 Object입니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
syncIteratorRecord를 obj.[[SyncIteratorRecord]]로 둡니다.
value가 존재하면, 다음을 수행합니다.
1. result를 Completion(IteratorNext(syncIteratorRecord, value))으로 둡니다.
그렇지 않으면,
1. result를 Completion(IteratorNext(syncIteratorRecord))으로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
AsyncFromSyncIteratorContinuation(result, promiseCapability, syncIteratorRecord, true)를 반환합니다.

27.1.5.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ `value` ] )

obj를 this 값으로 둡니다.
단언: obj는 [[SyncIteratorRecord]] 내부 슬롯을 갖는 Object입니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
syncIteratorRecord를 obj.[[SyncIteratorRecord]]로 둡니다.
syncIterator를 syncIteratorRecord.[[Iterator]]로 둡니다.
return을 Completion(GetMethod(syncIterator, "return"))으로 둡니다.
IfAbruptRejectPromise(return, promiseCapability).
return이 undefined이면, 다음을 수행합니다.
1. iteratorResult를 CreateIteratorResultObject(value, true)로 둡니다.
2. ! Call(promiseCapability.[[Resolve]], undefined, « iteratorResult »)를 수행합니다.
3. promiseCapability.[[Promise]]를 반환합니다.
value가 존재하면, 다음을 수행합니다.
1. result를 Completion(Call(return, syncIterator, « value »))으로 둡니다.
그렇지 않으면,
1. result를 Completion(Call(return, syncIterator))으로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
result가 Object가 아니면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
2. promiseCapability.[[Promise]]를 반환합니다.
AsyncFromSyncIteratorContinuation(result, promiseCapability, syncIteratorRecord, false)를 반환합니다.

27.1.5.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ `value` ] )

참고

이 명세에서는 value가 항상 제공되지만 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )과의 일관성을 위해 선택적으로 남겨 둡니다.

obj를 this 값으로 둡니다.
단언: obj는 [[SyncIteratorRecord]] 내부 슬롯을 갖는 Object입니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
syncIteratorRecord를 obj.[[SyncIteratorRecord]]로 둡니다.
syncIterator를 syncIteratorRecord.[[Iterator]]로 둡니다.
throw를 Completion(GetMethod(syncIterator, "throw"))으로 둡니다.
IfAbruptRejectPromise(throw, promiseCapability).
throw가 undefined이면, 다음을 수행합니다.
1. 참고: syncIterator에 throw 메서드가 없으면 capability를 거부하기 전에 정리할 기회를 주기 위해 이를 닫습니다.
2. closeCompletion을 NormalCompletion(empty)으로 둡니다.
3. result를 Completion(IteratorClose(syncIteratorRecord, closeCompletion))으로 둡니다.
4. IfAbruptRejectPromise(result, promiseCapability).
5. 참고: 다음 단계에서는 프로토콜 위반, 즉 syncIterator에 throw 메서드가 없음을 나타내기 위해 TypeError를 던집니다.
6. 참고: syncIterator를 닫는 과정에서 예외가 발생하지 않으면, 거부된 promise를 산출하더라도 해당 연산의 결과는 무시됩니다.
7. ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
8. promiseCapability.[[Promise]]를 반환합니다.
value가 존재하면, 다음을 수행합니다.
1. result를 Completion(Call(throw, syncIterator, « value »))으로 둡니다.
그렇지 않으면,
1. result를 Completion(Call(throw, syncIterator))으로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
result가 Object가 아니면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « 새로 생성된 TypeError 객체 »)를 수행합니다.
2. promiseCapability.[[Promise]]를 반환합니다.
AsyncFromSyncIteratorContinuation(result, promiseCapability, syncIteratorRecord, true)를 반환합니다.

27.1.5.3 Async-from-Sync Iterator 인스턴스의 프로퍼티

Async-from-Sync Iterator 인스턴스는 %AsyncFromSyncIteratorPrototype% 내재 객체에서 프로퍼티를 상속하는 일반 객체입니다. Async-from-Sync Iterator 인스턴스는 처음에 표 86에 나열된 내부 슬롯과 함께 생성됩니다.

표 86: Async-from-Sync Iterator 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[SyncIteratorRecord]]`	an Iterator Record	적응 중인 원래의 동기 iterator를 나타냅니다.

27.1.5.4 AsyncFromSyncIteratorContinuation ( `result`, `promiseCapability`, `syncIteratorRecord`, `closeOnRejection` )

추상 연산 AsyncFromSyncIteratorContinuation. 인수 result (Object), promiseCapability (a PromiseCapability Record for an intrinsic %Promise%), syncIteratorRecord (Iterator 레코드) 및 closeOnRejection (Boolean). 반환값: Promise. 호출되면 다음 단계를 수행한다.

참고: promiseCapability은 내재 %Promise%에서 파생되므로 아래에서 IfAbruptRejectPromise를 사용함으로써 발생하는 promiseCapability.[[Reject]] 호출은 예외를 던지지 않는 것이 보장됩니다.
done을 Completion(IteratorComplete(result))으로 둡니다.
IfAbruptRejectPromise(done, promiseCapability).
value를 Completion(IteratorValue(result))으로 둡니다.
IfAbruptRejectPromise(value, promiseCapability).
valueWrapper를 Completion(PromiseResolve(%Promise%, value))으로 둡니다.
valueWrapper가 abrupt completion이고 done이 false이며 closeOnRejection이 true이면, 다음을 수행합니다.
1. valueWrapper를 Completion(IteratorClose(syncIteratorRecord, valueWrapper))으로 설정합니다.
IfAbruptRejectPromise(valueWrapper, promiseCapability).
unwrap을 매개변수 (value)를 가지며 done을 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. CreateIteratorResultObject(value, done)를 반환합니다.
onFulfilled를 CreateBuiltinFunction(unwrap, 1, "", « »)로 둡니다.
참고: onFulfilled는 IteratorResult 객체의 "value" 프로퍼티를 처리할 때 그 값이 promise인 경우 기다린 뒤 결과를 새로운 “unwrapped” IteratorResult 객체로 다시 패키징하는 데 사용됩니다.
done이 true이거나 closeOnRejection이 false이면, 다음을 수행합니다.
1. onRejected를 undefined로 둡니다.
그렇지 않으면,
1. closeIterator를 매개변수 (error)를 가지며 syncIteratorRecord를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. ? IteratorClose(syncIteratorRecord, ThrowCompletion(error))를 반환합니다.
2. onRejected를 CreateBuiltinFunction(closeIterator, 1, "", « »)로 둡니다.
3. 참고: onRejected는 iterator가 산출한 IteratorResult 객체의 "value" 프로퍼티가 거부된 promise인 경우 Iterator를 닫는 데 사용됩니다.
PerformPromiseThen(valueWrapper, onFulfilled, onRejected, promiseCapability)을 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

27.2 리소스 관리

27.2.1 공통 리소스 관리 인터페이스

27.2.1.1 Disposable 인터페이스

Disposable 인터페이스에는 표 87에 설명된 프로퍼티가 포함됩니다:

표 87: Disposable 인터페이스 필수 프로퍼티

프로퍼티 값 요구 사항

%Symbol.dispose%

a function object

이 메서드를 호출하면 호출자가 이 객체를 계속 사용할 의도가 없음을 Disposable 객체에 알립니다. 이 메서드는 파일 시스템 핸들, 스트림, 호스트 객체 등을 포함하되 이에 국한되지 않는 리소스의 명시적 정리에 필요한 모든 로직을 수행해야 합니다. 이 메서드에서 예외가 던져지면 일반적으로 리소스를 명시적으로 해제할 수 없었음을 의미합니다.

같은 객체에서 이 메서드를 두 번 이상 호출하는 경우 이미 폐기된 리소스에 대한 정리 로직을 반복하지 않아야 하며, 첫 번째 호출에서 예외가 던져졌더라도 예외를 던져서는 안 됩니다. 그러나 이 요구 사항은 강제되지 않습니다.

Disposable 객체를 using 또는 await using 선언과 함께 사용하는 경우 선언을 직접 포함하는 Block 또는 Module의 평가가 완료되면 리소스가 자동으로 폐기됩니다.

27.2.1.2 AsyncDisposable 인터페이스

AsyncDisposable 인터페이스에는 표 88에 설명된 프로퍼티가 포함됩니다:

표 88: AsyncDisposable 인터페이스 필수 프로퍼티

프로퍼티 값 요구 사항

%Symbol.asyncDispose%

a function object that returns a promise

이 메서드를 호출하면 호출자가 이 객체를 계속 사용할 의도가 없음을 AsyncDisposable 객체에 알립니다. 이 메서드는 파일 시스템 핸들, 스트림, 호스트 객체 등을 포함하되 이에 국한되지 않는 리소스의 명시적 정리에 필요한 모든 로직을 수행해야 합니다. 이 메서드가 반환한 promise가 거부되면 일반적으로 리소스를 명시적으로 해제할 수 없었음을 의미합니다. 결과 Promise가 이행될 때까지 AsyncDisposable 객체는 “폐기된” 것으로 간주되지 않습니다.

같은 객체에서 이 메서드를 두 번 이상 호출하는 경우 이미 폐기된 리소스에 대한 정리 로직을 반복하지 않아야 하며, 첫 번째 호출에서 예외가 던져지거나 거부된 promise가 반환되었더라도 예외를 던지거나 거부된 promise를 반환해서는 안 됩니다. 그러나 이 요구 사항은 강제되지 않습니다.

AsyncDisposable 객체를 await using 선언과 함께 사용하는 경우 선언을 직접 포함하는 Block 또는 Module의 평가가 완료되면 리소스가 자동으로 폐기됩니다.

27.3 DisposableStack 객체

DisposableStack은 함께 폐기해야 하는 하나 이상의 리소스를 포함하는 데 사용할 수 있는 객체입니다.

모든 DisposableStack 객체는 서로 배타적인 두 상태 중 하나에 있습니다: disposed 또는 pending. disposable stack d에 대해 d.dispose()와 d.move() 어느 것도 호출되지 않은 경우에만 d는 pending입니다.

27.3.1 DisposableStack 생성자

DisposableStack 생성자는:

%DisposableStack%입니다.
전역 객체의 "DisposableStack" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 DisposableStack을 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 DisposableStack 동작을 상속하려는 하위 클래스 생성자는 DisposableStack.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태로 하위 클래스 인스턴스를 생성하고 초기화하기 위해 DisposableStack 생성자에 대한 super 호출을 포함해야 합니다.

27.3.1.1 DisposableStack ( )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
disposableStack을 ? OrdinaryCreateFromConstructor(NewTarget, "%DisposableStack.prototype%", « [[DisposableState]], [[DisposableResourceStack]] »)로 둡니다.
disposableStack.[[DisposableState]]를 pending으로 설정합니다.
disposableStack.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
disposableStack을 반환합니다.

27.3.2 DisposableStack 생성자의 프로퍼티

DisposableStack 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

27.3.2.1 DisposableStack.prototype

DisposableStack.prototype의 초기 값은 DisposableStack 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.3.3 DisposableStack 프로토타입 객체의 프로퍼티

DisposableStack 프로토타입 객체는:

%DisposableStack.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[DisposableState]] 내부 슬롯 또는 DisposableStack 인스턴스의 다른 내부 슬롯을 갖지 않습니다.

27.3.3.1 DisposableStack.prototype.adopt ( `value`, `onDispose` )

이 메서드는 호출되면 다음 단계를 수행합니다:

disposableStack을 this 값으로 둡니다.
? RequireInternalSlot(disposableStack, [[DisposableState]])를 수행합니다.
disposableStack.[[DisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
IsCallable(onDispose)이 false이면 TypeError 예외를 던집니다.
closure를 매개변수가 없고 value와 onDispose를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. ? Call(onDispose, undefined, « value »)를 반환합니다.
func를 CreateBuiltinFunction(closure, 0, "", « »)로 둡니다.
? AddDisposableResource(disposableStack.[[DisposableResourceStack]], undefined, sync-dispose, func)를 수행합니다.
value를 반환합니다.

27.3.3.2 DisposableStack.prototype.constructor

DisposableStack.prototype.constructor의 초기 값은 %DisposableStack%입니다.

27.3.3.3 DisposableStack.prototype.defer ( `onDispose` )

이 메서드는 호출되면 다음 단계를 수행합니다:

disposableStack을 this 값으로 둡니다.
? RequireInternalSlot(disposableStack, [[DisposableState]])를 수행합니다.
disposableStack.[[DisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
IsCallable(onDispose)이 false이면 TypeError 예외를 던집니다.
? AddDisposableResource(disposableStack.[[DisposableResourceStack]], undefined, sync-dispose, onDispose)를 수행합니다.
undefined를 반환합니다.

27.3.3.4 DisposableStack.prototype.dispose ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

disposableStack을 this 값으로 둡니다.
? RequireInternalSlot(disposableStack, [[DisposableState]])를 수행합니다.
disposableStack.[[DisposableState]]가 disposed이면 undefined를 반환합니다.
disposableStack.[[DisposableState]]를 disposed로 설정합니다.
? DisposeResources(disposableStack.[[DisposableResourceStack]], NormalCompletion(undefined))를 반환합니다.

27.3.3.5 get DisposableStack.prototype.disposed

DisposableStack.prototype.disposed는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

disposableStack을 this 값으로 둡니다.
? RequireInternalSlot(disposableStack, [[DisposableState]])를 수행합니다.
disposableStack.[[DisposableState]]가 disposed이면 true를 반환합니다.
false를 반환합니다.

27.3.3.6 DisposableStack.prototype.move ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

disposableStack을 this 값으로 둡니다.
? RequireInternalSlot(disposableStack, [[DisposableState]])를 수행합니다.
disposableStack.[[DisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
newDisposableStack을 ? OrdinaryCreateFromConstructor(%DisposableStack%, "%DisposableStack.prototype%", « [[DisposableState]], [[DisposableResourceStack]] »)로 둡니다.
newDisposableStack.[[DisposableState]]를 pending으로 설정합니다.
newDisposableStack.[[DisposableResourceStack]]을 disposableStack.[[DisposableResourceStack]]으로 설정합니다.
disposableStack.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
disposableStack.[[DisposableState]]를 disposed로 설정합니다.
newDisposableStack을 반환합니다.

27.3.3.7 DisposableStack.prototype.use ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

disposableStack을 this 값으로 둡니다.
? RequireInternalSlot(disposableStack, [[DisposableState]])를 수행합니다.
disposableStack.[[DisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
? AddDisposableResource(disposableStack.[[DisposableResourceStack]], value, sync-dispose)를 수행합니다.
value를 반환합니다.

27.3.3.8 DisposableStack.prototype [ %Symbol.dispose% ] ( )

%Symbol.dispose% 프로퍼티의 초기 값은 27.3.3.4에 정의된 %DisposableStack.prototype.dispose%입니다.

27.3.3.9 DisposableStack.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "DisposableStack"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.3.4 DisposableStack 인스턴스의 프로퍼티

DisposableStack 인스턴스는 DisposableStack 프로토타입 객체(내재 %DisposableStack.prototype%)에서 프로퍼티를 상속하는 일반 객체입니다. DisposableStack 인스턴스는 처음에 표 89에 설명된 내부 슬롯과 함께 생성됩니다.

표 89: DisposableStack 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[DisposableState]]`	pending or disposed	disposable stack이 `%Symbol.dispose%` 메서드에 대한 들어오는 호출에 어떻게 반응할지를 제어합니다.
`[[DisposableResourceStack]]`	a List of DisposableResource Records	disposable stack이 폐기될 때 폐기해야 하는 리소스입니다. 리소스는 초기화되는 순서로 추가되며 역순으로 폐기됩니다.

27.4 AsyncDisposableStack 객체

AsyncDisposableStack은 함께 비동기적으로 폐기해야 하는 하나 이상의 리소스를 포함하는 데 사용할 수 있는 객체입니다.

모든 AsyncDisposableStack 객체는 서로 배타적인 두 상태 중 하나에 있습니다: disposed 또는 pending. async-disposable stack d에 대해 d.disposeAsync()와 d.move() 어느 것도 호출되지 않은 경우에만 d는 pending입니다.

27.4.1 AsyncDisposableStack 생성자

AsyncDisposableStack 생성자는:

%AsyncDisposableStack%입니다.
전역 객체의 "AsyncDisposableStack" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 AsyncDisposableStack을 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 AsyncDisposableStack 동작을 상속하려는 하위 클래스 생성자는 AsyncDisposableStack.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태로 하위 클래스 인스턴스를 생성하고 초기화하기 위해 AsyncDisposableStack 생성자에 대한 super 호출을 포함해야 합니다.

27.4.1.1 AsyncDisposableStack ( )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
asyncDisposableStack을 ? OrdinaryCreateFromConstructor(NewTarget, "%AsyncDisposableStack.prototype%", « [[AsyncDisposableState]], [[DisposableResourceStack]] »)로 둡니다.
asyncDisposableStack.[[AsyncDisposableState]]를 pending으로 설정합니다.
asyncDisposableStack.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
asyncDisposableStack을 반환합니다.

27.4.2 AsyncDisposableStack 생성자의 프로퍼티

AsyncDisposableStack 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

27.4.2.1 AsyncDisposableStack.prototype

AsyncDisposableStack.prototype의 초기 값은 AsyncDisposableStack 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.4.3 AsyncDisposableStack 프로토타입 객체의 프로퍼티

AsyncDisposableStack 프로토타입 객체는:

%AsyncDisposableStack.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[AsyncDisposableState]] 내부 슬롯 또는 AsyncDisposableStack 인스턴스의 다른 내부 슬롯을 갖지 않습니다.

27.4.3.1 AsyncDisposableStack.prototype.adopt ( `value`, `onDisposeAsync` )

이 메서드는 호출되면 다음 단계를 수행합니다:

asyncDisposableStack을 this 값으로 둡니다.
? RequireInternalSlot(asyncDisposableStack, [[AsyncDisposableState]])를 수행합니다.
asyncDisposableStack.[[AsyncDisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
IsCallable(onDisposeAsync)가 false이면 TypeError 예외를 던집니다.
closure를 매개변수가 없고 value와 onDisposeAsync를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. ? Call(onDisposeAsync, undefined, « value »)를 반환합니다.
func를 CreateBuiltinFunction(closure, 0, "", « »)로 둡니다.
? AddDisposableResource(asyncDisposableStack.[[DisposableResourceStack]], undefined, async-dispose, func)를 수행합니다.
value를 반환합니다.

27.4.3.2 AsyncDisposableStack.prototype.constructor

AsyncDisposableStack.prototype.constructor의 초기 값은 %AsyncDisposableStack%입니다.

27.4.3.3 AsyncDisposableStack.prototype.defer ( `onDisposeAsync` )

이 메서드는 호출되면 다음 단계를 수행합니다:

asyncDisposableStack을 this 값으로 둡니다.
? RequireInternalSlot(asyncDisposableStack, [[AsyncDisposableState]])를 수행합니다.
asyncDisposableStack.[[AsyncDisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
IsCallable(onDisposeAsync)가 false이면 TypeError 예외를 던집니다.
? AddDisposableResource(asyncDisposableStack.[[DisposableResourceStack]], undefined, async-dispose, onDisposeAsync)를 수행합니다.
undefined를 반환합니다.

27.4.3.4 AsyncDisposableStack.prototype.disposeAsync ( )

이 async 메서드는 호출되면 다음 단계를 수행합니다:

asyncDisposableStack을 this 값으로 둡니다.
? RequireInternalSlot(asyncDisposableStack, [[AsyncDisposableState]])를 수행합니다.
asyncDisposableStack.[[AsyncDisposableState]]가 disposed이면 undefined를 반환합니다.
asyncDisposableStack.[[AsyncDisposableState]]를 disposed로 설정합니다.
? DisposeResources(asyncDisposableStack.[[DisposableResourceStack]], NormalCompletion(undefined))를 반환합니다.

27.4.3.5 get AsyncDisposableStack.prototype.disposed

AsyncDisposableStack.prototype.disposed는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

asyncDisposableStack을 this 값으로 둡니다.
? RequireInternalSlot(asyncDisposableStack, [[AsyncDisposableState]])를 수행합니다.
asyncDisposableStack.[[AsyncDisposableState]]가 disposed이면 true를 반환합니다.
false를 반환합니다.

27.4.3.6 AsyncDisposableStack.prototype.move ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

asyncDisposableStack을 this 값으로 둡니다.
? RequireInternalSlot(asyncDisposableStack, [[AsyncDisposableState]])를 수행합니다.
asyncDisposableStack.[[AsyncDisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
newAsyncDisposableStack을 ? OrdinaryCreateFromConstructor(%AsyncDisposableStack%, "%AsyncDisposableStack.prototype%", « [[AsyncDisposableState]], [[DisposableResourceStack]] »)로 둡니다.
newAsyncDisposableStack.[[AsyncDisposableState]]를 pending으로 설정합니다.
newAsyncDisposableStack.[[DisposableResourceStack]]을 asyncDisposableStack.[[DisposableResourceStack]]으로 설정합니다.
asyncDisposableStack.[[DisposableResourceStack]]을 새로운 빈 List로 설정합니다.
asyncDisposableStack.[[AsyncDisposableState]]를 disposed로 설정합니다.
newAsyncDisposableStack을 반환합니다.

27.4.3.7 AsyncDisposableStack.prototype.use ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

asyncDisposableStack을 this 값으로 둡니다.
? RequireInternalSlot(asyncDisposableStack, [[AsyncDisposableState]])를 수행합니다.
asyncDisposableStack.[[AsyncDisposableState]]가 disposed이면 ReferenceError 예외를 던집니다.
? AddDisposableResource(asyncDisposableStack.[[DisposableResourceStack]], value, async-dispose)를 수행합니다.
value를 반환합니다.

27.4.3.8 AsyncDisposableStack.prototype [ %Symbol.asyncDispose% ] ( )

%Symbol.asyncDispose% 프로퍼티의 초기 값은 27.4.3.4에 정의된 %AsyncDisposableStack.prototype.disposeAsync%입니다.

27.4.3.9 AsyncDisposableStack.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "AsyncDisposableStack"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.4.4 AsyncDisposableStack 인스턴스의 프로퍼티

AsyncDisposableStack 인스턴스는 AsyncDisposableStack 프로토타입 객체(내재 %AsyncDisposableStack.prototype%)에서 프로퍼티를 상속하는 일반 객체입니다. AsyncDisposableStack 인스턴스는 처음에 표 90에 설명된 내부 슬롯과 함께 생성됩니다.

표 90: AsyncDisposableStack 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[AsyncDisposableState]]`	pending or disposed	disposable stack이 `%Symbol.asyncDispose%` 메서드에 대한 들어오는 호출에 어떻게 반응할지를 제어합니다.
`[[DisposableResourceStack]]`	a List of DisposableResource Records	disposable stack이 폐기될 때 폐기해야 하는 리소스입니다. 리소스는 초기화되는 순서로 추가되며 역순으로 폐기됩니다.

27.5 Promise 객체

Promise는 지연된(그리고 비동기일 수 있는) 계산의 최종 결과를 위한 자리 표시자로 사용되는 객체입니다.

모든 Promise는 서로 배타적인 세 상태 중 하나에 있습니다: fulfilled, rejected, pending:

promise p에 대해 p.then(f, r)이 함수 f를 호출하는 Job을 즉시 큐에 넣는다면 p는 fulfilled입니다.
promise p에 대해 p.then(f, r)이 함수 r을 호출하는 Job을 즉시 큐에 넣는다면 p는 rejected입니다.
promise가 fulfilled도 rejected도 아니면 pending입니다.

promise가 pending이 아니면, 즉 fulfilled 또는 rejected이면 settled되었다고 합니다.

promise가 settled되었거나 다른 promise의 상태와 일치하도록 “고정”된 경우 resolved되었다고 합니다. resolved promise를 다시 resolve하거나 reject하려고 해도 아무 효과가 없습니다. promise가 resolved되지 않았다면 unresolved입니다. unresolved promise는 항상 pending 상태입니다. resolved promise는 pending, fulfilled 또는 rejected일 수 있습니다.

thenable은 Get(obj, "then")이 function object를 반환하는 객체 obj입니다.

27.5.1 Promise 추상 연산

27.5.1.1 PromiseCapability Records

PromiseCapability Record는 Promise 또는 promise와 유사한 객체와 함께 해당 promise를 resolve하거나 reject할 수 있는 함수를 캡슐화하는 데 사용되는 Record입니다. PromiseCapability Records는 NewPromiseCapability 추상 연산에 의해 생성됩니다.

PromiseCapability Records에는 표 91에 나열된 필드가 있습니다.

표 91: PromiseCapability Record 필드

필드 이름	값	의미
`[[Promise]]`	an Object	promise로 사용할 수 있는 객체입니다.
`[[Resolve]]`	a function object	주어진 promise를 resolve하는 데 사용되는 함수입니다.
`[[Reject]]`	a function object	주어진 promise를 reject하는 데 사용되는 함수입니다.

27.5.1.1.1 IfAbruptRejectPromise ( `value`, `capability` )

IfAbruptRejectPromise는 PromiseCapability Record를 사용하는 일련의 알고리즘 단계에 대한 축약 표현입니다. 다음 형식의 알고리즘 단계:

IfAbruptRejectPromise(value, capability).

는 다음과 같은 의미입니다:

단언: value는 Completion Record입니다.
value가 abrupt completion이면, 다음을 수행합니다.
1. ? Call(capability.[[Reject]], undefined, « value.[[Value]] »)를 수행합니다.
2. capability.[[Promise]]를 반환합니다.
value를 ! value로 설정합니다.

27.5.1.2 PromiseReaction Records

PromiseReaction Record는 promise가 주어진 값으로 resolve되거나 reject될 때 어떻게 반응해야 하는지에 대한 정보를 저장하는 데 사용되는 Record입니다. PromiseReaction Records는 PerformPromiseThen 추상 연산에 의해 생성되며 NewPromiseReactionJob이 반환하는 Abstract Closure에서 사용됩니다.

PromiseReaction Records에는 표 92에 나열된 필드가 있습니다.

표 92: PromiseReaction Record 필드

필드 이름	값	의미
`[[Capability]]`	a PromiseCapability Record or undefined	이 Record가 reaction handler를 제공하는 promise의 capability입니다.
`[[Type]]`	fulfill or reject	`[[Handler]]`가 empty일 때 settlement type에 특화된 동작을 허용하기 위해 `[[Type]]`을 사용합니다.
`[[Handler]]`	a JobCallback Record or empty	들어오는 값에 적용해야 하는 함수이며 그 반환 값에 따라 파생 promise에 어떤 일이 발생할지가 결정됩니다. `[[Handler]]`가 empty이면 대신 `[[Type]]` 값에 따라 달라지는 함수를 사용합니다.

27.5.1.3 CreateResolvingFunctions ( `toResolve` )

추상 연산 CreateResolvingFunctions. 인수 toResolve (Promise). 반환값: 레코드 (필드: [[Resolve]] (함수 객체), [[Reject]] (함수 객체)). 호출되면 다음 단계를 수행한다.

promiseOrEmpty를 Record { [[Value]]: toResolve }로 둡니다.
resolveSteps를 매개변수 (resolution)을 가지며 promiseOrEmpty를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. promiseOrEmpty.[[Value]]가 empty이면 undefined를 반환합니다.
2. promise를 promiseOrEmpty.[[Value]]로 둡니다.
3. promiseOrEmpty.[[Value]]를 empty로 설정합니다.
4. SameValue(resolution, promise)가 true이면, 다음을 수행합니다.
  1. selfResolutionError를 새로 생성된 TypeError 객체로 둡니다.
  2. RejectPromise(promise, selfResolutionError)를 수행합니다.
  3. undefined를 반환합니다.
5. resolution이 Object가 아니면, 다음을 수행합니다.
  1. FulfillPromise(promise, resolution)을 수행합니다.
  2. undefined를 반환합니다.
6. then을 Completion(Get(resolution, "then"))으로 둡니다.
7. then이 abrupt completion이면, 다음을 수행합니다.
  1. RejectPromise(promise, then.[[Value]])를 수행합니다.
  2. undefined를 반환합니다.
8. thenAction을 then.[[Value]]로 둡니다.
9. IsCallable(thenAction)이 false이면, 다음을 수행합니다.
  1. FulfillPromise(promise, resolution)을 수행합니다.
  2. undefined를 반환합니다.
10. thenJobCallback을 HostMakeJobCallback(thenAction)으로 둡니다.
11. job을 NewPromiseResolveThenableJob(promise, resolution, thenJobCallback)으로 둡니다.
12. HostEnqueuePromiseJob(job.[[Job]], job.[[Realm]])을 수행합니다.
13. undefined를 반환합니다.
resolve를 CreateBuiltinFunction(resolveSteps, 1, "", « »)로 둡니다.
rejectSteps를 매개변수 (reason)을 가지며 promiseOrEmpty를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. promiseOrEmpty.[[Value]]가 empty이면 undefined를 반환합니다.
2. promise를 promiseOrEmpty.[[Value]]로 둡니다.
3. promiseOrEmpty.[[Value]]를 empty로 설정합니다.
4. RejectPromise(promise, reason)을 수행합니다.
5. undefined를 반환합니다.
reject를 CreateBuiltinFunction(rejectSteps, 1, "", « »)로 둡니다.
Record { [[Resolve]]: resolve, [[Reject]]: reject }를 반환합니다.

27.5.1.4 FulfillPromise ( `promise`, `value` )

추상 연산 FulfillPromise. 인수 promise (Promise) 및 value (ECMAScript 언어 값). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: promise.[[PromiseState]]는 pending입니다.
reactions를 promise.[[PromiseFulfillReactions]]로 둡니다.
promise.[[PromiseResult]]를 value로 설정합니다.
promise.[[PromiseFulfillReactions]]를 undefined로 설정합니다.
promise.[[PromiseRejectReactions]]를 undefined로 설정합니다.
promise.[[PromiseState]]를 fulfilled로 설정합니다.
TriggerPromiseReactions(reactions, value)를 수행합니다.
unused를 반환합니다.

27.5.1.5 NewPromiseCapability ( `ctor` )

추상 연산 NewPromiseCapability. 인수 ctor (ECMAScript 언어 값). 반환값: (정상 완료 (값: PromiseCapability 레코드) 또는 throw 완료). 내장 Promise 생성자와 같은 방식으로 ctor를 생성자로 사용하여 promise를 생성하고 그 resolve 및 reject 함수를 추출하려고 시도합니다. promise와 resolve, reject 함수는 새로운 PromiseCapability Record를 초기화하는 데 사용됩니다. 호출되면 다음 단계를 수행한다.

IsConstructor(ctor)가 false이면 TypeError 예외를 던집니다.
참고: ctor는 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수라고 가정합니다(27.5.3.1 참조).
resolvingFuncs를 Record { [[Resolve]]: undefined, [[Reject]]: undefined }로 둡니다.
executorClosure를 매개변수 (resolve, reject)를 가지며 resolvingFuncs를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. resolvingFuncs.[[Resolve]]가 undefined가 아니면 TypeError 예외를 던집니다.
2. resolvingFuncs.[[Reject]]가 undefined가 아니면 TypeError 예외를 던집니다.
3. resolvingFuncs.[[Resolve]]를 resolve로 설정합니다.
4. resolvingFuncs.[[Reject]]를 reject로 설정합니다.
5. NormalCompletion(undefined)을 반환합니다.
executor를 CreateBuiltinFunction(executorClosure, 2, "", « »)로 둡니다.
promise를 ? Construct(ctor, « executor »)로 둡니다.
IsCallable(resolvingFuncs.[[Resolve]])가 false이면 TypeError 예외를 던집니다.
IsCallable(resolvingFuncs.[[Reject]])가 false이면 TypeError 예외를 던집니다.
PromiseCapability Record { [[Promise]]: promise, [[Resolve]]: resolvingFuncs.[[Resolve]], [[Reject]]: resolvingFuncs.[[Reject]] }를 반환합니다.

참고

이 추상 연산은 전달된 executor 함수 인수를 Promise 생성자와 같은 방식으로 호출하는 모든 생성자에 대해 일반적으로 동작하므로 Promise 하위 클래싱을 지원합니다. Promise 생성자의 정적 메서드를 모든 하위 클래스로 일반화하는 데 사용됩니다.

27.5.1.6 IsPromise ( `arg` )

추상 연산 IsPromise. 인수 arg (ECMAScript 언어 값). 반환값: Boolean. 객체에 promise 브랜드가 있는지 검사합니다. 호출되면 다음 단계를 수행한다.

arg가 Object가 아니면 false를 반환합니다.
arg에 [[PromiseState]] 내부 슬롯이 없으면 false를 반환합니다.
true를 반환합니다.

27.5.1.7 RejectPromise ( `promise`, `reason` )

추상 연산 RejectPromise. 인수 promise (Promise) 및 reason (ECMAScript 언어 값). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: promise.[[PromiseState]]는 pending입니다.
reactions를 promise.[[PromiseRejectReactions]]로 둡니다.
promise.[[PromiseResult]]를 reason으로 설정합니다.
promise.[[PromiseFulfillReactions]]를 undefined로 설정합니다.
promise.[[PromiseRejectReactions]]를 undefined로 설정합니다.
promise.[[PromiseState]]를 rejected로 설정합니다.
promise.[[PromiseIsHandled]]가 false이면 HostPromiseRejectionTracker(promise, "reject")를 수행합니다.
TriggerPromiseReactions(reactions, reason)을 수행합니다.
unused를 반환합니다.

27.5.1.8 TriggerPromiseReactions ( `reactions`, `arg` )

추상 연산 TriggerPromiseReactions. 인수 reactions (리스트 (요소: PromiseReaction 레코드)) 및 arg (ECMAScript 언어 값). 반환값: unused. reactions의 각 Record에 대해 새로운 Job을 큐에 넣습니다. 각 Job은 PromiseReaction Record의 [[Type]] 및 [[Handler]]를 처리하고, [[Handler]]가 empty가 아니면 주어진 인수를 전달하여 호출합니다. [[Handler]]가 empty이면 동작은 [[Type]]에 의해 결정됩니다. 호출되면 다음 단계를 수행한다.

reactions의 각 요소 reaction에 대해 다음을 수행합니다.
1. job을 NewPromiseReactionJob(reaction, arg)으로 둡니다.
2. HostEnqueuePromiseJob(job.[[Job]], job.[[Realm]])을 수행합니다.
unused를 반환합니다.

27.5.1.9 HostPromiseRejectionTracker ( `promise`, `operation` )

호스트 정의 추상 연산 HostPromiseRejectionTracker. 인수 promise (Promise) 및 operation (("reject" 또는 "handle")). 반환값: unused. 호스트 환경이 promise rejection을 추적할 수 있도록 합니다.

HostPromiseRejectionTracker의 기본 구현은 unused를 반환하는 것입니다.

참고 1

HostPromiseRejectionTracker는 두 가지 상황에서 호출됩니다:

promise가 handler 없이 reject되면 operation 인수를 "reject"로 설정하여 호출합니다.
reject된 promise에 처음으로 handler가 추가되면 operation 인수를 "handle"로 설정하여 호출합니다.

일반적인 HostPromiseRejectionTracker 구현은 처리되지 않은 rejection을 개발자에게 알리려고 하면서도, 나중에 새로운 handler가 연결되어 이전 알림이 더 이상 유효하지 않게 된 경우에도 이를 알리도록 주의할 수 있습니다.

참고 2

operation이 "handle"이면 구현체는 가비지 컬렉션을 방해하는 방식으로 promise에 대한 참조를 유지해서는 안 됩니다. operation이 "reject"이면 rejection은 드물고 핫 코드 경로에 있지 않을 것으로 예상되므로 구현체는 promise에 대한 참조를 유지할 수 있습니다.

27.5.2 Promise 작업

27.5.2.1 NewPromiseReactionJob ( `reaction`, `arg` )

추상 연산 NewPromiseReactionJob. 인수 reaction (PromiseReaction 레코드) 및 arg (ECMAScript 언어 값). 반환값: 레코드 (필드: [[Job]] (a Job Abstract Closure), [[Realm]] ((Realm 레코드 또는 null))). 들어오는 값에 적절한 handler를 적용하고 handler의 반환 값을 사용하여 해당 handler와 연결된 파생 promise를 resolve하거나 reject하는 새로운 Job Abstract Closure를 반환합니다. 호출되면 다음 단계를 수행한다.

job을 매개변수가 없고 reaction과 arg를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Job Abstract Closure로 둡니다:
1. promiseCapability을 reaction.[[Capability]]로 둡니다.
2. type을 reaction.[[Type]]으로 둡니다.
3. handler를 reaction.[[Handler]]로 둡니다.
4. handler가 empty이면, 다음을 수행합니다.
  1. type이 fulfill이면, 다음을 수행합니다.
    1. handlerResult를 NormalCompletion(arg)으로 둡니다.
  2. 그렇지 않으면,
    1. 단언: type은 reject입니다.
    2. handlerResult를 ThrowCompletion(arg)으로 둡니다.
5. 그렇지 않으면,
  1. handlerResult를 Completion(HostCallJobCallback(handler, undefined, « arg »))으로 둡니다.
6. promiseCapability이 undefined이면, 다음을 수행합니다.
  1. 단언: handlerResult는 abrupt completion이 아닙니다.
  2. empty를 반환합니다.
7. 단언: promiseCapability은 PromiseCapability Record입니다.
8. handlerResult가 abrupt completion이면, 다음을 수행합니다.
  1. ? Call(promiseCapability.[[Reject]], undefined, « handlerResult.[[Value]] »)를 반환합니다.
9. ? Call(promiseCapability.[[Resolve]], undefined, « handlerResult.[[Value]] »)를 반환합니다.
handlerRealm을 null로 둡니다.
reaction.[[Handler]]가 empty가 아니면, 다음을 수행합니다.
1. getHandlerRealmResult를 Completion(GetFunctionRealm(reaction.[[Handler]].[[Callback]]))으로 둡니다.
2. getHandlerRealmResult가 normal completion이면 handlerRealm을 getHandlerRealmResult.[[Value]]로 설정합니다.
3. 그렇지 않으면 handlerRealm을 현재 Realm Record로 설정합니다.
4. 참고: handler가 undefined인 경우를 제외하면 handlerRealm은 절대 null이 아닙니다. handler가 폐기된 Proxy이고 ECMAScript 코드가 실행되지 않는 경우 handlerRealm은 오류 객체를 생성하는 데 사용됩니다.
Record { [[Job]]: job, [[Realm]]: handlerRealm }를 반환합니다.

27.5.2.2 NewPromiseResolveThenableJob ( `promiseToResolve`, `thenable`, `then` )

추상 연산 NewPromiseResolveThenableJob. 인수 promiseToResolve (Promise), thenable (Object) 및 then (JobCallback 레코드). 반환값: 레코드 (필드: [[Job]] (a Job Abstract Closure), [[Realm]] (Realm 레코드)). 호출되면 다음 단계를 수행한다.

job을 매개변수가 없고 promiseToResolve, thenable, then을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Job Abstract Closure로 둡니다:
1. resolvingFuncs를 CreateResolvingFunctions(promiseToResolve)로 둡니다.
2. thenCallResult를 Completion(HostCallJobCallback(then, thenable, « resolvingFuncs.[[Resolve]], resolvingFuncs.[[Reject]] »))으로 둡니다.
3. thenCallResult가 abrupt completion이면, 다음을 수행합니다.
  1. ? Call(resolvingFuncs.[[Reject]], undefined, « thenCallResult.[[Value]] »)를 반환합니다.
4. ! thenCallResult를 반환합니다.
getThenRealmResult를 Completion(GetFunctionRealm(then.[[Callback]]))으로 둡니다.
getThenRealmResult가 normal completion이면 thenRealm을 getThenRealmResult.[[Value]]로 둡니다.
그렇지 않으면 thenRealm을 현재 Realm Record로 둡니다.
참고: thenRealm은 절대 null이 아닙니다. then.[[Callback]]이 폐기된 Proxy이고 코드가 실행되지 않는 경우 thenRealm은 오류 객체를 생성하는 데 사용됩니다.
Record { [[Job]]: job, [[Realm]]: thenRealm }를 반환합니다.

참고

이 Job은 제공된 thenable과 그 then 메서드를 사용하여 주어진 promise를 resolve합니다. then 메서드의 평가가 주변 코드의 평가가 완료된 후에 발생하도록 보장하기 위해 이 과정은 Job으로 수행되어야 합니다.

27.5.3 Promise 생성자

Promise 생성자는:

%Promise%입니다.
전역 객체의 "Promise" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 Promise를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.
클래스 정의의 extends 절에서 값으로 사용할 수 있습니다. 지정된 Promise 동작을 상속하려는 하위 클래스 생성자는 Promise 및 Promise.prototype의 내장 메서드를 지원하는 데 필요한 내부 상태로 하위 클래스 인스턴스를 생성하고 초기화하기 위해 Promise 생성자에 대한 super 호출을 포함해야 합니다.

27.5.3.1 Promise ( `executor` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
IsCallable(executor)이 false이면 TypeError 예외를 던집니다.
promise를 ? OrdinaryCreateFromConstructor(NewTarget, "%Promise.prototype%", « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] »)로 둡니다.
promise.[[PromiseState]]를 pending으로 설정합니다.
promise.[[PromiseResult]]를 empty로 설정합니다.
promise.[[PromiseFulfillReactions]]를 새로운 빈 List로 설정합니다.
promise.[[PromiseRejectReactions]]를 새로운 빈 List로 설정합니다.
promise.[[PromiseIsHandled]]를 false로 설정합니다.
resolvingFuncs를 CreateResolvingFunctions(promise)로 둡니다.
completion을 Completion(Call(executor, undefined, « resolvingFuncs.[[Resolve]], resolvingFuncs.[[Reject]] »))으로 둡니다.
completion이 abrupt completion이면, 다음을 수행합니다.
1. ? Call(resolvingFuncs.[[Reject]], undefined, « completion.[[Value]] »)를 수행합니다.
promise를 반환합니다.

참고

executor 인수는 function object여야 합니다. 이 Promise가 나타내는 지연될 수 있는 동작의 시작과 완료를 보고하기 위해 호출됩니다. executor는 두 인수 resolve와 reject로 호출됩니다. 이 함수들은 executor 함수가 지연된 계산의 최종 완료 또는 실패를 보고하는 데 사용할 수 있습니다. executor 함수에서 반환한다고 해서 지연된 동작이 완료되었다는 의미는 아니며, 단지 지연된 동작을 최종적으로 수행하라는 요청이 수락되었다는 의미입니다.

executor 함수에 전달되는 resolve 함수는 하나의 인수를 받습니다. executor 코드는 연결된 Promise를 resolve하려 함을 나타내기 위해 최종적으로 resolve 함수를 호출할 수 있습니다. resolve 함수에 전달되는 인수는 지연된 동작의 최종 값을 나타내며 실제 이행 값이거나, 이행되면 값을 제공할 다른 promise일 수 있습니다.

executor 함수에 전달되는 reject 함수는 하나의 인수를 받습니다. executor 코드는 연결된 Promise가 reject되었고 절대 fulfilled되지 않을 것임을 나타내기 위해 최종적으로 reject 함수를 호출할 수 있습니다. reject 함수에 전달되는 인수는 promise의 rejection 값으로 사용됩니다. 일반적으로 Error 객체입니다.

Promise 생성자가 executor 함수에 전달하는 resolve 및 reject 함수는 연결된 promise를 실제로 resolve하고 reject할 수 있습니다. 하위 클래스는 resolve 및 reject에 사용자 정의 값을 전달하는 다른 생성자 동작을 가질 수 있습니다.

27.5.4 Promise 생성자의 프로퍼티

Promise 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
다음 프로퍼티를 갖습니다:

27.5.4.1 Promise.all ( `iterable` )

이 함수는 전달된 promise들의 이행 값 배열로 fulfilled되는 새로운 promise를 반환하거나, 처음 reject된 전달 promise의 이유로 reject됩니다. 이 알고리즘을 실행하면서 전달된 iterable의 모든 요소를 promise로 resolve합니다.

ctor를 this 값으로 둡니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
promiseResolve를 Completion(GetPromiseResolve(ctor))으로 둡니다.
IfAbruptRejectPromise(promiseResolve, promiseCapability).
iteratorRecord를 Completion(GetIterator(iterable, sync))으로 둡니다.
IfAbruptRejectPromise(iteratorRecord, promiseCapability).
result를 Completion(PerformPromiseAll(iteratorRecord, ctor, promiseCapability, promiseResolve))으로 둡니다.
result가 abrupt completion이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]이 false이면 result를 Completion(IteratorClose(iteratorRecord, result))으로 설정합니다.
2. IfAbruptRejectPromise(result, promiseCapability).
! result를 반환합니다.

참고

이 함수의 this 값은 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수여야 합니다.

27.5.4.1.1 GetPromiseResolve ( `promiseCtor` )

추상 연산 GetPromiseResolve. 인수 promiseCtor (생성자). 반환값: (정상 완료 (값: 함수 객체) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

promiseResolve를 ? Get(promiseCtor, "resolve")로 둡니다.
IsCallable(promiseResolve)가 false이면 TypeError 예외를 던집니다.
promiseResolve를 반환합니다.

27.5.4.1.2 PerformPromiseAll ( `iteratorRecord`, `ctor`, `resultCapability`, `promiseResolve` )

추상 연산 PerformPromiseAll. 인수 iteratorRecord (Iterator 레코드), ctor (생성자), resultCapability (PromiseCapability 레코드) 및 promiseResolve (함수 객체). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

values를 새로운 빈 List로 둡니다.
참고: 입력 iterator가 소진되기 전에 전달된 콜백을 호출하는 잘못 동작하는 "then"이 존재하더라도 resultCapability.[[Resolve]]가 한 번만 호출되도록 remainingElementsCount는 0이 아니라 1에서 시작합니다.
remainingElementsCount를 Record { [[Value]]: 1 }로 둡니다.
index를 0으로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면, 다음을 수행합니다.
  1. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  2. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. valuesArray를 CreateArrayFromList(values)로 둡니다.
    2. ? Call(resultCapability.[[Resolve]], undefined, « valuesArray »)를 수행합니다.
  3. resultCapability.[[Promise]]를 반환합니다.
3. undefined를 values에 추가합니다.
4. nextPromise를 ? Call(promiseResolve, ctor, « next »)로 둡니다.
5. fulfilledSteps를 매개변수 (value)를 가지며 values, resultCapability, remainingElementsCount를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. activeFunc를 활성 함수 객체로 둡니다.
  2. activeFunc.[[AlreadyCalled]]가 true이면 undefined를 반환합니다.
  3. activeFunc.[[AlreadyCalled]]를 true로 설정합니다.
  4. thisIndex를 activeFunc.[[Index]]로 둡니다.
  5. values[thisIndex]를 value로 설정합니다.
  6. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  7. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. valuesArray를 CreateArrayFromList(values)로 둡니다.
    2. ? Call(resultCapability.[[Resolve]], undefined, « valuesArray »)를 반환합니다.
  8. undefined를 반환합니다.
6. onFulfilled를 CreateBuiltinFunction(fulfilledSteps, 1, "", « [[AlreadyCalled]], [[Index]] »)로 둡니다.
7. onFulfilled.[[AlreadyCalled]]를 false로 설정합니다.
8. onFulfilled.[[Index]]를 index로 설정합니다.
9. index를 index + 1로 설정합니다.
10. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] + 1로 설정합니다.
11. ? Invoke(nextPromise, "then", « onFulfilled, resultCapability.[[Reject]] »)를 수행합니다.

27.5.4.2 Promise.allSettled ( `iterable` )

이 함수는 원래의 모든 promise가 settled된 후, 즉 fulfilled 또는 rejected가 된 후에만 promise 상태 스냅샷의 배열로 fulfilled되는 promise를 반환합니다. 이 알고리즘을 실행하면서 전달된 iterable의 모든 요소를 promise로 resolve합니다.

ctor를 this 값으로 둡니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
promiseResolve를 Completion(GetPromiseResolve(ctor))으로 둡니다.
IfAbruptRejectPromise(promiseResolve, promiseCapability).
iteratorRecord를 Completion(GetIterator(iterable, sync))으로 둡니다.
IfAbruptRejectPromise(iteratorRecord, promiseCapability).
result를 Completion(PerformPromiseAllSettled(iteratorRecord, ctor, promiseCapability, promiseResolve))으로 둡니다.
result가 abrupt completion이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]이 false이면 result를 Completion(IteratorClose(iteratorRecord, result))으로 설정합니다.
2. IfAbruptRejectPromise(result, promiseCapability).
! result를 반환합니다.

참고

이 함수의 this 값은 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수여야 합니다.

27.5.4.2.1 PerformPromiseAllSettled ( `iteratorRecord`, `ctor`, `resultCapability`, `promiseResolve` )

추상 연산 PerformPromiseAllSettled. 인수 iteratorRecord (Iterator 레코드), ctor (생성자), resultCapability (PromiseCapability 레코드) 및 promiseResolve (함수 객체). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

values를 새로운 빈 List로 둡니다.
참고: 입력 iterator가 소진되기 전에 전달된 콜백 중 하나를 호출하는 잘못 동작하는 "then"이 존재하더라도 resultCapability.[[Resolve]]가 한 번만 호출되도록 remainingElementsCount는 0이 아니라 1에서 시작합니다.
remainingElementsCount를 Record { [[Value]]: 1 }로 둡니다.
index를 0으로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면, 다음을 수행합니다.
  1. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  2. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. valuesArray를 CreateArrayFromList(values)로 둡니다.
    2. ? Call(resultCapability.[[Resolve]], undefined, « valuesArray »)를 수행합니다.
  3. resultCapability.[[Promise]]를 반환합니다.
3. undefined를 values에 추가합니다.
4. nextPromise를 ? Call(promiseResolve, ctor, « next »)로 둡니다.
5. alreadyCalled를 Record { [[Value]]: false }로 둡니다.
6. fulfilledSteps를 매개변수 (value)를 가지며 values, resultCapability, remainingElementsCount를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. activeFunc를 활성 함수 객체로 둡니다.
  2. activeFunc.[[AlreadyCalled]].[[Value]]가 true이면 undefined를 반환합니다.
  3. activeFunc.[[AlreadyCalled]].[[Value]]를 true로 설정합니다.
  4. obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
  5. ! CreateDataPropertyOrThrow(obj, "status", "fulfilled")를 수행합니다.
  6. ! CreateDataPropertyOrThrow(obj, "value", value)를 수행합니다.
  7. thisIndex를 activeFunc.[[Index]]로 둡니다.
  8. values[thisIndex]를 obj로 설정합니다.
  9. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  10. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. valuesArray를 CreateArrayFromList(values)로 둡니다.
    2. ? Call(resultCapability.[[Resolve]], undefined, « valuesArray »)를 반환합니다.
  11. undefined를 반환합니다.
7. onFulfilled를 CreateBuiltinFunction(fulfilledSteps, 1, "", « [[AlreadyCalled]], [[Index]] »)로 둡니다.
8. onFulfilled.[[AlreadyCalled]]를 alreadyCalled로 설정합니다.
9. onFulfilled.[[Index]]를 index로 설정합니다.
10. rejectedSteps를 매개변수 (error)를 가지며 values, resultCapability, remainingElementsCount를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. activeFunc를 활성 함수 객체로 둡니다.
  2. activeFunc.[[AlreadyCalled]].[[Value]]가 true이면 undefined를 반환합니다.
  3. activeFunc.[[AlreadyCalled]].[[Value]]를 true로 설정합니다.
  4. obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
  5. ! CreateDataPropertyOrThrow(obj, "status", "rejected")를 수행합니다.
  6. ! CreateDataPropertyOrThrow(obj, "reason", error)를 수행합니다.
  7. thisIndex를 activeFunc.[[Index]]로 둡니다.
  8. values[thisIndex]를 obj로 설정합니다.
  9. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  10. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. valuesArray를 CreateArrayFromList(values)로 둡니다.
    2. ? Call(resultCapability.[[Resolve]], undefined, « valuesArray »)를 반환합니다.
  11. undefined를 반환합니다.
11. onRejected를 CreateBuiltinFunction(rejectedSteps, 1, "", « [[AlreadyCalled]], [[Index]] »)로 둡니다.
12. onRejected.[[AlreadyCalled]]를 alreadyCalled로 설정합니다.
13. onRejected.[[Index]]를 index로 설정합니다.
14. index를 index + 1로 설정합니다.
15. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] + 1로 설정합니다.
16. ? Invoke(nextPromise, "then", « onFulfilled, onRejected »)를 수행합니다.

27.5.4.3 Promise.any ( `iterable` )

이 함수는 주어진 promise 중 처음으로 fulfilled되는 promise에 의해 fulfilled되는 promise를 반환하거나, 주어진 모든 promise가 rejected되면 rejection 이유를 보유하는 AggregateError로 rejected됩니다. 이 알고리즘을 실행하면서 전달된 iterable의 모든 요소를 promise로 resolve합니다.

ctor를 this 값으로 둡니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
promiseResolve를 Completion(GetPromiseResolve(ctor))으로 둡니다.
IfAbruptRejectPromise(promiseResolve, promiseCapability).
iteratorRecord를 Completion(GetIterator(iterable, sync))으로 둡니다.
IfAbruptRejectPromise(iteratorRecord, promiseCapability).
result를 Completion(PerformPromiseAny(iteratorRecord, ctor, promiseCapability, promiseResolve))으로 둡니다.
result가 abrupt completion이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]이 false이면 result를 Completion(IteratorClose(iteratorRecord, result))으로 설정합니다.
2. IfAbruptRejectPromise(result, promiseCapability).
! result를 반환합니다.

참고

이 함수의 this 값은 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수여야 합니다.

27.5.4.3.1 PerformPromiseAny ( `iteratorRecord`, `ctor`, `resultCapability`, `promiseResolve` )

추상 연산 PerformPromiseAny. 인수 iteratorRecord (Iterator 레코드), ctor (생성자), resultCapability (PromiseCapability 레코드) 및 promiseResolve (함수 객체). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

errors를 새로운 빈 List로 둡니다.
참고: 입력 iterator가 소진되기 전에 전달된 콜백을 호출하는 잘못 동작하는 "then"이 존재하더라도 resultCapability.[[Reject]]가 한 번만 호출되도록 remainingElementsCount는 0이 아니라 1에서 시작합니다.
remainingElementsCount를 Record { [[Value]]: 1 }로 둡니다.
index를 0으로 둡니다.
다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면, 다음을 수행합니다.
  1. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  2. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. aggregateError를 새로 생성된 AggregateError 객체로 둡니다.
    2. ! DefinePropertyOrThrow(aggregateError, "errors", PropertyDescriptor { [[Configurable]]: true, [[Enumerable]]: false, [[Writable]]: true, [[Value]]: CreateArrayFromList(errors) })를 수행합니다.
    3. ? Call(resultCapability.[[Reject]], undefined, « aggregateError »)를 수행합니다.
  3. resultCapability.[[Promise]]를 반환합니다.
3. undefined를 errors에 추가합니다.
4. nextPromise를 ? Call(promiseResolve, ctor, « next »)로 둡니다.
5. rejectedSteps를 매개변수 (error)를 가지며 errors, resultCapability, remainingElementsCount를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. activeFunc를 활성 함수 객체로 둡니다.
  2. activeFunc.[[AlreadyCalled]]가 true이면 undefined를 반환합니다.
  3. activeFunc.[[AlreadyCalled]]를 true로 설정합니다.
  4. thisIndex를 activeFunc.[[Index]]로 둡니다.
  5. errors[thisIndex]를 error로 설정합니다.
  6. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] - 1로 설정합니다.
  7. remainingElementsCount.[[Value]] = 0이면, 다음을 수행합니다.
    1. aggregateError를 새로 생성된 AggregateError 객체로 둡니다.
    2. ! DefinePropertyOrThrow(aggregateError, "errors", PropertyDescriptor { [[Configurable]]: true, [[Enumerable]]: false, [[Writable]]: true, [[Value]]: CreateArrayFromList(errors) })를 수행합니다.
    3. ? Call(resultCapability.[[Reject]], undefined, « aggregateError »)를 반환합니다.
  8. undefined를 반환합니다.
6. onRejected를 CreateBuiltinFunction(rejectedSteps, 1, "", « [[AlreadyCalled]], [[Index]] »)로 둡니다.
7. onRejected.[[AlreadyCalled]]를 false로 설정합니다.
8. onRejected.[[Index]]를 index로 설정합니다.
9. index를 index + 1로 설정합니다.
10. remainingElementsCount.[[Value]]를 remainingElementsCount.[[Value]] + 1로 설정합니다.
11. ? Invoke(nextPromise, "then", « resultCapability.[[Resolve]], onRejected »)를 수행합니다.

27.5.4.4 Promise.prototype

Promise.prototype의 초기 값은 Promise 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.5.4.5 Promise.race ( `iterable` )

이 함수는 전달된 promise 중 처음 settled되는 promise와 같은 방식으로 settled되는 새로운 promise를 반환합니다. 이 알고리즘을 실행하면서 전달된 iterable의 모든 요소를 promise로 resolve합니다.

ctor를 this 값으로 둡니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
promiseResolve를 Completion(GetPromiseResolve(ctor))으로 둡니다.
IfAbruptRejectPromise(promiseResolve, promiseCapability).
iteratorRecord를 Completion(GetIterator(iterable, sync))으로 둡니다.
IfAbruptRejectPromise(iteratorRecord, promiseCapability).
result를 Completion(PerformPromiseRace(iteratorRecord, ctor, promiseCapability, promiseResolve))으로 둡니다.
result가 abrupt completion이면, 다음을 수행합니다.
1. iteratorRecord.[[Done]]이 false이면 result를 Completion(IteratorClose(iteratorRecord, result))으로 설정합니다.
2. IfAbruptRejectPromise(result, promiseCapability).
! result를 반환합니다.

참고 1

iterable 인수가 값을 산출하지 않거나 iterable이 산출한 promise 중 어느 것도 절대 settled되지 않으면 이 메서드가 반환한 pending promise도 절대 settled되지 않습니다.

참고 2

이 함수는 this 값이 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수일 것으로 기대합니다. 또한 this 값이 resolve 메서드를 제공할 것으로 기대합니다.

27.5.4.5.1 PerformPromiseRace ( `iteratorRecord`, `ctor`, `resultCapability`, `promiseResolve` )

추상 연산 PerformPromiseRace. 인수 iteratorRecord (Iterator 레코드), ctor (생성자), resultCapability (PromiseCapability 레코드) 및 promiseResolve (함수 객체). 반환값: (정상 완료 (값: Object) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

다음을 반복합니다.
1. next를 ? IteratorStepValue(iteratorRecord)로 둡니다.
2. next가 done이면, 다음을 수행합니다.
  1. resultCapability.[[Promise]]를 반환합니다.
3. nextPromise를 ? Call(promiseResolve, ctor, « next »)로 둡니다.
4. ? Invoke(nextPromise, "then", « resultCapability.[[Resolve]], resultCapability.[[Reject]] »)를 수행합니다.

27.5.4.6 Promise.reject ( `reason` )

이 함수는 전달된 인수로 rejected된 새로운 promise를 반환합니다.

ctor를 this 값으로 둡니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
? Call(promiseCapability.[[Reject]], undefined, « reason »)를 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

참고

이 함수는 this 값이 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수일 것으로 기대합니다.

27.5.4.7 Promise.resolve ( `resolution` )

이 함수는 전달된 인수로 resolve된 새로운 promise를 반환하거나, 인수가 이 생성자가 생성한 promise라면 인수 자체를 반환합니다.

ctor를 this 값으로 둡니다.
ctor가 Object가 아니면 TypeError 예외를 던집니다.
? PromiseResolve(ctor, resolution)을 반환합니다.

참고

이 함수는 this 값이 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수일 것으로 기대합니다.

27.5.4.7.1 PromiseResolve ( `ctor`, `resolution` )

추상 연산 PromiseResolve. 인수 ctor (Object) 및 resolution (ECMAScript 언어 값). 반환값: (정상 완료 (값: Object) 또는 throw 완료). resolution으로 resolve된 새로운 promise를 반환합니다. 호출되면 다음 단계를 수행한다.

IsPromise(resolution)이 true이면, 다음을 수행합니다.
1. resolutionCtor를 ? Get(resolution, "constructor")로 둡니다.
2. SameValue(resolutionCtor, ctor)가 true이면 resolution을 반환합니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
? Call(promiseCapability.[[Resolve]], undefined, « resolution »)를 수행합니다.
promiseCapability.[[Promise]]를 반환합니다.

27.5.4.8 Promise.try ( `callback`, ...`args` )

이 함수는 호출되면 다음 단계를 수행합니다:

ctor를 this 값으로 둡니다.
ctor가 Object가 아니면 TypeError 예외를 던집니다.
status를 Completion(Call(callback, undefined, args))으로 둡니다.
status가 abrupt completion이면, 다음을 수행합니다.
1. promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
2. ? Call(promiseCapability.[[Reject]], undefined, « status.[[Value]] »)를 수행합니다.
3. promiseCapability.[[Promise]]를 반환합니다.
그렇지 않으면,
1. ? PromiseResolve(ctor, ! status)를 반환합니다.

참고

이 함수는 this 값이 Promise 생성자의 매개변수 규약을 지원하는 생성자 함수일 것으로 기대합니다.

27.5.4.9 Promise.withResolvers ( )

이 함수는 세 프로퍼티, 즉 새로운 promise와 그에 연결된 resolve 및 reject 함수를 갖는 객체를 반환합니다.

ctor를 this 값으로 둡니다.
promiseCapability을 ? NewPromiseCapability(ctor)로 둡니다.
obj를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
! CreateDataPropertyOrThrow(obj, "promise", promiseCapability.[[Promise]])를 수행합니다.
! CreateDataPropertyOrThrow(obj, "resolve", promiseCapability.[[Resolve]])를 수행합니다.
! CreateDataPropertyOrThrow(obj, "reject", promiseCapability.[[Reject]])를 수행합니다.
obj를 반환합니다.

27.5.4.10 get Promise [ %Symbol.species% ]

Promise[%Symbol.species%]는 set 접근자 함수가 undefined인 접근자 프로퍼티입니다. get 접근자 함수는 호출되면 다음 단계를 수행합니다:

this 값을 반환합니다.

이 함수의 "name" 프로퍼티 값은 "get [Symbol.species]"입니다.

참고

Promise 프로토타입 메서드는 일반적으로 this 값의 생성자를 사용하여 파생 객체를 생성합니다. 그러나 하위 클래스 생성자는 자신의 %Symbol.species% 프로퍼티를 재정의하여 기본 동작을 재정의할 수 있습니다.

27.5.5 Promise 프로토타입 객체의 프로퍼티

Promise 프로토타입 객체는:

%Promise.prototype%입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
일반 객체입니다.
[[PromiseState]] 내부 슬롯 또는 Promise 인스턴스의 다른 내부 슬롯을 갖지 않습니다.

27.5.5.1 Promise.prototype.catch ( `onRejected` )

이 메서드는 호출되면 다음 단계를 수행합니다:

promise를 this 값으로 둡니다.
? Invoke(promise, "then", « undefined, onRejected »)를 반환합니다.

27.5.5.2 Promise.prototype.constructor

Promise.prototype.constructor의 초기 값은 %Promise%입니다.

27.5.5.3 Promise.prototype.finally ( `onFinally` )

이 메서드는 호출되면 다음 단계를 수행합니다:

promise를 this 값으로 둡니다.
promise가 Object가 아니면 TypeError 예외를 던집니다.
ctor를 ? SpeciesConstructor(promise, %Promise%)로 둡니다.
단언: IsConstructor(ctor)는 true입니다.
IsCallable(onFinally)가 false이면, 다음을 수행합니다.
1. thenFinally를 onFinally로 둡니다.
2. catchFinally를 onFinally로 둡니다.
그렇지 않으면,
1. thenFinallyClosure를 매개변수 (value)를 가지며 onFinally와 ctor를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. result를 ? Call(onFinally, undefined)로 둡니다.
  2. p를 ? PromiseResolve(ctor, result)로 둡니다.
  3. returnValue를 매개변수가 없고 value를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
    1. NormalCompletion(value)을 반환합니다.
  4. valueThunk를 CreateBuiltinFunction(returnValue, 0, "", « »)로 둡니다.
  5. ? Invoke(p, "then", « valueThunk »)를 반환합니다.
2. thenFinally를 CreateBuiltinFunction(thenFinallyClosure, 1, "", « »)로 둡니다.
3. catchFinallyClosure를 매개변수 (reason)을 가지며 onFinally와 ctor를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
  1. result를 ? Call(onFinally, undefined)로 둡니다.
  2. p를 ? PromiseResolve(ctor, result)로 둡니다.
  3. throwReason을 매개변수가 없고 reason을 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
    1. reason을 던집니다.
  4. thrower를 CreateBuiltinFunction(throwReason, 0, "", « »)로 둡니다.
  5. ? Invoke(p, "then", « thrower »)를 반환합니다.
4. catchFinally를 CreateBuiltinFunction(catchFinallyClosure, 1, "", « »)로 둡니다.
? Invoke(promise, "then", « thenFinally, catchFinally »)를 반환합니다.

27.5.5.4 Promise.prototype.then ( `onFulfilled`, `onRejected` )

이 메서드는 호출되면 다음 단계를 수행합니다:

promise를 this 값으로 둡니다.
IsPromise(promise)가 false이면 TypeError 예외를 던집니다.
ctor를 ? SpeciesConstructor(promise, %Promise%)로 둡니다.
resultCapability을 ? NewPromiseCapability(ctor)로 둡니다.
PerformPromiseThen(promise, onFulfilled, onRejected, resultCapability)을 반환합니다.

27.5.5.4.1 PerformPromiseThen ( `promise`, `onFulfilled`, `onRejected` [ , `resultCapability` ] )

추상 연산 PerformPromiseThen. 인수 promise (Promise), onFulfilled (ECMAScript 언어 값) 및 onRejected (ECMAScript 언어 값) 및 선택적 인수 resultCapability (PromiseCapability 레코드). 반환값: (Object 또는 undefined). onFulfilled와 onRejected를 settlement 동작으로 사용하여 promise에 “then” 연산을 수행합니다. resultCapability이 전달되면 resultCapability의 promise를 업데이트하여 결과를 저장합니다. 전달되지 않으면 결과가 중요하지 않은 명세 내부 연산에서 PerformPromiseThen이 호출된 것입니다. 호출되면 다음 단계를 수행한다.

단언: IsPromise(promise)는 true입니다.
resultCapability이 존재하지 않으면, 다음을 수행합니다.
1. resultCapability을 undefined로 설정합니다.
IsCallable(onFulfilled)가 false이면, 다음을 수행합니다.
1. onFulfilledJobCallback을 empty로 둡니다.
그렇지 않으면,
1. onFulfilledJobCallback을 HostMakeJobCallback(onFulfilled)으로 둡니다.
IsCallable(onRejected)가 false이면, 다음을 수행합니다.
1. onRejectedJobCallback을 empty로 둡니다.
그렇지 않으면,
1. onRejectedJobCallback을 HostMakeJobCallback(onRejected)으로 둡니다.
fulfillReaction을 PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]: fulfill, [[Handler]]: onFulfilledJobCallback }로 둡니다.
rejectReaction을 PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]: reject, [[Handler]]: onRejectedJobCallback }로 둡니다.
promise.[[PromiseState]]가 pending이면, 다음을 수행합니다.
1. fulfillReaction을 promise.[[PromiseFulfillReactions]]에 추가합니다.
2. rejectReaction을 promise.[[PromiseRejectReactions]]에 추가합니다.
그렇지 않고 promise.[[PromiseState]]가 fulfilled이면, 다음을 수행합니다.
1. value를 promise.[[PromiseResult]]로 둡니다.
2. fulfillJob을 NewPromiseReactionJob(fulfillReaction, value)로 둡니다.
3. HostEnqueuePromiseJob(fulfillJob.[[Job]], fulfillJob.[[Realm]])을 수행합니다.
그렇지 않으면,
1. 단언: promise.[[PromiseState]]는 rejected입니다.
2. reason을 promise.[[PromiseResult]]로 둡니다.
3. promise.[[PromiseIsHandled]]가 false이면 HostPromiseRejectionTracker(promise, "handle")를 수행합니다.
4. rejectJob을 NewPromiseReactionJob(rejectReaction, reason)으로 둡니다.
5. HostEnqueuePromiseJob(rejectJob.[[Job]], rejectJob.[[Realm]])을 수행합니다.
promise.[[PromiseIsHandled]]를 true로 설정합니다.
resultCapability이 undefined이면 undefined를 반환합니다.
resultCapability.[[Promise]]를 반환합니다.

27.5.5.5 Promise.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Promise"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.5.6 Promise 인스턴스의 프로퍼티

Promise 인스턴스는 Promise 프로토타입 객체(내재 %Promise.prototype%)에서 프로퍼티를 상속하는 일반 객체입니다. Promise 인스턴스는 처음에 표 93에 설명된 내부 슬롯과 함께 생성됩니다.

표 93: Promise 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[PromiseState]]`	pending, fulfilled, or rejected	promise가 `then` 메서드에 대한 들어오는 호출에 어떻게 반응할지를 제어합니다.
`[[PromiseResult]]`	an ECMAScript language value or empty	promise가 fulfilled 또는 rejected된 값입니다. 값이 있을 경우에 해당합니다. `[[PromiseState]]`가 pending인 경우에만 empty입니다.
`[[PromiseFulfillReactions]]`	a List of PromiseReaction Records	promise가 pending 상태에서 fulfilled 상태로 전환될 때 처리할 Record입니다.
`[[PromiseRejectReactions]]`	a List of PromiseReaction Records	promise가 pending 상태에서 rejected 상태로 전환될 때 처리할 Record입니다.
`[[PromiseIsHandled]]`	a Boolean	promise에 fulfillment 또는 rejection handler가 한 번이라도 있었는지를 나타냅니다. 처리되지 않은 rejection 추적에 사용됩니다.

27.6 GeneratorFunction 객체

GeneratorFunction은 일반적으로 GeneratorDeclaration, GeneratorExpression, GeneratorMethod를 평가하여 생성되는 함수입니다. %GeneratorFunction% 내재 객체를 호출하여 생성할 수도 있습니다.

매우 다양한 상자와 화살표. — 그림 6 (참고): Generator 객체 관계

27.6.1 GeneratorFunction 생성자

GeneratorFunction 생성자는:

%GeneratorFunction%입니다.
Function의 하위 클래스입니다.
생성자가 아니라 함수로 호출되면 새로운 GeneratorFunction을 생성하고 초기화합니다. 따라서 함수 호출 GeneratorFunction (…)은 같은 인수를 사용하는 객체 생성 표현식 new GeneratorFunction (…)과 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 GeneratorFunction 동작을 상속하려는 하위 클래스 생성자는 내장 GeneratorFunction 동작에 필요한 내부 슬롯을 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 GeneratorFunction 생성자에 대한 super 호출을 포함해야 합니다. generator 함수 객체를 정의하는 모든 ECMAScript 구문 형식은 GeneratorFunction의 직접 인스턴스를 생성합니다. GeneratorFunction 하위 클래스의 인스턴스를 생성하는 구문적 방법은 없습니다.

27.6.1.1 GeneratorFunction ( ...`paramArgs`, `bodyArg` )

마지막 인수(있는 경우)는 generator 함수의 본문(실행 가능한 코드)을 지정하며, 그 앞의 모든 인수는 형식 매개변수를 지정합니다.

이 함수는 호출되면 다음 단계를 수행합니다:

activeFunc를 활성 함수 객체로 둡니다.
bodyArg가 존재하지 않으면 bodyArg를 빈 String으로 설정합니다.
? CreateDynamicFunction(activeFunc, NewTarget, generator, paramArgs, bodyArg)를 반환합니다.

참고

20.2.1.1의 참고를 참조하시기 바랍니다.

27.6.2 GeneratorFunction 생성자의 프로퍼티

GeneratorFunction 생성자는:

Function 생성자에서 상속하는 표준 내장 함수 객체입니다.
값이 %Function%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 1_𝔽인 "length" 프로퍼티를 갖습니다.
값이 "GeneratorFunction"인 "name" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

27.6.2.1 GeneratorFunction.prototype

GeneratorFunction.prototype의 초기 값은 GeneratorFunction 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.6.3 GeneratorFunction 프로토타입 객체의 프로퍼티

GeneratorFunction 프로토타입 객체는:

%GeneratorFunction.prototype%입니다(그림 6 참조).
일반 객체입니다.
함수 객체가 아니며 [[ECMAScriptCode]] 내부 슬롯이나 표 26 또는 표 94에 나열된 다른 내부 슬롯을 갖지 않습니다.
값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

27.6.3.1 GeneratorFunction.prototype.constructor

GeneratorFunction.prototype.constructor의 초기 값은 %GeneratorFunction%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.6.3.2 GeneratorFunction.prototype.prototype

GeneratorFunction.prototype.prototype의 초기 값은 %GeneratorPrototype%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.6.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "GeneratorFunction"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.6.4 GeneratorFunction 인스턴스

모든 GeneratorFunction 인스턴스는 ECMAScript 함수 객체이며 표 26에 나열된 내부 슬롯을 갖습니다. 이러한 모든 인스턴스의 [[IsClassConstructor]] 내부 슬롯 값은 false입니다.

각 GeneratorFunction 인스턴스에는 다음 자체 프로퍼티가 있습니다:

27.6.4.1 length

20.2.4.1에 제시된 Function 인스턴스의 "length" 프로퍼티 명세는 GeneratorFunction 인스턴스에도 적용됩니다.

27.6.4.2 name

20.2.4.2에 제시된 Function 인스턴스의 "name" 프로퍼티 명세는 GeneratorFunction 인스턴스에도 적용됩니다.

27.6.4.3 prototype

GeneratorFunction 인스턴스가 생성될 때마다 또 다른 일반 객체도 생성되며 generator 함수의 "prototype" 프로퍼티의 초기 값이 됩니다. prototype 프로퍼티 값은 generator 함수 객체가 [[Call]]을 사용하여 호출될 때 새로 생성되는 Generator의 [[Prototype]] 내부 슬롯을 초기화하는 데 사용됩니다.

이 프로퍼티는 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

참고

Function 인스턴스와 달리 GeneratorFunction의 "prototype" 프로퍼티 값인 객체에는 값이 GeneratorFunction 인스턴스인 "constructor" 프로퍼티가 없습니다.

27.7 AsyncGeneratorFunction 객체

AsyncGeneratorFunction은 일반적으로 AsyncGeneratorDeclaration, AsyncGeneratorExpression, AsyncGeneratorMethod 구문 생성물을 평가하여 생성되는 함수입니다. %AsyncGeneratorFunction% 내재 객체를 호출하여 생성할 수도 있습니다.

27.7.1 AsyncGeneratorFunction 생성자

AsyncGeneratorFunction 생성자는:

%AsyncGeneratorFunction%입니다.
Function의 하위 클래스입니다.
생성자가 아니라 함수로 호출되면 새로운 AsyncGeneratorFunction을 생성하고 초기화합니다. 따라서 함수 호출 AsyncGeneratorFunction (...)은 같은 인수를 사용하는 객체 생성 표현식 new AsyncGeneratorFunction (...)과 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 AsyncGeneratorFunction 동작을 상속하려는 하위 클래스 생성자는 내장 AsyncGeneratorFunction 동작에 필요한 내부 슬롯을 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 AsyncGeneratorFunction 생성자에 대한 super 호출을 포함해야 합니다. async generator 함수 객체를 정의하는 모든 ECMAScript 구문 형식은 AsyncGeneratorFunction의 직접 인스턴스를 생성합니다. AsyncGeneratorFunction 하위 클래스의 인스턴스를 생성하는 구문적 방법은 없습니다.

27.7.1.1 AsyncGeneratorFunction ( ...`paramArgs`, `bodyArg` )

마지막 인수(있는 경우)는 async generator 함수의 본문(실행 가능한 코드)을 지정하며, 그 앞의 모든 인수는 형식 매개변수를 지정합니다.

이 함수는 호출되면 다음 단계를 수행합니다:

activeFunc를 활성 함수 객체로 둡니다.
bodyArg가 존재하지 않으면 bodyArg를 빈 String으로 설정합니다.
? CreateDynamicFunction(activeFunc, NewTarget, async-generator, paramArgs, bodyArg)를 반환합니다.

참고

20.2.1.1의 참고를 참조하시기 바랍니다.

27.7.2 AsyncGeneratorFunction 생성자의 프로퍼티

AsyncGeneratorFunction 생성자는:

Function 생성자에서 상속하는 표준 내장 함수 객체입니다.
값이 %Function%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 1_𝔽인 "length" 프로퍼티를 갖습니다.
값이 "AsyncGeneratorFunction"인 "name" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

27.7.2.1 AsyncGeneratorFunction.prototype

AsyncGeneratorFunction.prototype의 초기 값은 AsyncGeneratorFunction 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.7.3 AsyncGeneratorFunction 프로토타입 객체의 프로퍼티

AsyncGeneratorFunction 프로토타입 객체는:

%AsyncGeneratorFunction.prototype%입니다.
일반 객체입니다.
함수 객체가 아니며 [[ECMAScriptCode]] 내부 슬롯이나 표 26 또는 표 95에 나열된 다른 내부 슬롯을 갖지 않습니다.
값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

27.7.3.1 AsyncGeneratorFunction.prototype.constructor

AsyncGeneratorFunction.prototype.constructor의 초기 값은 %AsyncGeneratorFunction%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.7.3.2 AsyncGeneratorFunction.prototype.prototype

AsyncGeneratorFunction.prototype.prototype의 초기 값은 %AsyncGeneratorPrototype%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.7.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "AsyncGeneratorFunction"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.7.4 AsyncGeneratorFunction 인스턴스

모든 AsyncGeneratorFunction 인스턴스는 ECMAScript 함수 객체이며 표 26에 나열된 내부 슬롯을 갖습니다. 이러한 모든 인스턴스의 [[IsClassConstructor]] 내부 슬롯 값은 false입니다.

각 AsyncGeneratorFunction 인스턴스에는 다음 자체 프로퍼티가 있습니다:

27.7.4.1 length

"length" 프로퍼티 값은 AsyncGeneratorFunction이 일반적으로 받을 것으로 예상되는 인수 수를 나타내는 정수 Number입니다. 그러나 언어는 다른 수의 인수로 함수를 호출하는 것도 허용합니다. "length" 프로퍼티에 지정된 수와 다른 수의 인수로 AsyncGeneratorFunction을 호출했을 때의 동작은 함수에 따라 달라집니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.7.4.2 name

20.2.4.2에 제시된 Function 인스턴스의 "name" 프로퍼티 명세는 AsyncGeneratorFunction 인스턴스에도 적용됩니다.

27.7.4.3 prototype

AsyncGeneratorFunction 인스턴스가 생성될 때마다 또 다른 일반 객체도 생성되며 async generator 함수의 "prototype" 프로퍼티의 초기 값이 됩니다. prototype 프로퍼티 값은 generator 함수 객체가 [[Call]]을 사용하여 호출될 때 새로 생성되는 AsyncGenerator의 [[Prototype]] 내부 슬롯을 초기화하는 데 사용됩니다.

이 프로퍼티는 { [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

참고

함수 인스턴스와 달리 AsyncGeneratorFunction의 "prototype" 프로퍼티 값인 객체에는 값이 AsyncGeneratorFunction 인스턴스인 "constructor" 프로퍼티가 없습니다.

27.8 Generator 객체

Generator는 generator 함수를 호출하여 생성되며 iterator 인터페이스와 iterable 인터페이스를 모두 준수합니다.

Generator 인스턴스는 해당 인스턴스를 생성한 generator 함수의 "prototype" 프로퍼티 초기 값에서 직접 프로퍼티를 상속합니다. Generator 인스턴스는 %GeneratorPrototype%에서 간접적으로 프로퍼티를 상속합니다.

27.8.1 %GeneratorPrototype% 객체

%GeneratorPrototype% 객체는:

%GeneratorFunction.prototype.prototype%입니다.
일반 객체입니다.
Generator 인스턴스가 아니며 [[GeneratorState]] 내부 슬롯을 갖지 않습니다.
값이 %Iterator.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
모든 Generator 인스턴스가 간접적으로 상속하는 프로퍼티를 갖습니다.

27.8.1.1 %GeneratorPrototype%.constructor

%GeneratorPrototype%.constructor의 초기 값은 %GeneratorFunction.prototype%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.8.1.2 %GeneratorPrototype%.next ( `value` )

? GeneratorResume(this 값, value, empty)를 반환합니다.

27.8.1.3 %GeneratorPrototype%.return ( `value` )

이 메서드는 호출되면 다음 단계를 수행합니다:

gen을 this 값으로 둡니다.
completion을 ReturnCompletion(value)으로 둡니다.
? GeneratorResumeAbrupt(gen, completion, empty)를 반환합니다.

27.8.1.4 %GeneratorPrototype%.throw ( `exception` )

이 메서드는 호출되면 다음 단계를 수행합니다:

gen을 this 값으로 둡니다.
completion을 ThrowCompletion(exception)으로 둡니다.
? GeneratorResumeAbrupt(gen, completion, empty)를 반환합니다.

27.8.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Generator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.8.2 Generator 인스턴스의 프로퍼티

Generator 인스턴스는 처음에 표 94에 설명된 내부 슬롯과 함께 생성됩니다.

표 94: Generator 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[GeneratorState]]`	suspended-start, suspended-yield, executing, or completed	generator의 현재 실행 상태입니다.
`[[GeneratorContext]]`	an execution context	이 generator의 코드를 실행할 때 사용하는 실행 컨텍스트입니다.
`[[GeneratorBrand]]`	a String or empty	서로 다른 종류의 generator를 구별하는 데 사용되는 브랜드입니다. ECMAScript 소스 텍스트로 선언된 generator의 `[[GeneratorBrand]]`는 항상 empty입니다.

27.8.3 Generator 추상 연산

27.8.3.1 GeneratorStart ( `gen`, `genBody` )

추상 연산 GeneratorStart. 인수 gen (Generator) 및 genBody ((a FunctionBody Parse Node 또는 매개변수가 없는 추상 클로저)). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: gen.[[GeneratorState]]는 suspended-start입니다.
genContext를 실행 중인 실행 컨텍스트로 둡니다.
genContext의 Generator 구성 요소를 gen으로 설정합니다.
closure를 매개변수가 없고 genBody를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. acGenContext를 실행 중인 실행 컨텍스트로 둡니다.
2. acGen을 acGenContext의 Generator 구성 요소로 둡니다.
3. genBody가 Parse Node이면, 다음을 수행합니다.
  1. result를 Completion(genBody의 Evaluation)으로 둡니다.
4. 그렇지 않으면,
  1. 단언: genBody는 매개변수가 없는 Abstract Closure입니다.
  2. result를 Completion(genBody())로 둡니다.
5. 단언: 여기서 반환한다면 generator는 예외를 던졌거나 암시적 또는 명시적 return을 수행했습니다.
6. acGenContext를 실행 컨텍스트 스택에서 제거하고 실행 컨텍스트 스택 맨 위의 실행 컨텍스트를 실행 중인 실행 컨텍스트로 복원합니다.
7. acGen.[[GeneratorState]]를 completed로 설정합니다.
8. 참고: generator가 completed 상태에 들어가면 다시 벗어나지 않으며 연결된 실행 컨텍스트는 다시 재개되지 않습니다. acGen과 연결된 모든 실행 상태는 이 시점에 폐기할 수 있습니다.
9. result가 throw completion이면, 다음을 수행합니다.
  1. resumption을 result로 둡니다.
10. 그렇지 않으면,
  1. result가 normal completion이면, 다음을 수행합니다.
    1. resultValue를 undefined로 둡니다.
  2. 그렇지 않고 result가 return completion이면, 다음을 수행합니다.
    1. resultValue를 result.[[Value]]로 둡니다.
  3. resumption을 NormalCompletion(CreateIteratorResultObject(resultValue, true))으로 둡니다.
11. callerContext를 실행 중인 실행 컨텍스트로 둡니다.
12. resumption을 전달하여 callerContext를 재개합니다.
13. 단언: 이 단계에는 절대 도달하지 않습니다.
해당 실행 컨텍스트의 평가가 재개될 때 closure가 인수 없이 호출되도록 genContext의 코드 평가 상태를 설정합니다.
gen.[[GeneratorContext]]를 genContext로 설정합니다.
unused를 반환합니다.

27.8.3.2 GeneratorValidate ( `gen`, `genBrand` )

추상 연산 GeneratorValidate. 인수 gen (ECMAScript 언어 값) 및 genBrand ((String 또는 empty)). 반환값: (정상 완료 (값: (suspended-start, suspended-yield 또는 completed)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(gen, [[GeneratorState]])를 수행합니다.
? RequireInternalSlot(gen, [[GeneratorBrand]])를 수행합니다.
gen.[[GeneratorBrand]]가 genBrand가 아니면 TypeError 예외를 던집니다.
단언: gen에는 [[GeneratorContext]] 내부 슬롯이 있습니다.
state를 gen.[[GeneratorState]]로 둡니다.
state가 executing이면 TypeError 예외를 던집니다.
state를 반환합니다.

27.8.3.3 GeneratorResume ( `gen`, `value`, `genBrand` )

추상 연산 GeneratorResume. 인수 gen (ECMAScript 언어 값), value ((ECMAScript 언어 값 또는 empty)) 및 genBrand ((String 또는 empty)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

state를 ? GeneratorValidate(gen, genBrand)로 둡니다.
state가 completed이면 CreateIteratorResultObject(undefined, true)를 반환합니다.
단언: state는 suspended-start 또는 suspended-yield입니다.
genContext를 gen.[[GeneratorContext]]로 둡니다.
gen.[[GeneratorState]]를 executing으로 설정합니다.
? RunSuspendedContext(genContext, NormalCompletion(value))을 반환합니다.

27.8.3.4 GeneratorResumeAbrupt ( `gen`, `abruptCompletion`, `genBrand` )

추상 연산 GeneratorResumeAbrupt. 인수 gen (ECMAScript 언어 값), abruptCompletion ((return 완료 또는 throw 완료)) 및 genBrand ((String 또는 empty)). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

state를 ? GeneratorValidate(gen, genBrand)로 둡니다.
state가 suspended-start이면, 다음을 수행합니다.
1. gen.[[GeneratorState]]를 completed로 설정합니다.
2. 참고: generator가 completed 상태에 들어가면 다시 벗어나지 않으며 연결된 실행 컨텍스트는 다시 재개되지 않습니다. gen과 연결된 모든 실행 상태는 이 시점에 폐기할 수 있습니다.
3. state를 completed로 설정합니다.
state가 completed이면, 다음을 수행합니다.
1. abruptCompletion이 return completion이면, 다음을 수행합니다.
  1. CreateIteratorResultObject(abruptCompletion.[[Value]], true)를 반환합니다.
2. ? abruptCompletion을 반환합니다.
단언: state는 suspended-yield입니다.
genContext를 gen.[[GeneratorContext]]로 둡니다.
gen.[[GeneratorState]]를 executing으로 설정합니다.
? RunSuspendedContext(genContext, abruptCompletion)을 반환합니다.

27.8.3.5 GetGeneratorKind ( )

추상 연산 GetGeneratorKind. 인수 없음. 반환값: (non-generator, sync 또는 async). 호출되면 다음 단계를 수행한다.

genContext를 실행 중인 실행 컨텍스트로 둡니다.
genContext에 Generator 구성 요소가 없으면 non-generator를 반환합니다.
gen을 genContext의 Generator 구성 요소로 둡니다.
gen에 [[AsyncGeneratorState]] 내부 슬롯이 있으면 async를 반환합니다.
sync를 반환합니다.

27.8.3.6 GeneratorYield ( `iteratorResult` )

추상 연산 GeneratorYield. 인수 iteratorResult (an Object that conforms to the IteratorResult interface). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

genContext를 실행 중인 실행 컨텍스트로 둡니다.
단언: genContext는 generator의 실행 컨텍스트입니다.
gen을 genContext의 Generator 구성 요소 값으로 둡니다.
단언: GetGeneratorKind()는 sync입니다.
gen.[[GeneratorState]]를 suspended-yield로 설정합니다.
? RunCallerContext(iteratorResult)를 반환합니다.

27.8.3.7 Yield ( `arg` )

추상 연산 Yield. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

genKind를 GetGeneratorKind()로 둡니다.
genKind가 async이면 ? AsyncGeneratorYield(? Await(arg))를 반환합니다.
? GeneratorYield(CreateIteratorResultObject(arg, false))를 반환합니다.

27.8.3.8 CreateIteratorFromClosure ( `closure`, `genBrand`, `genProto` [ , `extraSlots` ] )

추상 연산 CreateIteratorFromClosure. 인수 closure (매개변수가 없는 추상 클로저), genBrand ((String 또는 empty)) 및 genProto (Object) 및 선택적 인수 extraSlots (리스트 (요소: 내부 슬롯 이름)). 반환값: Generator. 호출되면 다음 단계를 수행한다.

참고: closure는 IteratorResult 객체를 산출하기 위한 Yield 연산 사용을 포함할 수 있습니다.
extraSlots가 존재하지 않으면 extraSlots를 새로운 빈 List로 설정합니다.
internalSlotsList를 extraSlots와 « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »의 목록 연결로 둡니다.
gen을 OrdinaryObjectCreate(genProto, internalSlotsList)로 둡니다.
gen.[[GeneratorBrand]]를 genBrand로 설정합니다.
gen.[[GeneratorState]]를 suspended-start로 설정합니다.
callerContext를 실행 중인 실행 컨텍스트로 둡니다.
calleeContext를 새로운 실행 컨텍스트로 둡니다.
calleeContext의 Function을 null로 설정합니다.
calleeContext의 Realm을 현재 Realm Record로 설정합니다.
calleeContext의 ScriptOrModule을 callerContext의 ScriptOrModule로 설정합니다.
callerContext가 아직 일시 중단되지 않았다면 callerContext를 일시 중단합니다.
calleeContext를 실행 컨텍스트 스택에 push합니다. 이제 calleeContext가 실행 중인 실행 컨텍스트입니다.
GeneratorStart(gen, closure)를 수행합니다.
calleeContext를 실행 컨텍스트 스택에서 제거하고 callerContext를 실행 중인 실행 컨텍스트로 복원합니다.
gen을 반환합니다.

27.9 AsyncGenerator 객체

AsyncGenerator는 async generator 함수를 호출하여 생성되며 async iterator 인터페이스와 async iterable 인터페이스를 모두 준수합니다.

AsyncGenerator 인스턴스는 해당 인스턴스를 생성한 async generator 함수의 "prototype" 프로퍼티 초기 값에서 직접 프로퍼티를 상속합니다. AsyncGenerator 인스턴스는 %AsyncGeneratorPrototype%에서 간접적으로 프로퍼티를 상속합니다.

27.9.1 %AsyncGeneratorPrototype% 객체

%AsyncGeneratorPrototype% 객체는:

%AsyncGeneratorFunction.prototype.prototype%입니다.
일반 객체입니다.
AsyncGenerator 인스턴스가 아니며 [[AsyncGeneratorState]] 내부 슬롯을 갖지 않습니다.
값이 %AsyncIteratorPrototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
모든 AsyncGenerator 인스턴스가 간접적으로 상속하는 프로퍼티를 갖습니다.

27.9.1.1 %AsyncGeneratorPrototype%.constructor

%AsyncGeneratorPrototype%.constructor의 초기 값은 %AsyncGeneratorFunction.prototype%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.9.1.2 %AsyncGeneratorPrototype%.next ( `value` )

gen을 this 값으로 둡니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
result를 Completion(AsyncGeneratorValidate(gen, empty))으로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
state를 gen.[[AsyncGeneratorState]]로 둡니다.
state가 completed이면, 다음을 수행합니다.
1. iteratorResult를 CreateIteratorResultObject(undefined, true)로 둡니다.
2. ! Call(promiseCapability.[[Resolve]], undefined, « iteratorResult »)를 수행합니다.
3. promiseCapability.[[Promise]]를 반환합니다.
completion을 NormalCompletion(value)으로 둡니다.
AsyncGeneratorEnqueue(gen, completion, promiseCapability)을 수행합니다.
state가 suspended-start 또는 suspended-yield이면, 다음을 수행합니다.
1. AsyncGeneratorResume(gen, completion)을 수행합니다.
그렇지 않으면,
1. 단언: state는 executing 또는 draining-queue입니다.
promiseCapability.[[Promise]]를 반환합니다.

27.9.1.3 %AsyncGeneratorPrototype%.return ( `value` )

gen을 this 값으로 둡니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
result를 Completion(AsyncGeneratorValidate(gen, empty))으로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
completion을 ReturnCompletion(value)으로 둡니다.
AsyncGeneratorEnqueue(gen, completion, promiseCapability)을 수행합니다.
state를 gen.[[AsyncGeneratorState]]로 둡니다.
state가 suspended-start 또는 completed이면, 다음을 수행합니다.
1. gen.[[AsyncGeneratorState]]를 draining-queue로 설정합니다.
2. AsyncGeneratorAwaitReturn(gen)을 수행합니다.
그렇지 않고 state가 suspended-yield이면, 다음을 수행합니다.
1. AsyncGeneratorResume(gen, completion)을 수행합니다.
그렇지 않으면,
1. 단언: state는 executing 또는 draining-queue입니다.
promiseCapability.[[Promise]]를 반환합니다.

27.9.1.4 %AsyncGeneratorPrototype%.throw ( `exception` )

gen을 this 값으로 둡니다.
promiseCapability을 ! NewPromiseCapability(%Promise%)로 둡니다.
result를 Completion(AsyncGeneratorValidate(gen, empty))으로 둡니다.
IfAbruptRejectPromise(result, promiseCapability).
state를 gen.[[AsyncGeneratorState]]로 둡니다.
state가 suspended-start이면, 다음을 수행합니다.
1. gen.[[AsyncGeneratorState]]를 completed로 설정합니다.
2. state를 completed로 설정합니다.
state가 completed이면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « exception »)를 수행합니다.
2. promiseCapability.[[Promise]]를 반환합니다.
completion을 ThrowCompletion(exception)으로 둡니다.
AsyncGeneratorEnqueue(gen, completion, promiseCapability)을 수행합니다.
state가 suspended-yield이면, 다음을 수행합니다.
1. AsyncGeneratorResume(gen, completion)을 수행합니다.
그렇지 않으면,
1. 단언: state는 executing 또는 draining-queue입니다.
promiseCapability.[[Promise]]를 반환합니다.

27.9.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "AsyncGenerator"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.9.2 AsyncGenerator 인스턴스의 프로퍼티

AsyncGenerator 인스턴스는 처음에 아래에 설명된 내부 슬롯과 함께 생성됩니다:

표 95: AsyncGenerator 인스턴스의 내부 슬롯

내부 슬롯	타입	설명
`[[AsyncGeneratorState]]`	suspended-start, suspended-yield, executing, draining-queue, or completed	async generator의 현재 실행 상태입니다.
`[[AsyncGeneratorContext]]`	an execution context	이 async generator의 코드를 실행할 때 사용하는 실행 컨텍스트입니다.
`[[AsyncGeneratorQueue]]`	a List of AsyncGeneratorRequest Records	async generator를 재개하라는 요청을 나타내는 Record입니다. 상태 전환 중을 제외하면 `[[AsyncGeneratorState]]`가 executing 또는 draining-queue인 경우에만 비어 있지 않습니다.
`[[GeneratorBrand]]`	a String or empty	서로 다른 종류의 async generator를 구별하는 데 사용되는 브랜드입니다. ECMAScript 소스 텍스트로 선언된 async generator의 `[[GeneratorBrand]]`는 항상 empty입니다.

27.9.3 AsyncGenerator 추상 연산

27.9.3.1 AsyncGeneratorRequest Records

AsyncGeneratorRequest는 async generator를 어떻게 재개해야 하는지에 대한 정보를 저장하는 데 사용되는 Record이며 대응하는 promise를 fulfill하거나 reject하기 위한 capability를 포함합니다.

다음 필드를 갖습니다:

표 96: AsyncGeneratorRequest Record 필드

필드 이름	값	의미
`[[Completion]]`	a Completion Record	async generator를 재개하는 데 사용해야 하는 Completion Record입니다.
`[[Capability]]`	a PromiseCapability Record	이 요청과 연결된 promise capability입니다.

27.9.3.2 AsyncGeneratorStart ( `gen`, `genBody` )

추상 연산 AsyncGeneratorStart. 인수 gen (AsyncGenerator) 및 genBody ((a FunctionBody Parse Node 또는 매개변수가 없는 추상 클로저)). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: gen.[[AsyncGeneratorState]]는 suspended-start입니다.
genContext를 실행 중인 실행 컨텍스트로 둡니다.
genContext의 Generator 구성 요소를 gen으로 설정합니다.
closure를 매개변수가 없고 genBody를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. acGenContext를 실행 중인 실행 컨텍스트로 둡니다.
2. acGen을 acGenContext의 Generator 구성 요소로 둡니다.
3. genBody가 Parse Node이면, 다음을 수행합니다.
  1. result를 Completion(genBody의 Evaluation)으로 둡니다.
4. 그렇지 않으면,
  1. 단언: genBody는 매개변수가 없는 Abstract Closure입니다.
  2. result를 Completion(genBody())로 둡니다.
5. 단언: 여기서 반환한다면 async generator는 예외를 던졌거나 암시적 또는 명시적 return을 수행했습니다.
6. acGenContext를 실행 컨텍스트 스택에서 제거하고 실행 컨텍스트 스택 맨 위의 실행 컨텍스트를 실행 중인 실행 컨텍스트로 복원합니다.
7. acGen.[[AsyncGeneratorState]]를 draining-queue로 설정합니다.
8. result가 normal completion이면 result를 NormalCompletion(undefined)으로 설정합니다.
9. result가 return completion이면 result를 NormalCompletion(result.[[Value]])으로 설정합니다.
10. AsyncGeneratorCompleteStep(acGen, result, true)를 수행합니다.
11. AsyncGeneratorDrainQueue(acGen)를 수행합니다.
12. callerContext를 실행 중인 실행 컨텍스트로 둡니다.
13. NormalCompletion(undefined)을 전달하여 callerContext를 재개합니다.
14. 단언: 이 단계에는 절대 도달하지 않습니다.
해당 실행 컨텍스트의 평가가 재개될 때 closure가 인수 없이 호출되도록 genContext의 코드 평가 상태를 설정합니다.
gen.[[AsyncGeneratorContext]]를 genContext로 설정합니다.
gen.[[AsyncGeneratorQueue]]를 새로운 빈 List로 설정합니다.
unused를 반환합니다.

27.9.3.3 AsyncGeneratorValidate ( `gen`, `genBrand` )

추상 연산 AsyncGeneratorValidate. 인수 gen (ECMAScript 언어 값) 및 genBrand ((String 또는 empty)). 반환값: (정상 완료 (값: unused) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireInternalSlot(gen, [[AsyncGeneratorContext]])를 수행합니다.
? RequireInternalSlot(gen, [[AsyncGeneratorState]])를 수행합니다.
? RequireInternalSlot(gen, [[AsyncGeneratorQueue]])를 수행합니다.
gen.[[GeneratorBrand]]가 genBrand가 아니면 TypeError 예외를 던집니다.
unused를 반환합니다.

27.9.3.4 AsyncGeneratorEnqueue ( `gen`, `completion`, `promiseCapability` )

추상 연산 AsyncGeneratorEnqueue. 인수 gen (AsyncGenerator), completion (완료 레코드) 및 promiseCapability (PromiseCapability 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

request를 AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability }로 둡니다.
request를 gen.[[AsyncGeneratorQueue]]에 추가합니다.
unused를 반환합니다.

27.9.3.5 AsyncGeneratorCompleteStep ( `gen`, `completion`, `done` [ , `realm` ] )

추상 연산 AsyncGeneratorCompleteStep. 인수 gen (AsyncGenerator), completion (완료 레코드) 및 done (Boolean) 및 선택적 인수 realm (Realm 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: gen.[[AsyncGeneratorQueue]]는 비어 있지 않습니다.
next를 gen.[[AsyncGeneratorQueue]]의 첫 번째 요소로 둡니다.
gen.[[AsyncGeneratorQueue]]에서 첫 번째 요소를 제거합니다.
promiseCapability을 next.[[Capability]]로 둡니다.
value를 completion.[[Value]]로 둡니다.
completion이 throw completion이면, 다음을 수행합니다.
1. ! Call(promiseCapability.[[Reject]], undefined, « value »)를 수행합니다.
그렇지 않으면,
1. 단언: completion은 normal completion입니다.
2. realm이 존재하면, 다음을 수행합니다.
  1. oldRealm을 실행 중인 실행 컨텍스트의 Realm으로 둡니다.
  2. 실행 중인 실행 컨텍스트의 Realm을 realm으로 설정합니다.
  3. iteratorResult를 CreateIteratorResultObject(value, done)로 둡니다.
  4. 실행 중인 실행 컨텍스트의 Realm을 oldRealm으로 설정합니다.
3. 그렇지 않으면,
  1. iteratorResult를 CreateIteratorResultObject(value, done)로 둡니다.
4. ! Call(promiseCapability.[[Resolve]], undefined, « iteratorResult »)를 수행합니다.
unused를 반환합니다.

27.9.3.6 AsyncGeneratorResume ( `gen`, `completion` )

추상 연산 AsyncGeneratorResume. 인수 gen (AsyncGenerator) 및 completion (완료 레코드). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: gen.[[AsyncGeneratorState]]는 suspended-start 또는 suspended-yield입니다.
genContext를 gen.[[AsyncGeneratorContext]]로 둡니다.
gen.[[AsyncGeneratorState]]를 executing으로 설정합니다.
! RunSuspendedContext(genContext, completion)을 수행합니다.
unused를 반환합니다.

27.9.3.7 AsyncGeneratorUnwrapYieldResumption ( `resumptionValue` )

추상 연산 AsyncGeneratorUnwrapYieldResumption. 인수 resumptionValue (완료 레코드). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

resumptionValue가 return completion이 아니면 ? resumptionValue를 반환합니다.
awaited를 Completion(Await(resumptionValue.[[Value]]))으로 둡니다.
awaited가 throw completion이면 ? awaited를 반환합니다.
단언: awaited는 normal completion입니다.
ReturnCompletion(awaited.[[Value]])을 반환합니다.

27.9.3.8 AsyncGeneratorYield ( `arg` )

추상 연산 AsyncGeneratorYield. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: ECMAScript 언어 값) 또는 중도 완료). 호출되면 다음 단계를 수행한다.

genContext를 실행 중인 실행 컨텍스트로 둡니다.
단언: genContext는 generator의 실행 컨텍스트입니다.
gen을 genContext의 Generator 구성 요소 값으로 둡니다.
단언: GetGeneratorKind()는 async입니다.
completion을 NormalCompletion(arg)으로 둡니다.
단언: 실행 컨텍스트 스택에는 최소 두 개의 요소가 있습니다.
previousContext를 실행 컨텍스트 스택에서 위에서 두 번째 요소로 둡니다.
previousRealm을 previousContext의 Realm으로 둡니다.
AsyncGeneratorCompleteStep(gen, completion, false, previousRealm)을 수행합니다.
queue를 gen.[[AsyncGeneratorQueue]]로 둡니다.
queue가 비어 있지 않으면, 다음을 수행합니다.
1. 참고: generator를 일시 중단하지 않고 실행이 계속됩니다.
2. toYield를 queue의 첫 번째 요소로 둡니다.
3. resumptionValue를 Completion(toYield.[[Completion]])으로 둡니다.
4. ? AsyncGeneratorUnwrapYieldResumption(resumptionValue)을 반환합니다.
gen.[[AsyncGeneratorState]]를 suspended-yield로 설정합니다.
resumptionValue를 Completion(RunCallerContext(undefined))으로 둡니다.
? AsyncGeneratorUnwrapYieldResumption(resumptionValue)을 반환합니다.

27.9.3.9 AsyncGeneratorAwaitReturn ( `gen` )

추상 연산 AsyncGeneratorAwaitReturn. 인수 gen (AsyncGenerator). 반환값: unused. 호출되면 다음 단계를 수행한다.

단언: gen.[[AsyncGeneratorState]]는 draining-queue입니다.
queue를 gen.[[AsyncGeneratorQueue]]로 둡니다.
단언: queue는 비어 있지 않습니다.
next를 queue의 첫 번째 요소로 둡니다.
completion을 Completion(next.[[Completion]])으로 둡니다.
단언: completion은 return completion입니다.
promiseCompletion을 Completion(PromiseResolve(%Promise%, completion.[[Value]]))으로 둡니다.
promiseCompletion이 abrupt completion이면, 다음을 수행합니다.
1. AsyncGeneratorCompleteStep(gen, promiseCompletion, true)를 수행합니다.
2. AsyncGeneratorDrainQueue(gen)를 수행합니다.
3. unused를 반환합니다.
단언: promiseCompletion은 normal completion입니다.
promise를 promiseCompletion.[[Value]]로 둡니다.
fulfilledClosure를 매개변수 (value)를 가지며 gen을 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. 단언: gen.[[AsyncGeneratorState]]는 draining-queue입니다.
2. result를 NormalCompletion(value)으로 둡니다.
3. AsyncGeneratorCompleteStep(gen, result, true)를 수행합니다.
4. AsyncGeneratorDrainQueue(gen)를 수행합니다.
5. NormalCompletion(undefined)을 반환합니다.
onFulfilled를 CreateBuiltinFunction(fulfilledClosure, 1, "", « »)로 둡니다.
rejectedClosure를 매개변수 (reason)을 가지며 gen을 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. 단언: gen.[[AsyncGeneratorState]]는 draining-queue입니다.
2. result를 ThrowCompletion(reason)으로 둡니다.
3. AsyncGeneratorCompleteStep(gen, result, true)를 수행합니다.
4. AsyncGeneratorDrainQueue(gen)를 수행합니다.
5. NormalCompletion(undefined)을 반환합니다.
onRejected를 CreateBuiltinFunction(rejectedClosure, 1, "", « »)로 둡니다.
PerformPromiseThen(promise, onFulfilled, onRejected)을 수행합니다.
unused를 반환합니다.

27.9.3.10 AsyncGeneratorDrainQueue ( `gen` )

추상 연산 AsyncGeneratorDrainQueue. 인수 gen (AsyncGenerator). 반환값: unused. return completion을 보유하는 AsyncGeneratorRequest를 만날 때까지 generator의 AsyncGeneratorQueue를 비웁니다. 호출되면 다음 단계를 수행한다.

단언: gen.[[AsyncGeneratorState]]는 draining-queue입니다.
queue를 gen.[[AsyncGeneratorQueue]]로 둡니다.
queue가 비어 있지 않은 동안 다음을 반복합니다.
1. next를 queue의 첫 번째 요소로 둡니다.
2. completion을 Completion(next.[[Completion]])으로 둡니다.
3. completion이 return completion이면, 다음을 수행합니다.
  1. AsyncGeneratorAwaitReturn(gen)을 수행합니다.
  2. unused를 반환합니다.
4. completion이 normal completion이면, 다음을 수행합니다.
  1. completion을 NormalCompletion(undefined)으로 설정합니다.
5. AsyncGeneratorCompleteStep(gen, completion, true)를 수행합니다.
gen.[[AsyncGeneratorState]]를 completed로 설정합니다.
unused를 반환합니다.

27.10 AsyncFunction 객체

AsyncFunction은 일반적으로 AsyncFunctionDeclaration, AsyncFunctionExpression, AsyncMethod, AsyncArrowFunction을 평가하여 생성되는 함수입니다. %AsyncFunction% 내재 객체를 호출하여 생성할 수도 있습니다.

27.10.1 AsyncFunction 생성자

AsyncFunction 생성자는:

%AsyncFunction%입니다.
Function의 하위 클래스입니다.
생성자가 아니라 함수로 호출되면 새로운 AsyncFunction을 생성하고 초기화합니다. 따라서 함수 호출 AsyncFunction(…)은 같은 인수를 사용하는 객체 생성 표현식 new AsyncFunction(…)과 동등합니다.
클래스 정의의 extends 절 값으로 사용할 수 있습니다. 지정된 AsyncFunction 동작을 상속하려는 하위 클래스 생성자는 내장 async 함수 동작에 필요한 내부 슬롯을 갖도록 하위 클래스 인스턴스를 생성하고 초기화하기 위해 AsyncFunction 생성자에 대한 super 호출을 포함해야 합니다. async 함수 객체를 정의하는 모든 ECMAScript 구문 형식은 AsyncFunction의 직접 인스턴스를 생성합니다. AsyncFunction 하위 클래스의 인스턴스를 생성하는 구문적 방법은 없습니다.

27.10.1.1 AsyncFunction ( ...`paramArgs`, `bodyArg` )

마지막 인수(있는 경우)는 async 함수의 본문(실행 가능한 코드)을 지정합니다. 그 앞의 모든 인수는 형식 매개변수를 지정합니다.

이 함수는 호출되면 다음 단계를 수행합니다:

activeFunc를 활성 함수 객체로 둡니다.
bodyArg가 존재하지 않으면 bodyArg를 빈 String으로 설정합니다.
? CreateDynamicFunction(activeFunc, NewTarget, async, paramArgs, bodyArg)를 반환합니다.

참고

20.2.1.1의 참고를 참조하시기 바랍니다.

27.10.2 AsyncFunction 생성자의 프로퍼티

AsyncFunction 생성자는:

Function 생성자에서 상속하는 표준 내장 함수 객체입니다.
값이 %Function%인 [[Prototype]] 내부 슬롯을 갖습니다.
값이 1_𝔽인 "length" 프로퍼티를 갖습니다.
값이 "AsyncFunction"인 "name" 프로퍼티를 갖습니다.
다음 프로퍼티를 갖습니다:

27.10.2.1 AsyncFunction.prototype

AsyncFunction.prototype의 초기 값은 AsyncFunction 프로토타입 객체입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

27.10.3 AsyncFunction 프로토타입 객체의 프로퍼티

AsyncFunction 프로토타입 객체는:

%AsyncFunction.prototype%입니다.
일반 객체입니다.
함수 객체가 아니며 [[ECMAScriptCode]] 내부 슬롯이나 표 26에 나열된 다른 내부 슬롯을 갖지 않습니다.
값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.

27.10.3.1 AsyncFunction.prototype.constructor

AsyncFunction.prototype.constructor의 초기 값은 %AsyncFunction%입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.10.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "AsyncFunction"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

27.10.4 AsyncFunction 인스턴스

모든 AsyncFunction 인스턴스는 ECMAScript 함수 객체이며 표 26에 나열된 내부 슬롯을 갖습니다. 이러한 모든 인스턴스의 [[IsClassConstructor]] 내부 슬롯 값은 false입니다. AsyncFunction 인스턴스는 생성자가 아니며 [[Construct]] 내부 메서드를 갖지 않습니다. AsyncFunction 인스턴스는 생성할 수 없으므로 prototype 프로퍼티를 갖지 않습니다.

각 AsyncFunction 인스턴스에는 다음 자체 프로퍼티가 있습니다:

27.10.4.1 length

20.2.4.1에 제시된 Function 인스턴스의 "length" 프로퍼티 명세는 AsyncFunction 인스턴스에도 적용됩니다.

27.10.4.2 name

20.2.4.2에 제시된 Function 인스턴스의 "name" 프로퍼티 명세는 AsyncFunction 인스턴스에도 적용됩니다.

27.10.5 Async 함수 추상 연산

27.10.5.1 AsyncFunctionStart ( `promiseCapability`, `asyncFuncBody` )

추상 연산 AsyncFunctionStart. 인수 promiseCapability (PromiseCapability 레코드) 및 asyncFuncBody ((a FunctionBody Parse Node, an ExpressionBody Parse Node 또는 매개변수가 없는 추상 클로저)). 반환값: unused. 호출되면 다음 단계를 수행한다.

runningContext를 실행 중인 실행 컨텍스트로 둡니다.
asyncContext를 runningContext의 복사본으로 둡니다.
참고: AsyncBlockStart가 실행을 재개하려면 실행 상태를 복사해야 합니다. 현재 실행 중인 컨텍스트를 재개하는 것은 정의되지 않습니다.
AsyncBlockStart(promiseCapability, asyncFuncBody, asyncContext)를 수행합니다.
unused를 반환합니다.

27.10.5.2 AsyncBlockStart ( `promiseCapability`, `asyncBody`, `asyncContext` )

추상 연산 AsyncBlockStart. 인수 promiseCapability (PromiseCapability 레코드), asyncBody ((구문 분석 노드 또는 매개변수가 없는 추상 클로저)) 및 asyncContext (실행 컨텍스트). 반환값: unused. 호출되면 다음 단계를 수행한다.

closure를 매개변수가 없고 promiseCapability과 asyncBody를 캡처하며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. acAsyncContext를 실행 중인 실행 컨텍스트로 둡니다.
2. asyncBody가 Parse Node이면, 다음을 수행합니다.
  1. result를 Completion(asyncBody의 Evaluation)으로 둡니다.
3. 그렇지 않으면,
  1. 단언: asyncBody는 매개변수가 없는 Abstract Closure입니다.
  2. result를 Completion(asyncBody())로 둡니다.
4. 단언: 여기서 반환한다면 async 함수는 예외를 던졌거나 암시적 또는 명시적 return을 수행했으며 모든 await가 완료되었습니다.
5. acAsyncContext를 실행 컨텍스트 스택에서 제거하고 실행 컨텍스트 스택 맨 위의 실행 컨텍스트를 실행 중인 실행 컨텍스트로 복원합니다.
6. result가 normal completion이면, 다음을 수행합니다.
  1. ! Call(promiseCapability.[[Resolve]], undefined, « undefined »)를 수행합니다.
7. 그렇지 않고 result가 return completion이면, 다음을 수행합니다.
  1. ! Call(promiseCapability.[[Resolve]], undefined, « result.[[Value]] »)를 수행합니다.
8. 그렇지 않으면,
  1. 단언: result는 throw completion입니다.
  2. ! Call(promiseCapability.[[Reject]], undefined, « result.[[Value]] »)를 수행합니다.
9. callerContext를 실행 중인 실행 컨텍스트로 둡니다.
10. NormalCompletion(unused)을 전달하여 callerContext를 재개합니다.
11. 단언: 이 단계에는 절대 도달하지 않습니다.
해당 실행 컨텍스트의 평가가 재개될 때 closure가 인수 없이 호출되도록 asyncContext의 코드 평가 상태를 설정합니다.
result를 ! RunSuspendedContext(asyncContext, NormalCompletion(empty))로 둡니다.
단언: result는 unused입니다.
참고: result 값의 가능한 출처는 Await 또는 async 함수가 아무것도 await하지 않는 경우 위의 1.j 단계입니다.
unused를 반환합니다.

27.10.5.3 Await ( `arg` )

추상 연산 Await. 인수 arg (ECMAScript 언어 값). 반환값: (정상 완료 (값: (ECMAScript 언어 값 또는 empty)) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

asyncContext를 실행 중인 실행 컨텍스트로 둡니다.
promise를 ? PromiseResolve(%Promise%, arg)로 둡니다.
fulfilledClosure를 매개변수 (value)를 가지며 asyncContext를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. Completion(RunSuspendedContext(asyncContext, NormalCompletion(value)))을 수행합니다.
2. 참고: RunSuspendedContext가 반환하는 Completion Record는 의도적으로 무시됩니다.
3. NormalCompletion(undefined)을 반환합니다.
onFulfilled를 CreateBuiltinFunction(fulfilledClosure, 1, "", « »)로 둡니다.
rejectedClosure를 매개변수 (reason)을 가지며 asyncContext를 캡처하고 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. Completion(RunSuspendedContext(asyncContext, ThrowCompletion(reason)))을 수행합니다.
2. 참고: RunSuspendedContext가 반환하는 Completion Record는 의도적으로 무시됩니다.
3. NormalCompletion(undefined)을 반환합니다.
onRejected를 CreateBuiltinFunction(rejectedClosure, 1, "", « »)로 둡니다.
PerformPromiseThen(promise, onFulfilled, onRejected)을 수행합니다.
? RunCallerContext(empty)를 반환합니다.

28 리플렉션

28.1 Reflect 객체

Reflect 객체는:

%Reflect%입니다.
전역 객체의 "Reflect" 프로퍼티의 초기 값입니다.
일반 객체입니다.
값이 %Object.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
함수 객체가 아닙니다.
[[Construct]] 내부 메서드를 갖지 않으므로 new 연산자와 함께 생성자로 사용할 수 없습니다.
[[Call]] 내부 메서드를 갖지 않으므로 함수로 호출할 수 없습니다.

28.1.1 Reflect.apply ( `target`, `thisArg`, `args` )

이 함수는 호출되면 다음 단계를 수행합니다:

IsCallable(target)이 false이면 TypeError 예외를 던집니다.
argList를 ? CreateListFromArrayLike(args)로 둡니다.
PrepareForTailCall()을 수행합니다.
? Call(target, thisArg, argList)를 반환합니다.

28.1.2 Reflect.construct ( `target`, `args` [ , `newTarget` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

IsConstructor(target)가 false이면 TypeError 예외를 던집니다.
newTarget이 존재하지 않으면 newTarget을 target으로 설정합니다.
그렇지 않고 IsConstructor(newTarget)가 false이면 TypeError 예외를 던집니다.
argList를 ? CreateListFromArrayLike(args)로 둡니다.
? Construct(target, argList, newTarget)을 반환합니다.

28.1.3 Reflect.defineProperty ( `target`, `key`, `attrs` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
propertyDesc를 ? ToPropertyDescriptor(attrs)로 둡니다.
? target.[[DefineOwnProperty]](propertyKey, propertyDesc)를 반환합니다.

28.1.4 Reflect.deleteProperty ( `target`, `key` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
? target.[[Delete]](propertyKey)를 반환합니다.

28.1.5 Reflect.get ( `target`, `key` [ , `receiver` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
receiver가 존재하지 않으면, 다음을 수행합니다.
1. receiver를 target으로 설정합니다.
? target.[[Get]](propertyKey, receiver)를 반환합니다.

28.1.6 Reflect.getOwnPropertyDescriptor ( `target`, `key` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
propertyDesc를 ? target.[[GetOwnProperty]](propertyKey)로 둡니다.
FromPropertyDescriptor(propertyDesc)를 반환합니다.

28.1.7 Reflect.getPrototypeOf ( `target` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
? target.[[GetPrototypeOf]]()를 반환합니다.

28.1.8 Reflect.has ( `target`, `key` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
? target.[[HasProperty]](propertyKey)를 반환합니다.

28.1.9 Reflect.isExtensible ( `target` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
? target.[[IsExtensible]]()를 반환합니다.

28.1.10 Reflect.ownKeys ( `target` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
keys를 ? target.[[OwnPropertyKeys]]()로 둡니다.
CreateArrayFromList(keys)를 반환합니다.

28.1.11 Reflect.preventExtensions ( `target` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
? target.[[PreventExtensions]]()를 반환합니다.

28.1.12 Reflect.set ( `target`, `key`, `value` [ , `receiver` ] )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
propertyKey를 ? ToPropertyKey(key)로 둡니다.
receiver가 존재하지 않으면, 다음을 수행합니다.
1. receiver를 target으로 설정합니다.
? target.[[Set]](propertyKey, value, receiver)를 반환합니다.

28.1.13 Reflect.setPrototypeOf ( `target`, `proto` )

이 함수는 호출되면 다음 단계를 수행합니다:

target이 Object가 아니면 TypeError 예외를 던집니다.
proto가 Object가 아니고 proto가 null도 아니면 TypeError 예외를 던집니다.
? target.[[SetPrototypeOf]](proto)를 반환합니다.

28.1.14 Reflect [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Reflect"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true } 속성을 갖습니다.

28.2 Proxy 객체

28.2.1 Proxy 생성자

Proxy 생성자는:

%Proxy%입니다.
전역 객체의 "Proxy" 프로퍼티의 초기 값입니다.
생성자로 호출되면 새로운 Proxy 객체를 생성하고 초기화합니다.
함수로 호출하도록 의도되지 않았으며 그러한 방식으로 호출되면 예외를 던집니다.

28.2.1.1 Proxy ( `target`, `handler` )

이 함수는 호출되면 다음 단계를 수행합니다:

NewTarget이 undefined이면 TypeError 예외를 던집니다.
? ProxyCreate(target, handler)를 반환합니다.

28.2.2 Proxy 생성자의 프로퍼티

Proxy 생성자는:

값이 %Function.prototype%인 [[Prototype]] 내부 슬롯을 갖습니다.
Proxy 객체에는 초기화가 필요한 [[Prototype]] 내부 슬롯이 없으므로 "prototype" 프로퍼티를 갖지 않습니다.
다음 프로퍼티를 갖습니다:

28.2.2.1 Proxy.revocable ( `target`, `handler` )

이 함수는 취소 가능한 Proxy 객체를 생성합니다.

호출되면 다음 단계를 수행합니다:

proxy를 ? ProxyCreate(target, handler)로 둡니다.
revokerClosure를 매개변수가 없고 아무것도 캡처하지 않으며 호출될 때 다음 단계를 수행하는 새로운 Abstract Closure로 둡니다:
1. activeFunc를 활성 함수 객체로 둡니다.
2. revocableProxy를 activeFunc.[[RevocableProxy]]로 둡니다.
3. revocableProxy가 null이면 NormalCompletion(undefined)을 반환합니다.
4. activeFunc.[[RevocableProxy]]를 null로 설정합니다.
5. 단언: revocableProxy는 Proxy 특수 객체입니다.
6. revocableProxy.[[ProxyTarget]]을 null로 설정합니다.
7. revocableProxy.[[ProxyHandler]]를 null로 설정합니다.
8. NormalCompletion(undefined)을 반환합니다.
revoker를 CreateBuiltinFunction(revokerClosure, 0, "", « [[RevocableProxy]] »)로 둡니다.
revoker.[[RevocableProxy]]를 proxy로 설정합니다.
result를 OrdinaryObjectCreate(%Object.prototype%)로 둡니다.
! CreateDataPropertyOrThrow(result, "proxy", proxy)를 수행합니다.
! CreateDataPropertyOrThrow(result, "revoke", revoker)를 수행합니다.
result를 반환합니다.

28.3 모듈 네임스페이스 객체

모듈 네임스페이스 객체는 모듈의 내보낸 바인딩에 런타임 프로퍼티 기반 접근을 제공하는 모듈 네임스페이스 특수 객체입니다. 모듈 네임스페이스 객체에는 생성자 함수가 없습니다. 대신 NameSpaceImport를 포함하는 ImportDeclaration에 의해 가져온 각 모듈에 대해 그러한 객체가 생성됩니다.

10.4.6에 지정된 프로퍼티에 더하여 각 모듈 네임스페이스 객체에는 다음 자체 프로퍼티가 있습니다:

28.3.1 %Symbol.toStringTag%

%Symbol.toStringTag% 프로퍼티의 초기 값은 String 값 "Module"입니다.

이 프로퍼티는 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false } 속성을 갖습니다.

29 메모리 모델

메모리 일관성 모델, 즉 메모리 모델은 SharedArrayBuffer를 기반으로 하는 TypedArray 인스턴스에 접근하거나 Atomics 객체의 메서드를 통해 발생하는 Shared Data Block 이벤트의 가능한 순서를 지정합니다. 프로그램에 데이터 경합(아래 정의)이 없으면 이벤트 순서는 순차적 일관성을 갖는 것처럼, 즉 각 에이전트의 동작이 서로 교차하여 실행되는 것처럼 보입니다. 프로그램에 데이터 경합이 있으면 공유 메모리 연산은 순차적으로 일관되지 않게 보일 수 있습니다. 예를 들어 프로그램은 인과성을 위반하는 동작과 그 밖의 놀라운 동작을 보일 수 있습니다. 이러한 놀라운 동작은 컴파일러 변환과 CPU 설계(예: 비순차 실행 및 추측 실행)에서 발생합니다. 메모리 모델은 프로그램이 순차적으로 일관된 동작을 보이는 정확한 조건과 데이터 경합에서 읽을 수 있는 가능한 값을 모두 정의합니다. 즉, 정의되지 않은 동작은 없습니다.

메모리 모델은 평가 중 SharedArrayBuffer에 대한 추상 연산 또는 Atomics 객체의 메서드가 도입하는 Memory 이벤트에 대한 관계적 제약으로 정의됩니다.

참고

이 절은 SharedArrayBuffer에 대한 추상 연산이 도입하는 Memory 이벤트에 대한 공리적 모델을 제공합니다. 이 명세의 나머지 부분과 달리 이 모델은 알고리즘으로 표현할 수 없다는 점을 강조합니다. 추상 연산에 의한 이벤트의 비결정적 도입은 ECMAScript 평가의 연산 의미론과 메모리 모델의 공리적 의미론 사이의 인터페이스입니다. 이러한 이벤트의 의미론은 평가의 모든 이벤트 그래프를 고려하여 정의됩니다. 이는 정적 의미론도 런타임 의미론도 아닙니다. 입증된 알고리즘 구현은 없으며, 대신 특정 이벤트 그래프가 허용되는지 허용되지 않는지를 결정하는 제약 조건 집합이 있습니다.

29.1 메모리 모델의 기본 사항

공유 메모리 접근(읽기 및 쓰기)은 아래에 정의된 원자적 접근과 데이터 접근이라는 두 그룹으로 나뉩니다. 원자적 접근은 순차적으로 일관됩니다. 즉, 에이전트 클러스터의 모든 에이전트가 동의하는 이벤트의 엄격한 전순서가 있습니다. 비원자적 접근에는 모든 에이전트가 동의하는 엄격한 전순서가 없습니다. 즉, 순서가 지정되지 않습니다.

참고 1

순차적 일관성보다 약하고 순서 없음보다 강한 release-acquire와 같은 순서는 지원되지 않습니다.

Shared Data Block 이벤트는 ReadSharedMemory, WriteSharedMemory, ReadModifyWriteSharedMemory Record 중 하나입니다. 읽기 이벤트는 ReadSharedMemory 또는 ReadModifyWriteSharedMemory입니다. 쓰기 이벤트는 WriteSharedMemory 또는 ReadModifyWriteSharedMemory입니다.

표 97: ReadSharedMemory 이벤트 필드

필드 이름	값	의미
`[[Order]]`	seq-cst or unordered	메모리 모델이 이 이벤트에 대해 보장하는 가장 약한 순서입니다.
`[[NoTear]]`	a Boolean	이 이벤트가 자신과 동일한 메모리 범위를 갖는 여러 쓰기 이벤트에서 읽는 것이 허용되는지 여부입니다.
`[[Block]]`	a Shared Data Block	이벤트가 동작하는 블록입니다.
`[[ByteIndex]]`	a non-negative integer	`[[Block]]`에서 읽기의 바이트 주소입니다.
`[[ElementSize]]`	a non-negative integer	읽기의 크기입니다.

표 98: WriteSharedMemory 이벤트 필드

필드 이름	값	의미
`[[Order]]`	seq-cst, unordered, or init	메모리 모델이 이 이벤트에 대해 보장하는 가장 약한 순서입니다.
`[[NoTear]]`	a Boolean	이 이벤트를 자신과 동일한 메모리 범위를 갖는 여러 읽기 이벤트가 읽는 것이 허용되는지 여부입니다.
`[[Block]]`	a Shared Data Block	이벤트가 동작하는 블록입니다.
`[[ByteIndex]]`	a non-negative integer	`[[Block]]`에서 쓰기의 바이트 주소입니다.
`[[ElementSize]]`	a non-negative integer	쓰기의 크기입니다.
`[[Payload]]`	a List of byte values	다른 이벤트가 읽을 바이트 값의 List입니다.

표 99: ReadModifyWriteSharedMemory 이벤트 필드

필드 이름	값	의미
`[[Order]]`	seq-cst	Read-modify-write 이벤트는 항상 순차적으로 일관됩니다.
`[[NoTear]]`	true	Read-modify-write 이벤트는 찢어질 수 없습니다.
`[[Block]]`	a Shared Data Block	이벤트가 동작하는 블록입니다.
`[[ByteIndex]]`	a non-negative integer	`[[Block]]`에서 read-modify-write의 바이트 주소입니다.
`[[ElementSize]]`	a non-negative integer	read-modify-write의 크기입니다.
`[[Payload]]`	a List of byte values	`[[ModifyOp]]`에 전달할 바이트 값의 List입니다.
`[[ModifyOp]]`	a read-modify-write modification function	읽은 바이트 값의 List와 `[[Payload]]`에서 수정된 바이트 값의 List를 반환하는 Abstract Closure입니다.

Shared Data Block 이벤트는 추상 연산 또는 Atomics 객체의 메서드에 의해 후보 실행의 Agent Events Records에 도입됩니다. 일부 연산은 필드가 없으며 순전히 다른 이벤트의 허용 가능한 순서를 직접 제한하기 위해 존재하는 Synchronize 이벤트도 도입합니다. 마지막으로 호스트별 이벤트가 있습니다. Memory 이벤트는 Shared Data Block 이벤트, Synchronize 이벤트 또는 그러한 호스트별 이벤트 중 하나입니다.

Shared Data Block 이벤트 e의 메모리 범위를 e.[[ByteIndex]](포함)부터 e.[[ByteIndex]] + e.[[ElementSize]](제외)까지 구간에 있는 모든 정수의 Set으로 둡니다. 두 이벤트가 같은 [[Block]], [[ByteIndex]], [[ElementSize]]를 가지면 두 이벤트의 메모리 범위는 같습니다. 두 이벤트가 같은 [[Block]]을 가지고 범위가 같지 않으며 교집합이 비어 있지 않으면 두 이벤트의 메모리 범위는 겹칩니다. 두 이벤트가 같은 [[Block]]을 갖지 않거나 그 범위가 같지도 겹치지도 않으면 두 이벤트의 메모리 범위는 서로 분리되어 있습니다.

참고 2

고려해야 하는 호스트별 동기화 이벤트의 예로는 한 에이전트에서 다른 에이전트로 SharedArrayBuffer를 보내는 것(예: 브라우저의 postMessage), 에이전트를 시작하고 중지하는 것, 공유 메모리 이외의 채널을 통해 에이전트 클러스터 내에서 통신하는 것이 있습니다. 특정 실행 execution에 대해 이러한 이벤트는 host-synchronizes-with 엄격 부분 순서를 통해 호스트가 제공합니다. 또한 호스트는 is-agent-order-before Relation에 참여하도록 호스트별 동기화 이벤트를 execution.[[EventList]]에 추가할 수 있습니다.

이벤트는 아래에 정의된 관계에 따라 후보 실행 내에서 순서가 정해집니다.

29.2 Agent Events Records

Agent Events Record는 다음 필드를 갖는 Record입니다.

표 100: Agent Events Record 필드

필드 이름	값	의미
`[[AgentSignifier]]`	an agent signifier	평가로 인해 이 순서가 발생한 에이전트입니다.
`[[EventList]]`	a List of Memory events	이벤트는 평가 중 이 List에 추가됩니다.
`[[AgentSynchronizesWith]]`	a List of pairs of Synchronize events	연산 의미론이 도입한 Synchronize 관계입니다.

29.3 Chosen Value Records

Chosen Value Record는 다음 필드를 갖는 Record입니다.

표 101: Chosen Value Record 필드

필드 이름	값	의미
`[[Event]]`	a Shared Data Block event	이 선택된 값에 대해 도입된 ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트입니다.
`[[ChosenValue]]`	a List of byte values	평가 중 비결정적으로 선택된 바이트입니다.

29.4 후보 실행

에이전트 클러스터 평가의 후보 실행은 다음 필드를 갖는 Record입니다.

표 102: 후보 실행 Record 필드

필드 이름	값	의미
`[[EventsRecords]]`	a List of Agent Events Records	에이전트를 평가 중 추가된 Memory 이벤트의 List에 매핑합니다.
`[[ChosenValues]]`	a List of Chosen Value Records	ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트를 평가 중 선택된 바이트 값의 List에 매핑합니다.

빈 후보 실행은 필드가 빈 List인 후보 실행 Record입니다.

29.5 메모리 모델을 위한 추상 연산

29.5.1 EventSet ( `execution` )

추상 연산 EventSet. 인수 execution (a candidate execution). 반환값: a Set of Memory events. 호출되면 다음 단계를 수행한다.

events를 빈 Set으로 둡니다.
execution.[[EventsRecords]]의 각 Agent Events Record eventsRecord에 대해 다음을 수행합니다.
1. eventsRecord.[[EventList]]의 각 Memory 이벤트 event에 대해 다음을 수행합니다.
  1. event를 events에 추가합니다.
events를 반환합니다.

29.5.2 SharedDataBlockEventSet ( `execution` )

추상 연산 SharedDataBlockEventSet. 인수 execution (a candidate execution). 반환값: a Set of Shared Data Block events. 호출되면 다음 단계를 수행한다.

events를 빈 Set으로 둡니다.
EventSet(execution)의 각 Memory 이벤트 event에 대해 다음을 수행합니다.
1. event가 Shared Data Block 이벤트이면 event를 events에 추가합니다.
events를 반환합니다.

29.5.3 HostEventSet ( `execution` )

추상 연산 HostEventSet. 인수 execution (a candidate execution). 반환값: a Set of Memory events. 호출되면 다음 단계를 수행한다.

SharedDataBlockEventSet(execution)에 포함되지 않은 EventSet(execution)의 모든 요소를 포함하는 새로운 Set을 반환합니다.

29.5.4 ComposeWriteEventBytes ( `execution`, `byteIndex`, `writes` )

추상 연산 ComposeWriteEventBytes. 인수 execution (a candidate execution), byteIndex (음이 아닌 정수) 및 writes (리스트 (요소: (WriteSharedMemory 또는 ReadModifyWriteSharedMemory events))). 반환값: 리스트 (요소: 바이트 값). 호출되면 다음 단계를 수행한다.

byteLocation을 byteIndex로 둡니다.
bytesRead를 새로운 빈 List로 둡니다.
writes의 각 요소 writeEvent에 대해 다음을 수행합니다.
1. 단언: writeEvent는 자신의 메모리 범위에 byteLocation을 포함합니다.
2. payloadIndex를 byteLocation - writeEvent.[[ByteIndex]]로 둡니다.
3. writeEvent가 WriteSharedMemory 이벤트이면, 다음을 수행합니다.
  1. byte를 writeEvent.[[Payload]][payloadIndex]로 둡니다.
4. 그렇지 않으면,
  1. 단언: writeEvent는 ReadModifyWriteSharedMemory 이벤트입니다.
  2. bytes를 ValueOfReadEvent(execution, writeEvent)로 둡니다.
  3. bytesModified를 writeEvent.[[ModifyOp]](bytes, writeEvent.[[Payload]])로 둡니다.
  4. byte를 bytesModified[payloadIndex]로 둡니다.
5. byte를 bytesRead에 추가합니다.
6. byteLocation을 byteLocation + 1로 설정합니다.
bytesRead를 반환합니다.

참고 1

read-modify-write 수정 [[ModifyOp]]는 ReadModifyWriteSharedMemory 이벤트를 도입하는 Atomics 객체의 함수 프로퍼티에 의해 제공됩니다.

참고 2

이 추상 연산은 쓰기 이벤트의 List를 바이트 값의 List로 구성합니다. ReadSharedMemory 및 ReadModifyWriteSharedMemory 이벤트의 이벤트 의미론에서 사용됩니다.

29.5.5 ValueOfReadEvent ( `execution`, `readEvent` )

추상 연산 ValueOfReadEvent. 인수 execution (a candidate execution) 및 readEvent ((a ReadSharedMemory 또는 ReadModifyWriteSharedMemory event)). 반환값: 리스트 (요소: 바이트 값). 호출되면 다음 단계를 수행한다.

writes를 execution에서 reads-bytes-from(readEvent)으로 둡니다.
단언: writes는 길이가 readEvent.[[ElementSize]]와 같은 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트의 List입니다.
ComposeWriteEventBytes(execution, readEvent.[[ByteIndex]], writes)를 반환합니다.

29.6 후보 실행의 관계

다음 관계와 수학적 함수는 특정 후보 실행에 대해 매개변수화되며 그 Memory 이벤트의 순서를 정합니다.

29.6.1 is-agent-order-before

후보 실행 execution에 대해 해당 is-agent-order-before Relation은 다음을 만족하는 Memory 이벤트에 대한 최소 Relation입니다.

이벤트 eventA와 eventB에 대해, execution.[[EventsRecords]]에 eventA와 eventB를 모두 포함하는 [[EventList]]를 가진 Agent Events Record eventsRecord가 있고 eventsRecord.[[EventList]]의 List 순서에서 eventA가 eventB보다 앞서면 execution에서 eventA is-agent-order-before eventB입니다.

참고

각 에이전트는 평가 중 에이전트별 엄격 전순서로 이벤트를 도입합니다. 이는 그러한 엄격 전순서들의 합집합입니다.

29.6.2 reads-bytes-from

후보 실행 execution에 대해 해당 reads-bytes-from 함수는 SharedDataBlockEventSet(execution)의 Memory 이벤트를 SharedDataBlockEventSet(execution)의 이벤트 List에 매핑하며 다음 조건을 만족하는 수학적 함수입니다.

SharedDataBlockEventSet(execution)의 각 ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 readEvent에 대해, execution에서 reads-bytes-from(readEvent)은 길이가 readEvent.[[ElementSize]]인 List이며 그 요소는 다음이 모두 참인 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 writes입니다.
- writes에서 인덱스 i인 각 이벤트 writeEvent는 자신의 메모리 범위에 readEvent.[[ByteIndex]] + i를 포함합니다.
- result는 writes에 포함되지 않습니다.

후보 실행에는 항상 reads-bytes-from 함수가 존재합니다.

29.6.3 reads-from

후보 실행 execution에 대해 해당 reads-from Relation은 다음을 만족하는 Memory 이벤트에 대한 최소 Relation입니다.

이벤트 readEvent와 writeEvent에 대해 SharedDataBlockEventSet(execution)이 readEvent와 writeEvent를 모두 포함하고 execution에서 reads-bytes-from(readEvent)이 writeEvent를 포함하면 execution에서 readEvent reads-from writeEvent입니다.

29.6.4 host-synchronizes-with

후보 실행 execution에 대해 해당 host-synchronizes-with Relation은 적어도 다음을 만족하는 호스트별 Memory 이벤트에 대한 호스트 제공 엄격 부분 순서입니다.

execution에서 eventA host-synchronizes-with eventB이면 HostEventSet(execution)은 eventA와 eventB를 포함합니다.
execution에서 host-synchronizes-with와 is-agent-order-before의 합집합에는 순환이 없습니다.

참고 1

후보 실행 execution의 두 호스트별 이벤트 eventA와 eventB에 대해 execution에서 eventA host-synchronizes-with eventB이면 execution에서 eventA happens-before eventB입니다.

참고 2

이 Relation을 통해 호스트는 HTML worker 사이의 postMessage와 같은 추가 동기화 메커니즘을 제공할 수 있습니다.

29.6.5 synchronizes-with

후보 실행 execution에 대해 해당 synchronizes-with Relation은 다음을 만족하는 Memory 이벤트에 대한 최소 Relation입니다.

이벤트 readEvent와 writeEvent에 대해 execution에서 readEvent reads-from writeEvent이고, readEvent.[[Order]]가 seq-cst이고, writeEvent.[[Order]]가 seq-cst이며, readEvent와 writeEvent의 메모리 범위가 같으면 execution에서 writeEvent synchronizes-with readEvent입니다.
execution.[[EventsRecords]]의 각 요소 eventsRecord에 대해 다음이 참입니다.
- 이벤트 eventA와 eventB에 대해 eventsRecord.[[AgentSynchronizesWith]]가 (eventA, eventB)를 포함하면 execution에서 eventA synchronizes-with eventB입니다.
이벤트 eventA와 eventB에 대해 execution에서 eventA host-synchronizes-with eventB이면 execution에서 eventA synchronizes-with eventB입니다.

참고 1

메모리 모델 문헌의 관례에 따라 후보 실행 execution에서는 읽기 이벤트가 쓰기 이벤트와 synchronizes-with하는 것이 아니라 쓰기 이벤트가 읽기 이벤트와 synchronizes-with합니다.

참고 2

후보 실행 execution에서 init 이벤트는 이 Relation에 참여하지 않으며 대신 happens-before에 의해 직접 제약됩니다.

참고 3

후보 실행 execution에서 reads-from으로 관련된 모든 seq-cst 이벤트가 synchronizes-with로 관련되는 것은 아닙니다. 메모리 범위도 같은 이벤트만 synchronizes-with로 관련됩니다.

참고 4

후보 실행 execution에서 writeEvent synchronizes-with readEvent인 Shared Data Block 이벤트 readEvent와 writeEvent에 대해 readEvent는 writeEvent 이외의 다른 쓰기에서도 reads-from할 수 있습니다.

29.6.6 happens-before

후보 실행 execution에 대해 해당 happens-before Relation은 다음을 만족하는 Memory 이벤트에 대한 최소 Relation입니다.

이벤트 eventA와 eventB에 대해 다음 조건 중 하나라도 참이면 execution에서 eventA happens-before eventB입니다.
- execution에서 eventA is-agent-order-before eventB입니다.
- execution에서 eventA synchronizes-with eventB입니다.
- SharedDataBlockEventSet(execution)이 eventA와 eventB를 모두 포함하고, eventA.[[Order]]가 init이며, eventA와 eventB의 메모리 범위가 겹칩니다.
- execution에서 eventA happens-before eventC이고 eventC happens-before eventB인 이벤트 eventC가 존재합니다.

참고

happens-before는 agent-order의 상위 집합이므로 후보 실행은 ECMAScript의 단일 스레드 평가 의미론과 일관됩니다.

29.7 유효한 실행의 프로퍼티

29.7.1 유효한 선택 읽기

다음 알고리즘이 true를 반환하면 후보 실행 execution은 유효한 선택 읽기를 갖습니다.

SharedDataBlockEventSet(execution)의 각 ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 readEvent에 대해 다음을 수행합니다.
1. chosenValueRecord를 [[Event]] 필드가 readEvent인 execution.[[ChosenValues]]의 요소로 둡니다.
2. chosenValue를 chosenValueRecord.[[ChosenValue]]로 둡니다.
3. readValue를 ValueOfReadEvent(execution, readEvent)로 둡니다.
4. chosenLength를 chosenValue의 요소 수로 둡니다.
5. readLength를 readValue의 요소 수로 둡니다.
6. chosenLength ≠ readLength이면, 다음을 수행합니다.
  1. false를 반환합니다.
7. 0(포함)부터 chosenLength(제외)까지의 구간에 있는 어떤 정수 i에 대해 chosenValue[i] ≠ readValue[i]이면, 다음을 수행합니다.
  1. false를 반환합니다.
true를 반환합니다.

29.7.2 일관된 읽기

다음 알고리즘이 true를 반환하면 후보 실행 execution은 일관된 읽기를 갖습니다.

SharedDataBlockEventSet(execution)의 각 ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 readEvent에 대해 다음을 수행합니다.
1. writes를 execution에서 reads-bytes-from(readEvent)으로 둡니다.
2. byteLocation을 readEvent.[[ByteIndex]]로 둡니다.
3. writes의 각 요소 writeEvent에 대해 다음을 수행합니다.
  1. execution에서 readEvent happens-before writeEvent이면, 다음을 수행합니다.
    1. false를 반환합니다.
  2. 자신의 메모리 범위에 byteLocation을 포함하는 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 value가 존재하여 execution에서 writeEvent happens-before value이고 value happens-before readEvent이면, 다음을 수행합니다.
    1. false를 반환합니다.
  3. byteLocation을 byteLocation + 1로 설정합니다.
true를 반환합니다.

29.7.3 찢어짐 없는 읽기

다음 알고리즘이 true를 반환하면 후보 실행 execution은 찢어짐 없는 읽기를 갖습니다.

SharedDataBlockEventSet(execution)의 각 ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 readEvent에 대해 다음을 수행합니다.
1. readEvent.[[NoTear]]가 true이면, 다음을 수행합니다.
  1. 단언: readEvent.[[ByteIndex]]를 readEvent.[[ElementSize]]로 나눈 나머지는 0입니다.
  2. execution에서 readEvent reads-from writeEvent이고 writeEvent.[[NoTear]]가 true인 각 Memory 이벤트 writeEvent에 대해 다음을 수행합니다.
    1. readEvent와 writeEvent의 메모리 범위가 같고, value와 writeEvent의 메모리 범위가 같고 value.[[NoTear]]가 true이며 writeEvent와 value가 동일한 Shared Data Block 이벤트가 아니고 execution에서 readEvent reads-from value인 Memory 이벤트 value가 존재하면, 다음을 수행합니다.
      1. false를 반환합니다.
true를 반환합니다.

참고

Shared Data Block 이벤트의 [[NoTear]] 필드는 해당 이벤트가 정수 TypedArray에 접근하여 도입되었으면 true이고, 부동 소수점 TypedArray 또는 DataView에 접근하여 도입되었으면 false입니다.

직관적으로 이 요구 사항은 정수 TypedArray를 통해 정렬된 방식으로 메모리 범위에 접근할 때 동일한 범위를 가진 다른 쓰기 이벤트와 데이터 경합이 발생하면 해당 범위에 대한 하나의 쓰기 이벤트가 “승리”해야 한다는 의미입니다. 더 정확하게는 정렬된 읽기 이벤트가 모두 동일한 범위를 갖는 서로 다른 여러 쓰기 이벤트의 바이트로 구성된 값을 읽을 수 없다는 의미입니다. 그러나 정렬된 읽기 이벤트가 범위가 겹치는 여러 쓰기 이벤트에서 읽는 것은 가능합니다.

29.7.4 순차적으로 일관된 원자적 연산

후보 실행 execution에 대해 is-memory-order-before는 EventSet(execution)의 모든 Memory 이벤트에 대한 엄격 전순서이며 다음을 만족합니다.

이벤트 eventA와 eventB에 대해 execution에서 eventA happens-before eventB이면 execution에서 eventA is-memory-order-before eventB입니다.
execution에서 readEvent reads-from writeEvent인 이벤트 readEvent와 writeEvent에 대해, value.[[Order]]가 seq-cst이고 execution에서 writeEvent is-memory-order-before value이며 value is-memory-order-before readEvent이고 다음 조건 중 하나라도 참인 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 value가 SharedDataBlockEventSet(execution)에 존재해서는 안 됩니다.
- execution에서 writeEvent synchronizes-with readEvent이고 value와 readEvent의 메모리 범위가 같습니다.
- execution에서 writeEvent happens-before readEvent이고 value happens-before readEvent이며, writeEvent.[[Order]]가 seq-cst이고 writeEvent와 value의 메모리 범위가 같습니다.
- execution에서 writeEvent happens-before readEvent이고 writeEvent happens-before value이며, readEvent.[[Order]]가 seq-cst이고 value와 readEvent의 메모리 범위가 같습니다.
참고 1

이 항목은 동일한 메모리 범위에 대한 seq-cst 이벤트를 추가로 제한합니다.
SharedDataBlockEventSet(execution)의 각 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트 writeEvent에 대해 writeEvent.[[Order]]가 seq-cst이면, 동일한 메모리 범위를 가지며 writeEvent보다 memory-order 앞에 있는 ReadSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트가 SharedDataBlockEventSet(execution)에 무한히 많이 존재하는 경우는 없어야 합니다.
참고 2

이 항목은 에이전트의 전진 진행 보장과 함께 seq-cst 쓰기가 동일한 메모리 범위의 seq-cst 읽기에 유한 시간 안에 보이게 된다는 생존성 조건을 보장합니다.

후보 실행에 is-memory-order-before Relation이 존재하면 순차적으로 일관된 원자적 연산을 갖습니다.

참고 3

is-memory-order-before는 EventSet(execution)의 모든 이벤트를 포함하지만, execution에서 happens-before 또는 synchronizes-with에 의해 제약되지 않는 이벤트는 순서의 어느 위치에서든 발생할 수 있습니다.

29.7.5 유효한 실행

다음이 모두 참이면 후보 실행 execution은 유효한 실행(또는 간단히 실행)입니다.

호스트가 execution에 대해 host-synchronizes-with Relation을 제공합니다.
execution에는 엄격 부분 순서인 happens-before Relation이 존재합니다.
execution은 유효한 선택 읽기를 갖습니다.
execution은 일관된 읽기를 갖습니다.
execution은 찢어짐 없는 읽기를 갖습니다.
execution은 순차적으로 일관된 원자적 연산을 갖습니다.

모든 프로그램에는 적어도 하나의 유효한 실행이 있습니다.

29.8 경합

실행 execution과 SharedDataBlockEventSet(execution)에 포함된 이벤트 eventA 및 eventB에 대해 다음 알고리즘이 true를 반환하면 eventA와 eventB는 경합 상태입니다.

eventA와 eventB가 동일한 Shared Data Block 이벤트가 아니면, 다음을 수행합니다.
1. execution에서 eventA happens-before eventB이고 eventB happens-before eventA인 것이 모두 참인 경우가 아니면, 다음을 수행합니다.
  1. eventA가 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트이고, eventB가 WriteSharedMemory 또는 ReadModifyWriteSharedMemory 이벤트이며, eventA와 eventB의 메모리 범위가 서로 분리되어 있지 않으면, 다음을 수행합니다.
    1. true를 반환합니다.
  2. execution에서 eventA reads-from eventB이거나 eventB reads-from eventA이면, 다음을 수행합니다.
    1. true를 반환합니다.
false를 반환합니다.

29.9 데이터 경합

실행 execution과 SharedDataBlockEventSet(execution)에 포함된 이벤트 eventA 및 eventB에 대해 다음 알고리즘이 true를 반환하면 eventA와 eventB는 데이터 경합 상태입니다.

execution에서 eventA와 eventB가 경합 상태이면, 다음을 수행합니다.
1. eventA.[[Order]]가 seq-cst가 아니거나 eventB.[[Order]]가 seq-cst가 아니면, 다음을 수행합니다.
  1. true를 반환합니다.
2. eventA와 eventB의 메모리 범위가 겹치면, 다음을 수행합니다.
  1. true를 반환합니다.
false를 반환합니다.

29.10 데이터 경합 없음

SharedDataBlockEventSet(execution)에 데이터 경합 상태인 두 이벤트가 없으면 실행 execution은 데이터 경합이 없습니다.

프로그램의 모든 실행에 데이터 경합이 없으면 프로그램에는 데이터 경합이 없습니다.

메모리 모델은 데이터 경합이 없는 프로그램의 모든 이벤트에 대해 순차적 일관성을 보장합니다.

29.11 공유 메모리 지침

참고 1

다음은 공유 메모리를 사용하는 ECMAScript 프로그래머를 위한 지침입니다.

프로그램에 데이터 경합이 없도록 유지할 것을 권장합니다. 즉, 동일한 메모리 위치에서 동시 비원자적 연산이 발생하는 것이 불가능하도록 해야 합니다. 데이터 경합이 없는 프로그램은 각 에이전트의 평가 의미론의 각 단계가 서로 교차하여 실행되는 의미론을 갖습니다. 데이터 경합이 없는 프로그램에서는 메모리 모델의 세부 사항을 이해할 필요가 없습니다. 세부 사항은 더 나은 ECMAScript 코드를 작성하는 데 도움이 되는 직관을 형성할 가능성이 낮습니다.

더 일반적으로 프로그램에 데이터 경합이 있더라도 원자적 연산이 어떤 데이터 경합에도 관여하지 않고 경합하는 연산이 모두 같은 접근 크기를 갖는다면 예측 가능한 동작을 가질 수 있습니다. 원자적 연산이 경합에 관여하지 않게 하는 가장 간단한 방법은 원자적 연산과 비원자적 연산이 서로 다른 메모리 셀을 사용하도록 하고 서로 다른 크기의 원자적 접근이 동일한 셀에 동시에 접근하지 않도록 하는 것입니다. 사실상 프로그램은 공유 메모리를 가능한 한 강한 타입이 지정된 것처럼 취급해야 합니다. 경합하는 비원자적 접근의 순서와 타이밍에 의존할 수는 없지만, 메모리를 강한 타입이 지정된 것처럼 취급하면 경합하는 접근이 “찢어지지” 않습니다(값의 비트가 서로 섞이지 않습니다).

참고 2

다음은 공유 메모리를 사용하는 프로그램에 대해 컴파일러 변환을 작성하는 ECMAScript 구현자를 위한 지침입니다.

다중 에이전트 프로그램에서 각 에이전트의 성능이 단일 에이전트 환경에서만큼 좋도록 하기 위해, 단일 에이전트 환경에서 유효한 대부분의 프로그램 변환을 다중 에이전트 환경에서도 허용하는 것이 바람직합니다. 이러한 변환은 판단하기 어려운 경우가 많습니다. 여기서는 규범적으로 받아들여지도록 의도된(메모리 모델에 의해 암시되거나 메모리 모델이 암시하는 것보다 더 강한) 프로그램 변환에 관한 몇 가지 규칙을 개략적으로 설명하지만, 완전한 목록은 아닐 가능성이 높습니다. 이러한 규칙은 is-agent-order-before Relation을 구성하는 Memory 이벤트가 도입되기 전에 이루어지는 프로그램 변환에 적용하도록 의도됩니다.

단일 에이전트와 관련된 is-agent-order-before Relation의 부분집합을 agent-order slice라고 합니다.

읽기 이벤트의 가능한 읽기 값을 모든 유효한 실행에 걸쳐 해당 이벤트의 ValueOfReadEvent가 가질 수 있는 모든 값의 집합이라고 합니다.

공유 메모리가 없을 때 유효한 agent-order slice의 모든 변환은 다음 예외를 제외하고 공유 메모리가 있을 때도 유효합니다.

Atomics는 변경할 수 없습니다: 프로그램 변환은 [[Order]]가 seq-cst인 Shared Data Block 이벤트를 is-agent-order-before Relation에서 제거하거나, 서로의 순서를 바꾸거나, [[Order]]가 unordered인 이벤트와 관련하여 agent-order slice 안에서 순서를 바꾸어서는 안 됩니다.

(실제로 순서 변경 금지는 컴파일러가 모든 seq-cst 연산을 동기화로 간주하고 최종 is-memory-order-before Relation에 포함된다고 가정하도록 강제합니다. 에이전트 간 프로그램 분석이 없다면 어차피 일반적으로 그렇게 가정해야 합니다. 또한 호출 대상의 memory-order에 대한 효과를 알 수 없는 모든 호출이 seq-cst 연산을 포함할 수 있다고 컴파일러가 가정하도록 강제합니다.)
읽기는 안정적이어야 합니다: 주어진 공유 메모리 읽기는 한 실행에서 하나의 값만 관찰해야 합니다.

(예를 들어 프로그램에서 의미상 하나의 읽기가 여러 번 실행되면 프로그램은 그 뒤 읽힌 값 중 하나만 관찰할 수 있습니다. rematerialization으로 알려진 변환은 이 규칙을 위반할 수 있습니다.)
쓰기는 안정적이어야 합니다: 공유 메모리에 대한 모든 관찰 가능한 쓰기는 실행의 프로그램 의미론에서 비롯되어야 합니다.

(예를 들어 더 작은 데이터를 쓰기 위해 더 큰 위치에 read-modify-write 연산을 사용하거나, 프로그램이 쓸 수 없는 값을 메모리에 쓰거나, 읽은 위치가 읽기 후 다른 에이전트에 의해 덮어쓰였을 수 있는데도 방금 읽은 값을 같은 위치에 다시 쓰는 것처럼 특정 관찰 가능한 쓰기를 변환이 도입해서는 안 됩니다.)
가능한 읽기 값은 비어 있지 않아야 합니다: 프로그램 변환으로 인해 공유 메모리 읽기의 가능한 읽기 값이 빈 집합이 되어서는 안 됩니다.

(직관과 달리 이 규칙은 사실상 쓰기에 대한 변환을 제한합니다. 메모리 모델에서 쓰기는 읽기 이벤트가 읽을 수 있다는 점에서 효력을 갖기 때문입니다. 예를 들어 두 seq-cst 연산 사이에서 쓰기를 이동하고 병합하며 때로는 순서를 바꿀 수 있지만, 변환은 위치를 업데이트하는 모든 쓰기를 제거해서는 안 됩니다. 일부 쓰기는 보존해야 합니다.)

계속 유효한 변환의 예로는 동일한 위치에서 여러 비원자적 읽기를 병합하는 것, 비원자적 읽기의 순서를 바꾸는 것, 추측적 비원자적 읽기를 도입하는 것, 동일한 위치에 대한 여러 비원자적 쓰기를 병합하는 것, 서로 다른 위치에 대한 비원자적 쓰기의 순서를 바꾸는 것, 종료 여부에 영향을 미치더라도 비원자적 읽기를 루프 밖으로 끌어올리는 것이 있습니다. 일반적으로 별칭이 있는 TypedArray는 위치가 서로 다름을 증명하기 어렵게 한다는 점에 유의하시기 바랍니다.

참고 3

다음은 공유 메모리 접근을 위한 기계어 코드를 생성하는 ECMAScript 구현자를 위한 지침입니다.

메모리 모델이 ARM 또는 Power보다 약하지 않은 아키텍처에서는 비원자적 store와 load를 대상 아키텍처의 단순 store 및 load로 컴파일할 수 있습니다. 원자적 store와 load는 순차적 일관성을 보장하는 명령으로 컴파일할 수 있습니다. 그러한 명령이 없으면 단순 store 또는 load의 양쪽에 배리어를 배치하는 것과 같은 메모리 배리어를 사용해야 합니다. read-modify-write 연산은 x86의 LOCK 접두사가 붙은 명령, ARM의 load-exclusive/store-exclusive 명령, Power의 load-link/store-conditional 명령과 같은 대상 아키텍처의 read-modify-write 명령으로 컴파일할 수 있습니다.

구체적으로 메모리 모델은 다음과 같은 코드 생성을 허용하도록 의도됩니다.

프로그램의 모든 원자적 연산은 필요하다고 가정합니다.
원자적 연산은 서로 또는 비원자적 연산과 절대 순서를 바꾸지 않습니다.
함수는 항상 원자적 연산을 수행한다고 가정합니다.
원자적 연산은 더 큰 데이터에 대한 read-modify-write 연산으로 구현하지 않으며, 플랫폼에 적절한 크기의 원자적 연산이 없으면 non-lock-free 원자적 연산으로 구현합니다. (우리는 이미 모든 플랫폼이 관심 있는 모든 크기의 일반 메모리 접근 연산을 갖는다고 가정합니다.)

단순한 코드 생성은 다음 패턴을 사용합니다:

일반 load 및 store는 단일 load 및 store 명령으로 컴파일합니다.
lock-free 원자적 load 및 store는 전체(순차적 일관성) fence, 일반 load 또는 store, 전체 fence로 컴파일합니다.
lock-free 원자적 read-modify-write 접근은 전체 fence, 원자적 read-modify-write 명령 시퀀스, 전체 fence로 컴파일합니다.
non-lock-free 원자적 연산은 spinlock 획득, 전체 fence, 일련의 비원자적 load 및 store 명령, 전체 fence, spinlock 해제로 컴파일합니다.

메모리 범위에 대한 원자적 연산이 비원자적 쓰기 또는 다른 크기의 원자적 연산과 경합하지 않는 한 이 매핑은 올바릅니다. 그러나 이것이면 충분합니다. 메모리 모델은 경합에 관여하는 원자적 연산을 사실상 비원자적 상태로 강등합니다. 반면 단순 매핑은 상당히 강합니다. 원자적 연산을 순차적으로 일관된 fence로 사용할 수 있게 하는데, 이는 메모리 모델이 실제로 보장하지는 않습니다.

메모리 모델의 제약을 따르는 한 이러한 기본 패턴에 대한 로컬 개선도 허용됩니다. 예를 들면:

중복 fence를 제거하는 명백한 플랫폼 의존적 개선이 있습니다. 예를 들어 x86에서는 lock-free 원자적 load 및 store 주변의 fence를 항상 생략할 수 있으며 store 뒤의 fence만 예외입니다. lock-free read-modify-write 명령은 모두 LOCK 접두사가 붙은 명령을 사용하므로 fence가 필요하지 않습니다. 많은 플랫폼에는 여러 강도의 fence가 있으며 특정 컨텍스트에서는 순차적 일관성을 깨뜨리지 않고 더 약한 fence를 사용할 수 있습니다.
대부분의 현대 플랫폼은 ECMAScript 원자적 연산에 필요한 모든 데이터 크기에 대해 lock-free 원자적 연산을 지원합니다. non-lock-free 원자적 연산이 필요한 경우 원자적 연산 본문 주변의 fence를 보통 lock과 unlock 단계에 통합할 수 있습니다. non-lock-free 원자적 연산의 가장 간단한 해결책은 SharedArrayBuffer마다 하나의 lock word를 두는 것입니다.
일부 코드 분석이 필요한 더 복잡한 플랫폼 의존적 로컬 개선도 있습니다. 예를 들어 연속된 두 fence는 하나의 fence와 같은 효과를 갖는 경우가 많으므로 두 원자적 연산이 연속되는 코드를 생성한다면 하나의 fence만으로 분리할 수 있습니다. x86에서는 store 뒤의 fence가 store를 이후 load와 분리하기 위해서만 필요하므로 원자적 store를 분리하는 단일 fence조차 생략할 수 있습니다.

부속서 A (참고) 문법 요약

A.1 어휘 문법

SourceCharacter

any Unicode code point

RegularExpressionLiteral

InputElementRegExpOrTemplateTail

RegularExpressionLiteral

TemplateSubstitutionTail

InputElementTemplateTail

TemplateSubstitutionTail

InputElementHashbangOrRegExp

RegularExpressionLiteral

WhiteSpace

<TAB>

<VT>

<FF>

<USP>

LineTerminator

<LF>

<CR>

<LS>

<PS>

LineTerminatorSequence

<LF>

<CR>

[lookahead ≠ <LF>]

<LS>

<PS>

<CR>

<LF>

MultiLineCommentChars

opt

MultiLineCommentChars

MultiLineNotAsteriskChar

MultiLineCommentChars

opt

PostAsteriskCommentChars

opt

PostAsteriskCommentChars

MultiLineNotForwardSlashOrAsteriskChar

MultiLineCommentChars

opt

PostAsteriskCommentChars

opt

MultiLineNotAsteriskChar

SourceCharacter

but not *

MultiLineNotForwardSlashOrAsteriskChar

SourceCharacter

but not one of / or *

SingleLineComment

SingleLineCommentChars

opt

SingleLineCommentChars

SingleLineCommentChar

SingleLineCommentChars

opt

SingleLineCommentChar

SourceCharacter

but not LineTerminator

HashbangComment

SingleLineCommentChars

opt

UnicodeEscapeSequence

IdentifierPart

IdentifierPartChar

UnicodeEscapeSequence

one of

any Unicode code point with the Unicode property “ID_Start”

UnicodeIDContinue

any Unicode code point with the Unicode property “ID_Continue”

ReservedWord

one of

await

break

case

catch

class

const

continue

debugger

default

delete

else

enum

export

extends

false

finally

for

function

import

instanceof

new

null

return

super

switch

this

throw

true

try

typeof

var

void

while

with

yield

Punctuator

OptionalChainingPunctuator

OtherPunctuator

OptionalChainingPunctuator

[lookahead ∉ DecimalDigit]

OtherPunctuator

one of

{

(

)

[

]

...

;

===

!==

>>>

**=

<<=

>>=

>>>=

&&=

||=

??=

}

null

true

false

NumericLiteralSeparator

NumericLiteral

DecimalLiteral

DecimalBigIntegerLiteral

NonDecimalIntegerLiteral

[+Sep]

NonDecimalIntegerLiteral

[+Sep]

BigIntLiteralSuffix

LegacyOctalIntegerLiteral

DecimalBigIntegerLiteral

BigIntLiteralSuffix

NonZeroDigit

DecimalDigits

[+Sep]

opt

BigIntLiteralSuffix

NonZeroDigit

NumericLiteralSeparator

DecimalDigits

[+Sep]

BigIntLiteralSuffix

NonDecimalIntegerLiteral

[Sep]

[?Sep]

[?Sep]

[?Sep]

DecimalIntegerLiteral

DecimalDigits

[+Sep]

opt

ExponentPart

[+Sep]

opt

DecimalDigits

[+Sep]

ExponentPart

[+Sep]

opt

DecimalIntegerLiteral

ExponentPart

[+Sep]

opt

DecimalIntegerLiteral

DecimalDigit

NonZeroDigit

NumericLiteralSeparator

opt

DecimalDigits

[+Sep]

NonOctalDecimalIntegerLiteral

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

one of

one of

[Sep]

[?Sep]

one of

[Sep]

[?Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

one of

[Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

OctalDigit

LegacyOctalIntegerLiteral

OctalDigit

LegacyOctalIntegerLiteral

OctalDigit

NonOctalDecimalIntegerLiteral

LegacyOctalLikeDecimalDigits

opt

NonOctalDigit

NonOctalDecimalIntegerLiteral

DecimalDigit

LegacyOctalLikeDecimalDigits

OctalDigit

LegacyOctalLikeDecimalDigits

one of

one of

[Sep]

[?Sep]

[?Sep]

[Sep]

[?Sep]

[+Sep]

[+Sep]

NumericLiteralSeparator

HexDigit

one of

StringLiteral

DoubleStringCharacters

opt

SingleStringCharacters

opt

DoubleStringCharacters

DoubleStringCharacter

DoubleStringCharacters

opt

SingleStringCharacters

SingleStringCharacter

SingleStringCharacters

opt

DoubleStringCharacter

SourceCharacter

but not one of " or \ or LineTerminator

<LS>

<PS>

EscapeSequence

LineContinuation

SingleStringCharacter

SourceCharacter

but not one of ' or \ or LineTerminator

<LS>

<PS>

EscapeSequence

LineContinuation

LineTerminatorSequence

EscapeSequence

CharacterEscapeSequence

[lookahead ∉ DecimalDigit]

LegacyOctalEscapeSequence

NonOctalDecimalEscapeSequence

HexEscapeSequence

UnicodeEscapeSequence

CharacterEscapeSequence

SingleEscapeCharacter

NonEscapeCharacter

SingleEscapeCharacter

one of

NonEscapeCharacter

SourceCharacter

but not one of EscapeCharacter or LineTerminator

EscapeCharacter

SingleEscapeCharacter

DecimalDigit

LegacyOctalEscapeSequence

[lookahead ∈ { 8, 9 }]

NonZeroOctalDigit

[lookahead ∉ OctalDigit]

ZeroToThree

OctalDigit

[lookahead ∉ OctalDigit]

but not 0

one of

one of

NonOctalDecimalEscapeSequence

one of

HexEscapeSequence

HexDigit

UnicodeEscapeSequence

}

RegularExpressionLiteral

RegularExpressionBody

RegularExpressionFlags

RegularExpressionBody

RegularExpressionFirstChar

RegularExpressionChars

[empty]

RegularExpressionChars

RegularExpressionChar

RegularExpressionFirstChar

RegularExpressionNonTerminator

but not one of * or \ or / or [

RegularExpressionBackslashSequence

RegularExpressionClass

RegularExpressionChar

RegularExpressionNonTerminator

but not one of \ or / or [

RegularExpressionBackslashSequence

RegularExpressionClass

RegularExpressionBackslashSequence

RegularExpressionNonTerminator

SourceCharacter

but not LineTerminator

RegularExpressionClass

[

RegularExpressionClassChars

]

RegularExpressionClassChars

[empty]

RegularExpressionClassChars

RegularExpressionClassChar

RegularExpressionNonTerminator

but not one of ] or \

RegularExpressionBackslashSequence

RegularExpressionFlags

[empty]

RegularExpressionFlags

IdentifierPartChar

Template

NoSubstitutionTemplate

TemplateHead

NoSubstitutionTemplate

TemplateCharacters

opt

TemplateHead

TemplateCharacters

opt

TemplateSubstitutionTail

}

opt

}

opt

opt

[lookahead ≠ {]

TemplateEscapeSequence

NotEscapeSequence

LineContinuation

LineTerminatorSequence

SourceCharacter

but not one of ` or \ or $ or LineTerminator

TemplateEscapeSequence

CharacterEscapeSequence

[lookahead ∉ DecimalDigit]

HexEscapeSequence

UnicodeEscapeSequence

NotEscapeSequence

DecimalDigit

but not 0

[lookahead ∉ HexDigit]

HexDigit

[lookahead ∉ HexDigit]

[lookahead ≠ {]

HexDigit

[lookahead ∉ HexDigit]

HexDigit

[lookahead ∉ HexDigit]

HexDigit

[lookahead ∉ HexDigit]

{

[lookahead ∉ HexDigit]

{

NotCodePoint

[lookahead ∉ HexDigit]

{

CodePoint

[lookahead ∉ HexDigit]

[lookahead ≠ }]

NotCodePoint

HexDigits

[~Sep]

but only if the MV of HexDigits > 0x10FFFF

CodePoint

HexDigits

[~Sep]

but only if the MV of HexDigits ≤ 0x10FFFF

A.2 표현식

IdentifierReference

[Yield, Await]

Identifier

[~Yield]

yield

[~Await]

await

BindingIdentifier

[Yield, Await]

Identifier

yield

await

LabelIdentifier

[Yield, Await]

Identifier

[~Yield]

yield

[~Await]

await

Identifier

IdentifierName

but not ReservedWord

PrimaryExpression

[Yield, Await]

this

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

AsyncFunctionExpression

AsyncGeneratorExpression

RegularExpressionLiteral

TemplateLiteral

[?Yield, ?Await, ~Tagged]

CoverParenthesizedExpressionAndArrowParameterList

[?Yield, ?Await]

CoverParenthesizedExpressionAndArrowParameterList

[Yield, Await]

(

)

(

Expression

[+In, ?Yield, ?Await]

opt

)

(

...

BindingIdentifier

[?Yield, ?Await]

)

(

...

BindingPattern

[?Yield, ?Await]

)

(

Expression

[+In, ?Yield, ?Await]

...

BindingIdentifier

[?Yield, ?Await]

)

(

Expression

[+In, ?Yield, ?Await]

...

BindingPattern

[?Yield, ?Await]

)

다음 생성물의 인스턴스를 처리할 때
PrimaryExpression[Yield, Await] : CoverParenthesizedExpressionAndArrowParameterList[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList의 해석은 다음 문법을 사용하여 정제됩니다:

ParenthesizedExpression

[Yield, Await]

(

Expression

[+In, ?Yield, ?Await]

)

[Yield, Await]

[

Elision

opt

]

[

ElementList

[?Yield, ?Await]

]

[

ElementList

[?Yield, ?Await]

Elision

opt

]

ElementList

[Yield, Await]

Elision

opt

AssignmentExpression

[+In, ?Yield, ?Await]

opt

[?Yield, ?Await]

[?Yield, ?Await]

opt

[+In, ?Yield, ?Await]

[?Yield, ?Await]

opt

[?Yield, ?Await]

[Yield, Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

ObjectLiteral

[Yield, Await]

{

}

{

PropertyDefinitionList

[?Yield, ?Await]

opt

}

PropertyDefinitionList

[Yield, Await]

PropertyDefinition

[?Yield, ?Await]

PropertyDefinitionList

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

MethodDefinition

[?Yield, ?Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[

AssignmentExpression

[+In, ?Yield, ?Await]

]

CoverInitializedName

[Yield, Await]

IdentifierReference

[?Yield, ?Await]

Initializer

[+In, ?Yield, ?Await]

Initializer

[In, Yield, Await]

AssignmentExpression

[?In, ?Yield, ?Await]

TemplateLiteral

[Yield, Await, Tagged]

NoSubstitutionTemplate

[?Yield, ?Await]

[Yield, Await]

[+In, ?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[+In, ?Yield, ?Await]

TemplateMiddleList

[?Yield, ?Await]

TemplateMiddle

Expression

[+In, ?Yield, ?Await]

MemberExpression

[Yield, Await]

PrimaryExpression

[?Yield, ?Await]

MemberExpression

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, +Tagged]

[?Yield, ?Await]

new

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

super

[

Expression

[+In, ?Yield, ?Await]

]

super

new

target

ImportMeta

import

meta

NewExpression

[Yield, Await]

MemberExpression

[?Yield, ?Await]

new

NewExpression

[?Yield, ?Await]

CallExpression

[Yield, Await]

CoverCallExpressionAndAsyncArrowHead

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, +Tagged]

CallExpression

[?Yield, ?Await]

PrivateIdentifier

다음 생성물의 인스턴스를 처리할 때
CallExpression[Yield, Await] : CoverCallExpressionAndAsyncArrowHead[?Yield, ?Await]
CoverCallExpressionAndAsyncArrowHead의 해석은 다음 문법을 사용하여 정제됩니다:

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

super

Arguments

[?Yield, ?Await]

ImportCall

[Yield, Await]

import

(

AssignmentExpression

[+In, ?Yield, ?Await]

opt

)

import

(

AssignmentExpression

[+In, ?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

opt

)

Arguments

[Yield, Await]

(

)

(

ArgumentList

[?Yield, ?Await]

opt

)

ArgumentList

[Yield, Await]

AssignmentExpression

[+In, ?Yield, ?Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

ArgumentList

[?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

ArgumentList

[?Yield, ?Await]

...

AssignmentExpression

[+In, ?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

IdentifierName

TemplateLiteral

[?Yield, ?Await, +Tagged]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[

Expression

[+In, ?Yield, ?Await]

]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, +Tagged]

OptionalChain

[?Yield, ?Await]

PrivateIdentifier

LeftHandSideExpression

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

LeftHandSideExpression

[?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

[no LineTerminator here]

LeftHandSideExpression

[?Yield, ?Await]

[no LineTerminator here]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

delete

UnaryExpression

[?Yield, ?Await]

void

UnaryExpression

[?Yield, ?Await]

typeof

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[+Await]

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[?Yield]

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[Yield]

await

UnaryExpression

[?Yield, +Await]

다음 생성물의 인스턴스를 처리할 때
UnaryExpression[Yield, Await] : [+Await] CoverAwaitExpressionAndAwaitUsingDeclarationHead[?Yield]
CoverAwaitExpressionAndAwaitUsingDeclarationHead의 해석은 다음 문법을 사용하여 정제됩니다:

AwaitExpression

[Yield]

await

UnaryExpression

[?Yield, +Await]

ExponentiationExpression

[Yield, Await]

UnaryExpression

[?Yield, ?Await]

UpdateExpression

[?Yield, ?Await]

ExponentiationExpression

[?Yield, ?Await]

MultiplicativeExpression

[Yield, Await]

ExponentiationExpression

[?Yield, ?Await]

MultiplicativeExpression

[?Yield, ?Await]

MultiplicativeOperator

ExponentiationExpression

[?Yield, ?Await]

MultiplicativeOperator

one of

AdditiveExpression

[Yield, Await]

MultiplicativeExpression

[?Yield, ?Await]

AdditiveExpression

[?Yield, ?Await]

MultiplicativeExpression

[?Yield, ?Await]

AdditiveExpression

[?Yield, ?Await]

MultiplicativeExpression

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

>>>

[?Yield, ?Await]

[In, Yield, Await]

[?Yield, ?Await]

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

instanceof

ShiftExpression

[?Yield, ?Await]

[+In]

RelationalExpression

[+In, ?Yield, ?Await]

ShiftExpression

[?Yield, ?Await]

[+In]

[?Yield, ?Await]

[In, Yield, Await]

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

===

RelationalExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

!==

RelationalExpression

[?In, ?Yield, ?Await]

BitwiseANDExpression

[In, Yield, Await]

EqualityExpression

[?In, ?Yield, ?Await]

BitwiseANDExpression

[?In, ?Yield, ?Await]

EqualityExpression

[?In, ?Yield, ?Await]

BitwiseXORExpression

[In, Yield, Await]

BitwiseANDExpression

[?In, ?Yield, ?Await]

BitwiseXORExpression

[?In, ?Yield, ?Await]

BitwiseANDExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[In, Yield, Await]

BitwiseXORExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

BitwiseXORExpression

[?In, ?Yield, ?Await]

LogicalANDExpression

[In, Yield, Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

LogicalANDExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

LogicalORExpression

[In, Yield, Await]

LogicalANDExpression

[?In, ?Yield, ?Await]

LogicalORExpression

[?In, ?Yield, ?Await]

LogicalANDExpression

[?In, ?Yield, ?Await]

CoalesceExpression

[In, Yield, Await]

CoalesceExpressionHead

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

CoalesceExpressionHead

[In, Yield, Await]

CoalesceExpression

[?In, ?Yield, ?Await]

BitwiseORExpression

[?In, ?Yield, ?Await]

ShortCircuitExpression

[In, Yield, Await]

LogicalORExpression

[?In, ?Yield, ?Await]

CoalesceExpression

[?In, ?Yield, ?Await]

ConditionalExpression

[In, Yield, Await]

ShortCircuitExpression

[?In, ?Yield, ?Await]

ShortCircuitExpression

[?In, ?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

AssignmentExpression

[?In, ?Yield, ?Await]

AssignmentExpression

[In, Yield, Await]

ConditionalExpression

[?In, ?Yield, ?Await]

[+Yield]

YieldExpression

[?In, ?Await]

ArrowFunction

[?In, ?Yield, ?Await]

AsyncArrowFunction

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentOperator

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

&&=

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

||=

AssignmentExpression

[?In, ?Yield, ?Await]

LeftHandSideExpression

[?Yield, ?Await]

??=

AssignmentExpression

[?In, ?Yield, ?Await]

AssignmentOperator

one of

<<=

>>=

>>>=

**=

특정 상황에서 다음 생성물의 인스턴스를 처리할 때
AssignmentExpression[In, Yield, Await] : LeftHandSideExpression[?Yield, ?Await] = AssignmentExpression[?In, ?Yield, ?Await]
LeftHandSideExpression의 해석은 다음 문법을 사용하여 정제됩니다:

AssignmentPattern

[Yield, Await]

ObjectAssignmentPattern

[?Yield, ?Await]

ArrayAssignmentPattern

[?Yield, ?Await]

ObjectAssignmentPattern

[Yield, Await]

{

}

{

AssignmentRestProperty

[?Yield, ?Await]

}

{

AssignmentPropertyList

[?Yield, ?Await]

opt

}

{

AssignmentPropertyList

[?Yield, ?Await]

AssignmentRestProperty

[?Yield, ?Await]

}

ArrayAssignmentPattern

[Yield, Await]

[

Elision

opt

AssignmentRestElement

[?Yield, ?Await]

opt

]

[

AssignmentElementList

[?Yield, ?Await]

]

[

AssignmentElementList

[?Yield, ?Await]

Elision

opt

AssignmentRestElement

[?Yield, ?Await]

opt

]

AssignmentRestProperty

[Yield, Await]

...

DestructuringAssignmentTarget

[?Yield, ?Await]

AssignmentPropertyList

[Yield, Await]

AssignmentProperty

[?Yield, ?Await]

AssignmentPropertyList

[?Yield, ?Await]

AssignmentProperty

[?Yield, ?Await]

AssignmentElementList

[Yield, Await]

AssignmentElisionElement

[?Yield, ?Await]

AssignmentElementList

[?Yield, ?Await]

AssignmentElisionElement

[?Yield, ?Await]

AssignmentElisionElement

[Yield, Await]

opt

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

opt

PropertyName

[?Yield, ?Await]

AssignmentElement

[?Yield, ?Await]

AssignmentElement

[Yield, Await]

DestructuringAssignmentTarget

[?Yield, ?Await]

Initializer

[+In, ?Yield, ?Await]

opt

AssignmentRestElement

[Yield, Await]

...

DestructuringAssignmentTarget

[?Yield, ?Await]

DestructuringAssignmentTarget

[Yield, Await]

LeftHandSideExpression

[?Yield, ?Await]

Expression

[In, Yield, Await]

AssignmentExpression

[?In, ?Yield, ?Await]

Expression

[?In, ?Yield, ?Await]

AssignmentExpression

[?In, ?Yield, ?Await]

A.3 문

Statement

[Yield, Await, Return]

BlockStatement

[?Yield, ?Await, ?Return]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await, ?Return]

BreakableStatement

[?Yield, ?Await, ?Return]

ContinueStatement

[?Yield, ?Await]

BreakStatement

[?Yield, ?Await]

[+Return]

ReturnStatement

[?Yield, ?Await]

WithStatement

[?Yield, ?Await, ?Return]

LabelledStatement

[?Yield, ?Await, ?Return]

ThrowStatement

[?Yield, ?Await]

TryStatement

[?Yield, ?Await, ?Return]

DebuggerStatement

Declaration

[Yield, Await]

HoistableDeclaration

[?Yield, ?Await, ~Default]

ClassDeclaration

[?Yield, ?Await, ~Default]

LexicalDeclaration

[+In, ?Yield, ?Await]

HoistableDeclaration

[Yield, Await, Default]

FunctionDeclaration

[?Yield, ?Await, ?Default]

GeneratorDeclaration

[?Yield, ?Await, ?Default]

AsyncFunctionDeclaration

[?Yield, ?Await, ?Default]

AsyncGeneratorDeclaration

[?Yield, ?Await, ?Default]

BreakableStatement

[Yield, Await, Return]

IterationStatement

[?Yield, ?Await, ?Return]

SwitchStatement

[?Yield, ?Await, ?Return]

BlockStatement

[Yield, Await, Return]

Block

[?Yield, ?Await, ?Return]

Block

[Yield, Await, Return]

{

StatementList

[?Yield, ?Await, ?Return]

opt

}

StatementList

[Yield, Await, Return]

StatementListItem

[?Yield, ?Await, ?Return]

StatementList

[?Yield, ?Await, ?Return]

StatementListItem

[?Yield, ?Await, ?Return]

StatementListItem

[Yield, Await, Return]

Statement

[?Yield, ?Await, ?Return]

[?Yield, ?Await]

[In, Yield, Await]

[?In, ?Yield, ?Await, +Pattern]

;

UsingDeclaration

[?In, ?Yield, ?Await]

[+Await]

AwaitUsingDeclaration

[?In, ?Yield]

LetOrConst

let

const

UsingDeclaration

[In, Yield, Await]

using

[no LineTerminator here]

BindingList

[?In, ?Yield, ?Await, ~Pattern]

;

AwaitUsingDeclaration

[In, Yield]

CoverAwaitExpressionAndAwaitUsingDeclarationHead

[?Yield]

[no LineTerminator here]

BindingList

[?In, ?Yield, +Await, ~Pattern]

;

BindingList

[In, Yield, Await, Pattern]

LexicalBinding

[?In, ?Yield, ?Await, ?Pattern]

BindingList

[?In, ?Yield, ?Await, ?Pattern]

LexicalBinding

[?In, ?Yield, ?Await, ?Pattern]

LexicalBinding

[In, Yield, Await, Pattern]

BindingIdentifier

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

opt

[+Pattern]

BindingPattern

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

다음 생성물의 인스턴스를 처리할 때
AwaitUsingDeclaration[In, Yield] : CoverAwaitExpressionAndAwaitUsingDeclarationHead[?Yield] [no LineTerminator here] BindingList[?In, ?Yield, +Await, ~Pattern] ;
CoverAwaitExpressionAndAwaitUsingDeclarationHead의 해석은 다음 문법을 사용하여 정제됩니다:

AwaitUsingDeclarationHead

await

[no LineTerminator here]

using

VariableStatement

[Yield, Await]

var

VariableDeclarationList

[+In, ?Yield, ?Await]

;

VariableDeclarationList

[In, Yield, Await]

VariableDeclaration

[?In, ?Yield, ?Await]

VariableDeclarationList

[?In, ?Yield, ?Await]

VariableDeclaration

[?In, ?Yield, ?Await]

VariableDeclaration

[In, Yield, Await]

BindingIdentifier

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

opt

BindingPattern

[?Yield, ?Await]

Initializer

[?In, ?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

{

}

{

BindingRestProperty

[?Yield, ?Await]

}

{

BindingPropertyList

[?Yield, ?Await]

opt

}

{

BindingPropertyList

[?Yield, ?Await]

BindingRestProperty

[?Yield, ?Await]

}

ArrayBindingPattern

[Yield, Await]

[

Elision

opt

BindingRestElement

[?Yield, ?Await]

opt

]

[

BindingElementList

[?Yield, ?Await]

]

[

BindingElementList

[?Yield, ?Await]

Elision

opt

BindingRestElement

[?Yield, ?Await]

opt

]

BindingRestProperty

[Yield, Await]

...

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

BindingElisionElement

[?Yield, ?Await]

BindingElementList

[?Yield, ?Await]

BindingElisionElement

[?Yield, ?Await]

BindingElisionElement

[Yield, Await]

opt

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

opt

SingleNameBinding

[Yield, Await]

BindingIdentifier

[?Yield, ?Await]

Initializer

[+In, ?Yield, ?Await]

opt

BindingRestElement

[Yield, Await]

...

BindingIdentifier

[?Yield, ?Await]

...

BindingPattern

[?Yield, ?Await]

EmptyStatement

;

ExpressionStatement

[Yield, Await]

[lookahead ∉ { {, function, async

[no LineTerminator here]

function, class, let [ }]

Expression

[+In, ?Yield, ?Await]

;

IfStatement

[Yield, Await, Return]

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

else

Statement

[?Yield, ?Await, ?Return]

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[lookahead ≠ else]

IterationStatement

[Yield, Await, Return]

DoWhileStatement

[?Yield, ?Await, ?Return]

WhileStatement

[?Yield, ?Await, ?Return]

ForStatement

[?Yield, ?Await, ?Return]

ForInOfStatement

[?Yield, ?Await, ?Return]

DoWhileStatement

[Yield, Await, Return]

Statement

[?Yield, ?Await, ?Return]

while

(

Expression

[+In, ?Yield, ?Await]

)

;

WhileStatement

[Yield, Await, Return]

while

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

ForStatement

[Yield, Await, Return]

for

(

[lookahead ≠ let []

Expression

[~In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

)

Statement

[?Yield, ?Await, ?Return]

for

(

var

VariableDeclarationList

[~In, ?Yield, ?Await]

;

Expression

[+In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

)

Statement

[?Yield, ?Await, ?Return]

for

(

LexicalDeclaration

[~In, ?Yield, ?Await]

Expression

[+In, ?Yield, ?Await]

opt

;

Expression

[+In, ?Yield, ?Await]

opt

)

Statement

[?Yield, ?Await, ?Return]

ForInOfStatement

[Yield, Await, Return]

for

(

[lookahead ≠ let []

LeftHandSideExpression

[?Yield, ?Await]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

var

ForBinding

[?Yield, ?Await, +Pattern]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

ForDeclaration

[?Yield, ?Await, ~Using]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

[lookahead ∉ { let, async of }]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

var

ForBinding

[?Yield, ?Await, +Pattern]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

for

(

[lookahead ≠ using of]

ForDeclaration

[?Yield, ?Await, +Using]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[+Await]

for

await

(

[lookahead ≠ let]

LeftHandSideExpression

[?Yield, ?Await]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[+Await]

for

await

(

var

ForBinding

[?Yield, ?Await, +Pattern]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

[+Await]

for

await

(

[lookahead ≠ using of]

ForDeclaration

[?Yield, ?Await, +Using]

AssignmentExpression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

ForDeclaration

[Yield, Await, Using]

LetOrConst

ForBinding

[?Yield, ?Await, +Pattern]

[+Using]

using

[no LineTerminator here]

ForBinding

[?Yield, ?Await, ~Pattern]

[+Using, +Await]

await

[no LineTerminator here]

using

[no LineTerminator here]

ForBinding

[?Yield, +Await, ~Pattern]

ForBinding

[Yield, Await, Pattern]

BindingIdentifier

[?Yield, ?Await]

[+Pattern]

BindingPattern

[?Yield, ?Await]

ContinueStatement

[Yield, Await]

continue

;

continue

[no LineTerminator here]

LabelIdentifier

[?Yield, ?Await]

;

BreakStatement

[Yield, Await]

break

;

break

[no LineTerminator here]

LabelIdentifier

[?Yield, ?Await]

;

ReturnStatement

[Yield, Await]

return

;

return

[no LineTerminator here]

Expression

[+In, ?Yield, ?Await]

;

WithStatement

[Yield, Await, Return]

with

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

SwitchStatement

[Yield, Await, Return]

switch

(

Expression

[+In, ?Yield, ?Await]

)

CaseBlock

[?Yield, ?Await, ?Return]

CaseBlock

[Yield, Await, Return]

{

CaseClauses

[?Yield, ?Await, ?Return]

opt

}

{

CaseClauses

[?Yield, ?Await, ?Return]

opt

DefaultClause

[?Yield, ?Await, ?Return]

CaseClauses

[?Yield, ?Await, ?Return]

opt

}

CaseClauses

[Yield, Await, Return]

CaseClause

[?Yield, ?Await, ?Return]

CaseClauses

[?Yield, ?Await, ?Return]

CaseClause

[?Yield, ?Await, ?Return]

CaseClause

[Yield, Await, Return]

case

Expression

[+In, ?Yield, ?Await]

StatementList

[?Yield, ?Await, ?Return]

opt

DefaultClause

[Yield, Await, Return]

default

StatementList

[?Yield, ?Await, ?Return]

opt

LabelledStatement

[Yield, Await, Return]

LabelIdentifier

[?Yield, ?Await]

LabelledItem

[?Yield, ?Await, ?Return]

LabelledItem

[Yield, Await, Return]

Statement

[?Yield, ?Await, ?Return]

FunctionDeclaration

[?Yield, ?Await, ~Default]

ThrowStatement

[Yield, Await]

throw

[no LineTerminator here]

Expression

[+In, ?Yield, ?Await]

;

TryStatement

[Yield, Await, Return]

try

Block

[?Yield, ?Await, ?Return]

Catch

[?Yield, ?Await, ?Return]

try

Block

[?Yield, ?Await, ?Return]

Finally

[?Yield, ?Await, ?Return]

try

Block

[?Yield, ?Await, ?Return]

Catch

[?Yield, ?Await, ?Return]

Finally

[?Yield, ?Await, ?Return]

Catch

[Yield, Await, Return]

catch

(

CatchParameter

[?Yield, ?Await]

)

Block

[?Yield, ?Await, ?Return]

catch

Block

[?Yield, ?Await, ?Return]

Finally

[Yield, Await, Return]

finally

Block

[?Yield, ?Await, ?Return]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

debugger

;

A.4 함수와 클래스

UniqueFormalParameters

[Yield, Await]

FormalParameters

[?Yield, ?Await]

FormalParameters

[Yield, Await]

[empty]

FunctionRestParameter

[?Yield, ?Await]

FormalParameterList

[?Yield, ?Await]

FormalParameterList

[?Yield, ?Await]

FormalParameterList

[?Yield, ?Await]

FunctionRestParameter

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

FunctionRestParameter

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await, Default]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

[+Default]

function

(

FormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

FunctionExpression

function

BindingIdentifier

[~Yield, ~Await]

opt

(

FormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

FunctionBody

[Yield, Await]

FunctionStatementList

[?Yield, ?Await]

FunctionStatementList

[Yield, Await]

StatementList

[?Yield, ?Await, +Return]

opt

ArrowFunction

[In, Yield, Await]

ArrowParameters

[?Yield, ?Await]

[no LineTerminator here]

ConciseBody

[?In]

ArrowParameters

[Yield, Await]

BindingIdentifier

[?Yield, ?Await]

CoverParenthesizedExpressionAndArrowParameterList

[?Yield, ?Await]

ConciseBody

[In]

[lookahead ≠ {]

ExpressionBody

[?In, ~Await]

{

FunctionBody

[~Yield, ~Await]

}

ExpressionBody

[In, Await]

AssignmentExpression

[?In, ~Yield, ?Await]

다음 생성물의 인스턴스를 처리할 때
ArrowParameters[Yield, Await] : CoverParenthesizedExpressionAndArrowParameterList[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList의 해석은 다음 문법을 사용하여 정제됩니다:

ArrowFormalParameters

[Yield, Await]

(

UniqueFormalParameters

[?Yield, ?Await]

)

AsyncArrowFunction

[In, Yield, Await]

async

[no LineTerminator here]

AsyncArrowBindingIdentifier

[?Yield]

[no LineTerminator here]

AsyncConciseBody

[?In]

CoverCallExpressionAndAsyncArrowHead

[?Yield, ?Await]

[no LineTerminator here]

AsyncConciseBody

[?In]

AsyncConciseBody

[In]

[lookahead ≠ {]

ExpressionBody

[?In, +Await]

{

AsyncFunctionBody

}

AsyncArrowBindingIdentifier

[Yield]

BindingIdentifier

[?Yield, +Await]

CoverCallExpressionAndAsyncArrowHead

[Yield, Await]

MemberExpression

[?Yield, ?Await]

Arguments

[?Yield, ?Await]

다음 생성물의 인스턴스를 처리할 때
AsyncArrowFunction[In, Yield, Await] : CoverCallExpressionAndAsyncArrowHead[?Yield, ?Await] [no LineTerminator here] => AsyncConciseBody[?In]
CoverCallExpressionAndAsyncArrowHead의 해석은 다음 문법을 사용하여 정제됩니다:

AsyncArrowHead

async

[no LineTerminator here]

ArrowFormalParameters

[~Yield, +Await]

MethodDefinition

[Yield, Await]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[~Yield, ~Await]

)

{

FunctionBody

[~Yield, ~Await]

}

GeneratorMethod

[?Yield, ?Await]

AsyncMethod

[?Yield, ?Await]

AsyncGeneratorMethod

[?Yield, ?Await]

get

ClassElementName

[?Yield, ?Await]

(

)

{

FunctionBody

[~Yield, ~Await]

}

set

ClassElementName

[?Yield, ?Await]

(

PropertySetParameterList

)

{

FunctionBody

[~Yield, ~Await]

}

PropertySetParameterList

FormalParameter

[~Yield, ~Await]

GeneratorDeclaration

[Yield, Await, Default]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[+Yield, ~Await]

)

{

GeneratorBody

}

[+Default]

function

(

FormalParameters

[+Yield, ~Await]

)

{

GeneratorBody

}

GeneratorExpression

function

BindingIdentifier

[+Yield, ~Await]

opt

(

FormalParameters

[+Yield, ~Await]

)

{

GeneratorBody

}

GeneratorMethod

[Yield, Await]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[+Yield, ~Await]

)

{

}

[+Yield, ~Await]

[In, Await]

yield

[no LineTerminator here]

AssignmentExpression

[?In, +Yield, ?Await]

yield

[no LineTerminator here]

AssignmentExpression

[?In, +Yield, ?Await]

AsyncGeneratorDeclaration

[Yield, Await, Default]

async

[no LineTerminator here]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

[+Default]

async

[no LineTerminator here]

function

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorExpression

async

[no LineTerminator here]

function

BindingIdentifier

[+Yield, +Await]

opt

(

FormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorMethod

[Yield, Await]

async

[no LineTerminator here]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[+Yield, +Await]

)

{

AsyncGeneratorBody

}

AsyncGeneratorBody

FunctionBody

[+Yield, +Await]

AsyncFunctionDeclaration

[Yield, Await, Default]

async

[no LineTerminator here]

function

BindingIdentifier

[?Yield, ?Await]

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

[+Default]

async

[no LineTerminator here]

function

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncFunctionExpression

async

[no LineTerminator here]

function

BindingIdentifier

[~Yield, +Await]

opt

(

FormalParameters

[~Yield, +Await]

)

{

AsyncFunctionBody

}

AsyncMethod

[Yield, Await]

async

[no LineTerminator here]

ClassElementName

[?Yield, ?Await]

(

UniqueFormalParameters

[~Yield, +Await]

)

{

}

[~Yield, +Await]

[Yield]

await

UnaryExpression

[?Yield, +Await]

ClassDeclaration

[Yield, Await, Default]

class

BindingIdentifier

[?Yield, ?Await]

ClassTail

[?Yield, ?Await]

[+Default]

class

ClassTail

[?Yield, ?Await]

ClassExpression

[Yield, Await]

class

BindingIdentifier

[?Yield, ?Await]

opt

ClassTail

[?Yield, ?Await]

ClassTail

[Yield, Await]

ClassHeritage

[?Yield, ?Await]

opt

{

ClassBody

[?Yield, ?Await]

opt

}

ClassHeritage

[Yield, Await]

extends

LeftHandSideExpression

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

[?Yield, ?Await]

[?Yield, ?Await]

[Yield, Await]

[?Yield, ?Await]

static

MethodDefinition

[?Yield, ?Await]

FieldDefinition

[?Yield, ?Await]

;

static

FieldDefinition

[?Yield, ?Await]

;

;

[Yield, Await]

[?Yield, ?Await]

[+In, ?Yield, ?Await]

opt

[Yield, Await]

[?Yield, ?Await]

static

{

ClassStaticBlockBody

}

ClassStaticBlockBody

ClassStaticBlockStatementList

StatementList

[~Yield, +Await, ~Return]

opt

A.5 스크립트와 모듈

opt

[~Yield, ~Await, ~Return]

opt

[~Yield, +Await, ~Return]

import

opt

;

import

ModuleSpecifier

WithClause

opt

;

ImportClause

ImportedDefaultBinding

NameSpaceImport

NamedImports

ImportedDefaultBinding

NameSpaceImport

ImportedDefaultBinding

NamedImports

ImportedDefaultBinding

{

}

{

ImportsList

opt

}

from

[~Yield, +Await]

with

{

}

with

{

WithEntries

opt

}

export

opt

;

export

NamedExports

;

export

VariableStatement

[~Yield, +Await]

export

[lookahead ∉ { using, await }]

Declaration

[~Yield, +Await]

export

default

HoistableDeclaration

[~Yield, +Await, +Default]

export

default

ClassDeclaration

[~Yield, +Await, +Default]

export

default

[lookahead ∉ { function, async

[no LineTerminator here]

function, class }]

AssignmentExpression

[+In, ~Yield, +Await]

;

ExportFromClause

ModuleExportName

NamedExports

{

}

{

ExportsList

opt

}

A.6 Number 변환

:::

opt

opt

opt

:::

opt

:::

:::

NonDecimalIntegerLiteral

[~Sep]

StrDecimalLiteral

:::

StrUnsignedDecimalLiteral

:::

Infinity

DecimalDigits

[~Sep]

DecimalDigits

[~Sep]

opt

ExponentPart

[~Sep]

opt

DecimalDigits

[~Sep]

ExponentPart

[~Sep]

opt

DecimalDigits

[~Sep]

ExponentPart

[~Sep]

opt

StringNumericLiteral 문법에서 명시적으로 정의되지 않은 모든 문법 기호는 숫자 리터럴의 어휘 문법에서 사용되는 정의를 갖습니다.

:::

opt

opt

opt

:::

[~Sep]

NonDecimalIntegerLiteral

[~Sep]

A.7 시간대 오프셋 String 형식

:::

[+Extended]

[~Extended]

:::

one of

Hour

:::

DecimalDigit

HourSubcomponents

[Extended]

:::

[?Extended]

[?Extended]

[?Extended]

TemporalDecimalFraction

opt

TimeSeparator

[Extended]

:::

[+Extended]

[~Extended]

[empty]

MinuteSecond

:::

DecimalDigit

TemporalDecimalFraction

:::

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

DecimalDigit

TemporalDecimalSeparator

:::

one of

A.8 정규 표현식

Pattern

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Disjunction

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

Alternative

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Alternative

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Alternative

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

[empty]

Alternative

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Term

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Term

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

Assertion

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Atom

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Atom

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Quantifier

Assertion

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

(?=

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?!

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?<=

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?<!

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

Quantifier

QuantifierPrefix

{

DecimalDigits

[~Sep]

}

{

DecimalDigits

[~Sep]

{

DecimalDigits

[~Sep]

DecimalDigits

[~Sep]

}

Atom

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

PatternCharacter

AtomEscape

[?UnicodeMode, ?NamedCaptureGroups]

CharacterClass

[?UnicodeMode, ?UnicodeSetsMode]

(

GroupSpecifier

[?UnicodeMode]

opt

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

[empty]

RegularExpressionModifiers

RegularExpressionModifier

one of

SyntaxCharacter

one of

(

)

[

]

{

}

PatternCharacter

SourceCharacter

but not SyntaxCharacter

AtomEscape

[UnicodeMode, NamedCaptureGroups]

DecimalEscape

CharacterClassEscape

[?UnicodeMode]

CharacterEscape

[?UnicodeMode]

[+NamedCaptureGroups]

[?UnicodeMode]

[UnicodeMode]

[lookahead ∉ DecimalDigit]

HexEscapeSequence

RegExpUnicodeEscapeSequence

[?UnicodeMode]

[?UnicodeMode]

one of

[UnicodeMode]

[?UnicodeMode]

[UnicodeMode]

[?UnicodeMode]

[UnicodeMode]

RegExpIdentifierStart

[?UnicodeMode]

RegExpIdentifierName

[?UnicodeMode]

RegExpIdentifierPart

[?UnicodeMode]

RegExpIdentifierStart

[UnicodeMode]

IdentifierStartChar

RegExpUnicodeEscapeSequence

[+UnicodeMode]

[~UnicodeMode]

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpIdentifierPart

[UnicodeMode]

IdentifierPartChar

RegExpUnicodeEscapeSequence

[+UnicodeMode]

[~UnicodeMode]

UnicodeLeadSurrogate

UnicodeTrailSurrogate

RegExpUnicodeEscapeSequence

[UnicodeMode]

[+UnicodeMode]

[+UnicodeMode]

[+UnicodeMode]

[+UnicodeMode]

[~UnicodeMode]

[+UnicodeMode]

}

any Unicode code point in the inclusive interval from U+D800 to U+DBFF

UnicodeTrailSurrogate

any Unicode code point in the inclusive interval from U+DC00 to U+DFFF

연결된 u HexLeadSurrogate의 선택이 모호한 각 \u HexTrailSurrogate는 그렇지 않으면 대응하는 \u HexTrailSurrogate를 갖지 않게 되는 가장 가까운 가능한 u HexLeadSurrogate와 연결해야 합니다.

HexLeadSurrogate

Hex4Digits

but only if the MV of Hex4Digits is in the inclusive interval from 0xD800 to 0xDBFF

HexTrailSurrogate

Hex4Digits

but only if the MV of Hex4Digits is in the inclusive interval from 0xDC00 to 0xDFFF

HexNonSurrogate

Hex4Digits

but only if the MV of Hex4Digits is not in the inclusive interval from 0xD800 to 0xDFFF

IdentityEscape

[UnicodeMode]

[+UnicodeMode]

SyntaxCharacter

[+UnicodeMode]

[~UnicodeMode]

SourceCharacter

but not UnicodeIDContinue

DecimalEscape

NonZeroDigit

DecimalDigits

[~Sep]

opt

[lookahead ∉ DecimalDigit]

CharacterClassEscape

[UnicodeMode]

[+UnicodeMode]

UnicodePropertyValueExpression

}

[+UnicodeMode]

UnicodePropertyValueExpression

}

UnicodePropertyValueExpression

UnicodePropertyName

UnicodePropertyValue

LoneUnicodePropertyNameOrValue

UnicodePropertyName

UnicodePropertyNameCharacters

UnicodePropertyNameCharacter

UnicodePropertyNameCharacters

opt

UnicodePropertyValue

UnicodePropertyValueCharacters

LoneUnicodePropertyNameOrValue

UnicodePropertyValueCharacters

UnicodePropertyValueCharacter

UnicodePropertyValueCharacters

opt

UnicodePropertyValueCharacter

UnicodePropertyNameCharacter

DecimalDigit

UnicodePropertyNameCharacter

AsciiLetter

CharacterClass

[UnicodeMode, UnicodeSetsMode]

[

[lookahead ≠ ^]

ClassContents

[?UnicodeMode, ?UnicodeSetsMode]

]

ClassContents

[?UnicodeMode, ?UnicodeSetsMode]

]

ClassContents

[UnicodeMode, UnicodeSetsMode]

[empty]

[~UnicodeSetsMode]

NonemptyClassRanges

[?UnicodeMode]

[+UnicodeSetsMode]

[UnicodeMode]

[?UnicodeMode]

[?UnicodeMode]

NonemptyClassRangesNoDash

[?UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassContents

[?UnicodeMode, ~UnicodeSetsMode]

NonemptyClassRangesNoDash

[UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassAtomNoDash

[?UnicodeMode]

NonemptyClassRangesNoDash

[?UnicodeMode]

ClassAtomNoDash

[?UnicodeMode]

ClassAtom

[?UnicodeMode]

ClassContents

[?UnicodeMode, ~UnicodeSetsMode]

[UnicodeMode]

[?UnicodeMode]

[UnicodeMode]

but not one of \ or ] or -

ClassEscape

[?UnicodeMode]

ClassEscape

[UnicodeMode]

[+UnicodeMode]

[?UnicodeMode]

[?UnicodeMode]

opt

opt

[lookahead ≠ &]

[lookahead ≠ &]

ClassStringDisjunction

ClassSetCharacter

NestedClass

[

[lookahead ≠ ^]

ClassContents

[+UnicodeMode, +UnicodeSetsMode]

]

ClassContents

[+UnicodeMode, +UnicodeSetsMode]

]

CharacterClassEscape

[+UnicodeMode]

ClassStringDisjunction

\q{

ClassStringDisjunctionContents

}

ClassStringDisjunctionContents

ClassString

ClassStringDisjunctionContents

[empty]

opt

[lookahead ∉ ClassSetReservedDoublePunctuator]

SourceCharacter

but not ClassSetSyntaxCharacter

CharacterEscape

[+UnicodeMode]

ClassSetReservedPunctuator

ClassSetReservedDoublePunctuator

one of

;;

ClassSetSyntaxCharacter

one of

(

)

[

]

{

}

ClassSetReservedPunctuator

one of

;

부속서 B (규정) 웹 브라우저를 위한 추가 ECMAScript 기능

이 부속서에서 정의하는 ECMAScript 언어 구문과 의미론은 ECMAScript 호스트가 웹 브라우저인 경우 요구됩니다. 이 부속서의 내용은 규범적이지만 ECMAScript 호스트가 웹 브라우저가 아닌 경우 선택 사항입니다.

이 부속서에서 정의하는 일부 기능은 이 부속서에 명시되어 있고 일부는 이 문서의 본문에 명시되어 있습니다.

기능이 본문에 명시된 경우 문서에서 해당 기능의 영향을 받는 각 지점은 색상 상자 안의 “Normative Optional”이라는 문구로 표시됩니다. 또한 해당 기능이 알고리즘이나 early error 규칙의 특정 문구와 관련된 경우 관련 기능을 “호스트가 지원한다”는 조건으로 보호됩니다. 웹 브라우저는 그러한 모든 기능을 지원해야 합니다.

참고

이 부속서는 웹 브라우저 ECMAScript 호스트의 다양한 레거시 기능과 그 밖의 특성을 설명합니다. 이 부속서에 지정된 모든 언어 기능과 동작은 하나 이상의 바람직하지 않은 특성을 가지며 레거시 사용이 없다면 이 명세에서 제거되었을 것입니다. 그러나 많은 기존 웹 페이지가 이러한 기능을 사용하므로 웹 브라우저는 계속 이를 지원해야 합니다. 이 부속서의 명세는 이러한 레거시 기능의 상호 운용 가능한 구현을 위한 요구 사항을 정의합니다.

이러한 기능은 핵심 ECMAScript 언어의 일부로 간주되지 않습니다. 프로그래머는 새로운 ECMAScript 코드를 작성할 때 이러한 기능과 동작을 사용하거나 존재한다고 가정해서는 안 됩니다. 구현이 웹 브라우저의 일부이거나 웹 브라우저가 접하는 동일한 레거시 ECMAScript 코드를 실행하는 데 필요하지 않은 한 ECMAScript 구현체가 이러한 기능을 구현하는 것은 권장되지 않습니다.

B.1 추가 구문

B.1.1 HTML 유사 주석

목표 기호 Module을 사용하여 소스 텍스트를 파싱할 때는 이 확장이 허용되지 않는다는 점을 제외하고 12.4의 구문과 의미론을 다음과 같이 확장합니다:

구문

InputElementHashbangOrRegExp

RegularExpressionLiteral

SingleLineHTMLOpenComment

SingleLineHTMLCloseComment

SingleLineDelimitedComment

MultiLineComment

FirstCommentLine

opt

LineTerminator

MultiLineCommentChars

opt

HTMLCloseComment

opt

FirstCommentLine

SingleLineDelimitedCommentChars

SingleLineHTMLOpenComment

<!--

SingleLineCommentChars

opt

SingleLineHTMLCloseComment

LineTerminatorSequence

HTMLCloseComment

SingleLineDelimitedComment

SingleLineDelimitedCommentChars

opt

HTMLCloseComment

WhiteSpaceSequence

opt

SingleLineDelimitedCommentSequence

opt

-->

SingleLineCommentChars

opt

SingleLineDelimitedCommentChars

SingleLineNotAsteriskChar

SingleLineDelimitedCommentChars

opt

SingleLinePostAsteriskCommentChars

opt

SingleLineNotAsteriskChar

SourceCharacter

but not one of * or LineTerminator

SingleLinePostAsteriskCommentChars

SingleLineNotForwardSlashOrAsteriskChar

SingleLineDelimitedCommentChars

opt

SingleLinePostAsteriskCommentChars

opt

SingleLineNotForwardSlashOrAsteriskChar

SourceCharacter

but not one of / or * or LineTerminator

WhiteSpaceSequence

WhiteSpace

WhiteSpaceSequence

opt

SingleLineDelimitedCommentSequence

SingleLineDelimitedComment

WhiteSpaceSequence

opt

SingleLineDelimitedCommentSequence

opt

줄 종결자 코드 포인트를 포함하는 MultiLineComment와 마찬가지로 SingleLineHTMLCloseComment는 구문 문법에 의한 파싱 목적에서 LineTerminator로 간주됩니다.

B.1.2 정규 표현식 패턴

22.2.1의 구문은 다음과 같이 수정되고 확장됩니다. 이러한 변경은 문법 생성물의 순서와 컨텍스트 정보에 의해 해결되는 모호성을 도입합니다. 다음 문법을 사용하여 파싱할 때 각 대안은 이전 생성물 대안이 일치하지 않는 경우에만 고려됩니다.

이 대체 패턴 문법과 의미론은 BMP 패턴의 구문과 의미론만 변경합니다. 다음 문법 확장에는 [UnicodeMode] 매개변수로 매개변수화된 생성물이 포함됩니다. 그러나 이러한 확장은 목표 기호에 [UnicodeMode] 매개변수가 존재하는 상태로 파싱할 때 인식되는 Unicode 패턴의 구문을 변경하지 않습니다.

구문

Term

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

[+UnicodeMode]

Assertion

[+UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

[+UnicodeMode]

Atom

[+UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

Quantifier

[+UnicodeMode]

Atom

[+UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

[~UnicodeMode]

QuantifiableAssertion

[?NamedCaptureGroups]

Quantifier

[~UnicodeMode]

Assertion

[~UnicodeMode, ~UnicodeSetsMode, ?NamedCaptureGroups]

[~UnicodeMode]

ExtendedAtom

[?NamedCaptureGroups]

Quantifier

[~UnicodeMode]

ExtendedAtom

[?NamedCaptureGroups]

Assertion

[UnicodeMode, UnicodeSetsMode, NamedCaptureGroups]

[+UnicodeMode]

(?=

Disjunction

[+UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

[+UnicodeMode]

(?!

Disjunction

[+UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

[~UnicodeMode]

QuantifiableAssertion

[?NamedCaptureGroups]

(?<=

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

(?<!

Disjunction

[?UnicodeMode, ?UnicodeSetsMode, ?NamedCaptureGroups]

)

QuantifiableAssertion

[NamedCaptureGroups]

(?=

Disjunction

[~UnicodeMode, ~UnicodeSetsMode, ?NamedCaptureGroups]

)

(?!

Disjunction

[~UnicodeMode, ~UnicodeSetsMode, ?NamedCaptureGroups]

)

ExtendedAtom

[NamedCaptureGroups]

AtomEscape

[~UnicodeMode, ?NamedCaptureGroups]

[lookahead = c]

CharacterClass

[~UnicodeMode, ~UnicodeSetsMode]

(

GroupSpecifier

[~UnicodeMode]

opt

Disjunction

[~UnicodeMode, ~UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

Disjunction

[~UnicodeMode, ~UnicodeSetsMode, ?NamedCaptureGroups]

)

RegularExpressionModifiers

Disjunction

[~UnicodeMode, ~UnicodeSetsMode, ?NamedCaptureGroups]

)

InvalidBracedQuantifier

ExtendedPatternCharacter

InvalidBracedQuantifier

{

DecimalDigits

[~Sep]

}

{

DecimalDigits

[~Sep]

{

DecimalDigits

[~Sep]

DecimalDigits

[~Sep]

}

ExtendedPatternCharacter

SourceCharacter

but not one of ^

(

)

[

AtomEscape

[UnicodeMode, NamedCaptureGroups]

[+UnicodeMode]

DecimalEscape

[~UnicodeMode]

DecimalEscape

but only if the CapturingGroupNumber of DecimalEscape is ≤ CountLeftCapturingParensWithin(the Pattern containing DecimalEscape)

CharacterClassEscape

[?UnicodeMode]

CharacterEscape

[?UnicodeMode, ?NamedCaptureGroups]

[+NamedCaptureGroups]

GroupName

[?UnicodeMode]

CharacterEscape

[UnicodeMode, NamedCaptureGroups]

ControlEscape

AsciiLetter

[lookahead ∉ DecimalDigit]

HexEscapeSequence

RegExpUnicodeEscapeSequence

[?UnicodeMode]

[~UnicodeMode]

LegacyOctalEscapeSequence

IdentityEscape

[?UnicodeMode, ?NamedCaptureGroups]

IdentityEscape

[UnicodeMode, NamedCaptureGroups]

[+UnicodeMode]

SyntaxCharacter

[+UnicodeMode]

[~UnicodeMode]

SourceCharacterIdentityEscape

[?NamedCaptureGroups]

SourceCharacterIdentityEscape

[NamedCaptureGroups]

[~NamedCaptureGroups]

SourceCharacter

but not c

[+NamedCaptureGroups]

SourceCharacter

but not one of c or k

ClassAtomNoDash

[UnicodeMode, NamedCaptureGroups]

SourceCharacter

but not one of \ or ] or -

ClassEscape

[?UnicodeMode, ?NamedCaptureGroups]

[lookahead = c]

ClassEscape

[UnicodeMode, NamedCaptureGroups]

[+UnicodeMode]

[~UnicodeMode]

ClassControlLetter

CharacterClassEscape

[?UnicodeMode]

CharacterEscape

[?UnicodeMode, ?NamedCaptureGroups]

ClassControlLetter

DecimalDigit

참고

동일한 좌변이 [+UnicodeMode]와 [~UnicodeMode] 가드 모두와 함께 나타나는 경우 이는 모호성 해소 우선순위를 제어하기 위한 것입니다.

B.1.2.1 Static Semantics: 조기 오류

22.2.1.1의 의미론은 다음과 같이 확장됩니다:

ExtendedAtom

InvalidBracedQuantifier

이 생성물이 어떤 소스 텍스트와 일치하면 Syntax Error입니다.

또한 다음 생성물에 대한 규칙은 강조된 텍스트를 추가하여 수정됩니다:

NonemptyClassRanges

ClassAtom

ClassContents

첫 번째 ClassAtom의 IsCharacterClass가 true이거나 두 번째 ClassAtom의 IsCharacterClass가 true이고 이 생성물에 _{[UnicodeMode]} 매개변수가 있으면 Syntax Error입니다.
첫 번째 ClassAtom의 IsCharacterClass가 false이고 두 번째 ClassAtom의 IsCharacterClass가 false이며 첫 번째 ClassAtom의 CharacterValue가 두 번째 ClassAtom의 CharacterValue보다 엄격하게 크면 Syntax Error입니다.

NonemptyClassRangesNoDash

ClassAtomNoDash

ClassAtom

ClassContents

ClassAtomNoDash의 IsCharacterClass가 true이거나 ClassAtom의 IsCharacterClass가 true이고 이 생성물에 _{[UnicodeMode]} 매개변수가 있으면 Syntax Error입니다.
ClassAtomNoDash의 IsCharacterClass가 false이고 ClassAtom의 IsCharacterClass가 false이며 ClassAtomNoDash의 CharacterValue가 ClassAtom의 CharacterValue보다 엄격하게 크면 Syntax Error입니다.

B.1.2.2 Static Semantics: CountLeftCapturingParensWithin 및 CountLeftCapturingParensBefore

CountLeftCapturingParensWithin 및 CountLeftCapturingParensBefore의 정의에서 “ Atom :: ( GroupSpecifieropt Disjunction ) ”에 대한 참조는 “ Atom :: ( GroupSpecifieropt Disjunction ) ” 또는 “ ExtendedAtom :: ( GroupSpecifieropt Disjunction ) ”을 의미하는 것으로 해석해야 합니다.

B.1.2.3 Static Semantics: IsCharacterClass

IsCharacterClass의 의미론은 다음과 같이 확장됩니다:

ClassAtomNoDash

[lookahead = c]

false를 반환합니다.

B.1.2.4 Static Semantics: CharacterValue

CharacterValue의 의미론은 다음과 같이 확장됩니다:

ClassAtomNoDash

[lookahead = c]

U+005C (REVERSE SOLIDUS)의 숫자 값을 반환합니다.

ClassEscape

ClassControlLetter

codePoint를 ClassControlLetter가 일치한 코드 포인트로 둡니다.
i를 codePoint의 숫자 값으로 둡니다.
i를 32로 나눈 나머지를 반환합니다.

CharacterEscape

LegacyOctalEscapeSequence

LegacyOctalEscapeSequence의 MV를 반환합니다(12.9.4.3 참조).

B.1.2.5 Runtime Semantics: CompileSubpattern

인수 regexpRecord와 direction을 사용하는 CompileSubpattern의 의미론은 다음과 같이 확장됩니다:

Term :: QuantifiableAssertion Quantifier 에 대한 규칙은 Atom을 QuantifiableAssertion로 대체한 Term :: Atom Quantifier 에 대한 규칙과 같습니다.

Term :: ExtendedAtom Quantifier 에 대한 규칙은 Atom을 ExtendedAtom으로 대체한 Term :: Atom Quantifier 에 대한 규칙과 같습니다.

Term :: ExtendedAtom 에 대한 규칙은 Atom을 ExtendedAtom으로 대체한 Term :: Atom 에 대한 규칙과 같습니다.

B.1.2.6 Runtime Semantics: CompileAssertion

인수 regexpRecord를 사용하는 CompileAssertion의 의미론은 다음과 같이 확장됩니다:

QuantifiableAssertion :: (?= Disjunction ) 에 대한 규칙은 Atom을 QuantifiableAssertion로 대체한 Assertion :: (?= Disjunction ) 에 대한 규칙과 같습니다.

QuantifiableAssertion :: (?! Disjunction ) 에 대한 규칙은 Atom을 QuantifiableAssertion로 대체한 Assertion :: (?! Disjunction ) 에 대한 규칙과 같습니다.

B.1.2.7 Runtime Semantics: CompileAtom

인수 regexpRecord와 direction을 사용하는 CompileAtom의 의미론은 다음과 같이 확장됩니다:

Atom :: PatternCharacter 를 제외한 Atom 생성물의 규칙은 Atom을 ExtendedAtom으로 대체하여 ExtendedAtom 생성물에도 사용됩니다.

다음 규칙도 추가됩니다:

ExtendedAtom

[lookahead = c]

charSet을 단일 문자 \ U+005C (REVERSE SOLIDUS)를 포함하는 CharSet으로 둡니다.
CharacterSetMatcher(regexpRecord, charSet, false, direction)을 반환합니다.

ExtendedAtom

ExtendedPatternCharacter

char를 ExtendedPatternCharacter가 나타내는 문자로 둡니다.
charSet을 문자 char를 포함하는 단일 요소 CharSet으로 둡니다.
CharacterSetMatcher(regexpRecord, charSet, false, direction)을 반환합니다.

B.1.2.8 Runtime Semantics: CompileToCharSet

인수 regexpRecord를 사용하는 CompileToCharSet의 의미론은 다음과 같이 확장됩니다:

두 규칙이 대체됩니다:

NonemptyClassRanges

ClassAtom

ClassContents

charSet을 인수 regexpRecord를 사용한 첫 번째 ClassAtom의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 두 번째 ClassAtom의 CompileToCharSet으로 둡니다.
remainingSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
rangeSet을 CharacterRangeOrUnion(regexpRecord, charSet, otherSet)으로 둡니다.
rangeSet과 remainingSet의 합집합을 반환합니다.

NonemptyClassRangesNoDash

ClassAtomNoDash

ClassAtom

ClassContents

charSet을 인수 regexpRecord를 사용한 ClassAtomNoDash의 CompileToCharSet으로 둡니다.
otherSet을 인수 regexpRecord를 사용한 ClassAtom의 CompileToCharSet으로 둡니다.
remainingSet을 인수 regexpRecord를 사용한 ClassContents의 CompileToCharSet으로 둡니다.
rangeSet을 CharacterRangeOrUnion(regexpRecord, charSet, otherSet)으로 둡니다.
rangeSet과 remainingSet의 합집합을 반환합니다.

다음 규칙도 추가됩니다:

ClassEscape

ClassControlLetter

charValue를 이 ClassEscape의 CharacterValue로 둡니다.
char를 문자 값이 charValue인 문자로 둡니다.
단일 문자 char를 포함하는 CharSet을 반환합니다.

ClassAtomNoDash

[lookahead = c]

단일 문자 \ U+005C (REVERSE SOLIDUS)를 포함하는 CharSet을 반환합니다.

참고

이 생성물은 허용 가능한 제어 문자가 뒤따르지 않는 문자 클래스 내부의 시퀀스 \c에서만 도달할 수 있습니다.

B.1.2.8.1 CharacterRangeOrUnion ( `regexpRecord`, `charSet`, `otherSet` )

추상 연산 CharacterRangeOrUnion. 인수 regexpRecord (RegExp 레코드), charSet (CharSet) 및 otherSet (CharSet). 반환값: CharSet. 호출되면 다음 단계를 수행한다.

HasEitherUnicodeFlag(regexpRecord)이 false이면, 다음을 수행합니다.
1. charSet이 정확히 하나의 문자를 포함하지 않거나 otherSet이 정확히 하나의 문자를 포함하지 않으면, 다음을 수행합니다.
  1. remainingSet을 단일 문자 - U+002D (HYPHEN-MINUS)를 포함하는 CharSet으로 둡니다.
  2. CharSet charSet, otherSet, remainingSet의 합집합을 반환합니다.
CharacterRange(charSet, otherSet)을 반환합니다.

B.1.2.9 Static Semantics: ParsePattern ( `patternText`, `u`, `v` )

인수 patternText, u, v를 사용하는 ParsePattern의 의미론은 다음과 같이 확장되며, 수정 사항은 강조되어 있습니다:

v가 true이고 u가 true이면, 다음을 수행합니다.
1. parseResult를 하나 이상의 SyntaxError 객체를 포함하는 List로 둡니다.
그렇지 않고 v가 true이면, 다음을 수행합니다.
1. parseResult를 ParseText(patternText, Pattern[+UnicodeMode, +UnicodeSetsMode, +NamedCaptureGroups])로 둡니다.
그렇지 않고 u가 true이면, 다음을 수행합니다.
1. parseResult를 ParseText(patternText, Pattern[+UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups])로 둡니다.
그렇지 않으면,
1. parseResult를 ParseText(patternText, Pattern[~UnicodeMode, ~UnicodeSetsMode, ~NamedCaptureGroups])로 둡니다.
2. parseResult가 Parse Node이고 parseResult가 GroupName을 포함하면, 다음을 수행합니다.
  1. parseResult를 ParseText(patternText, Pattern[~UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups])로 설정합니다.
parseResult를 반환합니다.

B.2 추가 내장 프로퍼티

ECMAScript 호스트가 웹 브라우저인 경우 표준 내장 객체의 다음 추가 프로퍼티가 정의됩니다.

B.2.1 전역 객체의 추가 프로퍼티

표 103의 항목을 표 6에 추가합니다.

표 103: 추가 잘 알려진 내재 객체

내재 이름	전역 이름	ECMAScript 언어 연관
%escape%	"escape"	`escape` 함수(B.2.1.1)
%unescape%	"unescape"	`unescape` 함수(B.2.1.2)

B.2.1.1 escape ( `string` )

이 함수는 전역 객체의 프로퍼티입니다. 특정 코드 단위를 16진수 이스케이프 시퀀스로 대체한 새로운 버전의 String 값을 계산합니다.

숫자 값이 0x00FF 이하인 코드 단위를 대체할 때는 %xx 형식의 두 자리 이스케이프 시퀀스를 사용합니다. 숫자 값이 0x00FF보다 엄격하게 큰 코드 단위를 대체할 때는 %uxxxx 형식의 네 자리 이스케이프 시퀀스를 사용합니다.

이는 %escape% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

string을 ? ToString(string)으로 설정합니다.
length를 string의 길이로 둡니다.
result를 빈 String으로 둡니다.
unescapedSet을 ASCII word 문자와 "@*+-./"의 문자열 연결로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. codeUnit을 string 안에서 인덱스 k에 있는 코드 단위로 둡니다.
2. unescapedSet이 codeUnit을 포함하면, 다음을 수행합니다.
  1. nextPart를 codeUnit으로 둡니다.
3. 그렇지 않으면,
  1. codeUnitNumber를 codeUnit의 숫자 값으로 둡니다.
  2. codeUnitNumber < 256이면, 다음을 수행합니다.
    1. hex를 codeUnitNumber를 대문자 16진수로 형식화한 String 표현으로 둡니다.
    2. nextPart를 "%"와 StringPad(hex, 2, "0", start)의 문자열 연결로 둡니다.
  3. 그렇지 않으면,
    1. hex를 codeUnitNumber를 대문자 16진수로 형식화한 String 표현으로 둡니다.
    2. nextPart를 "%u"와 StringPad(hex, 4, "0", start)의 문자열 연결로 둡니다.
4. result를 result와 nextPart의 문자열 연결로 설정합니다.
5. k를 k + 1로 설정합니다.
result를 반환합니다.

참고

인코딩은 일부 RFC 1738에 설명된 인코딩을 기반으로 하지만, 이 표준에 지정된 전체 인코딩은 RFC 1738의 내용과 관계없이 위에서 설명합니다. 이 인코딩은 RFC 3986이 RFC 1738에 적용한 변경 사항을 반영하지 않습니다.

B.2.1.2 unescape ( `string` )

이 함수는 전역 객체의 프로퍼티입니다. escape 함수가 도입할 수 있는 종류의 각 이스케이프 시퀀스를 그것이 나타내는 코드 단위로 대체한 새로운 버전의 String 값을 계산합니다.

이는 %unescape% 내재 객체입니다.

호출되면 다음 단계를 수행합니다:

string을 ? ToString(string)으로 설정합니다.
length를 string의 길이로 둡니다.
result를 빈 String으로 둡니다.
k를 0으로 둡니다.
k < length인 동안 다음을 반복합니다.
1. codeUnit을 string 안에서 인덱스 k에 있는 코드 단위로 둡니다.
2. codeUnit이 코드 단위 0x0025 (PERCENT SIGN)이면, 다음을 수행합니다.
  1. hexDigits를 빈 String으로 둡니다.
  2. optionalAdvance를 0으로 둡니다.
  3. k + 5 < length이고 string 안에서 인덱스 k + 1에 있는 코드 단위가 코드 단위 0x0075 (LATIN SMALL LETTER U)이면, 다음을 수행합니다.
    1. hexDigits를 string의 k + 2부터 k + 6까지의 부분 문자열로 설정합니다.
    2. optionalAdvance를 5로 설정합니다.
  4. 그렇지 않고 k + 3 ≤ length이면, 다음을 수행합니다.
    1. hexDigits를 string의 k + 1부터 k + 3까지의 부분 문자열로 설정합니다.
    2. optionalAdvance를 2로 설정합니다.
  5. parseResult를 ParseText(hexDigits, HexDigits[~Sep])로 둡니다.
  6. parseResult가 Parse Node이면, 다음을 수행합니다.
    1. codeUnitNumber를 parseResult의 MV로 둡니다.
    2. codeUnit을 숫자 값이 codeUnitNumber인 코드 단위로 설정합니다.
    3. k를 k + optionalAdvance로 설정합니다.
3. result를 result와 codeUnit의 문자열 연결로 설정합니다.
4. k를 k + 1로 설정합니다.
result를 반환합니다.

B.2.2 String.prototype 객체의 추가 프로퍼티

B.2.2.1 String.prototype.substr ( `start`, `length` )

이 메서드는 this 값을 String으로 변환한 결과의 부분 문자열을 반환하며, 인덱스 start에서 시작하여 length개의 코드 단위만큼 계속됩니다(length가 undefined이면 String 끝까지). start가 음수이면 sourceLength가 String의 길이일 때 sourceLength + start로 취급합니다. 결과는 String 객체가 아니라 String 값입니다.

호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireObjectCoercible(obj)을 수행합니다.
string을 ? ToString(obj)으로 둡니다.
size를 string의 길이로 둡니다.
intStart를 ? ToClampedIndex(start, size)로 둡니다.
length가 undefined이면 intLength를 size로 둡니다. 그렇지 않으면 intLength를 ? ToIntegerOrInfinity(length)을 0과 size 사이로 clamp한 결과로 둡니다.
intEnd를 min(intStart + intLength, size)로 둡니다.
string의 intStart부터 intEnd까지의 부분 문자열을 반환합니다.

참고

이 메서드는 의도적으로 일반적이며 this 값이 String 객체일 필요가 없습니다. 따라서 다른 종류의 객체로 옮겨 메서드로 사용할 수 있습니다.

B.2.2.2 String.prototype.anchor ( `name` )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "a", "name", name)을 반환합니다.

B.2.2.2.1 CreateHTML ( `contents`, `tag`, `attr`, `attrValue` )

추상 연산 CreateHTML. 인수 contents (ECMAScript 언어 값), tag (String), attr (String) 및 attrValue (ECMAScript 언어 값). 반환값: (정상 완료 (값: String) 또는 throw 완료). 호출되면 다음 단계를 수행한다.

? RequireObjectCoercible(contents)을 수행합니다.
contentsString을 ? ToString(contents)으로 둡니다.
part1을 "<"와 tag의 문자열 연결로 둡니다.
attr이 빈 String이 아니면, 다음을 수행합니다.
1. attrValueString을 ? ToString(attrValue)으로 둡니다.
2. escapedAttrValue를 attrValueString과 같지만 attrValueString 안의 코드 단위 0x0022 (QUOTATION MARK)의 각 발생을 여섯 코드 단위 시퀀스 """로 대체한 String 값으로 둡니다.
3. part1을 다음의 문자열 연결로 설정합니다:
  - part1
  - 코드 단위 0x0020 (SPACE)
  - attr
  - 코드 단위 0x003D (EQUALS SIGN)
  - 코드 단위 0x0022 (QUOTATION MARK)
  - escapedAttrValue
  - 코드 단위 0x0022 (QUOTATION MARK)
part2를 part1과 ">"의 문자열 연결로 둡니다.
part3를 part2와 contentsString의 문자열 연결로 둡니다.
part4를 part3, "</", tag, ">"의 문자열 연결로 둡니다.
part4를 반환합니다.

B.2.2.3 String.prototype.big ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "big", "", "")을 반환합니다.

B.2.2.4 String.prototype.blink ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "blink", "", "")을 반환합니다.

B.2.2.5 String.prototype.bold ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "b", "", "")을 반환합니다.

B.2.2.6 String.prototype.fixed ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "tt", "", "")을 반환합니다.

B.2.2.7 String.prototype.fontcolor ( `colour` )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "font", "color", colour)을 반환합니다.

B.2.2.8 String.prototype.fontsize ( `size` )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "font", "size", size)을 반환합니다.

B.2.2.9 String.prototype.italics ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "i", "", "")을 반환합니다.

B.2.2.10 String.prototype.link ( `url` )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "a", "href", url)을 반환합니다.

B.2.2.11 String.prototype.small ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "small", "", "")을 반환합니다.

B.2.2.12 String.prototype.strike ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "strike", "", "")을 반환합니다.

B.2.2.13 String.prototype.sub ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "sub", "", "")을 반환합니다.

B.2.2.14 String.prototype.sup ( )

이 메서드는 호출되면 다음 단계를 수행합니다:

string을 this 값으로 둡니다.
? CreateHTML(string, "sup", "", "")을 반환합니다.

B.2.2.15 String.prototype.trimLeft ( )

참고

"trimStart" 프로퍼티가 권장됩니다. "trimLeft" 프로퍼티는 주로 이전 코드와의 호환성을 위해 제공됩니다. 새로운 ECMAScript 코드에서는 "trimStart" 프로퍼티를 사용할 것을 권장합니다.

"trimLeft" 프로퍼티의 초기 값은 22.1.3.34에 정의된 %String.prototype.trimStart%입니다.

B.2.2.16 String.prototype.trimRight ( )

참고

"trimEnd" 프로퍼티가 권장됩니다. "trimRight" 프로퍼티는 주로 이전 코드와의 호환성을 위해 제공됩니다. 새로운 ECMAScript 코드에서는 "trimEnd" 프로퍼티를 사용할 것을 권장합니다.

"trimRight" 프로퍼티의 초기 값은 22.1.3.33에 정의된 %String.prototype.trimEnd%입니다.

B.2.3 Date.prototype 객체의 추가 프로퍼티

B.2.3.1 Date.prototype.getYear ( )

참고

getFullYear 메서드는 “2000년 문제”를 피하므로 거의 모든 목적에서 권장됩니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
tv를 dateObj.[[DateValue]]로 둡니다.
tv가 NaN이면 NaN을 반환합니다.
𝔽(YearFromTime(LocalTime(tv))) - 1900_𝔽을 반환합니다.

B.2.3.2 Date.prototype.setYear ( `year` )

참고

setFullYear 메서드는 “2000년 문제”를 피하므로 거의 모든 목적에서 권장됩니다.

이 메서드는 호출되면 다음 단계를 수행합니다:

dateObj를 this 값으로 둡니다.
? RequireInternalSlot(dateObj, [[DateValue]])를 수행합니다.
time을 dateObj.[[DateValue]]로 둡니다.
time이 NaN이면 time을 +0_𝔽으로 설정합니다. 그렇지 않으면 time을 LocalTime(time)으로 설정합니다.
fullYear를 MakeFullYear(? ToNumber(year))로 둡니다.
day를 MakeDay(fullYear, 𝔽(MonthFromTime(time)), 𝔽(DateFromTime(time)))로 둡니다.
date를 MakeDate(day, 𝔽(TimeWithinDay(time)))로 둡니다.
utcTimestamp를 TimeClip(UTC(date))로 둡니다.
dateObj.[[DateValue]]를 utcTimestamp로 설정합니다.
utcTimestamp를 반환합니다.

B.2.3.3 Date.prototype.toGMTString ( )

참고

toUTCString 메서드가 권장됩니다. 이 메서드는 주로 이전 코드와의 호환성을 위해 제공됩니다.

"toGMTString" 프로퍼티의 초기 값은 21.4.4.43에 정의된 %Date.prototype.toUTCString%입니다.

B.2.4 RegExp.prototype 객체의 추가 프로퍼티

B.2.4.1 RegExp.prototype.compile ( `pattern`, `flags` )

이 메서드는 호출되면 다음 단계를 수행합니다:

obj를 this 값으로 둡니다.
? RequireInternalSlot(obj, [[RegExpMatcher]])를 수행합니다.
pattern이 Object이고 pattern에 [[RegExpMatcher]] 내부 슬롯이 있으면, 다음을 수행합니다.
1. flags가 undefined가 아니면 TypeError 예외를 던집니다.
2. flags를 pattern.[[OriginalFlags]]로 설정합니다.
3. pattern을 pattern.[[OriginalSource]]로 설정합니다.
? RegExpInitialize(obj, pattern, flags)를 반환합니다.

참고

이 메서드는 새로운 패턴과 플래그를 사용하여 this 값 RegExp를 완전히 다시 초기화합니다. 구현체는 이 메서드의 사용을 결과 RegExp 객체가 여러 번 사용될 것이라는 단언으로 해석하여 추가 최적화의 후보로 삼을 수 있습니다.

B.3 그 밖의 추가 기능

B.3.1 레이블이 지정된 함수 선언

ECMAScript 2015 이전에는 LabelledStatement의 명세에서 문 레이블을 FunctionDeclaration과 연결하는 것을 허용하지 않았습니다. 그러나 레이블이 지정된 FunctionDeclaration은 비엄격 코드에서 허용되는 확장이었으며 대부분의 브라우저 호스팅 ECMAScript 구현체가 이 확장을 지원했습니다. ECMAScript 2015 이후에는 LabelledStatement의 문법 생성물이 FunctionDeclaration을 LabelledItem으로 사용하는 것을 허용하지만 14.13.1에는 그러한 경우 Syntax Error를 발생시키는 Early Error 규칙이 포함되어 있습니다. 이후 호스트가 이 기능을 지원한다면 비엄격 코드에서 Syntax Error를 억제하도록 해당 규칙을 수정합니다.

참고

WithStatement, IfStatement, IterationStatement에 대한 early error 규칙은 비엄격 코드에서 이러한 문이 레이블이 지정된 FunctionDeclaration을 포함하지 못하도록 합니다.

B.3.2 블록 수준 함수 선언의 웹 레거시 호환성 의미론

ECMAScript 2015 이전에는 ECMAScript 명세에서 Block 문의 StatementList 요소로 FunctionDeclaration이 나타나는 것을 정의하지 않았습니다. 그러나 이러한 형태의 FunctionDeclaration 지원은 허용되는 확장이었으며 대부분의 브라우저 호스팅 ECMAScript 구현체가 이를 허용했습니다. 불행히도 그러한 선언의 의미론은 구현체마다 다릅니다. 이러한 의미론적 차이 때문에 Block 수준 함수 선언을 사용하는 기존 웹 ECMAScript 소스 텍스트는 그 사용이 해당 선언에 대한 모든 브라우저 구현체의 의미론적 교집합에만 의존하는 경우에만 브라우저 구현체 사이에서 이식 가능합니다. 다음은 그 교집합 의미론에 속하는 사용 사례입니다:

함수가 선언되고 하나의 블록 안에서만 참조됩니다.
- BindingIdentifier가 이름 f인 하나 이상의 FunctionDeclaration이 둘러싸는 함수 g의 함수 코드 안에 나타나며 해당 선언은 Block 안에 중첩되어 있습니다.
- var 선언이 아닌 f의 다른 선언은 g의 함수 코드 안에 나타나지 않습니다.
- IdentifierReference로서 f의 모든 발생은 f 선언을 포함하는 Block의 StatementList 안에 있습니다.
함수가 하나의 Block 안에서 선언되고 사용될 수 있지만 동일한 Block 안에 포함되지 않은 내부 함수 정의에서도 참조됩니다.
- BindingIdentifier가 이름 f인 하나 이상의 FunctionDeclaration이 둘러싸는 함수 g의 함수 코드 안에 나타나며 해당 선언은 Block 안에 중첩되어 있습니다.
- var 선언이 아닌 f의 다른 선언은 g의 함수 코드 안에 나타나지 않습니다.
- f 선언을 포함하는 Block의 StatementList 안에 IdentifierReference로서 f의 발생이 있을 수 있습니다.
- g 안에 중첩된 다른 함수 h 안에 IdentifierReference로서 f가 적어도 한 번 나타나며, 다른 f 선언이 h 내부에서 f에 대한 참조를 가리지 않습니다.
- h의 모든 호출은 f 선언이 평가된 후에 발생합니다.
함수가 하나의 블록 안에서 선언되고 사용될 수 있지만 이후 블록에서도 참조됩니다.
- BindingIdentifier가 이름 f인 하나 이상의 FunctionDeclaration이 둘러싸는 함수 g의 함수 코드 안에 나타나며 해당 선언은 Block 안에 중첩되어 있습니다.
- var 선언이 아닌 f의 다른 선언은 g의 함수 코드 안에 나타나지 않습니다.
- f 선언을 포함하는 Block의 StatementList 안에 IdentifierReference로서 f의 발생이 있을 수 있습니다.
- f 선언을 포함하는 Block보다 어휘적으로 뒤에 오는 g의 함수 코드 안에 IdentifierReference로서 f가 적어도 한 번 나타납니다.

첫 번째 사용 사례는 ECMAScript 2015가 제공하는 Block 수준 함수 선언의 의미론과 상호 운용됩니다. 이 사용 사례를 사용하는 기존 ECMAScript 소스 텍스트는 10, 14, 15 절에 정의된 블록 수준 함수 선언 의미론을 사용하여 동작합니다.

두 번째와 세 번째 사용 사례의 ECMAScript 2015 상호 운용성에는 10 절, 15 절, 19.2.1 절, 16.1.7 절의 의미론에 다음 확장이 필요합니다.

ECMAScript 구현체에 진단 경고 메시지를 보고하는 메커니즘이 있다면, 이러한 호환성 의미론이 적용되는 FunctionDeclaration을 코드가 포함하고 비호환성 의미론과 관찰 가능한 차이를 도입할 때 경고를 생성해야 합니다. 예를 들어 var 바인딩 도입이 early error를 생성하기 때문에 도입되지 않는 경우에는 경고 메시지를 생성해서는 안 됩니다.

이 기능은 다음 지점에서 특별한 의미론을 포함합니다:

14.2.1의 Block : { StatementList } 에 대한 early error 규칙 중 하나
14.12.1의 SwitchStatement : switch ( Expression ) CaseBlock 에 대한 early error 규칙 중 하나
FunctionDeclarationInstantiation의 32.a 단계
BlockDeclarationInstantiation의 3.a.ii.1 단계
BlockDeclarationInstantiation의 3.b.iii 단계
GlobalDeclarationInstantiation의 12 단계
EvalDeclarationInstantiation의 13 단계

B.3.3 IfStatement 문 절의 FunctionDeclaration

다음은 14.6의 IfStatement 생성물을 보강합니다:

IfStatement

[Yield, Await, Return]

(

Expression

[+In, ?Yield, ?Await]

)

FunctionDeclaration

[?Yield, ?Await, ~Default]

else

Statement

[?Yield, ?Await, ?Return]

(

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

else

FunctionDeclaration

[?Yield, ?Await, ~Default]

(

Expression

[+In, ?Yield, ?Await]

)

FunctionDeclaration

[?Yield, ?Await, ~Default]

else

FunctionDeclaration

[?Yield, ?Await, ~Default]

(

Expression

[+In, ?Yield, ?Await]

)

FunctionDeclaration

[?Yield, ?Await, ~Default]

[lookahead ≠ else]

이 생성물은 비엄격 코드를 파싱할 때만 적용됩니다. 이 생성물과 일치하는 소스 텍스트는 일치하는 각 FunctionDeclaration[?Yield, ?Await, ~Default] 발생이 소스 텍스트의 해당 위치를 차지하는 BlockStatement의 유일한 StatementListItem인 것처럼 처리됩니다. 그러한 합성 BlockStatement의 의미론에는 B.3.2에 지정된 웹 레거시 호환성 의미론이 포함됩니다.

B.3.4 Catch 블록의 VariableStatement

이 기능에서 Catch 절의 Block은 CatchParameter에서도 바인딩되는 이름을 바인딩하는 var 선언을 포함할 수 있습니다. 이는 14.15.1의 Catch : catch ( CatchParameter ) Block 에 대한 early error 규칙을 수정하여 달성됩니다.

참고

런타임에서 그러한 바인딩은 VariableDeclarationEnvironment에 인스턴스화됩니다. 동일한 이름의 CatchParameter가 도입한 바인딩을 가리지 않으므로 그러한 var 선언의 Initializer는 var 바인딩이 아니라 대응하는 catch 매개변수에 할당합니다.

이 수정된 동작은 Catch 절의 Block 안에 포함된 직접 eval 호출이 도입하는 var 및 function 선언에도 적용됩니다. 이 변경은 EvalDeclarationInstantiation의 3.d.i.2.a.i 및 13.b.ii.4.a.i.i 단계를 수정하여 달성됩니다.

B.3.5 ForIn 문 헤드의 이니셜라이저

다음은 14.7.5의 ForInOfStatement 생성물을 보강합니다:

ForInOfStatement

[Yield, Await, Return]

for

(

var

BindingIdentifier

[?Yield, ?Await]

Initializer

[~In, ?Yield, ?Await]

Expression

[+In, ?Yield, ?Await]

)

Statement

[?Yield, ?Await, ?Return]

이 생성물은 비엄격 코드를 파싱할 때만 적용됩니다.

인수 labelSet을 사용하는 ContainsDuplicateLabels의 정적 의미론은 다음과 같이 보강됩니다:

ForInOfStatement

for

(

var

)

인수 labelSet을 사용한 Statement의 ContainsDuplicateLabels를 반환합니다.

인수 labelSet을 사용하는 ContainsUndefinedBreakTarget의 정적 의미론은 다음과 같이 보강됩니다:

ForInOfStatement

for

(

var

)

인수 labelSet을 사용한 Statement의 ContainsUndefinedBreakTarget을 반환합니다.

인수 iterationSet과 labelSet을 사용하는 ContainsUndefinedContinueTarget의 정적 의미론은 다음과 같이 보강됩니다:

ForInOfStatement

for

(

var

)

인수 iterationSet과 « »를 사용한 Statement의 ContainsUndefinedContinueTarget을 반환합니다.

IsDestructuring의 정적 의미론은 다음과 같이 보강됩니다:

BindingIdentifier

Identifier

yield

await

false를 반환합니다.

VarDeclaredNames의 정적 의미론은 다음과 같이 보강됩니다:

ForInOfStatement

for

(

var

)

names1을 BindingIdentifier의 BoundNames로 둡니다.
names2를 Statement의 VarDeclaredNames로 둡니다.
names1과 names2의 목록 연결을 반환합니다.

VarScopedDeclarations의 정적 의미론은 다음과 같이 보강됩니다:

ForInOfStatement

for

(

var

)

decls1을 « BindingIdentifier »로 둡니다.
decls2를 Statement의 VarScopedDeclarations로 둡니다.
decls1과 decls2의 목록 연결을 반환합니다.

인수 labelSet을 사용하는 ForInOfLoopEvaluation의 런타임 의미론은 다음과 같이 보강됩니다:

ForInOfStatement

for

(

var

)

name을 BindingIdentifier의 StringValue로 둡니다.
lhs를 ? ResolveBinding(name)으로 둡니다.
IsAnonymousFunctionDefinition(Initializer)가 true이면, 다음을 수행합니다.
1. value를 인수 name을 사용한 Initializer의 ? NamedEvaluation으로 둡니다.
그렇지 않으면,
1. rhs를 Initializer의 ? Evaluation으로 둡니다.
2. value를 ? GetValue(rhs)로 둡니다.
? PutValue(lhs, value)를 수행합니다.
keyResult를 ? ForIn/OfHeadEvaluation(« », Expression, enumerate)로 둡니다.
? ForIn/OfBodyEvaluation(BindingIdentifier, Statement, keyResult, enumerate, var-binding, labelSet)을 반환합니다.

B.3.6 `[[IsHTMLDDA]]` 내부 슬롯

[[IsHTMLDDA]] 내부 슬롯은 호스트 정의 객체에 존재할 수 있습니다. [[IsHTMLDDA]] 내부 슬롯을 갖는 객체는 ToBoolean 및 IsLooselyEqual 추상 연산과 typeof 연산자의 피연산자로 사용될 때 undefined처럼 동작합니다.

참고

[[IsHTMLDDA]] 내부 슬롯을 갖는 객체는 이 명세에서 절대 생성하지 않습니다. 그러나 웹 브라우저의 document.all 객체는 웹 호환성을 위해 존재하는 이 슬롯을 갖는 호스트 정의 특수 객체입니다. 이러한 타입의 객체에 대한 다른 알려진 예는 없으며 구현체는 document.all을 제외하고 어떤 객체도 이러한 슬롯과 함께 생성해서는 안 됩니다.

이 기능은 다음 지점에서 특별한 의미론을 포함합니다:

ToBoolean의 3 단계
IsLooselyEqual의 4 단계
typeof의 평가 의미론에서 12 단계

B.3.7 HostMakeJobCallback의 비기본 동작

HostMakeJobCallback 추상 연산은 웹 브라우저인 호스트가 비기본 동작을 지정할 수 있도록 합니다.

B.3.8 HostEnsureCanAddPrivateElement의 비기본 동작

HostEnsureCanAddPrivateElement 추상 연산은 웹 브라우저인 호스트가 비기본 동작을 지정할 수 있도록 합니다.

B.3.9 함수 호출 할당 대상의 런타임 오류

함수 호출(13.3.6)이 비엄격 코드에서 할당 대상으로 사용되면 early error를 생성하는 대신 할당 평가 중 ReferenceError 예외를 던집니다.

참고

할당 대상이 AssignmentExpression의 LeftHandSideExpression인 경우 할당 연산자는 = 또는 AssignmentOperator여야 합니다. 특히 여기의 허용 사항은 논리 할당 연산자(??=, &&=, ||=)에는 적용되지 않습니다.

CallExpression : CoverCallExpressionAndAsyncArrowHead 및 CallExpression : CallExpression Arguments 에 대한 AssignmentTargetType의 1 단계를 참조하시기 바랍니다.

부속서 C (참고) ECMAScript의 엄격 모드

엄격 모드 제한과 예외

implements, interface, let, package, private, protected, public, static, yield는 엄격 모드 코드에서 예약어입니다. (12.7.2).
적합한 구현체는 엄격 모드 코드를 처리할 때 생성물 NumericLiteral :: LegacyOctalIntegerLiteral 및 DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral 의 인스턴스를 허용해서는 안 됩니다.
적합한 구현체는 엄격 모드 코드를 처리할 때 생성물 EscapeSequence :: LegacyOctalEscapeSequence 및 EscapeSequence :: NonOctalDecimalEscapeSequence 의 인스턴스를 허용해서는 안 됩니다.
선언되지 않은 식별자 또는 그 밖의 해결할 수 없는 Reference에 할당해도 전역 객체에 프로퍼티가 생성되지 않습니다. 엄격 모드 코드 안에서 단순 할당이 발생하면 해당 LeftHandSideExpression은 해결할 수 없는 Reference로 평가되어서는 안 됩니다. 그러한 경우 ReferenceError 예외가 던져집니다(6.2.5.6). LeftHandSideExpression은 속성 값이 { [[Writable]]: false }인 데이터 프로퍼티에 대한 참조, 속성 값이 { [[Setter]]: undefined }인 접근자 프로퍼티에 대한 참조 또는 [[Extensible]] 내부 슬롯이 false인 객체의 존재하지 않는 프로퍼티에 대한 참조여서도 안 됩니다. 이러한 경우 TypeError 예외가 던져집니다(13.15).
StringValue가 "eval" 또는 "arguments"인 IdentifierReference는 Assignment 연산자(13.15) 또는 UpdateExpression(13.4)의 LeftHandSideExpression로 나타나거나 Prefix Increment(13.4.4) 또는 Prefix Decrement(13.4.5) 연산자가 작용하는 UnaryExpression로 나타날 수 없습니다.
엄격 함수의 arguments 객체는 접근 시 TypeError 예외를 던지는 구성 불가능한 접근자 프로퍼티 "callee"를 정의합니다(10.4.4.6).
엄격 함수의 arguments 객체는 해당 함수의 대응하는 형식 매개변수 바인딩과 배열 인덱스 프로퍼티 값을 동적으로 공유하지 않습니다. (10.4.4).
엄격 함수에서 arguments 객체가 생성되면 로컬 식별자 arguments의 arguments 객체에 대한 바인딩은 변경 불가능하므로 할당 표현식의 대상이 될 수 없습니다. (10.2.11).
엄격 모드 코드 안에서 BindingIdentifier의 StringValue가 "eval" 또는 "arguments"이면 SyntaxError입니다(13.1.1).
엄격 모드 eval 코드는 eval 호출자의 변수 환경에 변수나 함수를 인스턴스화할 수 없습니다. 대신 새로운 변수 환경을 생성하고 그 환경을 eval 코드의 선언 바인딩 인스턴스화에 사용합니다(19.2.1).
엄격 모드 코드 안에서 this가 평가되면 this 값은 객체로 강제 변환되지 않습니다. undefined 또는 null인 this 값은 전역 객체로 변환되지 않으며 프리미티브 값은 래퍼 객체로 변환되지 않습니다. 함수 호출(Function.prototype.apply 및 Function.prototype.call을 사용한 호출 포함)을 통해 전달된 this 값은 전달된 this 값을 객체로 강제 변환하지 않습니다(10.2.1.2, 20.2.3.1, 20.2.3.3).
엄격 모드 코드 안에서 delete 연산자가 나타날 때 해당 UnaryExpression이 변수, 함수 인수 또는 함수 이름에 대한 직접 참조이면 SyntaxError가 던져집니다(13.5.1.1).
엄격 모드 코드 안에서 delete 연산자가 나타날 때 삭제하려는 프로퍼티에 { [[Configurable]]: false } 속성이 있거나 그 밖의 이유로 삭제할 수 없으면 TypeError가 던져집니다(13.5.1.2).
엄격 모드 코드는 WithStatement를 포함할 수 없습니다. 그러한 컨텍스트에 WithStatement가 나타나면 SyntaxError입니다(14.11.1).
엄격 모드 코드 안에 CatchParameter가 나타나고 CatchParameter의 BoundNames가 eval 또는 arguments 중 하나를 포함하면 SyntaxError입니다(14.15.1).
엄격 함수의 FormalParameters 안에 같은 BindingIdentifier가 두 번 이상 나타나면 SyntaxError입니다. Function, Generator 또는 AsyncFunction 생성자를 사용하여 그러한 함수를 생성하려는 시도도 SyntaxError입니다(15.2.1, 20.2.1.1.1).
구현체는 함수 인스턴스의 "caller" 또는 "arguments"라는 이름의 프로퍼티가 엄격 함수 안에서 갖는 의미를 이 명세에 정의된 것 이상으로 확장할 수 없습니다.

부속서 D (참고) 호스트 계층화 지점

호스트의 정의는 4.2를 참조하시기 바랍니다.

D.1 호스트 훅

HostCallJobCallback(...)

HostEnqueueFinalizationRegistryCleanupJob(...)

HostEnqueueGenericJob(...)

HostEnqueuePromiseJob(...)

HostEnqueueTimeoutJob(...)

HostEnsureCanCompileStrings(...)

HostFinalizeImportMeta(...)

HostGetImportMetaProperties(...)

HostGrowSharedArrayBuffer(...)

HostHasSourceTextAvailable(...)

HostLoadImportedModule(...)

HostGetSupportedImportAttributes(...)

HostMakeJobCallback(...)

HostPromiseRejectionTracker(...)

HostResizeArrayBuffer(...)

InitializeHostDefinedRealm(...)

D.2 호스트 정의 필드

Realm Records의 [[HostDefined]]: 표 20를 참조하시기 바랍니다.

Script Records의 [[HostDefined]]: 표 35를 참조하시기 바랍니다.

Module Records의 [[HostDefined]]: 표 39를 참조하시기 바랍니다.

JobCallback Records의 [[HostDefined]]: 표 24를 참조하시기 바랍니다.

[[IsHTMLDDA]]: B.3.6를 참조하시기 바랍니다.

D.3 호스트 정의 객체

전역 객체: 19 절을 참조하시기 바랍니다.

D.4 작업 실행

Job Abstract Closure 호출 전의 준비 단계와 호출 후의 정리 단계입니다. 9.5를 참조하시기 바랍니다.

D.5 특수 객체의 내부 메서드

이 명세에 지정되지 않은 모든 특수 객체에 대한 표 4의 필수 내부 메서드 중 하나입니다.

D.6 내장 객체와 메서드

17.1에서 제한된 경우를 제외하고 이 명세 안에 정의되지 않은 모든 내장 객체와 메서드입니다.

부속서 E (참고) 호환성에 영향을 줄 수 있는 ECMAScript 2015의 수정 및 명확화

9.1.1.4.14-9.1.1.4.17 Edition 5 및 5.1은 새로운 전역 선언에 대응하는 전역 객체 프로퍼티가 이미 존재하는지 판단하기 위해 프로퍼티 존재 검사를 사용했습니다. ECMAScript 2015는 자체 프로퍼티 존재 검사를 사용합니다. 이는 웹 브라우저에서 가장 일반적으로 구현된 방식에 대응합니다.

10.4.2.1: 5^th Edition은 배열 인덱스 또는 새 길이 값의 정수 변환 전에 현재 배열 길이를 캡처하도록 변경했습니다. 그러나 변환 과정에서 배열 길이를 변경하는 부수 효과가 발생하면 캡처한 길이 값이 무효가 될 수 있었습니다. ECMAScript 2015는 그러한 부수 효과가 발생할 수 있는 시점 이후에 현재 배열 길이를 캡처해야 한다고 지정합니다.

21.4.1.31: 이전 판에서는 TimeClip 추상 연산이 0 시간 값의 표현으로 +0_𝔽 또는 -0_𝔽 중 하나를 반환하도록 허용했습니다. ECMAScript 2015는 +0_𝔽이 항상 반환되도록 지정합니다. 이는 ECMAScript 2015에서 Date의 시간 값이 관찰 가능하게 -0_𝔽이 되는 일이 없으며 시간 값을 반환하는 메서드도 절대 -0_𝔽을 반환하지 않는다는 의미입니다.

21.4.1.32: UTC 오프셋 표현이 없으면 로컬 시간대를 사용합니다. Edition 5.1은 시간대가 없을 때 "z"로 해석해야 한다고 잘못 명시했습니다.

21.4.4.36: 연도를 21.4.1.32에 지정된 Date Time String Format으로 표현할 수 없으면 RangeError 예외를 던집니다. 이전 판에서는 해당 경우의 동작을 지정하지 않았습니다.

21.4.4.41: 이전 판에서는 시간 값이 NaN일 때 Date.prototype.toString이 반환하는 값을 지정하지 않았습니다. ECMAScript 2015는 결과가 String 값 "Invalid Date"라고 지정합니다.

22.2.4.1, 22.2.6.13.1: RegExp 인스턴스의 "source" 프로퍼티 값에 있는 모든 LineTerminator 코드 포인트는 이스케이프 시퀀스를 사용하여 표현해야 합니다. Edition 5.1은 /의 이스케이프만 요구했습니다.

22.2.6.8, 22.2.6.11: 이전 판에서는 pattern 인수가 global 플래그가 설정된 RegExp 값인 경우 String.prototype.match 및 String.prototype.replace의 명세가 잘못되어 있었습니다. 이전 명세에서는 패턴 일치 시도마다 lastIndex가 변경되지 않으면 1 증가시켜야 한다고 명시했습니다. 올바른 동작은 패턴이 빈 String과 일치한 경우에만 lastIndex를 1 증가시키는 것입니다.

23.1.3.30: 이전 판에서는 comparator가 반환한 NaN 값을 Array.prototype.sort가 어떻게 해석하는지 지정하지 않았습니다. ECMAScript 2015는 그러한 값을 comparator가 +0_𝔽을 반환한 것처럼 취급하도록 지정합니다. ECMAScript 2015는 comparator가 반환한 결과에 ToNumber를 적용하도록 지정하기도 합니다. 이전 판에서는 Number 값이 아닌 comparator 결과의 효과가 구현체 정의였습니다. 실제 구현체는 ToNumber를 호출합니다.

부속서 F (참고) 이전 판과 비호환성을 도입하는 추가 및 변경 사항

6.2.5: ECMAScript 2015에서는 Function 호출이 Reference Record를 반환할 수 없습니다.

7.1.4.1: ECMAScript 2015에서는 String 값에 적용된 ToNumber가 이제 BinaryIntegerLiteral 및 OctalIntegerLiteral 숫자 문자열을 인식하고 변환합니다. 이전 판에서는 그러한 문자열이 NaN으로 변환되었습니다.

9.3: ECMAScript 2018에서는 Template 객체가 이전 판처럼 Realm 안의 해당 template literal 또는 tagged template의 모든 발생을 기준으로 하는 대신 Parse Node(소스 위치)를 기준으로 정규화됩니다.

12.2: ECMAScript 2016에서는 Unicode 5.1을 요구했던 ECMAScript 2015와 달리 Unicode 8.0.0 이상을 요구합니다. 특히 이로 인해 ECMAScript 2015에서 Space_Separator (Zs) 범주에 속하여 공백으로 취급되던 U+180E MONGOLIAN VOWEL SEPARATOR가 Format (Cf) 범주로 이동했습니다(Unicode 6.3.0부터). 이에 따라 공백에 민감한 메서드의 동작이 달라집니다. 예를 들어 "\u180E".trim().length는 이전 판에서 0이었지만 ECMAScript 2016 이후에는 1입니다. 또한 ECMAScript 2017에서는 항상 최신 버전의 Unicode Standard를 사용하도록 요구했습니다.

12.7: ECMAScript 2015에서 IdentifierName에 유효한 코드 포인트는 Unicode 프로퍼티 “ID_Start” 및 “ID_Continue”를 기준으로 지정됩니다. 이전 판에서는 유효한 IdentifierName 또는 Identifier 코드 포인트를 다양한 Unicode 코드 포인트 범주를 열거하여 지정했습니다.

12.10.1: ECMAScript 2015에서 Automatic Semicolon Insertion은 do-while 문의 끝에 세미콜론이 없으면 세미콜론을 추가합니다. 이 변경은 명세를 대부분의 기존 구현체의 실제 동작과 일치시킵니다.

13.2.5.1: ECMAScript 2015에서는 Object Initializer에 중복 프로퍼티 이름이 있어도 더 이상 early error가 아닙니다.

13.15.1: ECMAScript 2015에서 FunctionExpression의 함수 이름과 같은 변경 불가능한 바인딩에 대한 할당을 포함하는 엄격 모드 코드는 early error를 생성하지 않습니다. 대신 런타임 오류를 생성합니다.

14.2: ECMAScript 2015에서 토큰 let으로 시작하고 입력 요소 LineTerminator 다음에 Identifier가 오는 StatementList는 LexicalDeclaration의 시작입니다. 이전 판에서는 automatic semicolon insertion이 항상 Identifier 입력 요소 앞에 세미콜론을 삽입했습니다.

14.5: ECMAScript 2015에서 토큰 let 다음에 토큰 [이 오는 StatementListItem은 LexicalDeclaration의 시작입니다. 이전 판에서는 그러한 시퀀스가 ExpressionStatement의 시작이었습니다.

14.6.2: ECMAScript 2015에서 IfStatement의 normal 결과는 절대 값 empty가 아닙니다. 어떤 Statement 부분도 평가되지 않거나 평가된 Statement 부분이 empty를 포함하는 normal completion을 생성하면 IfStatement의 결과는 undefined입니다.

14.7: ECMAScript 2015에서 for 문의 ( 토큰 바로 뒤에 토큰 시퀀스 let [이 오면 let은 LexicalDeclaration의 시작으로 취급됩니다. 이전 판에서는 그러한 토큰 시퀀스가 Expression의 시작이었습니다.

14.7: ECMAScript 2015에서 for-in 문의 ( 토큰 바로 뒤에 토큰 시퀀스 let [이 오면 let은 ForDeclaration의 시작으로 취급됩니다. 이전 판에서는 그러한 토큰 시퀀스가 LeftHandSideExpression의 시작이었습니다.

14.7: ECMAScript 2015 이전에는 초기화 표현식이 in 키워드 앞의 VariableDeclaration 일부로 나타날 수 있었습니다. ECMAScript 2015에서는 같은 위치의 ForBinding이 그러한 이니셜라이저의 발생을 허용하지 않습니다. ECMAScript 2017에서는 그러한 이니셜라이저가 비엄격 코드에서만 허용됩니다.

14.7: ECMAScript 2015에서 IterationStatement 평가 결과는 [[Value]]가 empty인 normal completion이 아닙니다. IterationStatement의 Statement 부분이 평가되지 않거나 Statement 부분의 최종 평가가 [[Value]]가 empty인 normal completion을 생성하면 IterationStatement 평가 결과는 [[Value]]가 undefined인 normal completion입니다.

14.11.2: ECMAScript 2015에서 WithStatement 평가 결과는 [[Value]]가 empty인 normal completion이 아닙니다. WithStatement의 Statement 부분 평가가 [[Value]]가 empty인 normal completion을 생성하면 WithStatement 평가 결과는 [[Value]]가 undefined인 normal completion입니다.

14.12.4: ECMAScript 2015에서 SwitchStatement 평가 결과는 [[Value]]가 empty인 normal completion이 아닙니다. SwitchStatement의 CaseBlock 부분 평가가 [[Value]]가 empty인 normal completion을 생성하면 SwitchStatement 평가 결과는 [[Value]]가 undefined인 normal completion입니다.

14.15: ECMAScript 2015에서 Catch 절이 Catch 절 매개변수에 나타나는 것과 같은 Identifier에 대한 var 선언을 포함하면 early error입니다. 이전 판에서는 그러한 변수 선언이 둘러싸는 변수 환경에 인스턴스화되었지만 선언의 Initializer 값은 Catch 매개변수에 할당되었습니다.

14.15, 19.2.1.3: ECMAScript 2015에서 Catch 절이 eval 코드에 Catch 절 매개변수에 나타나는 것과 같은 Identifier를 바인딩하는 var 또는 FunctionDeclaration 선언이 포함된 비엄격 직접 eval을 평가하면 런타임 SyntaxError가 던져집니다.

14.15.3: ECMAScript 2015에서 TryStatement의 결과는 절대 값 empty가 아닙니다. TryStatement의 Block 부분이 empty를 포함하는 normal completion으로 평가되면 TryStatement의 결과는 undefined입니다. TryStatement의 Block 부분이 throw completion으로 평가되고 empty를 포함하는 normal completion으로 평가되는 Catch 부분을 갖는 경우, Finally 절이 없거나 Finally 절이 empty normal completion으로 평가되면 TryStatement의 결과는 undefined입니다.

15.4.5 ECMAScript 2015에서 ObjectLiteral의 접근자 프로퍼티 [[Getter]] 또는 [[Setter]] 속성 값으로 생성되는 함수 객체는 생성자 함수가 아니며 "prototype" 자체 프로퍼티를 갖지 않습니다. 이전 판에서는 생성자였고 "prototype" 프로퍼티를 가졌습니다.

20.1.2.6: ECMAScript 2015에서 Object.freeze의 인수가 객체가 아니면 자체 프로퍼티가 없는 확장 불가능한 일반 객체인 것처럼 취급합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.8: ECMAScript 2015에서 Object.getOwnPropertyDescriptor의 인수가 객체가 아니면 ToObject를 사용하여 인수를 강제 변환하려고 시도합니다. 강제 변환이 성공하면 그 결과를 원래 인수 값 대신 사용합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.10: ECMAScript 2015에서 Object.getOwnPropertyNames의 인수가 객체가 아니면 ToObject를 사용하여 인수를 강제 변환하려고 시도합니다. 강제 변환이 성공하면 그 결과를 원래 인수 값 대신 사용합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.12: ECMAScript 2015에서 Object.getPrototypeOf의 인수가 객체가 아니면 ToObject를 사용하여 인수를 강제 변환하려고 시도합니다. 강제 변환이 성공하면 그 결과를 원래 인수 값 대신 사용합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.16: ECMAScript 2015에서 Object.isExtensible의 인수가 객체가 아니면 자체 프로퍼티가 없는 확장 불가능한 일반 객체인 것처럼 취급합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.17: ECMAScript 2015에서 Object.isFrozen의 인수가 객체가 아니면 자체 프로퍼티가 없는 확장 불가능한 일반 객체인 것처럼 취급합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.18: ECMAScript 2015에서 Object.isSealed의 인수가 객체가 아니면 자체 프로퍼티가 없는 확장 불가능한 일반 객체인 것처럼 취급합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.19: ECMAScript 2015에서 Object.keys의 인수가 객체가 아니면 ToObject를 사용하여 인수를 강제 변환하려고 시도합니다. 강제 변환이 성공하면 그 결과를 원래 인수 값 대신 사용합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.20: ECMAScript 2015에서 Object.preventExtensions의 인수가 객체가 아니면 자체 프로퍼티가 없는 확장 불가능한 일반 객체인 것처럼 취급합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.1.2.22: ECMAScript 2015에서 Object.seal의 인수가 객체가 아니면 자체 프로퍼티가 없는 확장 불가능한 일반 객체인 것처럼 취급합니다. 이전 판에서는 비객체 인수가 항상 TypeError를 발생시켰습니다.

20.2.3.2: ECMAScript 2015에서 바인딩된 함수의 [[Prototype]] 내부 슬롯은 대상 함수의 [[GetPrototypeOf]] 값으로 설정됩니다. 이전 판에서는 [[Prototype]]이 항상 %Function.prototype%으로 설정되었습니다.

20.2.4.1: ECMAScript 2015에서 함수 인스턴스의 "length" 프로퍼티는 구성 가능합니다. 이전 판에서는 구성 불가능했습니다.

20.5.6.2: ECMAScript 2015에서 NativeError 생성자의 [[Prototype]] 내부 슬롯은 Error 생성자입니다. 이전 판에서는 Function 프로토타입 객체였습니다.

21.4.4 ECMAScript 2015에서 Date 프로토타입 객체는 Date 인스턴스가 아닙니다. 이전 판에서는 TimeValue가 NaN인 Date 인스턴스였습니다.

22.1.3.12 ECMAScript 2015에서 String.prototype.localeCompare 함수는 Unicode Standard에 따라 정규적으로 동등한 String을 동일한 것으로 취급해야 합니다. 이전 판에서는 구현체가 정규적 동등성을 무시하고 대신 비트 단위 비교를 사용할 수 있었습니다.

22.1.3.28 및 22.1.3.30 ECMAScript 2015에서 소문자/대문자 변환 처리는 코드 포인트에 대해 동작합니다. 이전 판에서는 그러한 변환 처리가 개별 코드 단위에만 적용되었습니다. 영향을 받는 유일한 코드 포인트는 Unicode의 Deseret 블록에 있는 코드 포인트입니다.

22.1.3.32 ECMAScript 2015에서 String.prototype.trim 메서드는 Unicode BMP 밖에 존재할 수 있는 공백 코드 포인트를 인식하도록 정의됩니다. 그러나 Unicode 7 기준으로 그러한 코드 포인트는 정의되어 있지 않습니다. 이전 판에서는 그러한 코드 포인트를 공백으로 인식하지 않았습니다.

22.2.4.1 ECMAScript 2015에서 pattern 인수가 RegExp 인스턴스이고 flags 인수가 undefined가 아니면 pattern과 같지만 pattern의 플래그가 인수 flags로 대체된 새로운 RegExp 인스턴스를 생성합니다. 이전 판에서는 pattern이 RegExp 인스턴스이고 flags가 undefined가 아니면 TypeError 예외를 던졌습니다.

22.2.6 ECMAScript 2015에서 RegExp 프로토타입 객체는 RegExp 인스턴스가 아닙니다. 이전 판에서는 패턴이 빈 String인 RegExp 인스턴스였습니다.

22.2.6 ECMAScript 2015에서 "source", "global", "ignoreCase", "multiline"은 RegExp 프로토타입 객체에 정의된 접근자 프로퍼티입니다. 이전 판에서는 RegExp 인스턴스에 정의된 데이터 프로퍼티였습니다.

25.4.10: ECMAScript 2019에서 Atomics.wake는 Atomics.wait와의 혼동을 방지하기 위해 Atomics.notify로 이름이 변경되었습니다.

27.1.5.4, 27.9.3.6: ECMAScript 2019에서 await가 큐에 넣는 Job의 수가 줄어들어 then() 호출과 await 표현식 사이의 resolve 순서에 관찰 가능한 차이가 생길 수 있게 되었습니다.

참고 문헌

IEEE 754-2019: IEEE Standard for Floating-Point Arithmetic. Institute of Electrical and Electronic Engineers, New York (2019) 참고

IEEE 754-2008과 IEEE 754-2019 사이에는 ECMA-262 명세에 영향을 주는 규범적 변경이 없습니다.
The Unicode Standard, <https://unicode.org/versions/latest>에서 이용 가능
Unicode Technical Note #5: Canonical Equivalence in Applications, <https://unicode.org/notes/tn5/>에서 이용 가능
Unicode Technical Standard #10: Unicode Collation Algorithm, <https://unicode.org/reports/tr10/>에서 이용 가능
Unicode Standard Annex #15, Unicode Normalization Forms, <https://unicode.org/reports/tr15/>에서 이용 가능
Unicode Standard Annex #18: Unicode Regular Expressions, <https://unicode.org/reports/tr18/>에서 이용 가능
Unicode Standard Annex #24: Unicode Script Property, <https://unicode.org/reports/tr24/>에서 이용 가능
Unicode Standard Annex #31, Unicode Identifiers and Pattern Syntax, <https://unicode.org/reports/tr31/>에서 이용 가능
Unicode Standard Annex #44: Unicode Character Database, <https://unicode.org/reports/tr44/>에서 이용 가능
Unicode Technical Standard #51: Unicode Emoji, <https://unicode.org/reports/tr51/>에서 이용 가능
IANA Time Zone Database, <https://www.iana.org/time-zones>에서 이용 가능
ISO 8601-1:2019(E) Date and time — Representations for information interchange — Part 1: Basic rules 및 Amendment 1:2022.
RFC 1738 “Uniform Resource Locators (URL)”, <https://rfc-editor.org/info/rfc1738>에서 이용 가능
RFC 2396 “Uniform Resource Identifiers (URI): Generic Syntax”, <https://rfc-editor.org/info/rfc2396>에서 이용 가능
RFC 3629 “UTF-8, a transformation format of ISO 10646”, <https://rfc-editor.org/info/rfc3629>에서 이용 가능
RFC 7231 “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content”, <https://rfc-editor.org/info/rfc7231>에서 이용 가능
RFC 9557 “Date and Time on the Internet: Timestamps with Additional Information”, <https://rfc-editor.org/info/rfc9557>에서 이용 가능

판권 정보

이 명세는 GitHub에서 Ecmarkup이라는 일반 텍스트 소스 형식으로 작성됩니다. Ecmarkup은 일반 텍스트로 Ecma 명세를 작성하고 이 문서의 편집 관례를 따르는 완전한 기능의 HTML 렌더링으로 명세를 처리하기 위한 프레임워크와 도구 모음을 제공하는 HTML 및 Markdown 방언입니다. Ecmarkup은 구문 정의를 위한 Grammarkdown과 알고리즘 단계 작성을 위한 Ecmarkdown을 포함한 여러 다른 형식과 기술을 기반으로 하며 통합합니다. 이 명세의 PDF 렌더링은 CSS Paged Media 명세를 활용하는 인쇄 스타일시트를 사용하여 생성되며 PrinceXML을 사용하여 변환됩니다.

이 명세의 이전 판은 Word를 사용하여 작성되었습니다. 이 판의 기반이 된 Ecmarkup 소스 텍스트는 자동 변환 도구를 사용하여 ECMAScript 2015 Word 문서를 Ecmarkup으로 변환하여 생성되었습니다.

Ecma International

Rue du Rhone 114

CH-1204 Geneva

Tel: +41 22 849 6000

Fax: +41 22 849 6001

Web: https://ecma-international.org/

저작권 고지

ALTERNATIVE COPYRIGHT NOTICE AND COPYRIGHT LICENSE

By obtaining and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.

Permission under Ecma’s copyright to copy, modify, prepare derivative works of, and distribute this work, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the work or portions thereof, including modifications:

(i) The full text of this COPYRIGHT NOTICE AND COPYRIGHT LICENSE in a location viewable to users of the redistributed or derivative work.

(ii) Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the Ecma alternative copyright notice should be included.

(iii) Notice of any changes or modifications, through a copyright statement on the document such as “This document includes material copied from or derived from ECMAScript® 2027 언어 명세 https://tc39.es/ecma262/.
Copyright © Ecma International.”

Disclaimers

THIS WORK IS PROVIDED “AS IS,” AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE DOCUMENT WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE DOCUMENT.

The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the work without specific, written prior permission. Title to copyright in this work will at all times remain with copyright holders.

소프트웨어 라이선스

All Software contained in this document ("Software") is protected by copyright and is being made available under the "BSD License", included below. This Software may be subject to third party rights (rights from parties other than Ecma International), including patent rights, and no licenses under such third party rights are granted under this license even if the third party concerned is a member of Ecma International. SEE THE ECMA CODE OF CONDUCT IN PATENT MATTERS AVAILABLE AT https://ecma-international.org/memento/codeofconduct.htm FOR INFORMATION REGARDING THE LICENSING OF PATENT CLAIMS THAT ARE REQUIRED TO IMPLEMENT ECMA INTERNATIONAL STANDARDS.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the authors nor Ecma International may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE ECMA INTERNATIONAL "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ECMA INTERNATIONAL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.