제어된 프레임 API

controlledframe 요소 element가 null이 아닌 탐색 컨텍스트를 가진 문서에 삽입될 때, 다음 단계를 실행한다.

1. element의 src가 비어 있지 않으면, 다음을 실행한다.

   1. element가 주어졌을 때 controlledframe을 초기화한다.

controlledframe 요소 element가 문서에서 제거될 때, 다음 단계를 실행한다.

1. element의 삽입된 navigable이 주어졌을 때 최상위 traversable을 파괴한다.

2. element의 삽입된 navigable을 null로 설정한다.

controlledframe 요소 element를 초기화하려면, 다음 단계를 실행한다.

1. element의 삽입된 navigable이 null임을 단언한다.

2. group을 새 탐색 컨텍스트 그룹으로 둔다.

3. document를 element의 노드 문서, element, group이 주어졌을 때 새 탐색 컨텍스트와 문서를 생성한 결과의 두 번째 반환값으로 둔다.

4. documentState를 새 문서 상태로 두며, 그 문서는 document이다.

5. traversable을 새 traversable navigable로 둔다.

6. documentState가 주어졌을 때 traversable navigable을 초기화한다.

7. traversable의 controlledFrameEmbedderParent를 element로 설정한다.

8. element의 삽입된 navigable을 traversable로 설정한다.

9. initialHistoryEntry를 traversable의 활성 세션 기록 항목으로 둔다.

10. initialHistoryEntry의 step을 0으로 설정한다.

11. initialHistoryEntry를 traversable의 세션 기록 항목에 추가한다.

    이 단계는 새 navigable 안에서 History.length를 초기화하는 데 필요하다. 이는 HTML Standard에 있는 기존 이슈이다.

12. element의 contentWindow를 document의 WindowProxy로 설정한다.

13. element와 element의 src가 주어졌을 때 controlledframe을 탐색한다.

controlledframe 요소 element를 USVString urlString이 주어졌을 때 탐색하려면, 다음 단계를 실행한다.

1. urlString이 absolute-URL 문자열이 아니면 반환한다.

2. url을 urlString과 element의 노드 문서가 주어졌을 때 URL을 파싱한 결과로 둔다.

3. historyHandling을 "auto"로 둔다.

4. element의 삽입된 navigable의 활성 문서가 완전히 로드됨이 아니면, historyHandling을 "replace"로 설정한다.

5. element의 삽입된 navigable을 url로 탐색한다. 이때 element의 노드 문서를 사용하고, NavigationHistoryBehavior는 historyHandling이다.

HTMLControlledFrameElement() 생성자 단계는 다음과 같다.

1. this의 request를 WebRequest의 새 인스턴스로 설정한다.

2. this의 contextMenus를 ContextMenus의 새 인스턴스로 설정한다.

controlledframe controlledframe, promise promise, 선택적인 value가 주어졌을 때, 삽입자의 promise를 resolve하려면 다음 단계를 실행한다.

1. controlledframe의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, promise를 value로 resolve한다.

   참고: controlledframe의 관련 전역 객체는 삽입자의 Window 객체이다.

controlledframe controlledframe, promise promise, 선택적인 value가 주어졌을 때, 삽입자의 promise를 reject하려면 다음 단계를 실행한다.

1. controlledframe의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, promise를 value로 reject한다.

   참고: controlledframe의 관련 전역 객체는 삽입자의 Window 객체이다.

URL url은 다음 단계가 true를 반환하는 경우 pattern인 URLPattern과 일치한다.

1. result를 pattern과 url이 주어졌을 때 match의 결과로 둔다.

2. result가 null이면 false를 반환한다.

3. true를 반환한다.

partition IDL 속성 setter 단계는 다음과 같다.

1. this의 삽입된 navigable이 null이 아니면, 다음을 실행한다.

   1. "NotSupportedError" DOMException을 던진다.

2. this의 partition을 주어진 값으로 설정한다.

src IDL 속성 setter 단계는 다음과 같다.

1. this가 문서 트리 안에 있지 않으면 반환한다.

2. this의 삽입된 navigable이 null이면, 다음을 실행한다.

   1. this가 주어졌을 때 controlledframe을 초기화한다.

3. 그렇지 않으면, 다음을 실행한다.

   1. this와 주어진 값이 주어졌을 때 controlledframe을 탐색한다.

controlledframe controlledframe와 정수 delta가 주어졌을 때, 삽입된 navigable의 기록을 delta만큼 순회하려면, 다음 단계를 실행한다.

1. resultPromise를 새 promise로 둔다.

2. resultPromise를 반환하고, 나머지 단계는 병렬로 실행한다.

3. embeddedNavigable을 controlledframe의 삽입된 navigable로 둔다.

4. embeddedNavigable이 null이면, controlledframe, resultPromise, false가 주어졌을 때 삽입자의 promise를 resolve하고, 이 단계를 중단한다.

5. embeddedNavigable의 활성 문서가 완전히 활성이 아니면, controlledframe, resultPromise, false가 주어졌을 때 삽입자의 promise를 resolve하고, 이 단계를 중단한다.

6. embeddedNavigable에 다음 세션 기록 순회 단계를 추가한다.

   1. allSteps를 embeddedNavigable에 대해 모든 사용된 기록 단계를 가져온 결과로 둔다.

   2. currentStepIndex를 allSteps 안에서 embeddedNavigable의 현재 세션 기록 단계의 인덱스로 둔다.

   3. targetStepIndex를 currentStepIndex + delta로 둔다.

   4. allSteps[targetStepIndex]가 존재하지 않으면, controlledframe, resultPromise, false가 주어졌을 때 삽입자의 promise를 resolve하고, 이 단계를 중단한다.

   5. result를 사용자 탐색 관여 "none"이 주어졌을 때 embeddedNavigable에 allSteps[targetStepIndex] 순회 기록 단계를 적용한 결과로 둔다.

   6. result가 "applied"와 같지 않으면, controlledframe, resultPromise, false가 주어졌을 때 삽입자의 promise를 resolve한다.

   7. 그렇지 않으면, controlledframe, resultPromise, true가 주어졌을 때 삽입자의 promise를 resolve한다.

canGoBack() 메서드 단계는 다음과 같다.

1. result를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. embeddedNavigable를 controlledframe의 삽입된 navigable로 둔다.

4. embeddedNavigable이 null이면, result를 false로 resolve하고 result를 반환한다.

5. embeddedNavigable의 노드 문서의 관련 전역 객체의 탐색 및 순회 태스크 소스에 전역 태스크를 큐에 추가하며, 이는 다음 단계를 실행한다.

   1. canGoBack을 embeddedNavigable의 현재 세션 기록 단계가 0보다 크면 true로, 그렇지 않으면 false로 둔다.

   2. controlledframe, result, canGoBack가 주어졌을 때 삽입자의 promise를 Resolve한다.

6. result를 반환한다.

canGoForward() 메서드 단계는 다음과 같다.

1. result를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. embeddedNavigable를 controlledframe의 삽입된 navigable로 둔다.

4. embeddedNavigable이 null이면, result를 false로 resolve하고 result를 반환한다.

5. embeddedNavigable의 노드 문서의 관련 전역 객체의 탐색 및 순회 태스크 소스에 전역 태스크를 큐에 추가하며, 이는 다음 단계를 실행한다.

   1. step을 embeddedNavigable의 현재 세션 기록 단계로 둔다.

   2. steps를 embeddedNavigable가 주어졌을 때 모든 사용된 기록 단계를 가져온 결과로 둔다.

   3. canGoForward를 step + 1 < steps의 크기이면 true로, 그렇지 않으면 false로 둔다.

   4. controlledframe, result, canGoForward가 주어졌을 때 삽입자의 promise를 Resolve한다.

6. result를 반환한다.

back() 메서드 단계는 다음과 같다.

1. this와 -1이 주어졌을 때 삽입된 navigable의 기록을 delta만큼 순회한 결과를 반환한다.

forward() 메서드 단계는 다음과 같다.

1. this와 1이 주어졌을 때 삽입된 navigable의 기록을 delta만큼 순회한 결과를 반환한다.

go(relativeIndex) 메서드 단계는 다음과 같다.

1. this와 relativeIndex가 주어졌을 때 삽입된 navigable의 기록을 delta만큼 순회한 결과를 반환한다.

