From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/clients/claim/index.html | 75 -------------------- files/fr/web/api/clients/claim/index.md | 75 ++++++++++++++++++++ files/fr/web/api/clients/get/index.html | 59 ---------------- files/fr/web/api/clients/get/index.md | 59 ++++++++++++++++ files/fr/web/api/clients/index.html | 97 -------------------------- files/fr/web/api/clients/index.md | 97 ++++++++++++++++++++++++++ files/fr/web/api/clients/matchall/index.html | 71 ------------------- files/fr/web/api/clients/matchall/index.md | 71 +++++++++++++++++++ files/fr/web/api/clients/openwindow/index.html | 73 ------------------- files/fr/web/api/clients/openwindow/index.md | 73 +++++++++++++++++++ 10 files changed, 375 insertions(+), 375 deletions(-) delete mode 100644 files/fr/web/api/clients/claim/index.html create mode 100644 files/fr/web/api/clients/claim/index.md delete mode 100644 files/fr/web/api/clients/get/index.html create mode 100644 files/fr/web/api/clients/get/index.md delete mode 100644 files/fr/web/api/clients/index.html create mode 100644 files/fr/web/api/clients/index.md delete mode 100644 files/fr/web/api/clients/matchall/index.html create mode 100644 files/fr/web/api/clients/matchall/index.md delete mode 100644 files/fr/web/api/clients/openwindow/index.html create mode 100644 files/fr/web/api/clients/openwindow/index.md (limited to 'files/fr/web/api/clients') diff --git a/files/fr/web/api/clients/claim/index.html b/files/fr/web/api/clients/claim/index.html deleted file mode 100644 index bd76981af1..0000000000 --- a/files/fr/web/api/clients/claim/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Clients.claim() -slug: Web/API/Clients/claim -tags: - - API - - Clients - - Méthode - - Reference - - Service Workers - - claim -translation_of: Web/API/Clients/claim ---- -

{{SeeCompatTable}}{{APIRef("Service Worker Clients")}}

- -

La méthode claim() de l'interface {{domxref("Clients")}} permet à un service worker actif de se définir comme service worker actif de la page client quand le worker et la page sont dans le même scope. Ceci déclenche un évènement {{domxref("ServiceWorkerContainer.oncontrollerchange","oncontrollerchange")}} dans toutes les pages dans la portée du service worker.

- -

Cette méthode peut être utilisée avec {{domxref("ServiceWorkerGlobalScope.skipWaiting()")}} pour s'assurer que la mise à jour du service worker sous jacent prend effet immédiatement pour et le client courant et tous les autres clients actifs.

- -

Syntaxe

- -
ServiceWorkerClients.claim().then(function() {
-  // Faire quelque chose
-});
-
- -

Paramètres

- -

None.

- -

Valeur de retour

- -

Une Promise.

- -

Exemple

- -

L'exemple suivant utilise claim() dans le gestionnaire d'évènement onActivate d'un service worker. Donc la page client chargée dans la même portée n'a pas besoin d'être rechargée avant de pouvoir utiliser le service worker.

- -
self.addEventListener('install', function(event) {
-  event.waitUntil(self.skipWaiting());
-});
-self.addEventListener('activate', function(event) {
-  event.waitUntil(self.clients.claim());
-});
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initiale. Toujours en cours de développement (voir ticket 414 et ticket 423).
- -

Compatibilité de navigateurs

- -

{{Compat("api.Clients.claim")}}

- -

À voir aussi

- - diff --git a/files/fr/web/api/clients/claim/index.md b/files/fr/web/api/clients/claim/index.md new file mode 100644 index 0000000000..bd76981af1 --- /dev/null +++ b/files/fr/web/api/clients/claim/index.md @@ -0,0 +1,75 @@ +--- +title: Clients.claim() +slug: Web/API/Clients/claim +tags: + - API + - Clients + - Méthode + - Reference + - Service Workers + - claim +translation_of: Web/API/Clients/claim +--- +

{{SeeCompatTable}}{{APIRef("Service Worker Clients")}}

+ +

La méthode claim() de l'interface {{domxref("Clients")}} permet à un service worker actif de se définir comme service worker actif de la page client quand le worker et la page sont dans le même scope. Ceci déclenche un évènement {{domxref("ServiceWorkerContainer.oncontrollerchange","oncontrollerchange")}} dans toutes les pages dans la portée du service worker.

