ロングタスク 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. 各 descendantBC（descendantBCs の要素）について、以下を実行する。document をその descendantBC の アクティブドキュメント とする。

   4. 各反復で、(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バージョンでは TaskAttributionTiming オブジェクトの 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 を唯一要素とする新たな frozen 配列を設定する。

         注記: 今後のAPIバージョンでは attribution 属性の値が追加される予定だが、現時点では配列は1要素のみ。

   6. PerformanceEntryをキューに追加 newEntry を行う。