reload() 단계는 다음과 같다.

1. embeddedNavigable을 this의 삽입된 navigable로 둔다.

2. embeddedNavigable이 null이면 반환한다.

3. embeddedNavigable의 노드 문서의 관련 전역 객체의 탐색 및 순회 태스크 소스에 전역 태스크를 큐에 추가하며, 이는 사용자 탐색 관여 "none"이 주어졌을 때 embeddedNavigable을 다시 로드한다.

stop() 단계는 다음과 같다.

1. embeddedNavigable을 this의 삽입된 navigable로 둔다.

2. embeddedNavigable이 null이면 반환한다.

3. embeddedNavigable의 노드 문서의 관련 전역 객체의 탐색 및 순회 태스크 소스에 전역 태스크를 큐에 추가하며, 이는 embeddedNavigable의 로드를 중지한다.

// One of |code| or |file| must be specified but not both.
dictionary InjectDetails {
  DOMString code;
  USVString file;
};

dictionary InjectionItems {
  DOMString code;
  sequence<USVString> files;
};

enum RunAt {
  "document-start",
  "document-end",
  "document-idle",
};

dictionary ContentScriptDetails {
  required DOMString name;
  InjectionItems js;
  InjectionItems css;
  required sequence<(URLPattern or URLPatternInput)> urlPatterns;
  sequence<(URLPattern or URLPatternInput)> excludeURLPatterns;
  boolean allFrames;
  boolean matchAboutBlank;
  RunAt runAt;
};

controlledframe controlledframe, USVString urlString, boolean isCss, long index, 그리고 long, boolean, DOMString을 받는 알고리즘 completionSteps가 주어졌을 때 삽입 항목을 가져오려면, 다음 단계를 실행한다.

참고: 여기서는 클래식 스크립트를 가져오기를 사용할 수 없다. 가져오기가 controlledframe의 관련 설정 객체를 사용해야 하지만, 클래식 스크립트는 삽입된 navigable의 활성 문서의 관련 설정 객체를 사용하여 실행되기 때문이다.

1. urlString이 유효한 URL 문자열이 아니면, 다음을 실행한다.

   1. 0, false, ""가 주어졌을 때 completionSteps를 실행한다.

   2. 반환한다.

2. request를 다음 필드를 가진 새 요청으로 둔다.

   URL

   urlString과 controlledframe의 노드 문서가 주어졌을 때 URL을 파싱한 결과.

   method

   "GET"

   destination

   isCss가 true이면 "style", 그렇지 않으면 "script"

   client

   controlledframe의 관련 설정 객체

   mode

   "cors"

3. request를 가져온다. 이때 processResponseConsumeBody는 응답 response와 null, failure 또는 바이트 시퀀스 contents가 주어졌을 때 다음 단계로 설정된다.

   1. response의 상태가 200이 아니거나, contents가 null 또는 failure이면, 0, false, ""가 주어졌을 때 completionSteps를 실행한다.

   2. 그렇지 않으면, index, true, contents가 주어졌을 때 completionSteps를 실행한다.

controlledframe controlledframe와 ContentScriptDetails details가 주어졌을 때 ContentScriptDetails를 검증하고 resolve하려면, 다음 단계를 실행한다.

1. result를 새 promise로 둔다.

2. details["js"]와 details["css"]가 둘 다 정의되어 있거나, 둘 다 정의되어 있지 않으면, result를 TypeError로 reject하고 이를 반환한다.

3. details["urlPatterns"]가 비어 있으면, result를 TypeError로 reject하고 이를 반환한다.

4. isCss를 details["css"]가 정의되어 있으면 true, 그렇지 않으면 false와 같은 boolean으로 둔다.

5. isCss가 true이고 details["runAt"]가 "document-start"와 같지 않으면, result를 TypeError로 reject하고 이를 반환한다.

6. injectionItems를 isCss가 true이면 details["css"]로, 그렇지 않으면 details["js"]로 둔다.

7. injectionItems["code"]와 injectionItems["files"]가 둘 다 정의되어 있거나, 둘 다 정의되어 있지 않으면, result를 TypeError로 reject하고 이를 반환한다.

8. result를 반환하고, 나머지 단계를 병렬로 실행한다.

9. config를 다음 값을 가진 새 콘텐츠 스크립트 구성으로 둔다.

   pendingFetchCount

   0

   urlPatterns

   «»

   excludeURLPatterns

   «»

   allFrames

   정의되어 있으면 details["allFrames"], 그렇지 않으면 false

   matchAboutBlank

   정의되어 있으면 details["matchAboutBlank"], 그렇지 않으면 false

   runAt

   정의되어 있으면 details["runAt"], 그렇지 않으면 document-idle

10. details["urlPatterns"]의 각 urlPattern에 대해:

    1. urlPattern이 URLPattern이면, urlPattern을 config의 urlPatterns에 추가한다.

    2. 그렇지 않으면, urlPattern이 주어졌을 때 URLPattern의 새 인스턴스를 config의 urlPatterns에 추가한다.

11. details["excludeURLPatterns"]가 정의되어 있으면, 다음을 실행한다.

    1. details["excludeURLPatterns"]의 각 urlPattern에 대해:

       1. urlPattern이 URLPattern이면, urlPattern을 config의 excludeURLPatterns에 추가한다.

       2. 그렇지 않으면, urlPattern이 주어졌을 때 URLPattern의 새 인스턴스를 config의 excludeURLPatterns에 추가한다.

12. completionSteps를 long index, boolean success, 그리고 DOMString source를 받는 다음 알고리즘으로 둔다.

    1. success가 false이면, controlledframe, result, TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

    2. isCss이면, 다음을 실행한다.

       1. config의 css[index]를 source로 설정한다.

    3. 그렇지 않으면, 다음을 실행한다.

       1. config의 js[index]를 source로 설정한다.

    4. config의 pendingFetchCount를 감소시킨다.

    5. config의 pendingFetchCount가 0보다 크면 반환한다.

    6. controlledframe의 콘텐츠 스크립트 맵[details[name]]을 config로 설정한다.

    7. controlledframe와 result가 주어졌을 때 삽입자의 promise를 Resolve한다.

13. injectionItems["code"]가 정의되어 있으면, 다음을 실행한다.

    1. 0, true, injectionItems ["code"]가 주어졌을 때 completionSteps를 실행한다.

14. 그렇지 않으면, 다음을 실행한다.

    1. injectionItems["files"]가 비어 있으면, controlledframe, result, TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

    2. injectionItems ["files"]의 각 urlString에 대해:

       1. controlledframe, urlString, isCss, config의 pendingFetchCount, 그리고 completionSteps가 주어졌을 때 삽입 항목 가져오기를 실행한다.

       2. config의 pendingFetchCount를 증가시킨다.

콘텐츠 스크립트 구성 config, URL url, 그리고 boolean isTopLevel가 주어졌을 때, 콘텐츠 스크립트 구성이 문서에 적용되는지 판단하려면, 다음 단계를 실행한다.

1. isTopLevel이 false이고 config의 allFrames가 false이면, false를 반환한다.

2. url이 about:blank와 일치하고 config의 matchAboutBlank가 false이면, false를 반환한다.

3. urlString을 url을 직렬화한 결과로 둔다.

4. match를 false로 둔다.

5. config의 urlPatterns의 각 pattern에 대해:

   1. urlString이 pattern URLPattern과 일치하면, match를 true로 설정한다.

6. config의 excludeURLPatterns의 각 pattern에 대해:

   1. urlString이 pattern URLPattern과 일치하면, match를 false로 설정한다.

7. match를 반환한다.

Document document와 RunAt currentPhase가 주어졌을 때 콘텐츠 스크립트를 문서에 삽입하려면, 다음 단계를 실행한다.

1. embeddedNavigable를 document의 노드 navigable의 traversable navigable로 둔다.

2. embeddedNavigable이 null이거나 그 controlledFrameEmbedderParent가 null이면 반환한다.

3. controlledframe를 embeddedNavigable의 controlledFrameEmbedderParent로 둔다.

4. url을 document의 URL로 둔다.

5. isTopLevel을 document의 노드 navigable의 부모가 null이면 true, 그렇지 않으면 false로 둔다.

