From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/serviceworkerglobalscope/index.md | 197 +++++++++------------ .../onnotificationclick/index.md | 55 +++--- 2 files changed, 109 insertions(+), 143 deletions(-) (limited to 'files/fr/web/api/serviceworkerglobalscope') diff --git a/files/fr/web/api/serviceworkerglobalscope/index.md b/files/fr/web/api/serviceworkerglobalscope/index.md index 49afb28427..c16273acd7 100644 --- a/files/fr/web/api/serviceworkerglobalscope/index.md +++ b/files/fr/web/api/serviceworkerglobalscope/index.md @@ -12,87 +12,80 @@ tags: - TopicStub translation_of: Web/API/ServiceWorkerGlobalScope --- -
{{APIRef("Service Workers API")}}
- -

The ServiceWorkerGlobalScope interface of the Service Worker API represents the global execution context of a service worker.

- -

Developers should keep in mind that the ServiceWorker state is not persisted across the termination/restart cycle, so each event handler should assume it's being invoked with a bare, default global state.

- -

Once successfully registered, a service worker can and will be terminated when idle to conserve memory and processor power. An active service worker is automatically restarted to respond to events, such as {{domxref("ServiceWorkerGlobalScope.onfetch")}} or {{domxref("ServiceWorkerGlobalScope.onmessage")}}.

- -

Additionally, synchronous requests are not allowed from within a service worker — only asynchronous requests, like those initiated via the {{domxref("GlobalFetch.fetch", "fetch()")}} method, can be used.

- -