+ +

Cette méthode peut être utilisée avec {{domxref("ServiceWorkerGlobalScope.skipWaiting()")}} pour s'assurer que la mise à jour du service worker sous jacent prend effet immédiatement pour et le client courant et tous les autres clients actifs.

+ +

Syntaxe

+ +
ServiceWorkerClients.claim().then(function() {
+  // Faire quelque chose
+});
+
+ +

Paramètres

+ +

None.

+ +

Valeur de retour

+ +

Une Promise.

+ +

Exemple

+ +

L'exemple suivant utilise claim() dans le gestionnaire d'évènement onActivate d'un service worker. Donc la page client chargée dans la même portée n'a pas besoin d'être rechargée avant de pouvoir utiliser le service worker.

+ +
self.addEventListener('install', function(event) {
+  event.waitUntil(self.skipWaiting());
+});
+self.addEventListener('activate', function(event) {
+  event.waitUntil(self.clients.claim());
+});
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initiale. Toujours en cours de développement (voir ticket 414 et ticket 423).
+ +

Compatibilité de navigateurs

+ +

{{Compat("api.Clients.claim")}}

+ +

À voir aussi

+ + diff --git a/files/fr/web/api/clients/get/index.html b/files/fr/web/api/clients/get/index.html deleted file mode 100644 index dd2d46c018..0000000000 --- a/files/fr/web/api/clients/get/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Clients.get() -slug: Web/API/Clients/get -tags: - - API - - Clients - - Méthode - - Reference - - Service Workers - - get -translation_of: Web/API/Clients/get ---- -
{{SeeCompatTable}}{{APIRef("Service Workers API")}}
- -
La méthode get() de l'interface {{domxref("Clients")}} récupère un service worker client correspondant à un id donné et le retourne dans une {{jsxref("Promise")}}.
- -

Syntaxe

- -
self.clients.get(id).then(function(client) {
-  // Faire quelque chose avec le client
-});
- -

Paramètres

- -
-
id
-
Une {{domxref("DOMString")}} représentant l'id du client que vous souhaitez récuperer.
-
- -

Valeur de retour

- -

Une Promise qui se résoud avec un objet {{domxref("Client")}}.

- -

Exemples