6. controlledframe의 콘텐츠 스크립트 맵의 각 config에 대해:

   1. config, url, 그리고 isTopLevel가 주어졌을 때 콘텐츠 스크립트 구성이 문서에 적용되는지 판단한 결과가 false이면, 계속한다.

   2. currentPhase가 document-start와 같고, config의 css가 비어 있지 않으면, 다음을 실행한다.

      1. config의 css의 각 styleSource에 대해, document와 styleSource가 주어졌을 때 스타일시트를 문서에 삽입을 실행한다.

   3. 그렇지 않고 currentPhase가 config의 runAt과 같으면, 다음을 실행한다.

      1. config의 js의 각 scriptSource에 대해, document, scriptSource, 그리고 빈 알고리즘이 주어졌을 때 스크립트를 문서에 삽입을 실행한다.

Document document와 DOMString styleSource가 주어졌을 때 스타일시트를 문서에 삽입하려면, 다음 단계를 실행한다.

1. styleSheet를 새 CSS 스타일시트 객체로 둔다.

2. styleSheet와 styleSource가 주어졌을 때 CSSStyleSheet의 규칙을 동기적으로 교체한다.

3. document의 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, document와 styleSheet가 주어졌을 때 CSS 스타일시트를 추가한다.

Document document, DOMString scriptSource, 그리고 completion record를 받는 알고리즘 completionSteps가 주어졌을 때 스크립트를 문서에 삽입하려면, 다음 단계를 실행한다.

참고: document.currentScript는 scriptSource를 실행하는 동안 의도적으로 설정되지 않는다.

1. script를 scriptSource, document의 관련 설정 객체, document의 URL, 그리고 기본 스크립트 가져오기 옵션이 주어졌을 때 클래식 스크립트를 생성한 결과로 둔다.

2. document의 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하며, 이는 다음 단계를 실행한다.

   1. completionRecord를 script가 주어졌을 때 클래식 스크립트를 실행한 결과로 둔다.

   2. controlledframe를 document의 노드 navigable의 traversable navigable의 controlledFrameEmbedderParent로 둔다.

   3. controlledframe의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하며, 이는 completionRecord로 completionSteps를 실행한다.

addContentScripts(contentScriptList) 메서드 단계는 다음과 같다.

1. contentScriptList가 비어 있으면, TypeError로 reject된 새 promise를 반환한다.

2. promises를 빈 목록으로 둔다.

3. contentScriptList의 각 contentScript에 대해:

   1. promise를 contentScript가 주어졌을 때 ContentScriptDetails 검증 및 resolve를 호출한 결과로 둔다.

   2. promise를 promises에 추가한다.

4. promises가 주어졌을 때 모든 promise를 기다리는 promise를 가져온 결과를 반환한다.

removeContentScripts(scriptNameList) 메서드 단계는 다음과 같다.

1. result를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. result를 반환하고, 나머지 단계를 병렬로 실행한다.

4. scriptNameList가 undefined이면, 다음을 실행한다.

   1. controlledframe의 콘텐츠 스크립트 맵을 비운다.

5. 그렇지 않으면, scriptNameList의 각 name에 대해:

   1. controlledframe의 콘텐츠 스크립트 맵[name]을 제거한다.

6. controlledframe와 result가 주어졌을 때 삽입자의 promise를 Resolve한다.

executeScript(details) 메서드 단계는 다음과 같다.

1. result를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. result를 반환하고, 나머지 단계를 병렬로 실행한다.

4. controlledframe의 삽입된 navigable이 null이면, controlledframe, result, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

5. details["code"]와 details"[file"]가 둘 다 정의되어 있거나 둘 다 정의되어 있지 않으면, controlledframe, result, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

6. executionSteps를 long과 DOMString 또는 boolean scriptString을 받는 다음 알고리즘으로 둔다.

   1. scriptString이 DOMString이 아니면, controlledframe, result, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

   2. document를 controlledframe의 삽입된 navigable의 활성 문서로 둔다.

   3. document, scriptString, 그리고 completion record completionRecord를 받는 다음 알고리즘이 주어졌을 때, 스크립트를 문서에 삽입한다.

      1. completionRecord가 normal completion이면, 다음을 실행한다.

         1. controlledframe, result, 그리고 completionRecord.[[Value]]가 주어졌을 때 삽입자의 promise를 Resolve한다.

      2. 그렇지 않으면, 다음을 실행한다.

         1. controlledframe, result, 그리고 completionRecord.[[Value]]가 주어졌을 때 삽입자의 promise를 Reject한다.

7. details["code"]가 정의되어 있으면, 0과 details["code"]가 주어졌을 때 executionSteps를 실행한다.

8. 그렇지 않으면, controlledframe, details["file"], false, 0, 그리고 executionSteps가 주어졌을 때 삽입 항목 가져오기를 실행한다.

insertCSS(details) 메서드 단계는 다음과 같다.

1. result를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. result를 반환하고, 나머지 단계를 병렬로 실행한다.

4. controlledframe의 삽입된 navigable이 null이면, controlledframe, result, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

5. details["code"]와 details["file"]가 둘 다 정의되어 있거나 둘 다 정의되어 있지 않으면, controlledframe, result, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

6. executionSteps를 long, boolean success, 그리고 DOMString styleString을 받는 다음 알고리즘으로 둔다.

   1. success가 false이면, controlledframe, result, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

   2. document를 controlledframe의 삽입된 navigable의 활성 문서로 둔다.

   3. document와 styleString가 주어졌을 때 스타일시트를 문서에 삽입한다.

   4. controlledframe와 result가 주어졌을 때 삽입자의 promise를 Resolve한다.

7. details["code"]가 정의되어 있으면, 0, true, 그리고 details["code"]가 주어졌을 때 executionSteps를 실행한다.

8. 그렇지 않으면, controlledframe, details["file"], false, 0, 그리고 executionSteps가 주어졌을 때 삽입 항목 가져오기를 실행한다.

dictionary ClearDataOptions {
  long since;
};

dictionary ClearDataTypeSet {
  boolean cache;
  boolean cookies;
  boolean fileSystems;
  boolean indexedDB;
  boolean localStorage;
  boolean persistentCookies;
  boolean sessionCookies;
};

저장소 버킷 bucket, 저장소 식별자 identifier, 그리고 long since가 주어졌을 때 저장소 병을 비우려면, 다음 단계를 실행한다.

참고: 가능하면 사용자 에이전트는 epoch 이후의 밀리초 단위 타임스탬프를 나타내는 since 이후에 마지막으로 사용된 데이터만 제거해야 한다. 모든 사용자 에이전트가 모든 브라우징 데이터에 대해 쓰기 또는 접근 시간을 추적하는 것은 아니다. 구현은 가능한 한 since를 존중해야 하지만, 이 API는 그 사용 가능성을 보장하지 않는다.

1. bottle을 bucket[identifier]로 둔다.

2. bottle의 map을 비운다.

3. bottle의 proxy map reference set을 새 set으로 설정한다.

clearData(options, types) 메서드 단계는 다음과 같다.

1. resultPromise를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. resultPromise를 반환하고, 나머지 단계를 병렬로 실행한다.

4. clearSince를 0으로 둔다.

5. options["since"]가 정의되어 있으면, clearSince를 options|["since"]로 설정한다.

6. embeddingOrigin을 controlledframe의 관련 설정 객체의 최상위 출처로 둔다.

7. partition을 controlledframe의 partition으로 둔다.

8. 각 storageKey → shelf에 대해, 이는 사용자 에이전트의 저장소 창고에 속한다.

   1. storageKey의 삽입 출처가 embeddingOrigin과 같지 않거나 storageKey의 partition이 partition과 같지 않으면, 계속한다.

   2. bucket을 shelf["default"]로 둔다.

   3. types["fileSystems"]가 true이면:

      1. bucket, "fileSystem", 그리고 clearSince가 주어졌을 때 저장소 병을 비운다.

   4. types["indexedDB"]가 true이면:

      1. bucket, "indexedDB", 그리고 clearSince가 주어졌을 때 저장소 병을 비운다.

   5. types["localStorage"]가 true이면:

      1. bucket, "localStorage", 그리고 clearSince가 주어졌을 때 저장소 병을 비운다.

