Skip to content

[worklets] Adds hook for downstream spec to set the destination. #388

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bfgeek merged 1 commit into from
Jul 8, 2020
Merged

[worklets] Adds hook for downstream spec to set the destination. #388

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions css-paint-api/Overview.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,8 @@ which are related to painting.

The {{paintWorklet}}'s <a>worklet global scope type</a> is {{PaintWorkletGlobalScope}}.

The {{paintWorklet}}'s <a>worklet destination type</a> is <code>"paintworklet"</code>.

<pre class='idl'>
partial interface CSS {
[SameObject] readonly attribute Worklet paintWorklet;
Expand Down
27 changes: 16 additions & 11 deletions worklets/Overview.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -314,6 +314,9 @@ Note: As an example the <a>worklet global scope type</a> might be a {{PaintWorkl
A {{Worklet}} has a list of the <dfn export>worklet's WorkletGlobalScopes</dfn>. Initially this list
is empty; it is populated when the user agent chooses to create its {{WorkletGlobalScope}}.

A {{Worklet}} has a <dfn export>worklet destination type</dfn>. This is used for setting the <a
for=request>destination</a> requests from <a>fetch a module worker script graph</a>.

A {{Worklet}} has a <dfn>module responses map</dfn>. This is a ordered map of module URLs to values
that are a <a>fetch</a> responses. The map's entries are ordered based on their insertion order.
Access to this map should be thread-safe.
Expand Down Expand Up @@ -359,7 +362,9 @@ When the <dfn method for=Worklet>import(|moduleURL|, |options|)</dfn> method is

9. Let |workletGlobalScopeType| be |worklet|'s <a>worklet global scope type</a>.

10. If the <a>worklet's WorkletGlobalScopes</a> is empty, run the following steps:
10. Let |destination| be |worklet|'s <a>worklet destination type</a>.

11. If the <a>worklet's WorkletGlobalScopes</a> is empty, run the following steps:

1. <a>Create a WorkletGlobalScope</a> given |workletGlobalScopeType|, |moduleResponsesMap|,
and |outsideSettings|.
Expand All @@ -370,22 +375,22 @@ When the <dfn method for=Worklet>import(|moduleURL|, |options|)</dfn> method is

Wait for this step to complete before continuing.

11. Let |pendingTaskStruct| be a new <a>pending tasks struct</a> with <a
12. Let |pendingTaskStruct| be a new <a>pending tasks struct</a> with <a
for="pending tasks struct">counter</a> initialized to the length of <a>worklet's
WorkletGlobalScopes</a>.

12. For each |workletGlobalScope| in the <a>worklet's WorkletGlobalScopes</a>, <a>queue a
13. For each |workletGlobalScope| in the <a>worklet's WorkletGlobalScopes</a>, <a>queue a
task</a> on the |workletGlobalScope| to <a>fetch and invoke a worklet script</a> given
|workletGlobalScope|, |moduleURLRecord|, |moduleResponsesMap|, |credentialOptions|,
|outsideSettings|, |pendingTaskStruct|, and |promise|.
|workletGlobalScope|, |moduleURLRecord|, |destination|, |moduleResponsesMap|,
|credentialOptions|, |outsideSettings|, |pendingTaskStruct|, and |promise|.

Note: The rejecting and resolving of the |promise| occurs within the <a>fetch and invoke a
worklet script</a> algorithm.
</div>

<div algorithm>
When the user agent is to <dfn>fetch and invoke a worklet script</dfn> given |workletGlobalScope|,
|moduleURLRecord|, |moduleResponsesMap|, |credentialOptions|, |outsideSettings|,
|moduleURLRecord|, |destination|, |moduleResponsesMap|, |credentialOptions|, |outsideSettings|,
|pendingTaskStruct|, and |promise|, the user agent <em>must</em> run the following steps:

Note: This algorithm is to be run within the <a>worklet global scope execution environment</a>.
Expand All @@ -394,8 +399,8 @@ When the user agent is to <dfn>fetch and invoke a worklet script</dfn> given |wo
object</a>.

2. Let |script| by the result of <a>fetch a worklet script</a> given |moduleURLRecord|,
|moduleResponsesMap|, |credentialOptions|, |outsideSettings|, and |insideSettings| when it
asynchronously completes.
|destination|, |moduleResponsesMap|, |credentialOptions|, |outsideSettings|, and
|insideSettings| when it asynchronously completes.

3. If |script| is <em>null</em>, then <a>queue a task</a> on |outsideSettings|'s <a>responsible
event loop</a> to run these steps:
Expand All @@ -422,14 +427,14 @@ When the user agent is to <dfn>fetch and invoke a worklet script</dfn> given |wo
</div>

<div algorithm>
When the user agent is to <dfn>fetch a worklet script</dfn> given |moduleURLRecord|,
When the user agent is to <dfn>fetch a worklet script</dfn> given |moduleURLRecord|, |destination|,
|moduleResponsesMap|, |credentialOptions|, |outsideSettings|, and |insideSettings|, the user agent
<em>must</em> run the following steps:

Note: This algorithm is to be run within the <a>worklet global scope execution environment</a>.

1. <a>Fetch a module worker script graph</a> given |moduleURLRecord|, |outsideSettings|, "script",
|credentialOptions|, and |insideSettings|.
1. <a>Fetch a module worker script graph</a> given |moduleURLRecord|, |outsideSettings|,
|destination|, |credentialOptions|, and |insideSettings|.

To <a>perform the fetch</a> given |request|, perform the following steps:

Expand Down