A service worker registration has an associated active worker (a service worker or null) whose state is either activating or activated. It is initially set to null.
A service worker registration has an associated last update check time. It is initially set to null.
A service worker registration has an associated uninstalling flag. It is initially unset.
-A service worker registration has one or more task queues that back up the tasks from its active worker's event loop's corresponding task queues. (The target task sources for this back up operation are the handle fetch task source and the handle functional event task source.) The user agent dumps the active worker's tasks to the service worker registration's task queues when the active worker is terminated and re-queues those tasks to the active worker's event loop's corresponding task queues when the active worker spins off. Unlike the task queues owned by event loops, the service worker registration's task queues are not processed by any event loops in and of itself.
+A service worker registration has one or more task queues that back up the tasks from its active worker's event loop's corresponding task queues. (The target task sources for this back up operation are the handle fetch task source and the handle functional event task source.) The user agent dumps the active worker's tasks to the service worker registration's task queues when the active worker is terminated and re-queues those tasks to the active worker's event loop's corresponding task queues when the active worker spins off. Unlike the task queues owned by event loops, the service worker registration's task queues are not processed by any event loops in and of itself.
Lifetime
@@ -502,9 +402,9 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/- auxiliary
- "
auxiliary" -The window client's global object's browsing context is an auxiliary browsing context.
+ - top-level
- "
top-level" -The window client's global object's browsing context is a top-level browsing context.
+ - nested
- "
nested" -The window client's global object's browsing context is a nested browsing context.
+ - none
- "
none"
@@ -1213,7 +1113,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
The window client's global object's browsing context is an auxiliary browsing context.
The window client's global object's browsing context is a top-level browsing context.
The window client's global object's browsing context is a nested browsing context.
-
-
- Let browsingContext be the context object's associated service worker client's global object's browsing context. +
- Let browsingContext be the context object's associated service worker client's global object's browsing context.
- Let visibilityState be null.
- Let focusState be null.
- Queue a task task to run the following substeps on the context object's associated service worker client's responsible event loop using the user interaction task source: @@ -1284,7 +1184,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- Let promise be a new promise.
- Run these substeps in parallel:
-
-
- Let browsingContext be the context object's associated service worker client's global object's browsing context. +
- Let browsingContext be the context object's associated service worker client's global object's browsing context.
- If browsingContext has discarded its {{Document}}, reject promise with a
TypeErrorand abort these steps. - Let navigateFailed to false.
- Let visibilityState be null. @@ -1360,7 +1260,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- If client is not a secure context, reject promise with a "{{SecurityError}}" exception and abort these steps.
- If client is a window client, then:
-
-
- Let browsingContext be client's global object's browsing context. +
- Let browsingContext be client's global object's browsing context.
- Let visibilityState be null.
- Let focusState be null.
- Queue a task task to run the following substeps:
@@ -1421,7 +1321,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- If options.{{ClientQueryOptions/type}} is "
window", and client is a window client, then:-
-
- Let browsingContext be client's global object's browsing context. +
- Let browsingContext be client's global object's browsing context.
- Let isClientEnumerable be false.
- Let visibilityState be the empty string.
- Let focusState be false. @@ -1457,7 +1357,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- If client is a window client, then:
-
-
- Let browsingContext be client's global object's browsing context. +
- Let browsingContext be client's global object's browsing context.
- Let isClientEnumerable be false.
- Let visibilityState be the empty string.
- Let focusState be false. @@ -3056,12 +2956,12 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- Run the Update Worker State algorithm passing registration's installing worker and installing as the arguments.
- Assert: job's promise is not null.
- Invoke Resolve Job Promise with job and the {{ServiceWorkerRegistration}} object which represents registration. -
- Queue a task to fire a simple event named
updatefoundat all the {{ServiceWorkerRegistration}} objects for all the service worker clients whose creation url matches registration's scope url and all the service workers whose containing service worker registration is registration.
+ - Queue a task to fire an event named
updatefoundat all the {{ServiceWorkerRegistration}} objects for all the service worker clients whose creation url matches registration's scope url and all the service workers whose containing service worker registration is registration. - Let installingWorker be registration's installing worker.
- Invoke Run Service Worker algorithm with installingWorker as the argument.
- Queue a task task to run the following substeps:
-
-
- Create a trusted event e that uses the {{ExtendableEvent}} interface, with the event type
install, which does not bubble and is not cancelable.
+ - Create a trusted event e that uses the {{ExtendableEvent}} interface, with the event type
install, which does not bubble and is not cancelable. - Dispatch e at installingWorker's environment settings object's global object globalObject.
- WaitForAsynchronousExtensions: Run the following substeps in parallel:
-
@@ -3151,7 +3051,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- Invoke Run Service Worker algorithm with activeWorker as the argument.
- Queue a task task to run the following substeps:
-
-
- Create a trusted event e that uses the {{ExtendableEvent}} interface, with the event type
activate, which does not bubble and is not cancelable.
+ - Create a trusted event e that uses the {{ExtendableEvent}} interface, with the event type
activate, which does not bubble and is not cancelable. - Dispatch e at activeWorker's environment settings object's global object.
- WaitForAsynchronousExtensions: Wait, in parallel, until e's extensions allowed flag is unset.
- Create a trusted event e that uses the {{ExtendableEvent}} interface, with the event type
- Let workerEventLoop be a newly created event loop. -
- Let workerGlobalScope be realmExecutionContext's global object. +
- Let workerGlobalScope be realmExecutionContext's global object.
- Let settingsObject be a new environment settings object whose algorithms are defined as follows:
-
-
- The realm execution context +
- The realm execution context
- Return realmExecutionContext.
- The global object
- Return workerGlobalScope.
- The responsible event loop
- Return workerEventLoop.
- The referrer policy -
- Return workerGlobalScope's referrer policy. +
- Return workerGlobalScope's referrer policy.
- The API URL character encoding
- Return UTF-8.
- The API base URL @@ -3201,17 +3101,17 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- The origin
- Return its registering service worker client's origin.
- The creation URL -
- Return workerGlobalScope's url. +
- Return workerGlobalScope's url.
- The HTTPS state -
- Return workerGlobalScope's HTTPS state. +
- Return workerGlobalScope's HTTPS state.
- - Set workerGlobalScope's url to serviceWorker's script url. -
- Set workerGlobalScope's HTTPS state to serviceWorker's script resource's HTTPS state. -
- Set workerGlobalScope's referrer policy to serviceWorker's script resource's referrer policy. -
- Set workerGlobalScope's type to serviceWorker's type. +
- Set workerGlobalScope's url to serviceWorker's script url. +
- Set workerGlobalScope's HTTPS state to serviceWorker's script resource's HTTPS state. +
- Set workerGlobalScope's referrer policy to serviceWorker's script resource's referrer policy. +
- Set workerGlobalScope's type to serviceWorker's type.
- Create a new {{WorkerLocation}} object and associate it with workerGlobalScope. -
- If serviceWorker is an active worker, and there are any tasks queued in serviceWorker's containing service worker registration's task queues, queue them to serviceWorker's event loop's task queues in the same order using their original task sources. +
- If serviceWorker is an active worker, and there are any tasks queued in serviceWorker's containing service worker registration's task queues, queue them to serviceWorker's event loop's task queues in the same order using their original task sources.
- If script is a classic script, then run the classic script script. Otherwise, it is a module script; run the module script script.
In addition to the usual possibilities of returning a value or failing due to an exception, this could be prematurely aborted by the kill a worker or terminate a worker algorithms.
@@ -3241,7 +3141,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- If serviceWorker is not running, abort these steps.
- Let serviceWorkerGlobalScope be serviceWorker's environment settings object's global object.
- Set serviceWorkerGlobalScope's closing flag to true. -
- If there are any tasks, whose task source is either the handle fetch task source or the handle functional event task source, queued in serviceWorkerGlobalScope's event loop's task queues, queue them to serviceWorker's containing service worker registration's corresponding task queues in the same order using their original task sources, and discard all the tasks (including tasks whose task source is neither the handle fetch task source nor the handle functional event task source) from serviceWorkerGlobalScope's event loop's task queues without processing them. +
- If there are any tasks, whose task source is either the handle fetch task source or the handle functional event task source, queued in serviceWorkerGlobalScope's event loop's task queues, queue them to serviceWorker's containing service worker registration's corresponding task queues in the same order using their original task sources, and discard all the tasks (including tasks whose task source is neither the handle fetch task source nor the handle functional event task source) from serviceWorkerGlobalScope's event loop's task queues without processing them.
This effectively means that the fetch events and the other functional events such as push events are backed up by the registration's task queues while the other tasks including message events are discarded.
- Abort the script currently running in serviceWorker. @@ -3300,7 +3200,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
- Invoke Run Service Worker algorithm with activeWorker as the argument.
- Queue a task task to run the following substeps:
-
-
- Create a trusted event e that uses the {{FetchEvent}} interface, with the event type
fetch, which does not bubble.
+ - Create a trusted event e that uses the {{FetchEvent}} interface, with the event type
fetch, which does not bubble. - Let the request attribute of e be initialized to r.
- Let the clientId attribute of e be initialized to client's id if request is not a non-subresource request, and to null otherwise.
- Let the isReload attribute of e be initialized to
trueif request's client is a window client and the event was dispatched with the user's intention for the page reload, andfalseotherwise.
@@ -3599,7 +3499,7 @@ spec: webidl; urlPrefix: https://heycam.github.io/webidl/
A new service worker is replacing the current service worker, or the current service worker is being discarded due to an install failure.
- - Create a trusted event e that uses the {{FetchEvent}} interface, with the event type
- Fire a simple event named
statechangeat workerObject.
+ - Fire an event named
statechangeat workerObject.
- Assert: client is not null. -
- Queue a task to fire a simple event named
controllerchangeat theServiceWorkerContainerobject client is associated with.
+ - Queue a task to fire an event named
controllerchangeat theServiceWorkerContainerobject client is associated with.
The task must use client's responsible event loop and the DOM manipulation task source.
- Create a trusted event e that uses the {{ExtendableEvent}} interface, with the event type
- If options.{{ClientQueryOptions/type}} is "
Service Workers 1
-Editor’s Draft,
+Editor’s Draft,
- This version:
@@ -1733,7 +1733,7 @@
A service worker has an associated id (an opaque string), which uniquely identifies itself during the lifetime of its containing service worker registration.
A service worker is dispatched a set of lifecycle events, install and activate, and functional events including fetch.
A service worker has an associated script resource (a script), which represents its own script resource. It is initially set to null. A script resource has an associated has ever been evaluated flag. It is initially unset. A script resource has an associated HTTPS state (an HTTPS state value). It is initially "
-none". A script resource has an associated referrer policy (a referrer policy). It is initially the empty string.A service worker has an associated script resource map which is a List of the Record {[[key]], [[value]]} where [[key]] is a URL and [[value]] is a response.
+A service worker has an associated script resource map which is a List of the Record {[[key]], [[value]]} where [[key]] is a URL and [[value]] is a response.
A service worker has an associated skip waiting flag. Unless stated otherwise it is unset.
A service worker has an associated imported scripts updated flag. It is initially unset.
A service worker has an associated set of event types to handle whose element type is an event listener’s event type. It is initially set to null.
@@ -1757,7 +1757,7 @@service worker registration has an associated active worker (a service worker or null) whose state is either activating or activated. It is initially set to null.
A service worker registration has an associated last update check time. It is initially set to null.
A service worker registration has an associated uninstalling flag. It is initially unset.
-A service worker registration has one or more task queues that back up the tasks from its active worker’s event loop’s corresponding task queues. (The target task sources for this back up operation are the handle fetch task source and the handle functional event task source.) The user agent dumps the active worker’s tasks to the service worker registration’s task queues when the active worker is terminated and re-queues those tasks to the active worker’s event loop’s corresponding task queues when the active worker spins off. Unlike the task queues owned by event loops, the service worker registration’s task queues are not processed by any event loops in and of itself.
+A service worker registration has one or more task queues that back up the tasks from its active worker’s event loop’s corresponding task queues. (The target task sources for this back up operation are the handle fetch task source and the handle functional event task source.) The user agent dumps the active worker’s tasks to the service worker registration’s task queues when the active worker is terminated and re-queues those tasks to the active worker’s event loop’s corresponding task queues when the active worker spins off. Unlike the task queues owned by event loops, the service worker registration’s task queues are not processed by any event loops in and of itself.
2.2.1. Lifetime
A user agent must persistently keep a list of registered service worker registrations unless otherwise they are explicitly unregistered. A user agent has a scope to registration map that stores the entries of the tuple of service worker registration’s scope url and the corresponding service worker registration. The lifetime of service worker registrations is beyond that of the
@@ -1871,7 +1871,7 @@ServiceWorkerRegistrationobjects which represent them within the lifetime of their corresponding service worker clients.<
- Let destination be the
ServiceWorkerGlobalScopeobject associated with serviceWorker.- Let targetRealm be destination’s Realm.
- Let incumbentSettings be the incumbent settings object, and incumbentGlobal its global object. -
- Let cloneRecord be StructuredCloneWithTransfer(message, transfer, targetRealm). If this throws an exception, rethrow that exception and abort these steps. +
- Let cloneRecord be StructuredCloneWithTransfer(message, transfer, targetRealm). If this throws an exception, rethrow that exception and abort these steps.
- Let clonedMessage be cloneRecord.[[Clone]].
- Let newPorts be a new frozen array consisting of all
MessagePortobjects in cloneRecord.[[TransferList]], if any, maintaining their relative order.- @@ -1946,7 +1946,7 @@
3.2.5.
update()update()method must run these steps:-
-
- Let p be a promise. +
- Let p be a promise.
- Let registration be the service worker registration.
- Let newestWorker be the result of running Get Newest Worker algorithm passing registration as its argument.
- If newestWorker is null, reject p with an "
InvalidStateError" exception and abort these steps. @@ -1962,7 +1962,7 @@The
unregister()method unregisters the service worker registration. It is important to note that the currently controlled service worker client’s active worker’s containing service worker registration is effective until all the service worker clients (including itself) using this service worker registration unload. That is, theunregister()method only affects subsequent navigations.unregister()method must run these steps:-
-
- Let p be a promise. +
- Let p be a promise.
- Let job be the result of running Create Job with unregister, the scope url of the service worker registration, null, p, and the context object’s relevant settings object client.
- Invoke Schedule Job with job.
- Return p.
@@ -2023,7 +2023,7 @@
The user agent must create a
ServiceWorkerContainerobject when aNavigatorobject or aWorkerNavigatorobject is created and associate it with that object.A
ServiceWorkerContainerprovides capabilities to register, unregister, and update the service worker registrations, and provides access to the state of the service worker registrations and their associated service workers.A
-ServiceWorkerContainerhas an associated service worker client, which is a service worker client whose global object is associated with theNavigatorobject or theWorkerNavigatorobject that theServiceWorkerContaineris retrieved from.A
+ServiceWorkerContainerobject has an associated ready promise (a promise). It is initially set to a new promise.A
ServiceWorkerContainerobject has an associated ready promise (a promise). It is initially set to a new promise.A
ServiceWorkerContainerobject has a task source called the client message queue, initially empty. A client message queue can be enabled or disabled, and is initially disabled. When aServiceWorkerContainerobject’s client message queue is enabled, the event loop must use it as one of its task sources. When theServiceWorkerContainerobject’s relevant global object is aWindowobject, all tasks queued on its client message queue must be associated with its relevant settings object’s responsible document.3.4.1.
@@ -2063,14 +2063,14 @@controllercontext object’s ready promise.
When the
+readyattribute is accessed, the returned promise will never reject. Instead, it waits until the promise resolves with a service worker registration that has an active worker.When the
readyattribute is accessed, the returned promise will never reject. Instead, it waits until the promise resolves with a service worker registration that has an active worker.
3.4.3.
register(scriptURL, options)The
register(scriptURL, options)method creates or updates a service worker registration for the given scope url. If successful, a service worker registration ties the provided scriptURL to a scope url, which is subsequently used for navigation matching.register(scriptURL, options)method must run these steps:-
-
- Let p be a promise. +
- Let p be a promise.
- Let client be the context object’s service worker client.
- Let scriptURL be the result of parsing scriptURL with the context object’s relevant settings object’s API base URL.
- If scriptURL is failure, reject p with a
TypeErrorand abort these steps. @@ -2095,9 +2095,9 @@context object’s service worker client.
- Let clientURL be the result of parsing clientURL with the context object’s relevant settings object’s API base URL. -
- If clientURL is failure, return a promise rejected with a
TypeError. + - If clientURL is failure, return a promise rejected with a
TypeError. - If the origin of clientURL is not client’s origin, return a promise rejected with a "
SecurityError" exception. - - Let promise be a new promise. +
- Let promise be a new promise.
-
Run the following substeps in parallel:
-
@@ -2121,13 +2121,13 @@
- Let client be the context object’s service worker client. -
- Let promise be a new promise. +
- Let promise be a new promise.
-
Run the following substeps in parallel:
- Let array be an empty array.
-
- For each Record {[[key]], [[value]]} entry of scope to registration map:
+ For each Record {[[key]], [[value]]} entry of scope to registration map:
- If the origin of the result of parsing entry.[[key]] is the same as client’s origin, and entry.[[value]]'s uninstalling flag is unset, add the
ServiceWorkerRegistrationobject associated with entry.[[value]] to the array.
The
skipWaiting()method allows this service worker to progress from the registration’s waiting position to active even while service worker clients are using the registration.skipWaiting()method must run these steps:-
-
- Let promise be a new promise. +
- Let promise be a new promise.
-
Run the following substeps in parallel:
-
@@ -2422,7 +2422,7 @@
- If destination is null, throw an "
InvalidStateError" exception. - Let targetRealm be destination’s relevant Realm. -
- Let cloneRecord be StructuredCloneWithTransfer(message, transfer, targetRealm). If this throws an exception, rethrow that exception and abort these steps. +
- Let cloneRecord be StructuredCloneWithTransfer(message, transfer, targetRealm). If this throws an exception, rethrow that exception and abort these steps.
- Let clonedMessage be cloneRecord.[[Clone]].
- Let newPorts be a new frozen array consisting of all
MessagePortobjects in cloneRecord.[[TransferList]], if any, maintaining their relative order. -
@@ -2449,8 +2449,8 @@
4.2.7.
focus()The
focus()method must run these steps:-
-
- If this algorithm is not triggered by user activation, return a promise rejected with an "
InvalidAccessError" exception. - - Let promise be a new promise. +
- If this algorithm is not triggered by user activation, return a promise rejected with an "
InvalidAccessError" exception. + - Let promise be a new promise.
-
Run these substeps in parallel:
-
@@ -2477,10 +2477,10 @@
- Let url be the result of parsing url with the context object’s relevant settings object’s API base URL. -
- If url is failure, return a promise rejected with a
TypeError. - - If url is
about:blank, return a promise rejected with aTypeError. - - If the context object’s associated service worker client’s active worker is not the context object’s relevant global object’s service worker, return a promise rejected with a
TypeError. - - Let promise be a new promise. +
- If url is failure, return a promise rejected with a
TypeError. + - If url is
about:blank, return a promise rejected with aTypeError. + - If the context object’s associated service worker client’s active worker is not the context object’s relevant global object’s service worker, return a promise rejected with a
TypeError. + - Let promise be a new promise.
-
Run these substeps in parallel:
-
@@ -2540,7 +2540,7 @@
- Let promise be a new promise. +
- Let promise be a new promise.
-
Run these substeps in parallel:
-
@@ -2584,7 +2584,7 @@
- Let promise be a new promise. +
- Let promise be a new promise.
-
Run these substeps in parallel:
-
@@ -2691,10 +2691,10 @@
- Let url be the result of parsing url with the context object’s relevant settings object’s API base URL. -
- If url is failure, return a promise rejected with a
TypeError. - - If url is
about:blank, return a promise rejected with aTypeError. - - If this algorithm is not triggered by user activation, return a promise rejected with an "
InvalidAccessError" exception. - - Let promise be a new promise. +
- If url is failure, return a promise rejected with a
TypeError. + - If url is
about:blank, return a promise rejected with aTypeError. + - If this algorithm is not triggered by user activation, return a promise rejected with an "
InvalidAccessError" exception. + - Let promise be a new promise.
-
Run these substeps in parallel:
-
@@ -2728,8 +2728,8 @@
- If the service worker is not an active worker, return a promise rejected with an "
InvalidStateError" exception. - - Let promise be a new promise. +
- If the service worker is not an active worker, return a promise rejected with an "
InvalidStateError" exception. + - Let promise be a new promise.
-
Run the following substeps in parallel:
-
@@ -2764,7 +2764,7 @@
- SetupPromiseArray: Set extendLifetimePromises to a copy of e’s extend lifetime promises. -
- Wait until all the promises in extendLifetimePromises settle. +
- Wait until all the promises in extendLifetimePromises settle.
- If the length of extendLifetimePromises does not equal the length of e’s extend lifetime promises, jump to the step labeled SetupPromiseArray.
- Unset e’s extensions allowed flag.
ExtendableEvent object has an associated extend lifetime promises (an array of promises). It is initially an empty array. +
An
ExtendableEventobject has an associated extend lifetime promises (an array of promises). It is initially an empty array.An
ExtendableEventobject has an associated extensions allowed flag. It is initially set.Service workers have two lifecycle events,
installandactivate. Service workers use theExtendableEventinterface foractivateevent andinstallevent.Service worker extensions that define event handlers may also use or extend the
@@ -2776,7 +2776,7 @@ExtendableEventinterface.in parallel:
Add f to the extend lifetime promises.
4.3.4.
claim()The
claim()method must run these steps:-
-
- If the service worker is not an active worker, return a promise rejected with an "
The
openWindow(url)method must run these steps:
4.3.2.
matchAll(options)The
matchAll(options)method must run these steps:-
-
4.
4.3.1.
get(id)The
get(id)method must run these steps:-
-
The
navigate()method must run these steps:
- If this algorithm is not triggered by user activation, return a promise rejected with an "
Let destination be the
ServiceWorkerContainerobject whose service worker client is the context object’s service worker client. - If destination is null, throw an "
- If the origin of the result of parsing entry.[[key]] is the same as client’s origin, and entry.[[value]]'s uninstalling flag is unset, add the
getRegistrations()method must run these steps:
Service workers and extensions that define event handlers may define their own behaviors, allowing the extend lifetime promises to suggest operation length, and the rejected state of any of the promise in extend lifetime promises to suggest operation failure.
+Service workers and extensions that define event handlers may define their own behaviors, allowing the extend lifetime promises to suggest operation length, and the rejected state of any of the promise in extend lifetime promises to suggest operation failure.
Service workers define the following behaviors for
installevent andactivateevent, respectively:-
-
- Adding a promise f to the event’s extend lifetime promises delays treating the installing worker as installed (i.e. a waiting worker) until all the promises in the extend lifetime promises resolve successfully. (See step 11.3.1 of Install algorithm.) If f rejects, the installation fails. This is primarily used to ensure that a service worker is not considered installed (i.e. a waiting worker) until all of the core caches it depends on are populated. -
- Adding a promise to the event’s extend lifetime promises delays treating the active worker as activated until all the promises in the extend lifetime promises settle. (See step 12.3 of Activate algorithm.) This is primarily used to ensure that any functional events are not dispatched to the
ServiceWorkerGlobalScopeobject that represents the service worker until it upgrades database schemas and deletes the outdated cache entries. + - Adding a promise f to the event’s extend lifetime promises delays treating the installing worker as installed (i.e. a waiting worker) until all the promises in the extend lifetime promises resolve successfully. (See step 11.3.1 of Install algorithm.) If f rejects, the installation fails. This is primarily used to ensure that a service worker is not considered installed (i.e. a waiting worker) until all of the core caches it depends on are populated. +
- Adding a promise to the event’s extend lifetime promises delays treating the active worker as activated until all the promises in the extend lifetime promises settle. (See step 12.3 of Activate algorithm.) This is primarily used to ensure that any functional events are not dispatched to the
ServiceWorkerGlobalScopeobject that represents the service worker until it upgrades database schemas and deletes the outdated cache entries.
@@ -2843,7 +2843,7 @@ 4.5.4.
-event.respondWith(r)Developers can set the argument r with either a promise that resolves with a
+Responseobject or aResponseobject (which is automatically cast to a promise). Otherwise, a network error is returned to Fetch. Renderer-side security checks about tainting for cross-origin content are tied to the types of filtered responses defined in Fetch.Developers can set the argument r with either a promise that resolves with a
Responseobject or aResponseobject (which is automatically cast to a promise). Otherwise, a network error is returned to Fetch. Renderer-side security checks about tainting for cross-origin content are tied to the types of filtered responses defined in Fetch.respondWith(r)method must run these steps:-
@@ -3013,10 +3013,10 @@
The following definitions are the user agent’s internal data structures used throughout the specification.
-A scope to registration map is a List of the Record {[[key]], [[value]]} where [[key]] is a string that represents a scope url and [[value]] is a service worker registration.
+A scope to registration map is a List of the Record {[[key]], [[value]]} where [[key]] is a string that represents a scope url and [[value]] is a service worker registration.
A job is an abstraction of one of register, update, and unregister request for a service worker registration.
A job has a job type, which is one of register, update, and unregister.
A job has a scope url (a URL).
A job has a script url (a URL).
A job has a worker type ("
classic" or "module").A job has a client (a service worker client). It is initially null.
-A job has a promise (a promise). It is initially null.
+A job has a promise (a promise). It is initially null.
A job has a list of equivalent jobs (a list of jobs). It is initially the empty list.
A job has a force bypass cache flag It is initially unset.
Two jobs are equivalent when their job type is the same and:
@@ -3714,7 +3714,7 @@Crea
- jobType, a job type
- scopeURL, a URL
- scriptURL, a URL -
- promise, a promise +
- promise, a promise
- client, a service worker client
- Output
- job, a job @@ -3761,7 +3761,7 @@
Run Job
- none
- jobType, a job type
- Let destination be the
-
-
- Assert: the job queue is not empty. +
- Assert: the job queue is not empty.
-
Queue a task to run these steps:
-
@@ -3783,7 +3783,7 @@
- none
-
-
- Assert: the top element in the job queue is job. +
- Assert: the top element in the job queue is job.
- Pop the top element from the job queue.
- If the job queue is not empty, invoke Run Job with the top element of the job queue.
Regist
- Input
- job, a job
- Output -
- promise, a promise +
- promise, a promise
-
@@ -4034,15 +4034,15 @@
In
- Let redundantWorker be null.
- Run the Update Registration State algorithm passing registration, "
installing" and worker as the arguments.- Run the Update Worker State algorithm passing registration’s installing worker and installing as the arguments. -
- Assert: job’s promise is not null. +
- Assert: job’s promise is not null.
- Invoke Resolve Job Promise with job and the
ServiceWorkerRegistrationobject which represents registration. -- Queue a task to fire a simple event named
updatefoundat all theServiceWorkerRegistrationobjects for all the service worker clients whose creation url matches registration’s scope url and all the service workers whose containing service worker registration is registration. +- Queue a task to fire an event named
updatefoundat all theServiceWorkerRegistrationobjects for all the service worker clients whose creation url matches registration’s scope url and all the service workers whose containing service worker registration is registration.- Let installingWorker be registration’s installing worker.
- Invoke Run Service Worker algorithm with installingWorker as the argument.
- Queue a task task to run the following substeps:
-
-
- Create a trusted event e that uses the
ExtendableEventinterface, with the event typeinstall, which does not bubble and is not cancelable. + - Create a trusted event e that uses the
ExtendableEventinterface, with the event typeinstall, which does not bubble and is not cancelable. - Dispatch e at installingWorker’s environment settings object’s global object globalObject.
-
WaitForAsynchronousExtensions: Run the following substeps in parallel:
@@ -4129,7 +4129,7 @@
Acti
- Queue a task task to run the following substeps:
-
-
- Create a trusted event e that uses the
ExtendableEventinterface, with the event typeactivate, which does not bubble and is not cancelable. + - Create a trusted event e that uses the
ExtendableEventinterface, with the event typeactivate, which does not bubble and is not cancelable. - Dispatch e at activeWorker’s environment settings object’s global object.
- WaitForAsynchronousExtensions: Wait, in parallel, until e’s extensions allowed flag is unset.
referrer policy to serviceWorker’s script resource’s referrer policy.
- Set workerGlobalScope’s type to serviceWorker’s type.
- Create a new
WorkerLocationobject and associate it with workerGlobalScope. -- If serviceWorker is an active worker, and there are any tasks queued in serviceWorker’s containing service worker registration’s task queues, queue them to serviceWorker’s event loop’s task queues in the same order using their original task sources. +
- If serviceWorker is an active worker, and there are any tasks queued in serviceWorker’s containing service worker registration’s task queues, queue them to serviceWorker’s event loop’s task queues in the same order using their original task sources.
- If script is a classic script, then run the classic script script. Otherwise, it is a module script; run the module script script.
In addition to the usual possibilities of returning a value or failing due to an exception, this could be prematurely aborted by the kill a worker or terminate a worker algorithms.
@@ -4215,7 +4215,7 @@Let serviceWorkerGlobalScope be serviceWorker’s environment settings object’s global object.
- Set serviceWorkerGlobalScope’s closing flag to true.
- - If there are any tasks, whose task source is either the handle fetch task source or the handle functional event task source, queued in serviceWorkerGlobalScope’s event loop’s task queues, queue them to serviceWorker’s containing service worker registration’s corresponding task queues in the same order using their original task sources, and discard all the tasks (including tasks whose task source is neither the handle fetch task source nor the handle functional event task source) from serviceWorkerGlobalScope’s event loop’s task queues without processing them. + If there are any tasks, whose task source is either the handle fetch task source or the handle functional event task source, queued in serviceWorkerGlobalScope’s event loop’s task queues, queue them to serviceWorker’s containing service worker registration’s corresponding task queues in the same order using their original task sources, and discard all the tasks (including tasks whose task source is neither the handle fetch task source nor the handle functional event task source) from serviceWorkerGlobalScope’s event loop’s task queues without processing them.
This effectively means that the fetch events and the other functional events such as push events are backed up by the registration’s task queues while the other tasks including message events are discarded.
- Abort the script currently running in serviceWorker.
- Queue a task task to run the following substeps:
Queue a task task to run the following substeps:
-
-
- Create a trusted event e that uses the
FetchEventinterface, with the event typefetch, which does not bubble. + - Create a trusted event e that uses the
FetchEventinterface, with the event typefetch, which does not bubble. - Let the request attribute of e be initialized to r.
- Let the clientId attribute of e be initialized to client’s id if request is not a non-subresource request, and to null otherwise.
- Let the isReload attribute of e be initialized to
trueif request’s client is a window client and the event was dispatched with the user’s intention for the page reload, andfalseotherwise. @@ -4321,8 +4321,8 @@Assert: a Record with the [[value]] equals to registration is contained in scope to registration map. -
- Assert: registration’s active worker is not null. +
- Assert: a Record with the [[value]] equals to registration is contained in scope to registration map. +
- Assert: registration’s active worker is not null.
- Let activeWorker be registration’s active worker.
- If activeWorker’s set of event types to handle does not contain the event type for this functional event, return. @@ -4364,7 +4364,7 @@
Record {[[key]], [[value]]} entry of its scope to registration map: + For each Record {[[key]], [[value]]} entry of its scope to registration map:
- Let registration be entry.[[value]].
-
@@ -4423,7 +4423,7 @@
serialized scope with the exclude fragment flag set.
- Let registration be a new service worker registration whose scope url is set to scope. -
- Set a newly-created Record {[[key]]: scopeString, [[value]]: registration} to scope to registration map. +
- Set a newly-created Record {[[key]]: scopeString, [[value]]: registration} to scope to registration map.
- Return registration.
Update Registration State algorithm passing registration, "
active" and null as the arguments.- Run the Update Worker State algorithm passing redundantWorker and redundant as the arguments.
- Delete a Record {[[key]], [[value]]} entry from scope to registration map where registration’s scope url is the result of parsing entry.[[key]]. +
- Delete a Record {[[key]], [[value]]} entry from scope to registration map where registration’s scope url is the result of parsing entry.[[key]].
@@ -4537,7 +4537,7 @@ Up
- installing
- "
installing" -The service worker in this state is considered an installing worker. During this state,
+event.waitUntil(f)can be called inside theoninstallevent handler to extend the life of the installing worker until the passed promise resolves successfully. This is primarily used to ensure that the service worker is not active until all of the core caches are populated.The service worker in this state is considered an installing worker. During this state,
event.waitUntil(f)can be called inside theoninstallevent handler to extend the life of the installing worker until the passed promise resolves successfully. This is primarily used to ensure that the service worker is not active until all of the core caches are populated.- installed
- "
installed" @@ -4545,7 +4545,7 @@Up
- activating
- "
activating" -The service worker in this state is considered an active worker. During this state,
+event.waitUntil(f)can be called inside theonactivateevent handler to extend the life of the active worker until the passed promise resolves successfully. No functional events are dispatched until the state becomes activated.The service worker in this state is considered an active worker. During this state,
event.waitUntil(f)can be called inside theonactivateevent handler to extend the life of the active worker until the passed promise resolves successfully. No functional events are dispatched until the state becomes activated.- activated
- "
activated" @@ -4555,7 +4555,7 @@Up "
redundant"A new service worker is replacing the current service worker, or the current service worker is being discarded due to an install failure.
-- Fire a simple event named
statechangeat workerObject. +- Fire an event named
statechangeat workerObject.
Fini
- none
The task must use workerObject’s relevant settings object’s responsible event loop and the DOM manipulation task source.
@@ -4570,8 +4570,8 @@None
- - Assert: client is not null.
-
- Queue a task to fire a simple event named
controllerchange at the ServiceWorkerContainer object client is associated with.
+ - Assert: client is not null.
+
- Queue a task to fire an event named
controllerchange at the ServiceWorkerContainer object client is associated with.
The task must use client’s responsible event loop and the DOM manipulation task source.
@@ -4611,7 +4611,7 @@ serialized scope with the exclude fragment flag set.
Let registration be null.
- For each Record {[[key]], [[value]]} entry of its scope to registration map:
+ For each Record {[[key]], [[value]]} entry of its scope to registration map:
- If scopeString matches entry.[[key]], set registration to entry.[[value]].
@@ -4760,10 +4760,10 @@ CacheBatchOperation dictionary objects
Output
- promise, a promise resolves with an array of Response objects.
+ promise, a promise resolves with an array of Response objects.
- - Let p be a promise resolved with no value.
+
- Let p be a promise resolved with no value.
-
Return the result of transforming p with a fulfillment handler that performs the following substeps in parallel:
@@ -5305,6 +5305,7 @@ dispatch flag
- event
- event listener
+
- fire an event
- stop immediate propagation flag
- stop propagation flag
@@ -5316,12 +5317,12 @@
[ECMASCRIPT] defines the following terms:
- - [[call]]
-
- assert
-
- list
-
- map objects
-
- promise
-
- record
+
- [[call]]
+
- assert
+
- list
+
- map objects
+
- promise
+
- record
-
[FETCH] defines the following terms:
@@ -5398,6 +5399,7 @@
MessagePort
- Navigator
- SharedWorkerGlobalScope
+
- StructuredCloneWithTransfer
- Window
- WindowOrWorkerGlobalScope
- Worker
@@ -5406,31 +5408,30 @@
WorkerNavigator
- WorkerType
- a browsing context is discarded
-
- about:blank
- active document
- api base url
- api url character encoding
- application cache
-
- auxiliary browsing contexts
+
- auxiliary browsing context
- browsing context
- classic script
- creation url
- discard a document
- dom manipulation task source
- environment settings object
+
- event handler
- event handler event type
- event handler idl attribute
-
- event handlers
-
- event loops
+
- event loop
- exceptions enabled flag
- fetch a classic worker script
- fetch a module worker script tree
-
- fire a simple event
- focusing steps
-
- global object
+
- global object (for Realm)
+
- global object (for environment settings object)
- has focus steps
+
- https state (for WorkerGlobalScope)
- https state (for environment settings object)
-
- https state (for workerglobalscope)
- import scripts into worker global scope
- importScripts(urls)
- in parallel
@@ -5446,9 +5447,10 @@
parent browsing context
- perform the fetch
- queue a task
+
- realm
- realm execution context
+
- referrer policy (for WorkerGlobalScope)
- referrer policy (for environment settings object)
-
- referrer policy (for workerglobalscope)
- relevant global object
- relevant realm
- relevant settings object
@@ -5462,13 +5464,10 @@
script
- shared workers
- source browsing context
-
- structuredclonewithtransfer
+
- task
- task queue
- task source
-
- tasks
- terminate a worker
-
- the global object's realm
-
- the realm's global object
- the worker's documents
- top-level browsing context
- triggered by user activation
controllerchange at the ServiceWorkerContainer object client is associated with.
+ controllerchange at the ServiceWorkerContainer object client is associated with.
- If scopeString matches entry.[[key]], set registration to entry.[[value]].
CacheBatchOperation dictionary objects
Output
- promise, a promise resolves with an array of Response objects.
+ promise, a promise resolves with an array of Response objects.
- - Let p be a promise resolved with no value.
+
- Let p be a promise resolved with no value.
-
Return the result of transforming p with a fulfillment handler that performs the following substeps in parallel:
@@ -5305,6 +5305,7 @@ dispatch flag
- event
- event listener
+
- fire an event
- stop immediate propagation flag
- stop propagation flag
@@ -5316,12 +5317,12 @@
[ECMASCRIPT] defines the following terms:
- - [[call]]
-
- assert
-
- list
-
- map objects
-
- promise
-
- record
+
- [[call]]
+
- assert
+
- list
+
- map objects
+
- promise
+
- record
-
[FETCH] defines the following terms:
@@ -5398,6 +5399,7 @@
MessagePort
- Navigator
- SharedWorkerGlobalScope
+
- StructuredCloneWithTransfer
- Window
- WindowOrWorkerGlobalScope
- Worker
@@ -5406,31 +5408,30 @@
WorkerNavigator
- WorkerType
- a browsing context is discarded
-
- about:blank
- active document
- api base url
- api url character encoding
- application cache
-
- auxiliary browsing contexts
+
- auxiliary browsing context
- browsing context
- classic script
- creation url
- discard a document
- dom manipulation task source
- environment settings object
+
- event handler
- event handler event type
- event handler idl attribute
-
- event handlers
-
- event loops
+
- event loop
- exceptions enabled flag
- fetch a classic worker script
- fetch a module worker script tree
-
- fire a simple event
- focusing steps
-
- global object
+
- global object (for Realm)
+
- global object (for environment settings object)
- has focus steps
+
- https state (for WorkerGlobalScope)
- https state (for environment settings object)
-
- https state (for workerglobalscope)
- import scripts into worker global scope
- importScripts(urls)
- in parallel
@@ -5446,9 +5447,10 @@
parent browsing context
- perform the fetch
- queue a task
+
- realm
- realm execution context
+
- referrer policy (for WorkerGlobalScope)
- referrer policy (for environment settings object)
-
- referrer policy (for workerglobalscope)
- relevant global object
- relevant realm
- relevant settings object
@@ -5462,13 +5464,10 @@
script
- shared workers
- source browsing context
-
- structuredclonewithtransfer
+
- task
- task queue
- task source
-
- tasks
- terminate a worker
-
- the global object's realm
-
- the realm's global object
- the worker's documents
- top-level browsing context
- triggered by user activation
Response objects.
+ Response objects.
-
-
- Let p be a promise resolved with no value. +
- Let p be a promise resolved with no value.
-
Return the result of transforming p with a fulfillment handler that performs the following substeps in parallel:
-
@@ -5305,6 +5305,7 @@
- event
- event listener +
- fire an event
- stop immediate propagation flag
- stop propagation flag
@@ -5316,12 +5317,12 @@
[ECMASCRIPT] defines the following terms:
-
-
- [[call]] -
- assert -
- list -
- map objects -
- promise -
- record +
- [[call]] +
- assert +
- list +
- map objects +
- promise +
- record
- [FETCH] defines the following terms: @@ -5398,6 +5399,7 @@
MessagePort
- Navigator
- SharedWorkerGlobalScope +
- StructuredCloneWithTransfer
- Window
- WindowOrWorkerGlobalScope
- Worker @@ -5406,31 +5408,30 @@
WorkerNavigator
- WorkerType
- a browsing context is discarded -
- about:blank
- active document
- api base url
- api url character encoding
- application cache -
- auxiliary browsing contexts +
- auxiliary browsing context
- browsing context
- classic script
- creation url
- discard a document
- dom manipulation task source
- environment settings object +
- event handler
- event handler event type
- event handler idl attribute -
- event handlers -
- event loops +
- event loop
- exceptions enabled flag
- fetch a classic worker script
- fetch a module worker script tree -
- fire a simple event
- focusing steps -
- global object +
- global object (for Realm) +
- global object (for environment settings object)
- has focus steps +
- https state (for WorkerGlobalScope)
- https state (for environment settings object) -
- https state (for workerglobalscope)
- import scripts into worker global scope
- importScripts(urls)
- in parallel @@ -5446,9 +5447,10 @@
parent browsing context
- perform the fetch
- queue a task +
- realm
- realm execution context +
- referrer policy (for WorkerGlobalScope)
- referrer policy (for environment settings object) -
- referrer policy (for workerglobalscope)
- relevant global object
- relevant realm
- relevant settings object @@ -5462,13 +5464,10 @@
script
- shared workers
- source browsing context -
- structuredclonewithtransfer +
- task
- task queue
- task source -
- tasks
- terminate a worker -
- the global object's realm -
- the realm's global object
- the worker's documents
- top-level browsing context
- triggered by user activation
dispatch flag