9. types["cookies"], types["persistentCookies"], 또는 types["sessionCookies"]가 true이면, 다음을 실행한다.

   [COOKIES] 명세는 저장소 키 같은 메커니즘을 통한 쿠키 파티션화를 지원하지 않는다. 다음 단계는 모든 쿠키를 지우지만, 의도는 이 Controlled Frame의 현재 partition을 가진 Controlled Frame 안의 콘텐츠가 만든 쿠키만 삭제하는 것이다.

   1. 각 cookie에 대해, 이는 사용자 에이전트의 쿠키 저장소에 있다.

      1. cookie의 persistent-flag가 설정되어 있으면, 다음을 실행한다.

         1. types["cookies"]와 types["persistentCookies"]가 false이면, 계속한다.

      2. 그렇지 않으면, 다음을 실행한다.

         1. types["cookies"]와 types["sessionCookies"]가 false이면, 계속한다.

      3. cookie의 last-access-time을 epoch 이후의 밀리초로 표현한 값이 clearSince보다 작으면, 계속한다.

      4. 사용자 에이전트의 쿠키 저장소에서 cookie를 제거한다.

10. types["cache"]가 true이면, 다음을 실행한다.

    1. 각 storageKey → cache에 대해, 이는 사용자 에이전트가 관리한다: [HTTP-CACHING]

       1. storageKey의 삽입 출처가 embeddingOrigin과 같지 않거나 storageKey의 partition이 partition과 같지 않으면, 계속한다.

       2. cache를 비운다.

11. controlledframe와 resultPromise가 주어졌을 때 삽입자의 promise를 Resolve한다.

getAudioState() 메서드 단계는 다음과 같다.

1. resultPromise를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. resultPromise를 반환하고, 나머지 단계를 병렬로 실행한다.

4. controlledframe의 삽입된 navigable이 null이면, controlledframe, resultPromise, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

5. playingAudio를, 중첩된 프레임을 포함하여 controlledframe의 삽입된 navigable 안의 콘텐츠가 현재 오디오를 재생하고 있으면 true, 그렇지 않으면 false로 둔다.

6. controlledframe, resultPromise, 그리고 playingAudio가 주어졌을 때 삽입자의 promise를 Resolve한다.

isAudioMuted() 메서드 단계는 다음과 같다.

1. resultPromise를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. resultPromise를 반환하고, 나머지 단계를 병렬로 실행한다.

4. controlledframe의 삽입된 navigable이 null이면, controlledframe, resultPromise, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

5. controlledframe, resultPromise, 그리고 controlledframe의 삽입된 navigable의 muted 플래그가 주어졌을 때 삽입자의 promise를 Resolve한다.

setAudioMuted(mute) 메서드 단계는 다음과 같다.

1. this의 삽입된 navigable이 null이면, TypeError를 던진다.

2. this의 삽입된 navigable의 muted 플래그를 mute로 설정한다.

enum ZoomMode {
  "per-origin",
  "per-view",
  "disabled"
};

HTMLControlledFrameElement e가 주어졌을 때 per-origin 확대/축소 수준을 가져오려면, 다음 단계를 실행한다.

1. result를 처음에 1.0f로 설정된 float로 둔다.

2. key를 e의 삽입된 navigable의 활성 문서의 현재 설정 객체와 관련된 환경이 주어졌을 때 Controlled Frame 저장소 키를 얻은 결과로 둔다.

3. Controlled Frame 확대/축소 맵[key]가 존재하면, key가 주어졌을 때 Controlled Frame 확대/축소 맵의 값을 가져온 결과로 result를 설정한다.

4. result를 반환한다.

HTMLControlledFrameElement e와 float zoomLevel가 주어졌을 때 per-origin 확대/축소 수준을 설정하려면, 다음 단계를 실행한다.

1. key를 e의 삽입된 navigable의 활성 문서의 현재 설정 객체와 관련된 환경이 주어졌을 때 Controlled Frame 저장소 키를 얻은 결과로 둔다.

2. key와 값 zoomLevel가 주어졌을 때 Controlled Frame 확대/축소 맵의 값을 설정한다.

HTMLControlledFrameElement e가 주어졌을 때 현재 문서가 per-origin 확대/축소 수준을 가지는지 판단하려면, 다음 단계를 실행한다.

1. key를 e의 삽입된 navigable의 활성 문서의 현재 설정 객체와 관련된 환경이 주어졌을 때 Controlled Frame 저장소 키를 얻은 결과로 둔다.

2. Controlled Frame 확대/축소 맵[key]가 존재하면 true를 반환한다.

3. false를 반환한다.

getZoomMode() 메서드 단계는 다음과 같다.

1. p를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. p를 반환하고, 나머지 단계를 병렬로 실행한다.

4. controlledframe, p, 그리고 controlledframe의 zoomMode가 주어졌을 때 삽입자의 promise를 Resolve한다.

setZoomMode(zoomMode) 메서드 단계는 다음과 같다.

1. p를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. p를 반환하고, 나머지 단계를 병렬로 실행한다.

4. currentZoomMode를 controlledframe가 주어졌을 때 getZoomMode의 결과로 둔다.

5. currentZoomMode가 zoomMode와 같으면, controlledframe와 p가 주어졌을 때 삽입자의 promise를 resolve한다.

6. controlledframe의 zoomMode를 zoomMode로 설정한다.

7. zoomMode가 per-origin이면:

   1. controlledframe가 주어졌을 때 현재 문서가 per-origin 확대/축소 수준을 가지는지가 true이면:

      1. oldZoomFactor를 controlledframe의 currentZoom으로 둔다.

      2. controlledframe의 currentZoom을 controlledframe가 주어졌을 때 per-origin 확대/축소 수준을 가져온 결과로 설정한다.

      3. oldZoomFactor가 controlledframe의 currentZoom과 같지 않으면:

         1. controlledframe의 currentZoom가 주어졌을 때 controlledframe의 삽입된 문서에 확대/축소 수준을 적용한다.

         2. controlledframe, oldZoomFactor, controlledframe의 currentZoom와 함께 "zoomchange" 이벤트를 발화한다.

8. zoomMode가 disabled이면:

   1. oldZoomFactor를 controlledframe의 currentZoom으로 둔다.

   2. controlledframe의 currentZoom을 1.0f로 설정한다.

   3. oldZoomFactor가 controlledframe의 currentZoom과 같지 않으면:

      1. controlledframe의 currentZoom가 주어졌을 때 controlledframe의 삽입된 문서에 확대/축소 수준을 적용한다.

      2. controlledframe, oldZoomFactor, controlledframe의 currentZoom와 함께 "zoomchange" 이벤트를 발화한다.

9. controlledframe와 p가 주어졌을 때 삽입자의 promise를 Resolve한다.

getZoom() 메서드 단계는 다음과 같다.

1. p를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. p를 반환하고, 나머지 단계를 병렬로 실행한다.

4. embeddedNavigable를 controlledframe의 삽입된 navigable로 둔다.

5. embeddedNavigable이 null이면, controlledframe, p, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

6. controlledframe, p, 그리고 controlledframe의 currentZoom이 주어졌을 때 삽입자의 promise를 Resolve한다.

setZoom(zoomFactor) 메서드 단계는 다음과 같다.

1. p를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. p를 반환하고, 나머지 단계를 병렬로 실행한다.

4. embeddedNavigable를 controlledframe의 삽입된 navigable로 둔다.

5. embeddedNavigable이 null이면, controlledframe, p, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

6. controlledframe의 ZoomMode가 disabled이면:

   1. controlledframe, p, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 Reject하고, 이 단계를 중단한다.