This interface inherits from the {{domxref("WorkerGlobalScope")}} interface, and its parent {{domxref("EventTarget")}}, and therefore implements properties from {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, and {{domxref("WindowEventHandlers")}}.

- -

{{InheritanceDiagram(700, 85, 20)}}

- -

Properties

- -
-
{{domxref("ServiceWorkerGlobalScope.caches")}} {{readonlyinline}}
-
Contains the {{domxref("CacheStorage")}} object associated with the service worker.
-
{{domxref("ServiceWorkerGlobalScope.clients")}} {{readonlyinline}}
-
Contains the {{domxref("Clients")}} object associated with the service worker.
-
{{domxref("ServiceWorkerGlobalScope.registration")}} {{readonlyinline}}
-
Contains the {{domxref("ServiceWorkerRegistration")}} object that represents the service worker's registration.
-
- -

Events

- -
-
{{domxref("ServiceWorkerGlobalScope/activate_event", "activate")}}
-
Occurs when a {{domxref("ServiceWorkerRegistration")}} acquires a new {{domxref("ServiceWorkerRegistration.active")}} worker.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onactivate")}} property.
-
{{domxref("ServiceWorkerGlobalScope/contentdelete_event", "contentdelete")}}
-
Occurs when an item is removed from the {{domxref("ContentIndex", "Content Index")}}.
- Also available via the {{domxref("ServiceWorkerGlobalScope.oncontentdelete")}} property.
-
fetch
-
Occurs when a {{domxref("GlobalFetch.fetch", "fetch()")}} is called.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onfetch")}} property.
-
{{domxref("ServiceWorkerGlobalScope/install_event", "install")}}
-
Occurs when a {{domxref("ServiceWorkerRegistration")}} acquires a new {{domxref("ServiceWorkerRegistration.installing")}} worker.
- Also available via the {{domxref("ServiceWorkerGlobalScope.oninstall")}} property.
-
{{domxref("ServiceWorkerGlobalScope/message_event", "message")}}
-
Occurs when incoming messages are received. Controlled pages can use the {{domxref("MessagePort.postMessage()")}} method to send messages to service workers. The service worker can optionally send a response back via the {{domxref("MessagePort")}} exposed in event.data.port, corresponding to the controlled page.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onmessage")}} property.
-
{{domxref("ServiceWorkerGlobalScope/notificationclick_event", "notificationclick")}}
-
Occurs when a user clicks on a displayed notification.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onnotificationclick")}} property.
-
notificationclose
-
Occurs — when a user closes a displayed notification.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onnotificationclose")}} property.
-
{{domxref("ServiceWorkerGlobalScope/push_event", "push")}}
-
Occurs when a server push notification is received.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onpush")}} property.
-
{{domxref("ServiceWorkerGlobalScope/pushsubscriptionchange_event", "pushsubscriptionchange")}}
-
Occurs when a push subscription has been invalidated, or is about to be invalidated (e.g. when a push service sets an expiration time).
- Also available via the {{domxref("ServiceWorkerGlobalScope.onpushsubscriptionchange")}} property.
-
sync
-
Triggered when a call to {{domxref("SyncManager.register")}} is made from a service worker client page. The attempt to sync is made either immediately if the network is available or as soon as the network becomes available.
- Also available via the {{domxref("ServiceWorkerGlobalScope.onsync")}} property.
-
- -

Methods

- -
-
{{domxref("ServiceWorkerGlobalScope.skipWaiting()")}}
-
Allows the current service worker registration to progress from waiting to active state while service worker clients are using it.
-
- -

ServiceWorkerGlobalScope implements {{domxref("WorkerGlobalScope")}} — which implements {{domxref("WindowOrWorkerGlobalScope")}}. Therefore it also has the following property available to it:

- -
-
{{domxref("GlobalFetch.fetch()")}}
-
Starts the process of fetching a resource. This returns a promise that resolves to the {{domxref("Response")}} object representing the response to your request. This algorithm is the entry point for the fetch handling handed to the service worker context.
-
- -

Examples

- -

This code snippet is from the service worker prefetch sample (see prefetch example live.) The {{domxref("ServiceWorkerGlobalScope.onfetch")}} event handler listens for the fetch event. When fired, the code returns a promise that resolves to the first matching request in the {{domxref("Cache")}} object. If no match is found, the code fetches a response from the network.

- -

The code also handles exceptions thrown from the {{domxref("GlobalFetch.fetch", "fetch()")}} operation. Note that an HTTP error response (e.g., 404) will not trigger an exception. It will return a normal response object that has the appropriate error code set.

- -
self.addEventListener('fetch', function(event) {
+{{APIRef("Service Workers API")}}
+
+The **`ServiceWorkerGlobalScope`** interface of the [Service Worker API](/en-US/docs/Web/API/Service_Worker_API) represents the global execution context of a service worker.
+
+Developers should keep in mind that the ServiceWorker state is not persisted across the termination/restart cycle, so each event handler should assume it's being invoked with a bare, default global state.
+
+Once successfully registered, a service worker can and will be terminated when idle to conserve memory and processor power. An active service worker is automatically restarted to respond to events, such as {{domxref("ServiceWorkerGlobalScope.onfetch")}} or {{domxref("ServiceWorkerGlobalScope.onmessage")}}.
+
+Additionally, synchronous requests are not allowed from within a service worker — only asynchronous requests, like those initiated via the {{domxref("GlobalFetch.fetch", "fetch()")}} method, can be used.
+
+This interface inherits from the {{domxref("WorkerGlobalScope")}} interface, and its parent {{domxref("EventTarget")}}, and therefore implements properties from {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, and {{domxref("WindowEventHandlers")}}.
+
+{{InheritanceDiagram(700, 85, 20)}}
+
+## Properties
+
+- {{domxref("ServiceWorkerGlobalScope.caches")}} {{readonlyinline}}
+  - : Contains the {{domxref("CacheStorage")}} object associated with the service worker.
+- {{domxref("ServiceWorkerGlobalScope.clients")}} {{readonlyinline}}
+  - : Contains the {{domxref("Clients")}} object associated with the service worker.
+- {{domxref("ServiceWorkerGlobalScope.registration")}} {{readonlyinline}}
+  - : Contains the {{domxref("ServiceWorkerRegistration")}} object that represents the service worker's registration.
+
+## Events
+
+- {{domxref("ServiceWorkerGlobalScope/activate_event", "activate")}}
+  - : Occurs when a {{domxref("ServiceWorkerRegistration")}} acquires a new {{domxref("ServiceWorkerRegistration.active")}} worker.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onactivate")}} property.
+- {{domxref("ServiceWorkerGlobalScope/contentdelete_event", "contentdelete")}}
+  - : Occurs when an item is removed from the {{domxref("ContentIndex", "Content Index")}}.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.oncontentdelete")}} property.
+- `fetch`
+  - : Occurs when a {{domxref("GlobalFetch.fetch", "fetch()")}} is called.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onfetch")}} property.
+- {{domxref("ServiceWorkerGlobalScope/install_event", "install")}}
+  - : Occurs when a {{domxref("ServiceWorkerRegistration")}} acquires a new {{domxref("ServiceWorkerRegistration.installing")}} worker.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.oninstall")}} property.
+- {{domxref("ServiceWorkerGlobalScope/message_event", "message")}}
+  - : Occurs when incoming messages are received. Controlled pages can use the {{domxref("MessagePort.postMessage()")}} method to send messages to service workers. The service worker can optionally send a response back via the {{domxref("MessagePort")}} exposed in [`event.data.port`](https://html.spec.whatwg.org/multipage/comms.html#messageport), corresponding to the controlled page.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onmessage")}} property.
+- {{domxref("ServiceWorkerGlobalScope/notificationclick_event", "notificationclick")}}
+  - : Occurs when a user clicks on a displayed notification.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onnotificationclick")}} property.
+- `notificationclose`
+  - : Occurs — when a user closes a displayed notification.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onnotificationclose")}} property.
+- {{domxref("ServiceWorkerGlobalScope/push_event", "push")}}
+  - : Occurs when a server push notification is received.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onpush")}} property.
+- {{domxref("ServiceWorkerGlobalScope/pushsubscriptionchange_event", "pushsubscriptionchange")}}
+  - : Occurs when a push subscription has been invalidated, or is about to be invalidated (e.g. when a push service sets an expiration time).
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onpushsubscriptionchange")}} property.
+- `sync`
+  - : Triggered when a call to {{domxref("SyncManager.register")}} is made from a service worker client page. The attempt to sync is made either immediately if the network is available or as soon as the network becomes available.
+    Also available via the {{domxref("ServiceWorkerGlobalScope.onsync")}} property.
+
+## Methods
+
+- {{domxref("ServiceWorkerGlobalScope.skipWaiting()")}}
+  - : Allows the current service worker registration to progress from waiting to active state while service worker clients are using it.
+
+`ServiceWorkerGlobalScope` implements {{domxref("WorkerGlobalScope")}} — which implements {{domxref("WindowOrWorkerGlobalScope")}}. Therefore it also has the following property available to it:
+
+- {{domxref("GlobalFetch.fetch()")}}
+  - : Starts the process of fetching a resource. This returns a promise that resolves to the {{domxref("Response")}} object representing the response to your request. This algorithm is the entry point for the fetch handling handed to the service worker context.
+
+## Examples
+
+This code snippet is from the [service worker prefetch sample](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/prefetch/service-worker.js) (see [prefetch example live](https://googlechrome.github.io/samples/service-worker/prefetch/).) The {{domxref("ServiceWorkerGlobalScope.onfetch")}} event handler listens for the `fetch` event. When fired, the code returns a promise that resolves to the first matching request in the {{domxref("Cache")}} object. If no match is found, the code fetches a response from the network.
+
+The code also handles exceptions thrown from the {{domxref("GlobalFetch.fetch", "fetch()")}} operation. Note that an HTTP error response (e.g., 404) will not trigger an exception. It will return a normal response object that has the appropriate error code set.
+
+```js
+self.addEventListener('fetch', function(event) {
   console.log('Handling fetch event for', event.request.url);
 
   event.respondWith(
@@ -115,38 +108,22 @@ translation_of: Web/API/ServiceWorkerGlobalScope
       });
     })
   );
-});
- -

Specifications

- - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('Service Workers', '#serviceworkerglobalscope-interface', 'ServiceWorkerGlobalScope')}}{{Spec2('Service Workers')}}Initial definition
+}); +``` -

Browser compatibility

+## Specifications +| Specification | Status | Comment | +| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------ | +| {{SpecName('Service Workers', '#serviceworkerglobalscope-interface', 'ServiceWorkerGlobalScope')}} | {{Spec2('Service Workers')}} | Initial definition | +## Browser compatibility -

{{Compat("api.ServiceWorkerGlobalScope")}}

+{{Compat("api.ServiceWorkerGlobalScope")}} -

See also

+## See also - +- [Using Service Workers](/en-US/docs/Web/API/ServiceWorker_API/Using_Service_Workers) +- [Service workers basic code example](https://github.com/mdn/sw-test) +- [Is ServiceWorker ready?](https://jakearchibald.github.io/isserviceworkerready/) +- {{jsxref("Promise")}} diff --git a/files/fr/web/api/serviceworkerglobalscope/onnotificationclick/index.md b/files/fr/web/api/serviceworkerglobalscope/onnotificationclick/index.md index a3dedb93af..c5e9dbe111 100644 --- a/files/fr/web/api/serviceworkerglobalscope/onnotificationclick/index.md +++ b/files/fr/web/api/serviceworkerglobalscope/onnotificationclick/index.md @@ -11,25 +11,25 @@ tags: - onnotificationclick translation_of: Web/API/ServiceWorkerGlobalScope/onnotificationclick --- -

{{APIRef("Service Workers API")}}

+{{APIRef("Service Workers API")}} -

La propriété ServiceWorkerGlobalScope.onnotificationclick est un gestionnaire d'événements appelé chaque fois que l'événement {{Event("notificationclick")}} est envoyé sur l'objet {{domxref ("ServiceWorkerGlobalScope")}}, c'est-à-dire lorsqu'un utilisateur clique sur une notification affichée générée par {{domxref("ServiceWorkerRegistration.showNotification()")}}.

+La propriété **`ServiceWorkerGlobalScope.onnotificationclick`** est un gestionnaire d'événements appelé chaque fois que l'événement {{Event("notificationclick")}} est envoyé sur l'objet {{domxref ("ServiceWorkerGlobalScope")}}, c'est-à-dire lorsqu'un utilisateur clique sur une notification affichée générée par {{domxref("ServiceWorkerRegistration.showNotification()")}}. -

Les notifications créées sur le thread principal ou dans un worker qui ne sont pas des service worker utilisant le constructeur {{domxref ("Notification.Notification", "Notification()")}} recevront à la place un événement {{Event("click")}} sur l'objet Notification lui-même.

+Les notifications créées sur le thread principal ou dans un worker qui ne sont pas des service worker utilisant le constructeur {{domxref ("Notification.Notification", "Notification()")}} recevront à la place un événement {{Event("click")}} sur l'objet `Notification` lui-même. -
-

Note : Essayer de créer une notification dans le {{domxref ("ServiceWorkerGlobalScope")}} en utilisant le constructeur {{domxref ("Notification.Notification", "Notification()")}} générera une erreur.

-
+> **Note :** Essayer de créer une notification dans le {{domxref ("ServiceWorkerGlobalScope")}} en utilisant le constructeur {{domxref ("Notification.Notification", "Notification()")}} générera une erreur. -

Syntaxe

+## Syntaxe -
ServiceWorkerGlobalScope.onnotificationclick = function(NotificationEvent) { ... }
-ServiceWorkerGlobalScope.onnotificationclick = (NotificationEvent) => { ... }
-
+```js +ServiceWorkerGlobalScope.onnotificationclick = function(NotificationEvent) { ... } +ServiceWorkerGlobalScope.onnotificationclick = (NotificationEvent) => { ... } +``` -

Exemple

+## Exemple -
self.onnotificationclick = (event) => {
+```js
+self.onnotificationclick = (event) => {
   console.log('On notification click: ', event.notification.tag)
   event.notification.close()
 
@@ -40,34 +40,23 @@ ServiceWorkerGlobalScope.onnotificationclick = (NotificationEvent) => { ... }
       .matchAll({
         type: 'window'
       })
-      .then((clientList) => {
-        for (let i = 0; i < clientList.length; i++) {
+      .then((clientList) => {
+        for (let i = 0; i < clientList.length; i++) {
           const client = clientList[i]
-          if (client.url == '/' && 'focus' in client) return client.focus()
+          if (client.url == '/' && 'focus' in client) return client.focus()
         }
         if (clients.openWindow) return clients.openWindow('/')
       })
   )
 }
-
+``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationÉtatCommentaire
{{SpecName('Web Notifications','#dom-serviceworkerglobalscope-onnotificationclick','onnotificationclick')}}{{Spec2('Web Notifications')}}Définition initiale. Cette propriété est spécifiée dans {{domxref ('Notifications_API')}} même si elle fait partie de {{domxref ('ServiceWorkerGlobalScope')}}.
+| Spécification | État | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {{SpecName('Web Notifications','#dom-serviceworkerglobalscope-onnotificationclick','onnotificationclick')}} | {{Spec2('Web Notifications')}} | Définition initiale. Cette propriété est spécifiée dans {{domxref ('Notifications_API')}} même si elle fait partie de {{domxref ('ServiceWorkerGlobalScope')}}. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.ServiceWorkerGlobalScope.onnotificationclick")}}

+{{Compat("api.ServiceWorkerGlobalScope.onnotificationclick")}} -- cgit v1.2.3-54-g00ecf