API Push

Para uma aplicação receber mensagens push, ela precisa ter um service worker (en-US) ativo. Quando o service worker está ativo, ele pode se inscrever para utilizar notificações push PushManager.subscribe() (en-US).

O resultado de PushSubscription (en-US) inclui toda informação que a aplicação precisa para receber uma mensagem push: um endpoint e a chave encriptada necessária para o envio de dados.

O service worker será iniciado conforme o necessário para lidar com as mensagens recebidas, que são entregues ao manipulador de evento ServiceWorkerGlobalScope.onpush . Isto permite que a aplicação reaja a cada mensagem recebida, por exemplo para exibir a notificação ao usuário (usando ServiceWorkerRegistration.showNotification() (en-US).)

Cada assinatura é única para um service worker. O endpoint para a assinatura é uma capability URL única: o conhecimento do endpoint é tudo que é necessário para enviar uma mensagem para sua aplicação. A URL do endpoint precisa ser mantida em segredo, ou outras aplicações estranhas poderão enviar mensagens push para a sua aplicação.

A ativação de um service worker para entregar mensagens push pode resultar em um aumento de uso de recursos, particularmente de bateria. Diferentes navegadores tem diferentes formas para lidar com isso — atualmente não existe uma forma padrão. Firefox permite um número limitado (cota) de mensagens push para serem enviadas para uma aplicação, embora as mensagens Push que gerem notificações são isentas deste limite. O limite é atualizado a cada site visitado. Numa comparação, Chrome não aplica nenhum limite, mas requer que cada mensagem push exiba uma notificação.

PushEvent (en-US)

Representa uma ação push enviada para o global scope (en-US) de um ServiceWorker (en-US). Ele contém informações enviadas de uma aplicação para um PushSubscription (en-US).

PushManager

Fornece uma forma de receber notificações de servidor third-party bem como solicitar URL para notificações push. Essa interface substitui a funcionalidade oferecida que está obsoleta PushRegistrationManager interface.

PushMessageData (en-US)

Fornece acesso aos dados push enviados por um servidor, e inclui métodos para manipular os dados recebidos.

PushSubscription (en-US)

Fornece a URL de assinatura do endpoint e permite o cancelamento da assinatura de um serviço push.

As seguintes informações adicionais para a Service Worker API foram especificadas na Push API spec, para fornecer um ponto de entrada para usar mensagens Push, e para monitorar e responder os eventos de envio e assinatura.

ServiceWorkerRegistration.pushManager (en-US) Somente leitura

Retorna uma referência para a interface PushManager para administrar assinaturas push incluindo subscrever, obter uma assinatura ativa e acessar o status de permissão de envio. Este é o ponto de entrada para usar mensagens Push.

ServiceWorkerGlobalScope.onpush

Um manipulador de eventos disparado sempre que um evento push ocorre; isto é, sempre que uma mensagem do servidor de envio for recebida.

ServiceWorkerGlobalScope.onpushsubscriptionchange

Um manipulador de eventos disparado sempre que um evento pushsubscriptionchange ocorre; por exemplo, quando uma assinatura push está inválida, ou está prestes a ser invalidada (ex. quando um serviço push service define um tempo de expiração.)

• Usando Push API (en-US)
• Push API Demo, no Github
• Push Notifications on the Open Web, Matt Gaunt
• Service Worker API