롱 태스크 API

const observer = new PerformanceObserver(function(list) {
    for (const entry of list.getEntries()) {
        // 롱 태스크 알림 처리:
        // 분석 및 모니터링을 위해 리포트
        // ...
    }
});
// 이전 및 이후 롱 태스크 알림에 대해 옵저버 등록.
observer.observe({type: "longtask", buffered: true});
// 이 이후 긴 스크립트 실행은 큐잉 및
// 옵저버에서 "longtask" 엔트리 수신을 초래합니다.

[Exposed=Window]
interface PerformanceLongTaskTiming : PerformanceEntry {
    /* Overloading PerformanceEntry */
    readonly attribute DOMHighResTimeStamp startTime;
    readonly attribute DOMHighResTimeStamp duration;
    readonly attribute DOMString name;
    readonly attribute DOMString entryType;

    readonly attribute FrozenArray<TaskAttributionTiming> attribution;
    [Default] object toJSON();
};

[Exposed=Window]
interface TaskAttributionTiming : PerformanceEntry {
    /* Overloading PerformanceEntry */
    readonly attribute DOMHighResTimeStamp startTime;
    readonly attribute DOMHighResTimeStamp duration;
    readonly attribute DOMString name;
    readonly attribute DOMString entryType;

    readonly attribute DOMString containerType;
    readonly attribute DOMString containerSrc;
    readonly attribute DOMString containerId;
    readonly attribute DOMString containerName;
    [Default] object toJSON();
};

start time, end time, top-level browsing contexts, task가 주어지면 다음 알고리즘을 수행합니다:

1. 작업 종료 시간 기록을 end time과 task의 document로 수행합니다.

2. end time에서 start time을 뺀 값이 롱 태스크 임계값 50ms 미만이면 이 단계들을 중단합니다.

3. destinationRealms를 빈 집합으로 둡니다.

4. 보고가 전달될 JavaScript Realm의 집합을 결정합니다:

   각 최상위 브라우징 컨텍스트 topmostBC에 대해 top-level browsing contexts에서:

   1. topmostBC의 활성 문서의 관련 Realm을 destinationRealms에 추가합니다.

   2. descendantBCs를 topmostBC의 활성 문서의 하위 브라우징 컨텍스트 목록으로 둡니다.

   3. document를 descendantBC의 활성 문서로 둡니다.

   4. 각 descendantBC에 대해 descendantBCs에서, (document의 관련 Realm, document의 관련 설정 객체의 cross-origin 격리 기능)을 destinationRealms에 추가합니다.

5. 사용자 에이전트는 JavaScript Realm 일부를 destinationRealms에서 제거할 수 있습니다.

참고: 이러한 제거는 사용자 에이전트가 별도의 프로세스에서 처리하는 JavaScript Realm에 대해 롱 태스크 보고를 피하기 위해 사용될 수 있습니다. 하지만 이 개념은 정확하게 명세되어 있지 않습니다.

