処理能 時列線 — Performance Timeline Level 2

`getEntries()@m ~method~手続きは ⇒ ~RET `~buffer~mapを名前と型で絞込む$( コレ, ~NULL, ~NULL )

`getEntriesByType(type)@m ~method~手続きは ⇒ ~RET `~buffer~mapを名前と型で絞込む$( コレ, ~NULL, %type )

`getEntriesByName(name, type)@m ~method~手続きは：

1. ~IF［ %type ~EQ ε ］ ⇒ %type ~SET ~NULL
2. ~RET `~buffer~mapを名前と型で絞込む$( コレ, %name, %type )

`observe(options)@m ~method~手続きは： ◎ must run these steps: • Let observer be the context object. • Let relevantGlobal be observer's relevant global object.

1. %型たち ~LET %options[ "`entryTypes$d" ] ◎ ↓
2. %型 ~LET %options[ "`type$d" ] ◎ ↓
3. ~IF［ %型たち ~EQ ε ］~AND［ %型 ~EQ ε ］ ⇒ ~THROW `TypeError$E ◎ If options's entryTypes and type members are both omitted, then throw a TypeError.
4. ~IF［ %型たち ~NEQ ε ］~AND［ %options に `entryTypes$d 以外の~memberは在る ］ ⇒ ~THROW `TypeError$E ◎ If options's entryTypes is present and any other member is also present, then throw a TypeError.

5. コレの`種別$pOに応じて： ◎ Update or check observer's observer type by running these steps:

   `未定義^i ◎ If observer's observer type is "undefined":

   コレの`種別$pO ~SET ［ %型たち ~NEQ ε ならば `複数個^i ／ ~ELSE_ `一個^i ］ ◎ If options's entryTypes member is present, then set observer's observer type to "multiple". ◎ If options's type member is present, then set observer's observer type to "single".

   `一個^i

   ~IF［ %型たち ~NEQ ε ］ ⇒ ~THROW `InvalidModificationError$E ◎ If observer's observer type is "single" and options's entryTypes member is present, then throw an InvalidModificationError.

   `複数個^i

   ~IF［ %型 ~NEQ ε ］ ⇒ ~THROW `InvalidModificationError$E ◎ If observer's observer type is "multiple" and options's type member is present, then throw an InvalidModificationError.

6. %大域~obj ~LET コレに`関連な大域~obj$ ◎ ↑↑
7. %観測器~list ~LET %大域~obj の`処理能~観測器~list$ ◎ ↓
8. %~supportする~entry型たち ~LET %大域~obj が`~supportする~entry型たち$ ◎ ↓

9. ~IF［ コレの`種別$pO ~EQ `複数個^i ］： ◎ If observer's observer type is "multiple", run the following steps: • Let entry types be options's entryTypes sequence.

   1. %型たち から［ %~supportする~entry型たち に含まれない`~entry型$ ］をすべて除去する ⇒ ~UAは、除去された型があれば，開発者に通知するベキである — 例えば、~console警告にそれらを挙げるのが適切になるであろう。 ◎ Remove all types from entry types that are not contained in relevantGlobal's frozen array of supported entry types. The user agent SHOULD notify developers if entry types is modified. For example, a console warning listing removed types might be appropriate.
   2. ~IF［ %型たち は空である ］ ⇒ ~RET ⇒ ~UAは、登録は中止されたことを開発者に通知するベキである — 例えば，~console警告が適切になるであろう。 ◎ If the resulting entry types sequence is an empty sequence, abort these steps. The user agent SHOULD notify developers when the steps are aborted to notify that registration has been aborted. For example, a console warning might be appropriate.
   3. ~IF［ コレ ~NIN %観測器~list ］ ⇒ コレを %観測器~list に付加する ◎ ↓
   4. コレの`~options~list$pO ~SET %options のみからなる~list ◎ If the list of registered performance observer objects of relevantGlobal contains a registered performance observer whose observer is the context object, replace its options list with a list containing options as its only item. ◎ Otherwise, create and append a registered performance observer object to the list of registered performance observer objects of relevantGlobal, with observer set to the context object and options list set to a list containing options as its only item.

10. ~ELSE（ コレの`種別$pO ~EQ `一個^i ）： ◎ Otherwise, run the following steps: • Assert that observer's observer type is "single".

    1. ~IF［ %型 ~NIN %~supportする~entry型たち ］ ⇒ ~RET ⇒ ~UAは、これが起きたことを開発者に通知するベキである — 例えば，~console警告を介して。 ◎ If options's type is not contained in the relevantGlobal's frozen array of supported entry types, abort these steps. The user agent SHOULD notify developers when this happens, for instance via a console warning.

    2. ~IF［ コレ ~IN %観測器~list ］： ◎ If the list of registered performance observer objects of relevantGlobal contains a registered performance observer obs whose observer is the context object:

       1. ~IF［ コレの`~options~list$pO内の ある~itemの `type$d ~EQ %型 ］ ⇒ コレの`~options~list$pO内の その~itemを %options に置換する ◎ If obs's options list contains a PerformanceObserverInit item currentOptions whose type is equal to options's type, replace currentOptions with options in obs's options list.
       2. ~ELSE ⇒ %options をコレの`~options~list$pOに付加する ◎ Otherwise, append options to obs's options list.
    3. ~ELSE ⇒＃ コレを %観測器~list に付加する； コレの`~options~list$pO ~SET %options のみからなる~list ◎ Otherwise, create and append a registered performance observer object to the list of registered performance observer objects of relevantGlobal, with observer set to the context object and options list set to a list containing options as its only item.

    4. ~IF［ %options の `buffered$d ~EQ ~T ］： ◎ If options's buffered flag is set:

       1. %~tuple ~LET `処理能~entry~tupleを得る$( %型, %大域~obj ) ◎ Let tuple be the relevant performance entry tuple of options's type and relevantGlobal.
       2. %~tuple の`処理能~entry~buffer$を成す ~EACH( %~entry ) に対し ⇒ ~IF［ `~entryを追加するべきか？$( %~entry, %options ) ~EQ ~T ］ ⇒ コレの`~buffer$pOに %~entry を`付加する$ ◎ For each entry in tuple's performance entry buffer: • If should add entry with entry and options as parameters returns true, append entry to the observer buffer.
       3. `処理能~観測器~taskを~queueする$( %大域~obj ) ◎ Queue the PerformanceObserver task with relevantGlobal as input.

`takeRecords()@m ~method~手続きは：

