长任务 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 {
    /* 重载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 {
            /* 重载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 集合：

   对于 top-level browsing contexts 中的每个 顶级浏览上下文 topmostBC：

   1. 将 topmostBC 的 活动文档的 相关 Realm 添加到 destinationRealms。

   2. 令 descendantBCs 为 topmostBC 的 活动文档的 后代浏览上下文列表。

   3. 令 document 为 descendantBC 的 活动文档。

   4. 对于 descendantBCs 中的每个 descendantBC，将（document 的 相关 Realm，document 的 相关设置对象的 跨域隔离能力）添加到 destinationRealms。

5. 用户代理可以从 destinationRealms 中移除一些 JavaScript Realm。

注：这种移除可用于避免为用户代理在单独进程中处理的 JavaScript Realm 报告长任务。但该概念未被精确定义。

关于哪些 文档 能看到哪些长任务的范围仍在讨论中，因此该逻辑未来可能会变化。[Issue #75]

1. 对于 destinationRealms 中的每个 (destinationRealm, crossOriginIsolatedCapability)：

   1. 令 name 为空字符串。该值用于下方报告 最小罪魁归因。

   2. 令 culpritSettings 为 null。

   3. 处理 task 的 脚本执行环境设置对象集，以如下方式确定 name 和 culpritSettings：

      1. 如果 task 的 脚本执行环境设置对象集为空：将 name 设为 "unknown"，culpritSettings 设为 null。

      2. 否则，如果 task 的 脚本执行环境设置对象集长度大于1：将 name 设为 "multiple-contexts"，culpritSettings 设为 null。

      3. 否则（即长度为1）：

         1. 将 culpritSettings 设为 task 的 脚本执行环境设置对象集中的唯一项。

         2. 令 destinationSettings 为 destinationRealm 的 相关设置对象。

         3. 令 destinationOrigin 为 destinationSettings 的 origin。

         4. 令 destinationBC 为 destinationSettings 的 全局对象的 浏览上下文。

         5. 令 culpritBC 为 culpritSettings 的 全局对象的 浏览上下文。

         6. 断言：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 为一个新的 TaskAttributionTiming 对象，使用 destinationRealm 并按如下设置其属性：

      1. 将 attribution 的 name 属性设为 "unknown"。

         注：未来 API 版本会为 TaskAttributionTiming 对象的 name 属性增加更多值，目前仅有一个值。

      2. 将 attribution 的 entryType 属性设为 "taskattribution"。

      3. 将 attribution 的 startTime 和 duration 设为 0。

      4. 将 attribution 的 containerType 属性设为 "window"。

      5. 将 attribution 的 containerName 和 containerSrc 属性设为空字符串。

      6. 如果 culpritSettings 不为 null：

         1. 令 culpritBC 为 culpritSettings 的 全局对象的 浏览上下文。

         2. 断言：culpritBC 不为 null。

         3. 令 container 为 culpritBC 的 浏览上下文容器。

         4. 断言：container 不为 null。

         5. 将 attribution 的 containerId 属性设为 container 的 ID 的值，若未设置则为空字符串。

         6. 如果 container 是 iframe 元素：

            1. 将 attribution 的 containerType 属性设为 "iframe"。

            2. 将 attribution 的 containerName 属性设为 container 的 name 内容属性的值，若无则为空字符串。

            3. 将 attribution 的 containerSrc 属性设为 container 的 src 内容属性的值，若无则为空字符串。

            注：此处记录的是 frame 的 src 属性，而不是其当前 URL，主要用于识别 frame，允许发现跨域 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. 创建一个新的 PerformanceLongTaskTiming 对象 newEntry，使用 destinationRealm 并按如下设置其属性：

      1. 将 newEntry 的 name 属性设为 name。

      2. 将 newEntry 的 entryType 属性设为 "longtask"。

      3. 将 newEntry 的 startTime 属性设为 粗化 start time 的结果，参数为 crossOriginIsolatedCapability。

      4. 令 dur 为 粗化 end time 的结果（参数同上），减去 newEntry 的 startTime。

      5. 将 newEntry 的 duration 属性设为 dur 的整数部分。

      6. 如果 attribution 不为 null，则将 newEntry 的 attribution 属性设为包含单个值 attribution 的新冻结数组。

         注：未来 API 版本会为 attribution 属性增加更多值，目前仅包含一个值。

   6. 将 PerformanceEntry newEntry 入队。