
Atraso de 300 ms no Suspense do React trava o carregamento de widgets
O problema
A extensão Tab Widgets, um painel para a nova aba do Chrome e do Edge, é construída com React 19 e Rspack. Cada widget fica em um chunk de código próprio e é carregado com React.lazy, dentro de um Suspense próprio. Como a extensão começa do zero a cada nova aba, o painel demorava para preencher, e a primeira suposição do autor, Matthew Wong, foi de que o bundle era grande demais.
A suposição não se confirmou. Em um build de produção no Chromium headless, todos os scripts eram carregados e avaliados em cerca de 100 ms, mas os widgets só apareciam por volta de 380 ms. Nesse intervalo, o navegador quase não fazia nada. Como os arquivos da extensão são lidos do disco local, centenas de kilobytes a mais custam pouco. Mover a biblioteca de data luxon para fora do arquivo principal, de 283 KB, deixou o arquivo menor, mas não mudou quando nada aparecia, e a alteração foi revertida.
A causa: duas regras do React
O atraso vem da combinação de dois comportamentos do React:
- Um componente
React.lazysempre suspende na primeira renderização, mesmo que o código já esteja carregado, porque a resposta chega por uma promise que só resolve depois dessa renderização. Chamarimport()antes também não resolve, pois o componente inicia o próprio import ao renderizar. - O React limita a revelação de conteúdo que suspendeu. Quando ele fica pronto, só é revelado após 300 ms desde o último fallback exibido ou trocado em qualquer ponto da página (
FALLBACK_THROTTLE_MS). A intenção é evitar piscadas quando muitas partes terminam de carregar em tempos parecidos. No caso da extensão, porém, o conteúdo fica pronto quase de imediato. Há uma discussão no GitHub sobre tornar o valor configurável, e os mantenedores, até agora, mantiveram a heurística fixa.
Assim, cada widget mostrava o placeholder e esperava pelo menos 300 ms. Como o temporizador é compartilhado pela página, os widgets também apareciam em lotes. Envolver a renderização em startTransition não resolveu, porque um Suspense montado pela primeira vez ainda exibe o fallback.
Primeira tentativa: pré-carregar
A primeira solução chamava _init do componente antes da renderização, para iniciar o import cedo. Isso reduziu o tempo dos widgets de cerca de 380 ms para cerca de 95 ms no headless. O autor, porém, aponta uma fragilidade: um widget cujo código demora mais que o limite de espera de 100 ms ainda suspende, e pode aparecer até 100 ms depois do que apareceria sem a espera. Também houve uma regressão, com o foco do teclado perdido ao fechar o modal Add widget, corrigida pré-carregando os modais quando a página fica ociosa.
Solução adotada: não suspender
A versão final evita a suspensão. Cada widget verifica se o código já foi carregado. Se não foi, mostra o placeholder como conteúdo comum e inicia o carregamento. Quando o código chega, uma atualização de estado comum troca o placeholder pelo widget. Como nada suspende, a regra de 300 ms não se aplica. O autor reconhece a contrapartida: os widgets aparecem um a um, e não em lote. Ele considera isso aceitável porque cada moldura tem tamanho fixo na grade, e o placeholder a preenche, sem deslocamento ao trocar.
A verificação de permissão usada por cinco widgets também deixou de ser uma consulta com suspense e passou a ser uma consulta comum, que dura alguns milissegundos.
O autor reconhece o uso de propriedades privadas do React (_init, _payload). Por isso, a implementação tem fallback: se essas propriedades mudarem, os componentes são tratados como carregados e a renderização volta ao comportamento original. Também há uma versão sem campos privados, baseada em um cache próprio de módulos.
Resultados
As medições foram feitas no Chrome 154 em um Windows 11 desktop, com 4 novas abas por versão, em um painel de 20 widgets (16 visíveis, sem login). Os valores são médias:
- Primeiro conteúdo de widget: 540 ms para 298 ms (−242 ms), com todos os widgets aparecendo de uma vez antes.
- 85% do conteúdo: 540 ms para 336 ms (−204 ms).
- Todo o conteúdo: 540 ms para 544 ms (+4 ms, dentro do ruído).
- Barra de navegação: 274 ms para 326 ms (+52 ms). O autor explica que ela faz parte da mesma primeira renderização e apenas se revela mais tarde por causa da animação de 150 ms. Em execuções headless baseadas em DOM, o atraso foi de cerca de 11 ms, dentro da variação entre execuções.
Weather e Word of the Day continuam atrasados, porque, após carregar o código, suspendem de novo ao buscar dados. Segundo o autor, a correção tratou apenas o carregamento de código, não o de dados, e esses dois widgets são o próximo passo.
O autor afirma abrir cerca de 107 novas abas por dia. Com cerca de 200 ms de ganho por aba, estima cerca de 20 segundos por dia, ou aproximadamente duas horas por ano.
Lições
O autor destaca quatro pontos: medir quando as coisas aparecem, e não apenas o tamanho dos arquivos; procurar períodos ociosos da thread principal; conhecer o comportamento intencional do framework, já que a limitação de 300 ms é um padrão razoável para evitar piscadas, mas prejudica páginas em que o conteúdo está pronto quase de imediato; e confirmar resultados de laboratório em máquinas reais.