1. %複製 ~LET コレの`~buffer$pOの複製
2. コレの`~buffer$pOを空にする
3. ~RET %複製

`disconnect()@m ~method~手続きは： ◎ The disconnect() method must do the following:

1. コレに`関連な大域~obj$の`処理能~観測器~list$から，コレを除去する ◎ Remove the context object from the list of registered performance observer objects of relevant global object.
2. コレの`~buffer$pOを空にする ◎ Empty the context object's observer buffer.
3. コレの`~options~list$pO ~SET ε【！空にする】 ◎ Empty the context object's options list.

`処理能~entryを~queueする@ ときは、所与の ( `PerformanceEntry$I ~obj %新たな~entry ) に対し，次を走らす： ◎ To queue a PerformanceEntry (newEntry), run these steps:

1. %~entry型 ~LET %新たな~entry の `entryType$m 値 ◎ ↓
2. %大域~obj ~LET %新たな~entry に`関連な大域~obj$ ◎ ↓
3. %大域~obj の`処理能~観測器~list$を成す ~EACH( `処理能~観測器$ %観測器 ) に対し ⇒ ~IF［ %観測器 の`~options~list$pO内に ある `PerformanceObserverInit$I ~options %~options が在って，［ %~entry型 ~IN %~options の `entryTypes$d ］~OR［ %~entry型 ~EQ %~options の `type$d ］を満たす【該当する %~options は在っても 1 個に限られる（ `observe()$m を見よ）】 ］ ⇒ ~IF［ `~entryを追加するべきか？$( %新たな~entry, %~options ) ~EQ ~T ］ ⇒ %観測器 の`~buffer$pOに %新たな~entry を付加する ◎ Let interested observers be an initially empty set of PerformanceObserver objects. ◎ Let entryType be newEntry’s entryType value. ◎ For each registered performance observer (regObs): • If regObs's options list contains a PerformanceObserverInit options whose entryTypes member includes entryType or whose type member equals to entryType: •• If should add entry with newEntry and options returns true, append regObs's observer to interested observers. ◎ For each observer in interested observers: • Append newEntry to observer's observer buffer.
4. %~tuple ~LET `処理能~entry~tupleを得る$( %~entry型, %大域~obj ) ◎ Let relevantGlobal be newEntry's relevant global object. ◎ Let tuple be the relevant performance entry tuple of entryType and relevantGlobal.
5. ~IF［ %~tuple は`処理能~entryを追加するに適格$である ］ ⇒ %~tuple の`処理能~entry~buffer$に %新たな~entry を`付加する$ ◎ Call the determine eligibility for adding a performance entry algorithm with tuple as input. If it returns true, append newEntry to tuple's performance entry buffer.
6. `処理能~観測器~taskを~queueする$( %大域~obj ) ◎ Queue the PerformanceObserver task with relevantGlobal as input.

`処理能~観測器~taskを~queueする@ ときは、所与の ( %大域~obj ) に対し，次を走らす： ◎ When asked to queue the PerformanceObserver task, given relevantGlobal as input, run the following steps:

1. ~IF［ %大域~obj の`処理能~観測器~task~queue済み~flag$ ~EQ ~T ］ ⇒ ~RET ◎ If relevantGlobal's performance observer task queued flag is set, terminate these steps.
2. %大域~obj の`処理能~観測器~task~queue済み~flag$ ~SET ~T ◎ Set relevantGlobal's performance observer task queued flag.

3. `処理能~時列線~task源@ から，次の下位手続きを走らす`~taskを~queueする$： ◎ Queue a task that consists of running the following substeps. The task source for the queued task is the performance timeline task source.

   1. %大域~obj の`処理能~観測器~task~queue済み~flag$ ~SET ~F ◎ Unset performance observer task queued flag of relevantGlobal.
   2. %通知-~list ~LET %大域~obj の`処理能~観測器~list$を`~cloneする$ 【~cloneするのは、後~段で~callされる~callbackによる~~影響を避けるため】 ◎ Let notifyList be a copy of relevantGlobal's list of registered performance observer objects.

   3. %通知-~list を成す ~EACH( `処理能~観測器$ %観測器 ) に対し： ◎ For each PerformanceObserver object po in notifyList, run these steps:

      1. ~IF［ %観測器 の`~buffer$pOは空である ］ ⇒ ~CONTINUE ◎ ↓
      2. %~entryたち ~LET %観測器 の`~buffer$pOの複製 ◎ Let entries be a copy of po’s observer buffer. ◎ If entries is empty, return.
      3. %観測器 の`~buffer$pOを空にする ◎ Empty po’s observer buffer.
      4. %観測器~entry~list ~LET 次のようにされた新たな `PerformanceObserverEntryList$I ⇒ `~entry~list$ ~SET %~entryたち ◎ Let observerEntryList be a new PerformanceObserverEntryList, with its entry list set to entries.

      5. 次を渡して %観測器 の`~callback$pOを~callする ⇒＃ 引数~list « %観測器~entry~list, %観測器 », `~callback this 値$ %観測器

         この段にて例外が`投出-$された場合、その`例外を報告する$。

         ◎ Call po’s callback with observerEntryList as the first argument and with po as the second argument and as callback this value. If this throws an exception, report the exception.

   `処理能~時列線~task源$用の`~task~queue$は、低優先度な~queueである — ~UAは、処理能~監視~codeの影響iを最小限にするため，アリなら遊休中に処理するべきである。 ◎ The performance timeline task queue is a low priority queue that, if possible, should be processed by the user agent during idle periods to minimize impact of performance monitoring code.

`~buffer~mapを名前と型で絞込む@ ときは、所与の ( %~obj, %名前, %型 ) に対し，次を走らす： ◎ When asked to run the filter buffer map by name and type algorithm with optional name and type, run the following steps:

1. %結果 ~LET 新たな`~list$ ◎ Let result be an initially empty list.
2. %~map ~LET %~obj に`関連な大域~obj$の`処理能~entry~buffer~map$ ◎ Let map be the performance entry buffer map associated with the relevant global object of context object.
3. %~tuple~list ~LET %型 に応じて ⇒＃ ~NULL ならば %~map の`値~listを取得する$ ／ ~ELSE_ « %~map[ %型 ] » ◎ Let tuple list be an empty list. ◎ If type is not null, append the result of getting the value of entry on map given type as key to tuple list. Otherwise, assign the result of get the values on map to tuple list

4. %~tuple~list を成す ~EACH( %~tuple ) に対し： ◎ For each tuple in tuple list, run the following steps:

   1. %~buffer ~LET %~tuple の`処理能~entry~buffer$ ◎ Let buffer be tuple's performance entry buffer.
   2. ~IF［ %~tuple の`時列線から可用？$ ~EQ ~F ］ ⇒ ~CONTINUE ◎ If tuple's availableFromTimeline is false, continue to the next tuple.
   3. %~entryたち ~LET `~bufferを名前と型で絞込む$( %~buffer, %名前, %型 ) ◎ Let entries be the result of running filter buffer by name and type with buffer, name and type as inputs.
   4. %結果 を %~entryたち で`拡張する$ ◎ For each entry in entries, append entry to result.
5. ~RET %結果 を各~entryの `startTime$m の時系列順に~sortした結果 【！＊~INFRA#list-sort-in-ascending-order】 ◎ Sort results's entries in chronological order with respect to startTime ◎ Return result.

`~bufferを名前と型で絞込む@ ときは、所与の ( %~buffer, %名前, %型 ) に対し，次を走らす： ◎ When asked to run the filter buffer by name and type algorithm, with buffer, name, and type as inputs, run the following steps:

1. %~list ~LET 新たな`~list$ ◎ Let result be an initially empty list.

2. %~buffer を成す ~EACH( `PerformanceEntry$I ~obj %~entry ) に対し： ◎ For each PerformanceEntry entry in buffer, run the following steps:

   1. ~IF［ %型 ~NIN { ~NULL, %~entry の `entryType$m 属性~値 } ］ ⇒ ~CONTINUE ◎ If type is not null and if type is not identical to entry's entryType attribute, continue to next entry.
   2. ~IF［ %名前 ~NIN { ~NULL, %~entry の `name$m 属性~値 ) ］ ⇒ ~CONTINUE ◎ If name is not null and if name is not identical to entry's name attribute, continue to next entry.
   3. %~list に %~entry を`付加する$ ◎ append entry to result.
3. ~RET %~list を 各~entryの `startTime$m の時系列順に~sortした結果 【！＊~INFRA#list-sort-in-ascending-order】 ◎ Sort results's entries in chronological order with respect to startTime ◎ Return result.