Por que o cursor em tempo real do Notion não aparece em alguns navegadores

Você pode notar que, ao colaborar em um documento do Notion, o cursor colorido que mostra onde seu colega está digitando não aparece em certos navegadores. Esse recurso de cursor em tempo real depende de conexões WebSocket e APIs específicas do navegador que nem todos suportam igualmente. Este artigo explica o motivo técnico por trás da ausência do cursor, lista quais navegadores são afetados e mostra como verificar a compatibilidade do seu navegador para que você possa mudar para um compatível, se necessário.

Por que o cursor em tempo real do Notion depende de WebSocket e SharedWorker

O recurso de colaboração em tempo real do Notion usa a tecnologia WebSocket para manter um canal de comunicação bidirecional persistente entre seu navegador e os servidores do Notion. Quando você move o cursor ou digita, seu navegador envia um pequeno pacote de dados por esse canal. Os navegadores dos outros colaboradores recebem o pacote e renderizam um cursor colorido na posição correspondente.

Para manter esse canal ativo mesmo quando você alterna entre guias ou minimiza a janela, o Notion também depende da API SharedWorker. Um SharedWorker é um script em segundo plano que é executado independentemente de qualquer guia individual do navegador. Ele mantém a conexão WebSocket para que seu cursor permaneça visível para outros mesmo se você navegar brevemente para fora da guia do Notion.

Alguns navegadores não possuem a API SharedWorker ou restringem como as conexões WebSocket são gerenciadas em scripts em segundo plano. Quando o SharedWorker não pode iniciar ou o handshake WebSocket falha, o Notion recorre a um mecanismo de polling que sincroniza as alterações apenas em intervalos de vários segundos. Nesse modo de fallback, os movimentos do cursor em tempo real não são transmitidos e o cursor colorido desaparece da visualização dos colaboradores.

Quais navegadores são totalmente compatíveis

O Notion oferece suporte oficial ao Google Chrome e ao Microsoft Edge (ambos baseados no motor Chromium) para exibição do cursor em tempo real. Esses navegadores implementam SharedWorker e WebSocket de acordo com a especificação W3C, sem restrições de segurança adicionais que bloqueiem a conexão. Usuários do Chrome 90 ou superior e Edge 90 ou superior verão cursores em tempo real sem nenhuma configuração manual.

Quais navegadores têm suporte limitado

Sabe-se que o Mozilla Firefox e o Apple Safari apresentam problemas intermitentes com os cursores em tempo real do Notion. O Firefox historicamente restringiu o tempo de vida do SharedWorker em certos modos de privacidade, fazendo com que o script em segundo plano seja encerrado após alguns minutos. O Safari, especialmente no iOS, limita as conexões WebSocket quando a guia não está ativa, o que impede o envio de atualizações do cursor. Em ambos os casos, o cursor parece congelado ou não aparece.

Passos para verificar e corrigir o cursor em tempo real no seu navegador

1. Abra o console do desenvolvedor do navegador
   Pressione Ctrl+Shift+J no Windows ou Cmd+Option+J no macOS para abrir o console. No Firefox, pressione Ctrl+Shift+K ou Cmd+Option+K.
2. Verifique se há erros de WebSocket
   Digite navigator.onLine no console e pressione Enter. Se retornar true, sua conexão de rede está ativa. Em seguida, procure por mensagens de erro vermelhas contendo as palavras “WebSocket” ou “SharedWorker”. Uma mensagem como “Falha na conexão WebSocket para ‘wss://…'” confirma que o navegador está bloqueando a conexão.
3. Verifique o suporte a SharedWorker
   Digite typeof SharedWorker no console e pressione Enter. Se o resultado for "undefined", seu navegador não suporta SharedWorker. Cursores em tempo real não funcionarão nesse navegador.
4. Mude para um navegador compatível
   Se você vir erros ou "undefined", instale o Google Chrome ou o Microsoft Edge. Abra a mesma página do Notion no novo navegador e confirme se o cursor colorido aparece quando um colaborador edita.
5. Desative extensões de privacidade do navegador
   No Firefox, vá em Configurações > Privacidade e Segurança > Proteção contra rastreamento aprimorada. Defina como “Padrão” ou adicione notion.so à lista de exceções. No Safari, vá em Safari > Ajustes > Privacidade e desmarque “Impedir rastreamento entre sites” se estiver ativado.

Se o Notion ainda não mostrar cursor após trocar de navegador

Cursor visível apenas no aplicativo para desktop, mas não no navegador

O aplicativo para desktop do Notion usa uma implementação nativa de WebSocket que ignora completamente as restrições do navegador. Se você vê cursores no aplicativo para desktop, mas não em nenhum navegador, o problema é específico do navegador. Continue usando o aplicativo para desktop para colaboração em tempo real ou atualize seu navegador para a versão mais recente.

Cursor aparece, mas congela após alguns minutos

Esse sintoma indica que o SharedWorker foi encerrado. No Firefox, abra about:config, pesquise por dom.workers.sharedWorkers.enabled e confirme que está definido como true. No Safari, certifique-se de que não ativou o modo “Navegação privada”, que desabilita completamente o SharedWorker.

Cursor aparece para alguns colaboradores, mas não para outros

Cada colaborador deve usar um navegador compatível. Peça para a pessoa que não consegue ver os cursores seguir as etapas de verificação acima. Se todos os colaboradores estiverem no Chrome e os cursores ainda falharem, pode haver um problema no lado do servidor do Notion. Verifique a página de status do Notion em status.notion.so para incidentes em andamento.

Suporte de navegador para cursor em tempo real do Notion: Comparação

Item	Google Chrome	Mozilla Firefox
Suporte a WebSocket	Completo	Completo
Suporte a SharedWorker	Completo	Parcial (desabilitado na Navegação Privada; pode encerrar após inatividade)
Cursor em tempo real visível	Sim	Não confiavelmente
Recomendado para colaboração no Notion	Sim	Não

O Apple Safari não está incluído na tabela porque seu comportamento varia significativamente entre as versões macOS e iOS. Em geral, o Safari no macOS tem suporte parcial a SharedWorker, enquanto o Safari no iOS não possui suporte algum. Para uma experiência consistente de cursor em tempo real, use Chrome ou Edge em todas as plataformas.

Agora você pode identificar se seu navegador suporta o cursor em tempo real do Notion verificando a disponibilidade de WebSocket e SharedWorker. Se o cursor estiver ausente, mude para o Google Chrome ou Microsoft Edge, ou use o aplicativo para desktop do Notion. Para solução de problemas avançada, desative extensões de privacidade que bloqueiam conexões WebSocket e verifique se seu navegador está atualizado.