Da mensagem enviada ao aviso na tela
As notificações push são avisos apresentados no dispositivo a partir de mensagens enviadas por um servidor. Na web, esse envio usa uma inscrição de push criada pelo navegador com a permissão necessária. A inscrição fornece um endereço de destino e as informações de criptografia que a aplicação utiliza para enviar a mensagem pelo serviço de push.
O navegador encaminha a mensagem recebida a um service worker, um script que pode executar tarefas mesmo com a página fechada. No tratamento do evento push, o script pode chamar showNotification() para apresentar o aviso. O recebimento da mensagem e sua apresentação na tela são etapas diferentes da implementação.
Exemplo de apresentação pelo service worker
Este exemplo didático apresenta um aviso de tarefa atualizada quando chega uma mensagem de push. O código fica no service worker e pressupõe seu registro ativo e uma inscrição válida. A apresentação exige permissão para notificações e um ambiente seguro, como uma página HTTPS.
self.addEventListener('push', (event) => { event.waitUntil( self.registration.showNotification('Tarefa atualizada', { body: 'Abra o painel para consultar o andamento.' }) )})O título e o corpo do aviso são fixos neste exemplo, portanto o código não interpreta o conteúdo da mensagem recebida. O método waitUntil() prolonga o tratamento do evento até a conclusão da promessa de showNotification(). A conclusão dessa promessa não comprova que o destinatário leu o aviso.
Você pode conferir separadamente a resposta do serviço de push e o tratamento do evento no navegador. A mensagem ainda depende da conectividade do dispositivo e das condições de execução da plataforma. Também é necessário acompanhar inscrições desativadas para que novos envios utilizem um destino válido.
Dúvidas frequentes
Perguntas frequentes sobre notificações push
- Uma página precisa permanecer aberta para receber Web Push?
- A Push API permite receber mensagens com a página fechada. O navegador pode iniciar o service worker para processá-las, conforme o suporte da plataforma e suas condições de execução.
- Uma resposta de sucesso confirma que o aviso apareceu?
- A resposta 201 do serviço Web Push confirma a aceitação da mensagem. O recebimento no navegador e a apresentação da notificação acontecem depois e precisam de acompanhamento próprio.
- Uma inscrição permanece válida indefinidamente?
- A inscrição pode expirar ou ser desativada. A revogação da permissão também a desativa. A aplicação precisa atualizar o destino armazenado quando houver uma nova inscrição.
Para continuar
Recursos relacionados
Documentação
MDN: recebimento de mensagens Web Push
Explica a inscrição, o endereço de envio e o recebimento de mensagens pelo service worker.
Abrir recursoAplicação na formação
n8n Experts
Uma automação que envia avisos precisa usar inscrições válidas e acompanhar a resposta do serviço de push.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.