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/client/frametype/index.md | 40 +++++-------- files/fr/web/api/client/id/index.md | 40 +++++-------- files/fr/web/api/client/index.md | 90 ++++++++++++---------------- files/fr/web/api/client/postmessage/index.md | 61 ++++++++----------- files/fr/web/api/client/url/index.md | 51 +++++++--------- 5 files changed, 115 insertions(+), 167 deletions(-) (limited to 'files/fr/web/api/client') diff --git a/files/fr/web/api/client/frametype/index.md b/files/fr/web/api/client/frametype/index.md index 4d3ed3cae9..acba1e7eac 100644 --- a/files/fr/web/api/client/frametype/index.md +++ b/files/fr/web/api/client/frametype/index.md @@ -11,36 +11,28 @@ tags: - frameType translation_of: Web/API/Client/frameType --- -

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

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

La propriété frameType (accessible en lecture seule) de l'interface {{domxref("Client")}} indique le type de contexte de navigation du {{domxref("Client")}} courant. Cette valeur peut être auxiliary, top-level, nested, ou none.

+La propriété **`frameType`** (accessible en lecture seule) de l'interface {{domxref("Client")}} indique le type de contexte de navigation du {{domxref("Client")}} courant. Cette valeur peut être `auxiliary`, `top-level`, `nested`, ou `none`. -

Syntaxe

+## Syntaxe -
var myFrameType = Client.frameType;
+```js +var myFrameType = Client.frameType; +``` -

Exemple

+## Exemple -
TBD
-
+```js +TBD +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#client-frametype', 'frameType')}}{{Spec2('Service Workers')}}Définition initiale.
+| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('Service Workers', '#client-frametype', 'frameType')}} | {{Spec2('Service Workers')}} | Définition initiale. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Client.frameType")}}

+{{Compat("api.Client.frameType")}} diff --git a/files/fr/web/api/client/id/index.md b/files/fr/web/api/client/id/index.md index 5860d16888..e38a2fb262 100644 --- a/files/fr/web/api/client/id/index.md +++ b/files/fr/web/api/client/id/index.md @@ -12,36 +12,28 @@ tags: - id translation_of: Web/API/Client/id --- -

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

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

La propriété id (lecture seule) de l'interface {{domxref("Client")}} retourne l'identifiant universellement unique de l'objet {{domxref("Client")}}.

+La propriété **`id`** (lecture seule) de l'interface {{domxref("Client")}} retourne l'identifiant universellement unique de l'objet {{domxref("Client")}}. -

Syntaxe

+## Syntaxe -
var clientId = Client.id;
+```js +var clientId = Client.id; +``` -

Exemple

+## Exemple -
TBD
-
+```js +TBD +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#client-id', 'id')}}{{Spec2('Service Workers')}}Initial definition.
+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('Service Workers', '#client-id', 'id')}} | {{Spec2('Service Workers')}} | Initial definition. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Client.id")}}

+{{Compat("api.Client.id")}} diff --git a/files/fr/web/api/client/index.md b/files/fr/web/api/client/index.md index 1852bcbdb3..1727a3bf41 100644 --- a/files/fr/web/api/client/index.md +++ b/files/fr/web/api/client/index.md @@ -13,35 +13,32 @@ tags: - ServiceWorkers translation_of: Web/API/Client --- -

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

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

L'interface Client de l'API ServiceWorker représente la portée d'exécution d'un {{domxref("Worker")}} ou {{domxref("SharedWorker")}}. Les clients {{domxref("Window")}} sont représentés par le plus spécifique {{domxref("WindowClient")}}. Vous pouvez obtenir les objets Client/WindowClient via les méthodes {{domxref("Clients.matchAll","Clients.matchAll()")}} et {{domxref("Clients.get","Clients.get()")}}.

+L'interface `Client` de l'[API ServiceWorker](/en-US/docs/Web/API/ServiceWorker_API) représente la portée d'exécution d'un {{domxref("Worker")}} ou {{domxref("SharedWorker")}}. Les clients {{domxref("Window")}} sont représentés par le plus spécifique {{domxref("WindowClient")}}. Vous pouvez obtenir les objets `Client`/`WindowClient` via les méthodes {{domxref("Clients.matchAll","Clients.matchAll()")}} et {{domxref("Clients.get","Clients.get()")}}. -

Méthodes

