API Push

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2023.

En savoir plus
Voir la compatibilit complte

Note : Cette fonctionnalit est disponible via les Web Workers.

L'API Push permet aux applications web de recevoir des messages pousss depuis un serveur, que l'application soit active au premier plan, charge, ou non. Ceci permet de fournir des notifications asynchrones et des alertes/mises jour pour les personnes qui souhaitent en recevoir, crant l'opportunit d'tre au courant rapidement.

Concepts et usages de Push

Attention : Lorsqu'on implmente des abonnements via PushManager, il est primordial de se protger contre les attaques CSRF/XSRF. Pour plus d'informations, voir les articles suivants :

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 ncessaire l'envoi des donnes.

Le service worker sera alors dmarr pour rceptionner les messages push via le gestionnaire d'vnement onpush. Ainsi, l'application peut ragir aux messages push reus, par exemple en affichant une notification avec ServiceWorkerRegistration.showNotification().

Chaque abonnement est propre un service worker. Le point d'accs correspondant pour l'abonnement est une URL fonctionnelle (capability URL) unique. Il suffit de connatre ce point d'accs pour envoyer un message votre application. L'URL du point d'accs doit donc rester secrte, afin d'viter que d'autres applications puissent envoyer des messages push vers votre application.

L'activation d'un service worker ncessaire la rception du message push peut accrotre l'utilisation des ressources, particulirement de la batterie. Chaque navigateur adopte une stratgie diffrente pour grer cette consommation, sans qu'il y ait actuellement de mcanisme standard. Firefox impose un quota de messages push pouvant tre envoys une application (cependant, les messages push utiliss pour les notifications sont exempts de cette limite). Le quota est rinitialis chaque visite sur le site. Chrome n'impose pas de limite particulire.

Interfaces

PushEvent: Reprsente une action push envoye la porte globale d'un ServiceWorker. Elle contient les informations envoyes 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'accs aux donnes transmises par le serveur, incluant des mthodes pour manipuler les donnes reues.
PushSubscription: Fournit l'URL de l'abonnement au point d'accs et permet galement le dsabonnement.
PushSubscriptionOptions: Reprsente les options associes l'abonnement.

Ajouts l'API Service Worker

Les ajouts l'API Service Worker suivants ont t spcifis dans l'API Push, pour fournir un point d'entre l'utilisation de messages Push pour surveiller et rpondre aux vnements de changement lis aux messages Push et aux souscriptions.

ServiceWorkerRegistration.pushManager Lecture seule: Fournit une rfrence l'interface une rfrence de l'interface PushManager permettant de grer les abonnements push (crer un nouvel abonnement, obtenir l'abonnement existant, connatre l'tat des permissions, se dsabonner). Il s'agit du point d'entre vers l'API Push.
onpush: Un gestionnaire d'vnement dclench chaque vnement push ; c'est--dire chaque message push reu depuis le serveur.
onpushsubscriptionchange: Un gestionnaire d'vnement dclench chaque vnement pushsubscriptionchange ; par exemple, quand un abonnement push a t invalid, ou va l'tre (par exemple, quand un service push dfinit une dure d'expiration).