어떤 문서 가 어떤 롱 태스크에 대한 가시성을 갖는지에 대한 범위에 대해 지속적인 논의가 있으므로 이 논리가 앞으로 바뀔 수 있습니다. [Issue #75]

1. 각 (destinationRealm, crossOriginIsolatedCapability)에 대해 destinationRealms에서:

   1. name을 빈 문자열로 둡니다. 이는 아래에서 최소 문제 지목 보고에 사용됩니다.

   2. culpritSettings를 null로 둡니다.

   3. task의 스크립트 평가 환경 설정 객체 집합을 처리하여 name과 culpritSettings를 다음과 같이 결정합니다:

      1. 만약 task의 스크립트 평가 환경 설정 객체 집합이 비어 있다면: name을 "unknown"으로, culpritSettings를 null로 설정합니다.

      2. 그렇지 않고 task의 스크립트 평가 환경 설정 객체 집합 길이가 1보다 크면: name을 "multiple-contexts"로, culpritSettings를 null로 설정합니다.

      3. 그렇지 않고 task의 스크립트 평가 환경 설정 객체 집합 길이가 1이면:

         1. culpritSettings를 task의 스크립트 평가 환경 설정 객체 집합의 단일 항목으로 설정합니다.

         2. destinationSettings를 destinationRealm의 관련 설정 객체로 둡니다.

         3. destinationOrigin을 destinationSettings의 origin으로 둡니다.

         4. destinationBC를 destinationSettings의 global object의 브라우징 컨텍스트로 둡니다.

         5. culpritBC를 culpritSettings의 global object의 브라우징 컨텍스트로 둡니다.

         6. Assert: culpritBC는 null이 아님.

         7. 만약 culpritSettings가 destinationSettings와 동일하다면, name을 "self"로 설정합니다.

         8. 그렇지 않고 culpritSettings의 origin과 destinationOrigin이 동일 출처라면:

            1. destinationBC가 null이면, name을 "same-origin"로 설정합니다.

            2. 그렇지 않고 culpritBC가 상위 브라우징 컨텍스트라면 destinationBC에 대해, name을 "same-origin-ancestor"로 설정합니다.

            3. 그렇지 않고 destinationBC가 상위 브라우징 컨텍스트라면 culpritBC에 대해, name을 "same-origin-descendant"로 설정합니다.

            4. 그 밖의 경우, name을 "same-origin"로 설정합니다.

         9. 그 밖의 경우:

            1. destinationBC가 null이면, name을 "cross-origin-unreachable"로 설정합니다.

            2. 그렇지 않고 culpritBC가 상위 브라우징 컨텍스트라면 destinationBC에 대해, name을 "cross-origin-ancestor" 로 설정하고 culpritSettings를 null로 설정합니다.

               참고: 이는 보안을 위해 보고되지 않습니다. 개발자는 직접 확인해야 합니다.

            3. 그렇지 않고 destinationBC가 상위 브라우징 컨텍스트라면 culpritBC에 대해, name을 "cross-origin-descendant"로 설정합니다.

            4. 그 밖의 경우, name을 "cross-origin-unreachable"로 설정합니다.

   4. attribution을 destinationRealm으로 새 TaskAttributionTiming 객체로 생성하고, 다음과 같이 속성을 설정합니다:

      1. attribution의 name 속성을 "unknown"으로 설정합니다.

         참고: 향후 API 버전에서는 name 속성에 더 많은 값을 추가할 예정이지만, 현재는 단일 값만 지원합니다.

      2. attribution의 entryType 속성을 "taskattribution"으로 설정합니다.

      3. attribution의 startTime 및 duration 을 0으로 설정합니다.

      4. attribution의 containerType 속성을 "window"로 설정합니다.

      5. attribution의 containerName 및 containerSrc 속성을 빈 문자열로 설정합니다.

      6. culpritSettings가 null이 아니라면:

         1. culpritBC를 culpritSettings의 global object의 브라우징 컨텍스트로 둡니다.

         2. Assert: culpritBC는 null이 아님.

         3. container를 culpritBC의 브라우징 컨텍스트 컨테이너로 둡니다.

         4. Assert: container는 null이 아님.

         5. attribution의 containerId 속성을 container의 ID 값 또는 ID가 없으면 빈 문자열로 설정합니다.

         6. container가 iframe 요소라면:

            1. attribution의 containerType 속성을 "iframe"으로 설정합니다.

            2. attribution의 containerName 속성을 container의 name 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

            3. attribution의 containerSrc 속성을 container의 src 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

            참고: 프레임의 src 속성을 현재 URL 대신 기록하는 것은 일부러입니다. 이는 프레임 식별에 도움이 되며, 교차 출처 iframe의 현재 URL을 알 수 있게 하는 것은 보안상 문제가 있기 때문입니다.

         7. container가 frame 요소라면:

            1. attribution의 containerType 속성을 "frame"으로 설정합니다.

            2. attribution의 containerName 속성을 container의 name 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

            3. attribution의 containerSrc 속성을 container의 src 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

         8. container가 object 요소라면:

            1. attribution의 containerType 속성을 "object"로 설정합니다.

            2. attribution의 containerName 속성을 container의 name 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

            3. attribution의 containerSrc 속성을 container의 data 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

         9. container가 embed 요소라면:

            1. attribution의 containerType 속성을 "embed"로 설정합니다.

            2. attribution의 containerName 속성을 빈 문자열로 설정합니다.

            3. attribution의 containerSrc 속성을 container의 src 콘텐츠 속성 값 또는 없으면 빈 문자열로 설정합니다.

   5. newEntry라는 PerformanceLongTaskTiming 객체를 destinationRealm으로 새로 생성하고, 다음과 같이 속성을 설정합니다:

      1. newEntry의 name 속성을 name으로 설정합니다.

      2. newEntry의 entryType 속성을 "longtask"로 설정합니다.

      3. newEntry의 startTime 속성을 coarsening start time의 결과로, crossOriginIsolatedCapability를 기준으로 설정합니다.

      4. dur를 coarsening end time의 결과로, crossOriginIsolatedCapability를 기준으로 계산한 값에서 newEntry의 startTime을 뺀 값을 둡니다.

      5. newEntry의 duration 속성을 dur의 정수 부분으로 설정합니다.

      6. attribution이 null이 아니면, newEntry의 attribution 속성을 attribution 단일 값을 담은 새 고정 배열로 설정합니다.

         참고: 향후 API 버전에서는 attribution 속성에 더 많은 값을 추가할 예정이지만, 현재는 단일 값만 포함됩니다.

   6. PerformanceEntry를 큐에 추가 합니다: newEntry.