Publicado em 16 de julho de 2026
A partir do Chrome 152, os Progressive Web Apps (PWAs) instalados no macOS terão as notificações atribuídas nativamente ao próprio PWA, em vez do Google Chrome.
Essa é uma melhoria significativa na experiência do usuário, tornando os apps da Web mais integrados ao macOS. No entanto, ela também introduz mudanças importantes na forma como as permissões de notificação são processadas e como algumas APIs de notificação se comportam.
O que muda?
Antes, todas as notificações enviadas por PWAs eram atribuídas ao Chrome no nível do SO. No Centro de Notificações do macOS, elas apareciam em "Google Chrome" e usavam o ícone do Chrome. Para desativar as notificações, os usuários precisavam usar controles no Chrome, não nas configurações do sistema macOS.
Com a atribuição de notificações, quando um site é instalado como um PWA, o macOS o trata como um aplicativo distinto para notificações. Isso se aplica a PWAs recém-instalados e a PWAs que o usuário já tinha instalado.
Benefícios:
- Identidade da marca: as notificações mostram o nome e o ícone do PWA no Centro de Notificações e nos banners do macOS.
- Controles de usuário conhecidos: os controles de notificação desses apps agora aparecem exatamente onde os usuários esperam: nas configurações do sistema macOS (não no Chrome).
- Controle granular: os usuários podem gerenciar as configurações de notificação de apps PWA individuais (por exemplo, estilos de alerta, comportamento da tela de bloqueio).
- Modos de foco: os PWAs podem ser permitidos ou silenciados individualmente nos perfis de foco do macOS (Não perturbe).
O novo fluxo de permissão
Como o macOS agora trata o PWA como um app separado, o PWA precisa receber permissão de notificação no nível do SO antes de poder mostrar notificações. Isso muda o fluxo de permissão para usuários novos e atuais.
Novos usuários (solicitação de permissão pela primeira vez)
Se um usuário instalar um PWA e o site solicitar permissão de notificação após a instalação:
- O Chrome vai pular o prompt de permissão no nível do navegador (o menu suspenso da barra de endereço).
- O Chrome vai acionar imediatamente o prompt de permissão do sistema macOS para o PWA.
Usuários atuais (caminho de migração)
Se um usuário já tiver concedido permissão de notificação ao seu site no Chrome e instalar (ou já tiver instalado) o PWA, ele ainda precisará conceder permissão no nível do SO ao PWA.
Para tornar essa transição o mais tranquila possível:
- Na primeira vez que o PWA tentar enviar uma notificação, o macOS vai mostrar o prompt de permissão do sistema.
- Se o usuário aprovar, as notificações vão continuar funcionando sem problemas.
- Se o usuário ignorar ou dispensar esse prompt, o PWA vai mostrar um indicador no app (normalmente na barra de título ou no menu do app) orientando-o às configurações do sistema macOS para ativar as permissões manualmente.
Impacto do desenvolvedor: descontinuação de requireInteraction no macOS
No macOS, se uma notificação permanece na tela até que o usuário a dispense ("Permanente") ou desaparece automaticamente ("Temporária") é uma configuração controlada pelo usuário e por app nas configurações do sistema macOS.
Devido a esse design do SO, o Chrome não vai mais respeitar a
requireInteraction opção na API Notification no macOS quando a atribuição
estiver ativa.
O que isso significa para seu código:
Se o app depende de requireInteraction: true para manter notificações importantes na tela, isso não será mais garantido no macOS. Em vez disso, você deve:
- Projete seu app presumindo que as notificações podem ser temporárias (Temporárias).
- Incentive os usuários que precisam de notificações permanentes a configurar o estilo de alerta de notificação do PWA como "Permanente" em
System Settings > Notifications > [Your PWA].
Impacto do desenvolvedor: a API App Badging requer permissão de notificação
A API App Badging permite que os apps da Web definam um selo no ícone do aplicativo (por exemplo, mostrando uma contagem de mensagens não lidas). No macOS, a identificação do ícone do app está tecnicamente vinculada às configurações de notificação do aplicativo. Como o PWA agora tem a própria identidade de notificação nativa:
- Permissão necessária: o PWA precisa ter a permissão de notificação no nível do SO ativada para que o selo apareça no ícone do Dock. Isso está alinhado aos padrões da plataforma macOS e corresponde à forma como o Safari já processa a API Badging para apps da Web.
- Falha silenciosa: se o usuário desativar "Ícone do app de selo" em
System Settings > Notifications > [Your PWA], ou negar a permissão de notificação completamente, as chamadas paranavigator.setAppBadge()ainda serão bem-sucedidas no JavaScript (sem gerar um erro), mas o selo não será mostrado no Dock. Se o app depende de identificação, peça permissão de notificação para garantir que o selo possa ser mostrado.
Impacto da administração empresarial
Para administradores empresariais que gerenciam dispositivos macOS e querem conceder permissões de notificação antecipadamente:
- Política do Chrome: ainda é necessário configurar a política do Chrome
(
NotificationsAllowedForUrls) para conceder permissão à origem do PWA. - Política do macOS: além disso, agora é necessário implantar um perfil de configuração do macOS (MDM) para conceder permissões de notificação antecipadamente ao identificador do pacote do PWA (shim do app).
Sem as duas políticas, os usuários ainda vão receber um prompt no nível do SO.
Práticas recomendadas para desenvolvedores
- Verificar o status da permissão: sempre verifique
Notification.permissionantes de enviar uma notificação. - Prompts contextuais: se você detectar que a permissão foi concedida no nível da Web , mas as notificações não estão aparecendo (o que pode acontecer se a permissão no nível do SO for revogada), oriente o usuário às configurações do sistema macOS.
- Preparar notificações temporárias: não dependa de
requireInteractionpara fluxos de usuários críticos no macOS.