API Push

Pour qu'une application web puisse recevoir des messages push, elle doit disposer d'un service worker actif. Quand le service worker est actif, on peut souscrire aux notifications push en utilisant PushManager.subscribe().

Cet abonnement fournira un objet PushSubscription contenant toutes les informations dont l'application a besoin pour transmettre un message push : un point de terminaison et la clé de chiffrement nécessaire à l'envoi des données.

Le service worker sera alors démarré pour réceptionner les messages push via le gestionnaire d'évènement onpush. Ainsi, l'application peut réagir aux messages push reçus, par exemple en affichant une notification avec ServiceWorkerRegistration.showNotification().

Chaque abonnement est propre à un service worker. Le point d'accès correspondant pour l'abonnement est une URL fonctionnelle (capability URL) unique. Il suffit de connaître ce point d'accès pour envoyer un message à votre application. L'URL du point d'accès doit donc rester secrète, afin d'éviter que d'autres applications puissent envoyer des messages push vers votre application.

L'activation d'un service worker nécessaire à la réception du message push peut accroître l'utilisation des ressources, particulièrement de la batterie. Chaque navigateur adopte une stratégie différente pour gérer cette consommation, sans qu'il y ait actuellement de mécanisme standard. Firefox impose un quota de messages push pouvant être envoyés à une application (cependant, les messages push utilisés pour les notifications sont exempts de cette limite). Le quota est réinitialisé à chaque visite sur le site. Chrome n'impose pas de limite particulière.

PushEvent

Représente une action push envoyée à la portée globale d'un ServiceWorker. Elle contient les informations envoyées depuis le serveur d'application vers l'objet PushSubscription responsable du traitement.

PushManager

Permet de recevoir des notifications de serveurs tiers et de demander les URL pour les notifications push.

PushMessageData

Fournit l'accès aux données transmises par le serveur, incluant des méthodes pour manipuler les données reçues.

PushSubscription

Fournit l'URL de l'abonnement au point d'accès et permet également le désabonnement.

PushSubscriptionOptions

Représente les options associées à l'abonnement.

Les ajouts à l'API Service Worker suivants ont été spécifiés dans l'API Push, pour fournir un point d'entrée à l'utilisation de messages Push pour surveiller et répondre aux évènements de changement liés aux messages Push et aux souscriptions.

ServiceWorkerRegistration.pushManager Lecture seule

Fournit une référence à l'interface une référence de l'interface PushManager permettant de gérer les abonnements push (créer un nouvel abonnement, obtenir l'abonnement existant, connaître l'état des permissions, se désabonner). Il s'agit du point d'entrée vers l'API Push.

onpush

Un gestionnaire d'événement déclenché à chaque évènement push ; c'est-à-dire à chaque message push reçu depuis le serveur.

onpushsubscriptionchange

Un gestionnaire d'événement déclenché à chaque évènement pushsubscriptionchange ; par exemple, quand un abonnement push a été invalidé, ou va l'être (par exemple, quand un service push définit une durée d'expiration).

Le livre de recettes pour les service workers contient différents exemples d'utilisation de l'API Push.

• Envoyer des notifications WebPush identifiées avec VAPID grâce au service Push de Mozilla (en anglais)
• Démo API Push sur GitHub
• Aperçu général des notifications push (en anglais)
• L'API Service Worker