7. controlledframe의 ZoomMode가 per-origin이면:

   1. oldZoomFactor를 controlledframe의 currentZoom으로 둔다.

   2. controlledframe와 zoomFactor가 주어졌을 때 per-origin 확대/축소 수준을 설정한다.

   3. 사용자 에이전트의 탐색 컨텍스트 그룹 집합 안의 각 탐색 컨텍스트 그룹 group에 대해:

      1. group 안의 각 최상위 탐색 컨텍스트 browsingContext에 대해:

         1. embeddedDocument를 browsingContext의 활성 문서로 둔다.

         2. embedder를 embeddedDocument의 노드 navigable의 controlledFrameEmbedderParent로 둔다.

         3. embedder가 null이면 계속한다.

         4. match를 다음 조건이 모두 true이면 true로 둔다.

            • embedder의 ZoomMode가 per-origin이다.

            • embedder의 partition이 controlledframe의 partition과 같다.

            • embeddedDocument의 출처가 controlledframe의 삽입된 navigable의 활성 문서의 출처와 같다.

            • embedder의 currentZoom이 zoomFactor와 같지 않다.

         5. match가 true이면, 다음을 실행한다.

            1. embedder의 currentZoom을 zoomFactor로 설정한다.

            2. zoomFactor가 주어졌을 때 embeddedDocument에 확대/축소 수준을 적용한다.

            3. embedder, oldZoomFactor, 그리고 zoomFactor와 함께 "zoomchange" 이벤트를 발화한다.

8. controlledframe의 ZoomMode가 per-view이면:

   1. oldZoomFactor를 controlledframe의 currentZoom으로 둔다.

   2. controlledframe의 currentZoom을 zoomFactor로 설정한다.

   3. oldZoomFactor가 controlledframe의 currentZoom과 같지 않으면:

      1. controlledframe의 currentZoom가 주어졌을 때 controlledframe의 삽입된 문서에 확대/축소 수준을 적용한다.

      2. controlledframe, oldZoomFactor, controlledframe의 currentZoom와 함께 "zoomchange" 이벤트를 발화한다.

9. controlledframe와 p가 주어졌을 때 삽입자의 promise를 Resolve한다.

// One of |code| or |file| must be specified but not both.
dictionary ImageDetails {
  DOMString format;
  DOMString quality;
};

captureVisibleRegion(options) 메서드 단계는 다음과 같다.

1. resultPromise를 새 promise로 둔다.

2. controlledframe를 this로 둔다.

3. resultPromise를 반환하고, 나머지 단계를 병렬로 실행한다.

4. controlledframe의 삽입된 navigable이 null이면, controlledframe, resultPromise, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

5. optionsFormat를 기본값 "JPEG"로 둔다.

6. optionsQuality를 기본값 100으로 둔다.

7. options에 "format" 필드가 있으면:

   1. optionsFormat를 options["format"]으로 둔다.

8. optionsFormat가 인식할 수 없는 형식이면, controlledframe, resultPromise, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

9. options에 "quality" 필드가 있으면:

   1. optionsQuality를 options["quality"]로 둔다.

10. optionsQuality가 정수가 아니거나 0 이상 100 이하가 아니면, controlledframe, resultPromise, 그리고 TypeError가 주어졌을 때 삽입자의 promise를 reject하고, 이 단계를 중단한다.

11. imageData를 optionsQuality 품질로 optionsFormat에 인코딩된, 삽입된 콘텐츠의 보이는 영역을 보여주는 이미지로 둔다.

    참고: 지원되는 이미지 형식의 집합은 구현 정의이지만, 적어도 "JPEG"와 "PNG"를 지원하는 것이 권장된다.

12. controlledframe, resultPromise, 그리고 imageData를 포함하는 data: URL이 주어졌을 때 삽입자의 promise를 Resolve한다.

print() 메서드 단계는 다음과 같다.

1. this의 삽입된 navigable이 null이면, TypeError를 던진다.

2. 삽입된 콘텐츠에 대한 브라우저 인쇄 페이지 기능을 시작한다.

[Exposed=Window, IsolatedContext]
interface ConsoleMessage {
  readonly attribute long level;
  readonly attribute DOMString message;
};

[Exposed=Window, IsolatedContext]
interface ConsoleMessageEvent : Event {
  constructor(DOMString type, optional ConsoleMessageEventInit eventInitDict = {});
  readonly attribute ConsoleMessage consoleMessage;
};

dictionary ConsoleMessageEventInit: EventInit {
  ConsoleMessage? consoleMessage;
};

controlledframe 요소 target, long logLevel 그리고 DOMString message가 주어졌을 때 e인 ConsoleMessageEvent를 발화하려면, 다음 단계를 실행한다.

1. consoleMessage를 새 ConsoleMessage 객체로 둔다.

2. consoleMessage의 다음 필드를 설정한다.

   level

   logLevel.

   message

   message.

3. e의 consoleMessage를 consoleMessage로 설정한다.

4. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

enum DialogType {
  "alert",
  "confirm",
  "prompt"
};

[Exposed=Window, IsolatedContext]
interface DialogController {
  undefined okay(optional DOMString response);
  undefined cancel();
};

[Exposed=Window, IsolatedContext]
interface DialogMessage {
  readonly attribute DialogType messageType;
  readonly attribute DOMString messageText;
  readonly attribute DialogController dialog;
};

[Exposed=Window, IsolatedContext]
interface DialogEvent : Event {
  constructor(DOMString type, optional DialogEventInit eventInitDict = {});
  readonly attribute DialogMessage dialogMessage;
};

dictionary DialogEventInit: EventInit {
  DialogMessage? dialogMessage;
};

controlledframe 요소 target, simple-dialogs 타입 dialogType, 그리고 message message가 주어졌을 때 e인 DialogEvent를 발화하려면, 다음 단계를 실행한다.

1. e["dialogMessage"]["dialog"]["accept"]가 false와 같음을 단언한다.

2. dialogMessage를 새 DialogMessage 객체로 둔다.

3. dialog를 새 DialogController 객체로 둔다.

4. dialogMessage의 다음 필드를 설정한다.

   messageType

   dialogType.

   messageText

   message.

   dialog

   dialog.

5. e의 dialogMessage를 dialogMessage로 설정한다.

6. complete를 false로 둔다.

7. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여 다음 단계를 실행한다.

   1. e를 target에 디스패치한다.

   2. complete를 true로 설정한다.

8. complete가 true가 될 때까지 동기적으로 기다린다.

   참고: "dialog" 이벤트가 나타내는 alert, confirm, prompt 대화상자는 메인 스레드를 차단하고, 여기에서 호출하는 이벤트 핸들러가 반환값에 영향을 줄 수 있으므로, 여기서의 차단은 의도된 것이다.

9. e["dialogMessage"]["dialog"]["accept"] 및 e["dialogMessage"]["dialog"]["response"]를 반환한다.

enum WindowOpenDisposition {
  "ignore",
  "save_to_disk",
  "current_tab",
  "new_background_tab",
  "new_foreground_tab",
  "new_window",
  "new_popup"
};

[Exposed=Window, IsolatedContext]
interface NewWindowController {
  undefined attach(HTMLControlledFrameElement newControlledFrame);
  undefined discard();
};

[Exposed=Window, IsolatedContext]
interface NewWindow {
  readonly attribute NewWindowController window;
  readonly attribute USVString targetUrl;
  readonly attribute DOMString name;
  readonly attribute WindowOpenDisposition windowOpenDisposition;
};

[Exposed=Window, IsolatedContext]
interface NewWindowEvent : Event {
  constructor(DOMString type, optional NewWindowEventInit eventInitDict = {});
  readonly attribute NewWindow newWindow;
};

dictionary NewWindowEventInit: EventInit {
  NewWindow? newWindow;
};

controlledframe 요소 controlledFrame, USVString url, DOMString target, navigable targetNavigable, 그리고 WindowOpenDisposition windowOpenDisposition가 주어졌을 때 e인 NewWindowEvent를 발화하려면, 다음 단계를 실행한다.

1. controller를 새 NewWindowController 객체로 둔다.

2. controller의 대상 navigable을 targetNavigable로 설정한다.

3. newWindow를 새 NewWindow 객체로 둔다.

4. newWindow의 다음 필드를 설정한다.

   window

   controller

   targetUrl

   url

   name

   target.

   windowOpenDisposition

   windowOpenDisposition

5. e의 newWindow를 newWindow로 설정한다.

6. controlledFrame의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 controlledFrame에 디스패치한다.

enum PermissionType {
  "media",
  "geolocation",
  "pointerLock",
  "download",
  "filesystem",
  "fullscreen",
  "hid",
};

[Exposed=Window, IsolatedContext]
interface PermissionRequestControllerBase {
  undefined allow();
  undefined cancel();
};