- -
self.clients.get(options).then(function(client) {
-  self.clients.openWindow(client.url);
-});
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('Service Workers', '#clients-get-method', 'get()')}}{{Spec2('Service Workers')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Clients.get")}}

diff --git a/files/fr/web/api/clients/get/index.md b/files/fr/web/api/clients/get/index.md new file mode 100644 index 0000000000..dd2d46c018 --- /dev/null +++ b/files/fr/web/api/clients/get/index.md @@ -0,0 +1,59 @@ +--- +title: Clients.get() +slug: Web/API/Clients/get +tags: + - API + - Clients + - Méthode + - Reference + - Service Workers + - get +translation_of: Web/API/Clients/get +--- +
{{SeeCompatTable}}{{APIRef("Service Workers API")}}
+ +
La méthode get() de l'interface {{domxref("Clients")}} récupère un service worker client correspondant à un id donné et le retourne dans une {{jsxref("Promise")}}.
+ +

Syntaxe

+ +
self.clients.get(id).then(function(client) {
+  // Faire quelque chose avec le client
+});
+ +

Paramètres

+ +
+
id
+
Une {{domxref("DOMString")}} représentant l'id du client que vous souhaitez récuperer.
+
+ +

Valeur de retour

+ +

Une Promise qui se résoud avec un objet {{domxref("Client")}}.

+ +

Exemples

+ +
self.clients.get(options).then(function(client) {
+  self.clients.openWindow(client.url);
+});
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaires
{{SpecName('Service Workers', '#clients-get-method', 'get()')}}{{Spec2('Service Workers')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Clients.get")}}

diff --git a/files/fr/web/api/clients/index.html b/files/fr/web/api/clients/index.html deleted file mode 100644 index aab1e6c132..0000000000 --- a/files/fr/web/api/clients/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: Clients -slug: Web/API/Clients -tags: - - API - - Clients - - Experimental - - Interface - - Reference - - Service Workers - - Service worker API - - ServiceWorker - - Workers -translation_of: Web/API/Clients ---- -
{{APIRef("Service Workers API")}}
- -

L'interface Clients permet d'accéder aux objets Client. On y accède via self.clients au sein d'un service worker.

- -

Méthodes

- -
-
Clients.get()
-
Retourne une Promise (« Promesse ») pour un Client correspondant à un id donné.
-
Clients.matchAll()
-
Retourne une Promise (« Promesse ») pour un tableau d'objets Client. L'argument options vous permet de contrôler les types de clients renvoyés.
-
Clients.openWindow()
-
Ouvre une nouvelle fenêtre de navigateur pour une url donnée et renvoie une Promise (« Promesse ») pour le nouveau WindowClient.
-
Clients.claim()
-
Permet à un service worker actif de se définir comme le controller (« Controlleur ») pour tous les clients dans son scope (« sa portée »).
-
- -

Exemple

- -

L'exemple suivant montre une fenêtre de chat existante ou en crée une nouvelle lorsque l'utilisateur clique sur une notification.

- -
addEventListener('notificationclick', event => {
-  event.waitUntil(async function() {
-    const allClients = await clients.matchAll({
-      includeUncontrolled: true
-    });
-
-    let chatClient;
-
-    // Voyons si nous avons déjà une fenêtre de discussion ouverte :
-    for (const client of allClients) {
-      const url = new URL(client.url);
-
-      if (url.pathname == '/chat/') {
-        // Excellent, utilisons-la !
-        client.focus();
-        chatClient = client;
-        break;
-      }
-    }
-
-    // Si nous n'avons pas trouvé de fenêtre de discussion existante,
-    // ouvrons-en une nouvelle :
-    if (!chatClient) {
-      chatClient = await clients.openWindow('/chat/');
-    }
-
-    // Envoyez un message au client :
-    chatClient.postMessage("Nouveaux messages !");
-  }());
-});
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/clients/index.md b/files/fr/web/api/clients/index.md new file mode 100644 index 0000000000..aab1e6c132 --- /dev/null +++ b/files/fr/web/api/clients/index.md @@ -0,0 +1,97 @@ +--- +title: Clients +slug: Web/API/Clients +tags: + - API + - Clients + - Experimental + - Interface + - Reference + - Service Workers + - Service worker API + - ServiceWorker + - Workers +translation_of: Web/API/Clients +--- +
{{APIRef("Service Workers API")}}
+ +

L'interface Clients permet d'accéder aux objets Client. On y accède via self.clients au sein d'un service worker.

+ +

Méthodes

+ +
+
Clients.get()
+
Retourne une Promise (« Promesse ») pour un Client correspondant à un id donné.
+
Clients.matchAll()
+
Retourne une Promise (« Promesse ») pour un tableau d'objets Client. L'argument options vous permet de contrôler les types de clients renvoyés.
+
Clients.openWindow()
+
Ouvre une nouvelle fenêtre de navigateur pour une url donnée et renvoie une Promise (« Promesse ») pour le nouveau WindowClient.
+
Clients.claim()
+
Permet à un service worker actif de se définir comme le controller (« Controlleur ») pour tous les clients dans son scope (« sa portée »).
+
+ +

Exemple

+ +

L'exemple suivant montre une fenêtre de chat existante ou en crée une nouvelle lorsque l'utilisateur clique sur une notification.

+ +
addEventListener('notificationclick', event => {
+  event.waitUntil(async function() {
+    const allClients = await clients.matchAll({
+      includeUncontrolled: true
+    });
+
+    let chatClient;
+
+    // Voyons si nous avons déjà une fenêtre de discussion ouverte :
+    for (const client of allClients) {
+      const url = new URL(client.url);
+
+      if (url.pathname == '/chat/') {
+        // Excellent, utilisons-la !
+        client.focus();
+        chatClient = client;
+        break;
+      }
+    }
+
+    // Si nous n'avons pas trouvé de fenêtre de discussion existante,
+    // ouvrons-en une nouvelle :
+    if (!chatClient) {
+      chatClient = await clients.openWindow('/chat/');
+    }
+
+    // Envoyez un message au client :
+    chatClient.postMessage("Nouveaux messages !");
+  }());
+});
+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/clients/matchall/index.html b/files/fr/web/api/clients/matchall/index.html deleted file mode 100644 index 2636074f8d..0000000000 --- a/files/fr/web/api/clients/matchall/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Clients.matchAll() -slug: Web/API/Clients/matchAll -tags: - - API - - Client - - Expérimental(2) - - Méthode - - Référence(2) - - Service Workers -translation_of: Web/API/Clients/matchAll ---- -
{{SeeCompatTable}}{{APIRef("Service Workers API")}}
- -
La méthode matchAll() de l'interface {{domxref("Clients")}} retourne une Promesse pour une liste de service worker clients. Inclure le paramètre options permet de retourner tous les services worker clients dont l'origine est la même que l'origine du service worker associé. Si options n'est pas inclus, la méthode retourne que le service worker client controllé par le service worker.
- -
 
- -

Syntaxe

- -
ServiceWorkerClients.matchAll(options).then(function(clients) {
-  // faire quelque chose avec la list de clients
-});
- -

Paramètres

- -
-
options
-

L'objet option vous permet de définir les options pour l'opération. Les options disponibles sont :

-
    -
  • includeUncontrolled: Un {{domxref("Boolean")}} — défini à true, l'opération retournera tous les services worker clients qui sont de la même origine que le service worker courant. Sinon, elle ne retournera que le service worker client controllé par le service worker courant. La valeur par défaut est false.
    • -
  • type: Défini le type de client que vous voulez observer. Les types disponibles sont window, worker, sharedworker, et all. La valeur par défaut est all.
    • -
-
-
- -

Valeur de retour

- -

Une  Promesse qui se résout avec un tableau d'objets {{domxref("Client")}}.

- -

Exemples

- -
clients.matchAll(options).then(function(clientList) {
-  for(var i = 0 ; i < clients.length ; i++) {
-    if(clientList[i].url === 'index.html') {
-      clients.openWindow(clientList[i]);
-      // ou faire quelque chose avec le client
-    }
-  }
-});
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initial.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Clients.matchAll")}}

diff --git a/files/fr/web/api/clients/matchall/index.md b/files/fr/web/api/clients/matchall/index.md new file mode 100644 index 0000000000..2636074f8d --- /dev/null +++ b/files/fr/web/api/clients/matchall/index.md @@ -0,0 +1,71 @@ +--- +title: Clients.matchAll() +slug: Web/API/Clients/matchAll +tags: + - API + - Client + - Expérimental(2) + - Méthode + - Référence(2) + - Service Workers +translation_of: Web/API/Clients/matchAll +--- +
{{SeeCompatTable}}{{APIRef("Service Workers API")}}
+ +
La méthode matchAll() de l'interface {{domxref("Clients")}} retourne une Promesse pour une liste de service worker clients. Inclure le paramètre options permet de retourner tous les services worker clients dont l'origine est la même que l'origine du service worker associé. Si options n'est pas inclus, la méthode retourne que le service worker client controllé par le service worker.
+ +
 
+ +

Syntaxe

+ +
ServiceWorkerClients.matchAll(options).then(function(clients) {
+  // faire quelque chose avec la list de clients
+});
+ +

Paramètres

+ +
+
options
+

L'objet option vous permet de définir les options pour l'opération. Les options disponibles sont :

+
    +
  • includeUncontrolled: Un {{domxref("Boolean")}} — défini à true, l'opération retournera tous les services worker clients qui sont de la même origine que le service worker courant. Sinon, elle ne retournera que le service worker client controllé par le service worker courant. La valeur par défaut est false.
    • +
  • type: Défini le type de client que vous voulez observer. Les types disponibles sont window, worker, sharedworker, et all. La valeur par défaut est all.
    • +
+
+
+ +

Valeur de retour

+ +

Une  Promesse qui se résout avec un tableau d'objets {{domxref("Client")}}.

+ +

Exemples

+ +
clients.matchAll(options).then(function(clientList) {
+  for(var i = 0 ; i < clients.length ; i++) {
+    if(clientList[i].url === 'index.html') {
+      clients.openWindow(clientList[i]);
+      // ou faire quelque chose avec le client
+    }
+  }
+});
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initial.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Clients.matchAll")}}

diff --git a/files/fr/web/api/clients/openwindow/index.html b/files/fr/web/api/clients/openwindow/index.html deleted file mode 100644 index 1116da97f5..0000000000 --- a/files/fr/web/api/clients/openwindow/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Clients.openWindow() -slug: Web/API/Clients/openWindow -translation_of: Web/API/Clients/openWindow ---- -

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

- -

La méthode openWindow() de l'interface {{domxref("Clients")}} crée un nouveau niveau de contexte de navigation et charge une URL donnée. Si le script d'origine n'a pas la permission d'ouvrir une popup,   openWindow() lèvera une InvalidAccessError.

- -

Dans Firefox, une méthode est authorisée d'ouvrir une popup seulement lorsqu'elle est appelée à la suite d'un click sur une notification.

- -

Syntaxe

- -
ServiceWorkerClients.openWindow(url).then(function(WindowClient) {
-  // Faire quelque chose avec le WindowClient
-});
- -

Paramètres

- -
-
url
-
Une {{domxref("USVString")}} représentant l'URL que le client veut ouvrir dans une nouvelle fenêtre. Généralement, cette valeur doit être une URL de la même  origine que le script d'origine.
-
- -

Valeur de retour

- -

Une {{jsxref("Promise")}} qui résoud un objet {{domxref("WindowClient")}} si l'URL est de la même origine que le service worker, et {{Glossary("null", "null value")}} sinon.

- -

Exemples

- -
// Quand l'utilisateur click sur une notification, focus sur la fenêtre si elle existe,
-// ou ouvre en une autre.
-onotificationclick = function(event) {
-  var found = false;
-  clients.matchAll().then(function(clients) {
-    for (i = 0; i < clients.length; i++) {
-      if (clients[i].url === event.data.url) {
-        // La fenêtre existe, focus dessus.
-        found = true;
-        clients[i].focus();
-        break;
-      }
-    }
-    if (!found) {
-      // Crée une nouvelle fenêtre
-      clients.openWindow(event.data.url).then(function(windowClient) {
-        // Faire quelque chose avec le WindowClient
-      });
-    }
-  });
-};
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Clients.openWindow")}}

diff --git a/files/fr/web/api/clients/openwindow/index.md b/files/fr/web/api/clients/openwindow/index.md new file mode 100644 index 0000000000..1116da97f5 --- /dev/null +++ b/files/fr/web/api/clients/openwindow/index.md @@ -0,0 +1,73 @@ +--- +title: Clients.openWindow() +slug: Web/API/Clients/openWindow +translation_of: Web/API/Clients/openWindow +--- +

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

+ +

La méthode openWindow() de l'interface {{domxref("Clients")}} crée un nouveau niveau de contexte de navigation et charge une URL donnée. Si le script d'origine n'a pas la permission d'ouvrir une popup,   openWindow() lèvera une InvalidAccessError.

+ +

Dans Firefox, une méthode est authorisée d'ouvrir une popup seulement lorsqu'elle est appelée à la suite d'un click sur une notification.

+ +

Syntaxe

+ +
ServiceWorkerClients.openWindow(url).then(function(WindowClient) {
+  // Faire quelque chose avec le WindowClient
+});
+ +

Paramètres

+ +
+
url
+
Une {{domxref("USVString")}} représentant l'URL que le client veut ouvrir dans une nouvelle fenêtre. Généralement, cette valeur doit être une URL de la même  origine que le script d'origine.
+
+ +

Valeur de retour

+ +

Une {{jsxref("Promise")}} qui résoud un objet {{domxref("WindowClient")}} si l'URL est de la même origine que le service worker, et {{Glossary("null", "null value")}} sinon.

+ +

Exemples

+ +
// Quand l'utilisateur click sur une notification, focus sur la fenêtre si elle existe,
+// ou ouvre en une autre.
+onotificationclick = function(event) {
+  var found = false;
+  clients.matchAll().then(function(clients) {
+    for (i = 0; i < clients.length; i++) {
+      if (clients[i].url === event.data.url) {
+        // La fenêtre existe, focus dessus.
+        found = true;
+        clients[i].focus();
+        break;
+      }
+    }
+    if (!found) {
+      // Crée une nouvelle fenêtre
+      clients.openWindow(event.data.url).then(function(windowClient) {
+        // Faire quelque chose avec le WindowClient
+      });
+    }
+  });
+};
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Service Workers', '#clients', 'Clients')}}{{Spec2('Service Workers')}}Définition initiale
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Clients.openWindow")}}

-- cgit v1.2.3-54-g00ecf