ロングタスク 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 の 関連設定オブジェクト の クロスオリジン分離機能) を destinationRealms に加える。

5. ユーザーエージェントは、JavaScript Realm の一部を destinationRealms から除外できる。

注: この除外は、ユーザーエージェントが別プロセスで扱う JavaScript Realm のロングタスク報告を回避するために利用される可能性がある。しかしこの概念は厳密には規定されていない。

どの Document がどのロングタスクに可視性を持つかについて、議論が続いているため、このロジックは将来的に変更される可能性がある。 [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 の オリジン に設定する。

         4. destinationBC を destinationSettings の グローバルオブジェクト の ブラウジングコンテキスト に設定する。

         5. culpritBC を culpritSettings の グローバルオブジェクト の ブラウジングコンテキスト に設定する。

         6. Assert: culpritBC は null ではない。

         7. culpritSettings が destinationSettings と同じなら、name を "self" に設定する。

         8. そうでなく、culpritSettings の オリジン と 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のバージョンでは name 属性に追加値が加わる予定だが、現時点では値は1つのみ。

      2. attribution の entryType 属性を "taskattribution" に設定する。

      3. attribution の startTime および duration を 0 に設定する。

      4. attribution の containerType 属性を "window" に設定する。

      5. attribution の containerName および containerSrc 属性を空文字列に設定する。

      6. culpritSettings が null でない場合：

         1. culpritBC を culpritSettings の グローバルオブジェクト の ブラウジングコンテキスト に設定する。

         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 コンテンツ属性の値に（属性がなければ空文字列）。

            注: ここで記録するのは frame の 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. 新しい PerformanceLongTaskTiming オブジェクト newEntry を 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 1つのみを含む新しい凍結配列に設定する。

         注: 今後このAPIのバージョンでは attribution 属性に追加値が加わる予定だが、現時点では値は1つのみ。

   6. PerformanceEntry をキュー する（newEntry）。