+## Méthodes -
-
{{domxref("Client.postMessage()")}}
-
Permet à un service worker d'envoyer un message au ServiceWorkerClient.
-
+- {{domxref("Client.postMessage()")}} + - : Permet à un service worker d'envoyer un message au [`ServiceWorkerClient`](/en-US/docs/Web/API/ServiceWorkerClient). -

Propriétés

+## Propriétés -
-
{{domxref("Client.id")}} {{readonlyInline}}
-
Retourne l'identifiant universellement unique de l'objet Client.
-
{{domxref("Client.type")}} {{readonlyInline}}
-
Indique le type de contexte de navigation du client courant. Cette valeur peut être auxiliary, top-level, nested, or none.
-
{{domxref("Client.url")}} {{readonlyInline}}
-
Retourne l'URL du client service worker courant.
-
+- {{domxref("Client.id")}} {{readonlyInline}} + - : Retourne l'identifiant universellement unique de l'objet `Client`. +- {{domxref("Client.type")}} {{readonlyInline}} + - : Indique le type de contexte de navigation du client courant. Cette valeur peut être `auxiliary`, `top-level`, `nested`, or `none`. +- {{domxref("Client.url")}} {{readonlyInline}} + - : Retourne l'URL du client service worker courant. -

Exemples

+## Exemples -

