From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/client/frametype/index.html | 96 ++++++++++++++++++ files/fr/web/api/client/id/index.html | 103 +++++++++++++++++++ files/fr/web/api/client/index.html | 92 +++++++++++++++++ files/fr/web/api/client/postmessage/index.html | 132 +++++++++++++++++++++++++ files/fr/web/api/client/url/index.html | 118 ++++++++++++++++++++++ 5 files changed, 541 insertions(+) create mode 100644 files/fr/web/api/client/frametype/index.html create mode 100644 files/fr/web/api/client/id/index.html create mode 100644 files/fr/web/api/client/index.html create mode 100644 files/fr/web/api/client/postmessage/index.html create mode 100644 files/fr/web/api/client/url/index.html (limited to 'files/fr/web/api/client') diff --git a/files/fr/web/api/client/frametype/index.html b/files/fr/web/api/client/frametype/index.html new file mode 100644 index 0000000000..42fdca1bde --- /dev/null +++ b/files/fr/web/api/client/frametype/index.html @@ -0,0 +1,96 @@ +--- +title: Client.frameType +slug: Web/API/Client/frameType +tags: + - API + - Client + - Experimental + - Property + - Reference + - ServiceWorker + - frameType +translation_of: Web/API/Client/frameType +--- +

{{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.

+ +

Syntaxe

+ +
var myFrameType = Client.frameType;
+ +

Exemple

+ +
TBD
+
+ +

Spécifications

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

Compatibilité des navigateurs

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Support de base{{CompatChrome(43.0)}}{{ CompatGeckoDesktop("44.0") }}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidFirefox Mobile (Gecko)Firefox OSIE MobileOpera MobileSafari MobileChrome for Android
Support de base{{CompatNo}}{{ CompatGeckoMobile("44.0") }}{{CompatUnknown}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}{{CompatChrome(43.0)}}
+
diff --git a/files/fr/web/api/client/id/index.html b/files/fr/web/api/client/id/index.html new file mode 100644 index 0000000000..8e7cf2701c --- /dev/null +++ b/files/fr/web/api/client/id/index.html @@ -0,0 +1,103 @@ +--- +title: Client.id +slug: Web/API/Client/id +tags: + - API + - Client + - Experimental + - Propriété + - Reference + - Service Workers + - ServiceWorkers + - id +translation_of: Web/API/Client/id +--- +

{{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")}}.

+ +

Syntaxe

+ +
var clientId = Client.id;
+ +

Exemple

+ +
TBD
+
+ +

Spécifications

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

Compatibilité des navigateurs

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Support de base{{CompatChrome(45.0)}} [1]{{ CompatGeckoDesktop("44.0") }}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidAndroid WebviewFirefox Mobile (Gecko)Firefox OSIE MobileOpera MobileSafari MobileChrome for Android
Support de base{{CompatNo}}{{CompatNo}}{{ CompatGeckoMobile("44.0") }}{{CompatUnknown}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}{{CompatChrome(45.0)}} [1]
+
+ + diff --git a/files/fr/web/api/client/index.html b/files/fr/web/api/client/index.html new file mode 100644 index 0000000000..ceb18926b1 --- /dev/null +++ b/files/fr/web/api/client/index.html @@ -0,0 +1,92 @@ +--- +title: Client +slug: Web/API/Client +tags: + - API + - Client + - Experimental + - Interface + - Reference + - Service Workers + - Service worker API + - ServiceWorkerClient + - ServiceWorkers +translation_of: Web/API/Client +--- +

{{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()")}}.

+ +

Méthodes

+ +
+
{{domxref("Client.postMessage()")}}
+
Permet à un service worker d'envoyer un message au ServiceWorkerClient.
+
+ +

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.
+
+ +

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 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)
+function sendMessage(message) {
+  return new Promise(function(resolve, reject) {
+    // Notez que c'est la version du ServiceWorker.postMessage
+    navigator.serviceWorker.controller.postMessage(message);
+    window.serviceWorker.onMessage = function(e) {
+      resolve(e.data);
+    };
+  });
+}
+
+// Contrôle du service worker
+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

+ + diff --git a/files/fr/web/api/client/postmessage/index.html b/files/fr/web/api/client/postmessage/index.html new file mode 100644 index 0000000000..1217139212 --- /dev/null +++ b/files/fr/web/api/client/postmessage/index.html @@ -0,0 +1,132 @@ +--- +title: Client.postMessage() +slug: Web/API/Client/postMessage +tags: + - API + - Client + - Méthode + - Reference + - Service Worker + - ServiceWorker + - postMessage +translation_of: Web/API/Client/postMessage +--- +

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

+ +

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

+ +

Syntaxe

+ +
Client.postMessage(message[, transfer]);
+ +

Valeur de retour

+ +

Void.

+ +

Paramètres

+ +
+
message
+
Le message à envoyer au service worker.
+
transfer {{optional_inline}}
+
Un objet transferable, comme par exemple une référence à un port.
+
+ +

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 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) {
+  return new Promise(function(resolve, reject) {
+     var messageChannel = new MessageChannel();
+     messageChannel.port1.onmessage = function(event) {
+       if (event.data.error) {
+         reject(event.data.error);
+       } else {
+         resolve(event.data);
+       }
+     };
+    navigator.serviceWorker.controller.postMessage(message, [messageChannel.port2]);
+  });
+}
+ +

Spécifications

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

Compatibilité des navigateurs

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Support de base{{CompatChrome(45.0)}} [1]{{CompatVersionUnknown}}
+ {{ CompatGeckoDesktop("44.0") }}		{{CompatNo}}{{CompatUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidAndroid WebviewFirefox Mobile (Gecko)Firefox OSIE MobileOpera MobileSafari MobileChrome for Android
Support de base{{CompatNo}}{{CompatNo}}{{CompatVersionUnknown}}
+ {{ CompatGeckoMobile("44.0") }}		{{CompatUnknown}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}{{CompatChrome(45.0)}} [1]
+
+ + diff --git a/files/fr/web/api/client/url/index.html b/files/fr/web/api/client/url/index.html new file mode 100644 index 0000000000..f96661289f --- /dev/null +++ b/files/fr/web/api/client/url/index.html @@ -0,0 +1,118 @@ +--- +title: Client.url +slug: Web/API/Client/url +tags: + - API + - Client + - Experimental + - Property + - Reference + - ServiceWorkers + - URL +translation_of: Web/API/Client/url +--- +
{{SeeCompatTable}}{{APIRef("Service Workers API")}}
+ +
La propriété url (lecture seule) de l'interface {{domxref("Client")}} retourne l'url du service worker client courant.
+ +
 
+ +

Syntaxe

+ +
var clientUrl = Client.url;
+ +

Valeur de retour

+ +

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

+ +

Exemple

+ +
self.addEventListener('notificationclick', function(event) {
+  console.log('Au click de notification : ', event.notification.tag);
+  event.notification.close();
+
+  // Vérification pour savoir si l'évenement est ouvert et
+  // se focalise dessus si c'est le cas
+  event.waitUntil(clients.matchAll({
+    type: "window"
+  }).then(function(clientList) {
+    for (var i = 0; i < clientList.length; i++) {
+      var client = clientList[i];
+      if (client.url == '/' && 'focus' in client)
+        return client.focus();
+    }
+    if (clients.openWindow)
+      return clients.openWindow('/');
+  }));
+});
+ +

Spécifications

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

Compatibilité des navigateurs

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Support de base{{CompatChrome(41.0)}}{{ CompatGeckoDesktop("44.0") }}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidFirefox Mobile (Gecko)Firefox OSIE MobileOpera MobileSafari MobileChrome for Android
Support de base{{CompatNo}}{{ CompatGeckoMobile("44.0") }}{{CompatUnknown}}{{CompatNo}}{{CompatUnknown}}{{CompatNo}}{{CompatChrome(41.0)}}
+
-- cgit v1.2.3-54-g00ecf