[Exposed=Window, IsolatedContext]
interface MediaPermissionRequestController: PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface GeolocationPermissionRequestController: PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface PointerLockPermissionRequestController: PermissionRequestControllerBase {
  readonly attribute boolean lastUnlockedBySelf;
  readonly attribute boolean userGesture;
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface DownloadPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute DOMString requestMethod;
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface FileSystemPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface FullscreenPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute USVString origin;
};

[Exposed=Window, IsolatedContext]
interface HidPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface PermissionRequest {
  readonly attribute PermissionType permission;
  readonly attribute PermissionRequestControllerBase request;
};

[Exposed=Window, IsolatedContext]
interface PermissionRequestEvent : Event {
  constructor(DOMString type, optional PermissionRequestEventInit eventInitDict = {});
  readonly attribute PermissionRequest permissionRequest;
};

dictionary PermissionRequestEventInit: EventInit {
  PermissionRequest? permissionRequest;
};

문서 embeddedDocument, controlledframe 요소 target, DOMString type, USVString url, 선택적인 dictionary options, 그리고 boolean을 받는 알고리즘 completionSteps가 주어졌을 때 e인 PermissionRequestEvent를 발화하려면, 다음 단계를 실행한다.

1. permissionRequest를 새 PermissionRequest 객체로 둔다.

2. type이 "media"이면:

   1. requestController를 다음 속성을 가진 새 MediaPermissionRequestController로 둔다.

      url

      url

3. type이 "geolocation"이면:

   1. requestController를 다음 속성을 가진 새 GeolocationPermissionRequestController로 둔다.

      url

      url

4. type이 "pointerLock"이면:

   1. requestController를 다음 속성을 가진 새 PointerLockPermissionRequestController로 둔다.

      lastUnlockedBySelf

      options["lastUnlockedBySelf"]

      userGesture

      options["userGesture"]

      url

      url

5. type이 "download"이면:

   1. requestController를 다음 속성을 가진 새 DownloadPermissionRequestController로 둔다.

      requestMethod

      options["requestMethod"]

      url

      url

6. type이 "filesystem"이면:

   1. requestController를 다음 속성을 가진 새 FileSystemPermissionRequestController로 둔다.

      url

      url

7. type이 "fullscreen"이면:

   1. requestController를 다음 속성을 가진 새 FullscreenPermissionRequestController로 둔다.

      origin

      url의 origin

8. type이 "hid"이면:

   1. requestController를 다음 속성을 가진 새 HidPermissionRequestController로 둔다.

      url

      url

9. permissionRequest의 다음 필드를 설정한다.

   request

   requestController

   permission

   type.

10. e의 permissionRequest를 permissionRequest로 설정한다.

11. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여 다음 단계를 실행한다.

    1. e를 target에 디스패치한다.

    2. embeddedDocument의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e["permissionRequest"]["permission"]["allow"]와 함께 completionSteps를 실행한다.

[Exposed=Window, IsolatedContext]
interface SizeChange {
  readonly attribute unsigned long oldWidth;
  readonly attribute unsigned long oldHeight;
  readonly attribute unsigned long newWidth;
  readonly attribute unsigned long newHeight;
};

[Exposed=Window, IsolatedContext]
interface SizeChangedEvent : Event {
  constructor(DOMString type, optional SizeChangedEventInit eventInitDict = {});
  readonly attribute SizeChange sizeChange;
};

dictionary SizeChangedEventInit: EventInit {
  SizeChange? sizeChange;
};

controlledframe 요소 target, 음이 아닌 숫자 4개 oldWidth, oldHeight, newWidth, newHeight가 주어졌을 때 SizeChangedEvent e를 발화하려면:

1. sizeChange를 새 SizeChange 객체로 둔다.

2. sizeChange의 다음 필드를 설정한다.

   oldWidth

   oldWidth.

   oldHeight

   oldHeight.

   newWidth

   newWidth.

   newHeight

   newHeight.

3. e의 sizeChange를 sizeChange로 설정한다.

4. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface ZoomChange {
  readonly attribute float oldZoomFactor;
  readonly attribute float newZoomFactor;
};

[Exposed=Window, IsolatedContext]
interface ZoomChangeEvent : Event {
  constructor(DOMString type, optional ZoomChangeEventInit eventInitDict = {});
  readonly attribute ZoomChange zoomChange;
};

dictionary ZoomChangeEventInit: EventInit {
  ZoomChange? zoomChange;
};

controlledframe 요소 target, float 숫자 2개 oldZoomFactor, newZoomFactor가 주어졌을 때 e인 ZoomChangeEvent를 발화하려면:

1. zoomChange를 새 ZoomChange 객체로 둔다.

2. zoomChange의 다음 필드를 설정한다.

   oldZoomFactor

   oldZoomFactor.

   newZoomFactor

   newZoomFactor.

3. e의 zoomChange를 zoomChange로 설정한다.

4. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface ContentLoadEvent : Event {
  constructor(DOMString type, optional EventInit eventInitDict = {});
};

controlledframe 요소 target가 주어졌을 때 e인 ContentLoadEvent를 발화하려면, 다음 단계를 실행한다.

1. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface LoadInfo {
  readonly attribute USVString url;
  readonly attribute boolean isTopLevel;
};

[Exposed=Window, IsolatedContext]
interface LoadAbortInfo : LoadInfo{
  readonly attribute long code;
  readonly attribute DOMString reason;
};

[Exposed=Window, IsolatedContext]
interface LoadRedirectInfo{
  readonly attribute USVString oldUrl;
  readonly attribute USVString newUrl;
  readonly attribute boolean isTopLevel;
};

[Exposed=Window, IsolatedContext]
interface LoadAbortEvent : Event {
  constructor(DOMString type, optional LoadAbortEventInit eventInitDict = {});
  readonly attribute LoadAbortInfo loadAbortInfo;
};

dictionary LoadAbortEventInit: EventInit {
  LoadAbortInfo? loadAbortInfo;
};

LoadAbortEvent e를 발화하려면, 주어진 controlledframe 요소 target, USVString url, boolean isTopLevel, long code, 그리고 DOMString reason에 대해 다음 단계를 실행한다.

1. info를 다음 속성을 가진 새 LoadAbortInfo로 둔다.

   url

   url

   isTopLevel

   isTopLevel

   code

   code

   reason

   reason

2. e의 loadAbortInfo를 info로 설정한다.

3. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface LoadCommitEvent : Event {
  constructor(DOMString type, optional LoadCommitEventInit eventInitDict = {});
  readonly attribute LoadInfo loadInfo;
};

dictionary LoadCommitEventInit: EventInit {
  LoadInfo? loadInfo;
};

LoadCommitEvent e를 발화하려면, 주어진 controlledframe 요소 target, USVString url, 그리고 boolean isTopLevel에 대해 다음 단계를 실행한다.

1. info를 다음 속성을 가진 새 LoadInfo로 둔다.

   url

   url

   isTopLevel

   isTopLevel

2. e의 loadInfo를 info로 설정한다.

3. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface LoadStartEvent : Event {
  constructor(DOMString type, optional LoadStartEventInit eventInitDict = {});
  readonly attribute LoadInfo loadInfo;
};

dictionary LoadStartEventInit: EventInit {
  LoadInfo? loadInfo;
};

LoadStartEvent e를 발화하려면, 주어진 controlledframe 요소 target, USVString url, 그리고 boolean isTopLevel에 대해 다음 단계를 실행한다.

1. info를 다음 속성을 가진 새 LoadInfo로 둔다.

   url

   url

   isTopLevel

   isTopLevel

2. e의 loadInfo를 info로 설정한다.

3. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface LoadStopEvent : Event {
  constructor(DOMString type, optional LoadStopEventInit eventInitDict = {});
};

dictionary LoadStopEventInit: EventInit {
};

controlledframe 요소 target가 주어졌을 때 e인 LoadStopEvent를 발화하려면, 다음 단계를 실행한다.

1. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

[Exposed=Window, IsolatedContext]
interface LoadRedirectEvent : Event {
  constructor(DOMString type, optional LoadRedirectEventInit eventInitDict = {});
  readonly attribute LoadRedirectInfo loadRedirectInfo;
};

dictionary LoadRedirectEventInit: EventInit {
  LoadRedirectInfo? loadRedirectInfo;
};

controlledframe 요소 target, URL oldUrl, URL newUrl, 그리고 boolean isTopLevel이 주어졌을 때 e인 LoadRedirectEvent를 발화하려면, 다음 단계를 실행한다.