Ce code est basé sur un fragment pris d'un exemple d'envoi de message (voir l'exemple en ligne.) Ce code envoie une référence de message à laquelle le service worker peut répondre via {{domxref("Client.postMessage()")}}.

+Ce code est basé sur un fragment pris d'un [exemple d'envoi de message](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/post-message/index.html) (voir [l'exemple en ligne](https://googlechrome.github.io/samples/service-worker/post-message/).) Ce code envoie une référence de message à laquelle le service worker peut répondre via {{domxref("Client.postMessage()")}}. -

Ce message est contenu dans une promesse qui est résolue si la réponse ne contient pas d'erreur et est rejetée avec une erreur.

+Ce message est contenu dans une promesse qui est résolue si la réponse ne contient pas d'erreur et est rejetée avec une erreur. -
// client service worker (par exemple un document)
+```js
+// client service worker (par exemple un document)
 function sendMessage(message) {
   return new Promise(function(resolve, reject) {
     // Notez que c'est la version du ServiceWorker.postMessage
@@ -57,36 +54,23 @@ self.addEventListener("message", function(e) {
   // e.source est un object client
   e.source.postMessage("Hello! Your message was: " + e.data);
 });
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaire
{{SpecName('Service Workers', '#client', 'Client')}}{{Spec2('Service Workers')}}Définition initiale
- -

Compatibilité des navigateurs

- -
{{Compat("api.Client")}}
- -

Voir également

- - +``` + +## Spécifications + +| Spécification | État | Commentaire | +| -------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('Service Workers', '#client', 'Client')}} | {{Spec2('Service Workers')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Client")}} + +## Voir également + +- [Utiliser les Service Workers](/en-US/docs/Web/API/ServiceWorker_API/Using_Service_Workers) +- [Exemple simple de service workers](https://github.com/mdn/sw-test) +- [Est ce que le ServiceWorker est prêt ?](https://jakearchibald.github.io/isserviceworkerready/) +- [Promesses](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) +- [Utilisation performante des web workers](/en-US/docs/Web/Guide/Performance/Using_web_workers) +- [Channel Messaging API](/en-US/docs/Web/API/Channel_Messaging_API) diff --git a/files/fr/web/api/client/postmessage/index.md b/files/fr/web/api/client/postmessage/index.md index 3ea26daa58..45e64508aa 100644 --- a/files/fr/web/api/client/postmessage/index.md +++ b/files/fr/web/api/client/postmessage/index.md @@ -11,34 +11,35 @@ tags: - postMessage translation_of: Web/API/Client/postMessage --- -

{{SeeCompatTable}}{{APIRef("Client")}}

+{{SeeCompatTable}}{{APIRef("Client")}} -

La méthode postMessage() de l'interface {{domxref("Client")}} permet à un service worker client d'envoyer un message à un {{domxref("ServiceWorker")}}.

+La méthode **`postMessage() `**de l'interface {{domxref("Client")}} permet à un service worker client d'envoyer un message à un {{domxref("ServiceWorker")}}. -

Syntaxe

+## Syntaxe -
Client.postMessage(message[, transfer]);
+```js +Client.postMessage(message[, transfer]); +``` -

Valeur de retour

+### Valeur de retour -

Void.

+Void. -

Paramètres

+### Paramètres -
-
message
-
Le message à envoyer au service worker.
-
transfer {{optional_inline}}
-
Un objet transferable, comme par exemple une référence à un port.
-
+- `message` + - : Le message à envoyer au service worker. +- `transfer {{optional_inline}}` + - : Un objet transferable, comme par exemple une référence à un port. -

Exemples

+## Exemples -

Ce fragment de code est tiré de l'exemple d'envoi de message du service worker exemple d'envoi de message du service worker (voir exemple en ligne). Le code envoi un message et transfert le port vers le service worker qui pourra répondre via {{domxref("Client.postMessage()")}}.

+Ce fragment de code est tiré de l'[exemple d'envoi de message du service worker](https://github.com/GoogleChrome/samples/blob/gh-pages/service-worker/post-message/index.html) exemple d'envoi de message du service worker (voir [exemple en ligne](https://googlechrome.github.io/samples/service-worker/post-message/)). Le code envoi un message et transfert le port vers le service worker qui pourra répondre via {{domxref("Client.postMessage()")}}. -

Ce message est contenu dans une promesse qui se résolvera si la réponse ne contient pas d'erreur et qui échouera avec l'erreur.

+Ce message est contenu dans une promesse qui se résolvera si la réponse ne contient pas d'erreur et qui échouera avec l'erreur. -
function sendMessage(message) {
+```js
+function sendMessage(message) {
   return new Promise(function(resolve, reject) {
      var messageChannel = new MessageChannel();
      messageChannel.port1.onmessage = function(event) {
@@ -50,25 +51,15 @@ translation_of: Web/API/Client/postMessage
      };
     navigator.serviceWorker.controller.postMessage(message, [messageChannel.port2]);
   });
-}
+} +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#client-postmessage-method', 'postMessage()')}}{{Spec2('Service Workers')}}Définition initiale
+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- | +| {{SpecName('Service Workers', '#client-postmessage-method', 'postMessage()')}} | {{Spec2('Service Workers')}} | Définition initiale | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Client.postMessage")}}

+{{Compat("api.Client.postMessage")}} diff --git a/files/fr/web/api/client/url/index.md b/files/fr/web/api/client/url/index.md index e024102c50..7b40c93b14 100644 --- a/files/fr/web/api/client/url/index.md +++ b/files/fr/web/api/client/url/index.md @@ -11,23 +11,22 @@ tags: - URL translation_of: Web/API/Client/url --- -
{{SeeCompatTable}}{{APIRef("Service Workers API")}}
+{{SeeCompatTable}}{{APIRef("Service Workers API")}}La propriété **`url`** (lecture seule) de l'interface {{domxref("Client")}} retourne l'url du service worker client courant. -
La propriété url (lecture seule) de l'interface {{domxref("Client")}} retourne l'url du service worker client courant.
+## Syntaxe -
 
+```js +var clientUrl = Client.url; +``` -

Syntaxe

+### Valeur de retour -
var clientUrl = Client.url;
+Valeur de type {{domxref("USVString")}}. -

Valeur de retour

+## Exemple -

Valeur de type {{domxref("USVString")}}.

- -

Exemple

- -
self.addEventListener('notificationclick', function(event) {
+```js
+self.addEventListener('notificationclick', function(event) {
   console.log('Au click de notification : ', event.notification.tag);
   event.notification.close();
 
@@ -36,33 +35,23 @@ translation_of: Web/API/Client/url
   event.waitUntil(clients.matchAll({
     type: "window"
   }).then(function(clientList) {
-    for (var i = 0; i < clientList.length; i++) {
+    for (var i = 0; i < clientList.length; i++) {
       var client = clientList[i];
-      if (client.url == '/' && 'focus' in client)
+      if (client.url == '/' && 'focus' in client)
         return client.focus();
     }
     if (clients.openWindow)
       return clients.openWindow('/');
   }));
-});
+}); +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#client-url', 'url')}}{{Spec2('Service Workers')}}Défintion initiale.
+| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------ | ------------------------------------ | ------------------- | +| {{SpecName('Service Workers', '#client-url', 'url')}} | {{Spec2('Service Workers')}} | Défintion initiale. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Client.url")}}

+{{Compat("api.Client.url")}} -- cgit v1.2.3-54-g00ecf