blob: 5cdfead701c7aa197a77dbdaec60f7c0713f27bf (
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
77
78
79
80
81
|
---
title: ExtendableMessageEvent
slug: Web/API/ExtendableMessageEvent
tags:
- API
- Experimental
- ExtendableMessageEvent
- Interface
- Reference
- Service Workers
translation_of: Web/API/ExtendableMessageEvent
---
{{APIRef("Service Workers API")}}{{SeeCompatTable}}
L'interface **`ExtendableMessageEvent`** de {{domxref("ServiceWorker_API", "ServiceWorker API")}} représentes un objet d'évenement qu'un évènement {{event("message_(ServiceWorker)","message")}} lance pour un service worker (quand un canal de message est reçu sur le {{domxref("ServiceWorkerGlobalScope")}} depuis un autre context) — étends la durée de vie de ces évènements.
Cette interface hérite de l'interface {{domxref("ExtendableEvent")}}.
## Constructeur
- {{domxref("ExtendableMessageEvent.ExtendableMessageEvent()")}}
- : Crée une nouvelle instance de l'objet `ExtendableMessageEvent`.
## Propriétés
_Hérite des propriétés de son parent,_ _{{domxref("ExtendableEvent")}}_.
- {{domxref("ExtendableMessageEvent.data")}} {{readonlyinline}}
- : Retourne les données de l'évenements. Il peut être de n'importe quel type.
- {{domxref("ExtendableMessageEvent.origin")}} {{readonlyinline}}
- : Retourne l'origine du {{domxref("ServiceWorkerClient")}} qui envoie le message.
- {{domxref("ExtendableMessageEvent.lastEventId")}} {{readonlyinline}}
- : Représente, dans un [server-sent events](en-US/docs/Server-sent_events/Using_server-sent_events), le dernier ID de l'évenement source.
- {{domxref("ExtendableMessageEvent.source")}} {{readonlyinline}}
- : Retourne une référence vers le service worker qui envoie le message.
- {{domxref("ExtendableMessageEvent.ports")}} {{readonlyinline}}
- : Retourne un tableau contenant l'objet {{domxref("MessagePort")}} représentant les ports associés au canal de messagerie.
## Méthodes
_Hérite des méthodesde son parent, {{domxref("ExtendableEvent")}}_.
## Exemples
Le code suivant est utilisé dans un service worker pour répondre à un message push en envoyant les données reçues via {{domxref("PushMessageData")}} au contexte principale via un [channel message](/en-US/docs/Web/API/Channel_Messaging_API), l'objet d'évènement du `onmessage` sera un `ExtendableMessageEvent`.
```js
var port;
self.addEventListener('push', function(e) {
var obj = e.data.json();
if(obj.action === 'subscribe' || obj.action === 'unsubscribe') {
port.postMessage(obj);
} else if(obj.action === 'init' || obj.action === 'chatMsg') {
port.postMessage(obj);
}
});
self.onmessage = function(e) {
console.log(e);
port = e.ports[0];
}
```
## Spécifications
| Spécification | Statut | Commentaireaire |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- |
| {{SpecName('Service Workers', '#extendablemessage-event-interface', 'ExtendableMessageEvent')}} | {{Spec2('Service Workers')}} | Définition initiale. |
## Compatibilités des navigateurs
{{Compat("api.ExtendableMessageEvent")}}
## Voir aussi
- [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)
- [Les serviceWorker sont-ils prêts?](https://jakearchibald.github.io/isserviceworkerready/)
- [Cannal de Messagerie](/en-US/docs/Web/API/Channel_Messaging_API)
|