1. info를 다음 속성을 가진 새 LoadInfo로 둔다.

   oldUrl

   oldUrl이 주어졌을 때 URL을 직렬화한 결과

   newUrl

   newUrl이 주어졌을 때 URL을 직렬화한 결과

   isTopLevel

   isTopLevel

2. e의 loadRedirectInfo를 info로 설정한다.

3. target의 관련 전역 객체의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여, e를 target에 디스패치한다.

Document document가 DOMString permission, 선택적인 dictionary options, 그리고 boolean을 받는 알고리즘 completionSteps가 주어졌을 때 삽입자에 의해 permission을 사용하도록 허용되는지를 판단하려면, 다음 단계를 실행한다.

1. controlledFrameEmbedderParent를 document의 node navigable의 controlledFrameEmbedderParent로 둔다.

2. controlledFrameEmbedderParent가 HTMLControlledFrameElement가 아니면, true를 반환한다.

3. document, controlledFrameEmbedderParent, permission, document의 URL, options, 그리고 completionSteps와 함께 "permissionrequest" 이벤트를 발화한다.

environment environment가 주어졌을 때, network partition key를 결정하려면:

4. topLevelOrigin이 주어졌을 때 site를 얻은 결과를 topLevelSite로 둔다.

5. secondKey를 null 또는 구현 정의 값 로 둔다.

6. controlledFrameEmbedderParent를 environment가 주어졌을 때 environment의 controlledFrameEmbedderParent를 얻은 결과로 둔다.
7. controlledFrameEmbedderParent가 null이 아니면, secondKey를 controlledFrameEmbedderParent의 관련 설정 객체의 최상위 출처와 controlledFrameEmbedderParent의 partition으로 구성된 튜플로 설정한다.

8. (topLevelSite, secondKey)를 반환한다.

environment environment가 주어졌을 때 비-storage 목적을 위한 storage key를 얻으려면, 다음 단계를 실행한다.

1. environment가 environment settings object이면 environment의 origin을, 그렇지 않으면 environment의 creation URL의 origin을 origin으로 둔다.

2. origin으로 구성된 튜플을 반환한다.
3. topLevelOrigin과 partition을 null로 둔다.
4. controlledFrameEmbedderParent를 environment가 주어졌을 때 environment의 controlledFrameEmbedderParent를 얻은 결과로 둔다.
5. controlledFrameEmbedderParent가 null이 아니면:
   1. topLevelOrigin을 controlledFrameEmbedderParent의 관련 설정 객체의 최상위 출처로 설정한다.
   2. partition을 controlledFrameEmbedderParent의 partition으로 설정한다.
6. topLevelOrigin, partition, 그리고 origin으로 구성된 튜플을 반환한다.

environment environment가 주어졌을 때 environment의 controlledFrameEmbedderParent를 얻으려면, 다음 단계를 실행한다.

1. environment가 environment settings object이고, 그 전역 객체가 Window 객체이면:

   이 알고리즘은 Shared Worker나 Service Worker에 대해 작동하지 않는다. controlledFrameEmbedderParent는 navigable에만 정의되어 있고, 비-Window environment에서 navigable로 가는 것이 항상 가능하지는 않기 때문이다.

   1. navigable을 environment의 전역 객체의 navigable로 둔다.

   2. top을 navigable의 top-level traversable로 둔다.

   3. top의 controlledFrameEmbedderParent가 null이 아니면, top의 controlledFrameEmbedderParent를 반환한다.

2. null을 반환한다.

enum ResourceType {
  "main-frame",
  "sub-frame",
  "stylesheet",
  "script",
  "image",
  "font",
  "object",
  "xmlhttprequest",
  "ping",
  "csp-report",
  "media",
  "websocket",
  "other",
};

enum RequestedHeaders {
  "none",
  "cors",
  "all",
};

enum ConnectionState {
  "broken", "insecure", "secure"
};

dictionary Fingerprint {
  required DOMString sha256;
};

dictionary CertificateInfo {
  required Fingerprint fingerprint;
  Uint8Array rawDER;
};

dictionary SecurityInfo {
  required sequence<CertificateInfo> certificates;
  required ConnectionState state;
};

dictionary WebRequestInterceptorOptions {
  required sequence<(URLPattern or URLPatternInput)> urlPatterns;
  sequence<ResourceType> resourceTypes = [];
  boolean blocking = false;
  boolean includeRequestBody = false;
  RequestedHeaders includeHeaders = "none";
  boolean securityInfo = false;
  boolean securityInfoRawDer = false;
};

[Exposed=Window, IsolatedContext]
interface WebRequest {
  WebRequestInterceptor createWebRequestInterceptor(
      WebRequestInterceptorOptions options);
};

[Exposed=Window, IsolatedContext]
interface WebRequestInterceptor : EventTarget {
  attribute EventHandler onauthrequired;
  attribute EventHandler onbeforeredirect;
  attribute EventHandler onbeforerequest;
  attribute EventHandler onbeforesendheaders;
  attribute EventHandler oncompleted;
  attribute EventHandler onerroroccurred;
  attribute EventHandler onheadersreceived;
  attribute EventHandler onsendheaders;
  attribute EventHandler onresponsestarted;
};

enum DocumentLifecycle {
  "prerender",
  "active",
  "cached",
  "pending-deletion",
};

enum FrameType {
  "outermost-frame",
  "fenced-frame",
  "sub-frame",
};

[Exposed=Window, IsolatedContext]
interface UploadData {
  readonly attribute ArrayBuffer? bytes;
  readonly attribute DOMString? file;
};

[Exposed=Window, IsolatedContext]
interface RequestBody {
  readonly attribute DOMString? error;
  readonly attribute any formData;
  readonly attribute FrozenArray<UploadData>? raw;
};

[Exposed=Window, IsolatedContext]
interface WebRequestRequest {
  readonly attribute DOMString method;
  readonly attribute DOMString id;
  readonly attribute ResourceType type;
  readonly attribute USVString url;
  readonly attribute USVString? initiator;
  readonly attribute Headers? headers;
  readonly attribute RequestBody? body;
};

[Exposed=Window, IsolatedContext]
interface AuthChallenger {
  readonly attribute DOMString host;
  readonly attribute long port;
};

[Exposed=Window, IsolatedContext]
interface WebRequestAuthDetails {
  readonly attribute AuthChallenger challenger;
  readonly attribute boolean isProxy;
  readonly attribute DOMString scheme;
  readonly attribute DOMString? realm;
};

[Exposed=Window, IsolatedContext]
interface WebRequestResponse {
  readonly attribute long statusCode;
  readonly attribute DOMString statusLine;
  readonly attribute boolean fromCache;
  readonly attribute Headers? headers;
  readonly attribute DOMString? ip;
  readonly attribute USVString? redirectURL;
  readonly attribute WebRequestAuthDetails? auth;
};

[Exposed=Window, IsolatedContext]
interface WebRequestEvent : Event {
  readonly attribute WebRequestRequest request;
  readonly attribute long frameId;
  readonly attribute FrameType? frameType;
  readonly attribute DOMString? documentId;
  readonly attribute DocumentLifecycle? documentLifecycle;
  readonly attribute DOMString? parentDocumentId;
  readonly attribute long? parentFrameId;
};

dictionary WebRequestAuthCredentials {
  required DOMString username;
  required DOMString password;
};

dictionary WebRequestAuthOptions {
  AbortSignal signal;
};

[Exposed=Window, IsolatedContext]
interface WebRequestAuthRequiredEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;

  undefined setCredentials(
    Promise<WebRequestAuthCredentials> credentials,
    optional WebRequestAuthOptions options = {});
};

[Exposed=Window, IsolatedContext]
interface WebRequestBeforeRedirectEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
};

[Exposed=Window, IsolatedContext]
interface WebRequestBeforeRequestEvent : WebRequestEvent {
  undefined redirect(USVString redirectURL);
};

[Exposed=Window, IsolatedContext]
interface WebRequestBeforeSendHeadersEvent : WebRequestEvent {
  undefined setRequestHeaders((Headers or HeadersInit) requestHeaders);
};

[Exposed=Window, IsolatedContext]
interface WebRequestCompletedEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
};

