Data de publicação: 30/04/2026

🎯 Objetivo

Orientar como evitar que a aba do WebApp entre em hibernação no navegador e explicar o impacto desse comportamento na conexão com o AppServer. (TDN TOTVS Developer Network)

🧩 Ambiente

TOTVSTEC – SmartClient HTML – WebApp
A página técnica consultada está na trilha de migração do SmartClient Desktop para o WebApp e foi modificada em 13/08/2025. (TDN TOTVS Developer Network)

🔎 Visão geral

Os navegadores modernos possuem mecanismos de economia de memória que colocam páginas sem uso em estado de hibernação. Quando isso acontece com a aba do WebApp, a conexão entre o WebApp e o AppServer é interrompida. (TDN TOTVS Developer Network)

Para evitar esse comportamento, a TOTVS orienta configurar o navegador para manter o endereço do WebApp como site sempre ativo, impedindo que a aba seja suspensa automaticamente. A documentação cita orientações específicas para Google Chrome, Microsoft Edge e Mozilla Firefox. (TDN TOTVS Developer Network)

⚙️ Como evitar a hibernação da aba

1. Identifique a URL do WebApp

Antes de iniciar a configuração, confirme qual é o endereço utilizado pelos usuários para acessar o WebApp no ambiente.

2. Ajuste o navegador para manter o site ativo

A orientação geral da TOTVS é incluir o endereço do WebApp na lista de sites que não devem hibernar. Esse ajuste impede que o navegador suspenda a aba por economia de memória. (TDN TOTVS Developer Network)

3. Aplique a configuração conforme o navegador homologado

Google Chrome

No Chrome, a TOTVS orienta utilizar a configuração de sites sempre ativos, adicionando o endereço do WebApp à lista correspondente. (TDN TOTVS Developer Network)

Microsoft Edge

No Edge, o procedimento é semelhante ao do Chrome. A própria documentação informa para localizar a opção relacionada aos sites que nunca devem dormir e incluir o endereço do WebApp. (TDN TOTVS Developer Network)

Mozilla Firefox

No Firefox, o ajuste indicado é alterar o parâmetro browser.tabs.unloadOnLowMemory para false, evitando o descarregamento de abas inativas por baixa memória. (TDN TOTVS Developer Network)

⚠️ O que acontece quando a aba hiberna

Quando a aba do navegador com Protheus ou Logix entra em hibernação, ocorre interrupção da comunicação com o AppServer. Para tratar isso, a TOTVS informa que a partir do WebApp 10.1.3 foi implementado um mecanismo de aviso ao usuário, indicando a necessidade de aplicar a configuração preventiva no navegador. (TDN TOTVS Developer Network)

Na prática, isso ajuda a tornar o problema mais visível ao usuário final, mas não substitui a configuração correta do navegador.

✅ Resultado esperado

Após configurar o navegador para manter o endereço do WebApp como ativo, a aba deixa de entrar em hibernação com facilidade, reduzindo o risco de perda de conexão entre WebApp e AppServer durante o uso do sistema. (TDN TOTVS Developer Network)

💡 Boas práticas

• aplicar a configuração em todas as estações que acessam o WebApp;

• padronizar a URL exata do ambiente em produção, homologação e testes;

• revisar esse ajuste após atualização ou reinstalação do navegador;

• orientar os usuários sobre o impacto da hibernação da aba;

• validar a versão do WebApp quando houver relato recorrente de perda de sessão.

❓ FAQ

1. Por que a aba do WebApp não pode hibernar?

Porque, segundo a TOTVS, quando a página entra em hibernação a conexão entre o WebApp e o AppServer é interrompida. (TDN TOTVS Developer Network)

2. Quais navegadores são citados na documentação?

A página menciona Google Chrome, Microsoft Edge e Mozilla Firefox como navegadores com orientação para impedir a hibernação. (TDN TOTVS Developer Network)

3. Como evitar o problema no Chrome e no Edge?

Incluindo o endereço do WebApp na lista de sites que devem permanecer ativos, sem entrar em suspensão. (TDN TOTVS Developer Network)

4. Como evitar o problema no Firefox?

Alterando o parâmetro browser.tabs.unloadOnLowMemory para false. (TDN TOTVS Developer Network)

5. O WebApp possui algum aviso quando a aba hiberna?

Sim. A partir do WebApp 10.1.3, a TOTVS informa que foi implementado um mecanismo de aviso ao usuário. (TDN TOTVS Developer Network)

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”