blob: 1727a3bf41627a171b47809eeb24053161c91691 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
---
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](/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
- {{domxref("Client.postMessage()")}}
- : Permet à un service worker d'envoyer un message au [`ServiceWorkerClient`](/en-US/docs/Web/API/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](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.
```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
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 | É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)
|