[Exposed=Window, IsolatedContext]
interface WebRequestErrorOccurredEvent : WebRequestEvent {
  readonly attribute DOMString error;
};

[Exposed=Window, IsolatedContext]
interface WebRequestHeadersReceivedEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
  readonly attribute SecurityInfo? securityInfo;

  undefined redirect(USVString redirectURL);
  undefined setResponseHeaders((Headers or HeadersInit) responseHeaders);
};

[Exposed=Window, IsolatedContext]
interface WebRequestResponseStartedEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
};

[Exposed=Window, IsolatedContext]
interface WebRequestSendHeadersEvent : WebRequestEvent {};

createWebRequestInterceptor(options) 메서드 단계는 다음과 같다.

1. interceptor를 새 WebRequestInterceptor 객체로 둔다.

2. interceptor에 다음 필드를 설정한다.

   resourceTypes

   options["resourceTypes"]

   blocking

   options["blocking"]

   includeRequestBody

   options["includeRequestBody"]

   includeHeaders

   options["includeHeaders"]

   securityInfo

   options["securityInfo"]

   securityInfoRawDer

   options["securityInfoRawDer"]

3. options["urlPatterns"] 안의 각 urlPattern에 대해 반복한다.

   1. urlPattern이 URLPattern이면, urlPattern을 interceptor의 urlPatterns에 append한다.

   2. 그렇지 않으면, urlPattern가 주어졌을 때 새 URLPattern을 interceptor의 urlPatterns에 append한다.

4. interceptor를 this의 interceptors에 append한다.

5. interceptor를 반환한다.

request request에 대한 적용 가능한 WebRequestInterceptor들을 얻으려면, 다음 단계를 실행한다.

1. client를 request의 client로 둔다.

2. client가 null이면, 빈 list와 false를 반환한다.

3. window를 client가 주어졌을 때 environment settings object의 소유 Window로 둔다.

4. window가 null이면, 빈 list와 false를 반환한다.

5. navigable를 window의 navigable로 둔다.

6. navigable 또는 그 controlledFrameEmbedderParent가 null이면, 빈 list와 false를 반환한다.

7. controlledFrame를 navigable의 controlledFrameEmbedderParent로 둔다.

8. applicableInterceptors를 빈 list로 둔다.

9. controlledFrame의 request의 interceptors 안의 각 interceptor에 대해:

   1. request가 interceptor에 의해 intercepted되어서는 안 되면, continue한다.

   2. interceptor를 applicableInterceptors에 append한다.

10. applicableInterceptors를 반환한다.

request request가 WebRequestInterceptor에 의해 intercepted되어야 하는지 판단하려면, 다음 단계를 실행한다.

1. types를 interceptor의 resourceTypes로 둔다.

2. types가 비어 있지 않고 request가 주어졌을 때 request의 ResourceType을 얻은 결과를 types가 contain하지 않으면, false를 반환한다.

3. urlPatterns를 interceptor의 urlPatterns로 둔다.

4. urlPatterns 안의 각 urlPattern에 대해:

   1. request의 URL이 urlPattern가 주어졌을 때 URLPattern과 일치하면, true를 반환한다.

5. false를 반환한다.

environment settings object environment가 주어졌을 때, environment settings object의 소유 Window를 얻으려면, 다음 단계를 실행한다.

1. global를 environment의 전역 객체로 둔다.

2. global이 Window 객체이면, global를 반환한다.

3. global이 DedicatedWorkerGlobalScope 객체이면, 다음을 실행한다.

   1. owner를 global로 둔다.

   2. owner가 DedicatedWorkerGlobalScope 객체인 동안:

      1. owner를 owner의 owner set[0]로 둔다.

   3. owner가 Document 객체이면, owner의 관련 전역 객체를 반환한다.

4. null을 반환한다.

WebRequestAuthRequiredEvent의 setCredentials(credentials, options) 메서드 단계는 다음과 같다.

1. this의 authCredentials를 credentials로 설정한다.

2. this의 options를 options로 설정한다.

WebRequestAuthRequiredEvent의 preventDefault() 메서드 단계는 this의 cancel을 true로 설정하는 것이다.

WebRequestBeforeRequestEvent의 redirect(redirectURL) 메서드 단계는 this의 redirectURL을 redirectURL로 설정하는 것이다.

WebRequestBeforeRequestEvent의 preventDefault() 메서드 단계는 this의 cancel을 true로 설정하는 것이다.

WebRequestBeforeSendHeadersEvent의 setRequestHeaders(requestHeaders) 메서드 단계는 this의 requestHeaders를 requestHeaders로 설정하는 것이다.

WebRequestBeforeSendHeadersEvent의 preventDefault() 메서드 단계는 this의 cancel을 true로 설정하는 것이다.

WebRequestHeadersReceivedEvent의 redirect(redirectURL) 메서드 단계는 this의 redirectURL을 redirectURL로 설정하는 것이다.

WebRequestHeadersReceivedEvent의 setResponseHeaders(responseHeaders) 메서드 단계는 this의 responseHeaders를 responseHeaders로 설정하는 것이다.

WebRequestHeadersReceivedEvent의 preventDefault() 메서드 단계는 this의 cancel을 true로 설정하는 것이다.

request request가 주어졌을 때 beforeRequest 이벤트를 처리하려면, 다음 단계를 실행한다.

1. interceptors를 request의 적용 가능한 WebRequestInterceptors를 얻은 결과로 둔다.

2. result를 WebRequestEvent result로 둔다.

3. pendingHandlerCount를 0으로 둔다.

4. controlledFrameEmbedderGlobal를 request의 client가 주어졌을 때 environment의 controlledFrameEmbedderParent를 얻은 결과의 관련 전역 객체로 둔다.

5. controlledFrameEmbedderGlobal가 null이면 반환한다.

6. interceptors 안의 각 interceptor에 대해:

   1. interceptor의 blocking이 true이면, pendingHandlerCount를 증가시킨다.

   2. controlledFrameEmbedderGlobal의 DOM 조작 태스크 소스에 전역 태스크를 큐에 추가하여 다음 단계를 실행한다.

      1. event를 이름이 beforerequest인 새 WebRequestBeforeRequestEvent로 둔다.

      2. event, request, 그리고 "none"이 주어졌을 때 WebRequestEvent를 채운다.

      3. interceptor의 includeRequestBody가 true이고 request의 body가 null이 아니면:

         1. requestBody를 새 RequestBody로 둔다.

         2. body를 request의 body로 둔다.

            TODO: 존재하는 경우 body의 stream을 직렬화한다.

         3. body의 source에 대해 switch한다.

            byte sequence

            직렬화된 body의 source와 같은 bytes를 가진 새 UploadData를 requestBody의 raw에 append한다.

            Blob

            직렬화된 body의 source와 같은 bytes를 가진 새 UploadData를 requestBody의 raw에 append한다.

            FormData

            1. formData를 «[]»로 둔다.

            2. body의 source의 entry list 안의 각 entry에 대해 반복한다.

               1. entry[1]에 대해 switch한다.

               File

               entry[1]의 name과 같은 file을 가진 새 UploadData를 requestBody의 raw에 append한다.

               USVString

               1. formData[entry[0]]이 존재하지 않으면, formData[entry[0]]을 빈 list와 같도록 설정한다.

               2. entry[1]을 formData[entry[0]]에 append한다.

            3. requestBody의 formData를 formData로 설정한다.

         4. event의 request의 body를 requestBody로 설정한다.

      4. event를 interceptor에 dispatch한다.

      5. event의 cancel이 true이면, result의 cancel을 true로 설정한다.

      6. event의 redirectURL이 null이 아니고 result의 redirectURL이 ""이면, result의 redirectURL을 event의 redirectURL로 설정한다.

      7. interceptor의 blocking이 true이면, pendingHandlerCount를 감소시킨다.

7. pendingHandlerCount > 0이면, pendingHandlerCount가 0과 같아질 때까지 병렬로 기다린 다음, 이 단계들이 병렬로 가기 전에 어떻게 실행되었는지에 따라 request의 client의 전역 객체의 네트워킹 태스크 소스 또는 이 단계들이 처음 호출된 병렬 컨텍스트 중 하나에서 이 알고리즘의 나머지 단계를 계속할 전역 태스크를 큐에 추가한다.

8. result를 반환한다.