Voltar
Como medir Web Vitals em soft navigations com o SDK do Sentry

Sentry JavaScript SDK v11 mede Web Vitals em soft navigations

Aprofundamento CEVIU

Aprofundamento

Até agora, Web Vitals no Sentry descreviam basicamente quem chegava ao site vindo de fora. O JavaScript SDK v11 muda isso: com Chrome reportando métricas para soft navigations, o SDK captura LCP, CLS e INP para cada navegação do lado do cliente. Vem ligado por padrão para quem usa v11 com browserTracingIntegration, e depende de span streaming, também padrão na v11. Quem preferir um único conjunto de vitals para a vida inteira da página pode usar Sentry.webVitalsIntegration({ softNavigations: false }).

O Chrome define soft navigation com três critérios: iniciada por ação do usuário, com mudança visível de URL e com pintura visível. Essas heurísticas não são finais. Por enquanto, só o Chromium 151 e posteriores reporta, e o próprio navegador decide o que conta, independentemente do router. No app da Sentry, cerca de três em quatro mudanças de rota no Chrome se qualificam. TTFB, FP e FCP continuam só para page loads.

Cada métrica ganha o atributo browser.navigation.type, e o dashboard ganha o filtro "Measured on" (page loads, soft navigations, bfcache restores e prerenders). Os relógios são diferentes: o do page load começa na requisição do documento, o da soft navigation começa na interação do usuário. Por isso o dashboard esconde os limites good/poor nessa visão. No app da Sentry, o p75 de LCP é 2,48 s em todas as navegações e 1,17 s só nas soft navigations. O app não ficou mais rápido, a mistura mudou.

O que mudou

Em 25 de setembro de 2026, o CEVIU noticiou "Sentry Lança Ferramenta Essencial para Monitoramento do Cache Back/Forward e Otimização da Experiência do Desenvolvedor", sobre a bfcacheMetricsIntegration. Segundo a Sentry, essas métricas dizem se o botão voltar foi instantâneo. Agora, a v11 traz os web vitals da própria navegação, incluindo restaurações de bfcache e soft navigations. São medições diferentes e complementares.

Por que isso importa

Para quem opera uma SPA, isso significa enxergar rotas como configurações ou o segundo passo do checkout, que quase nunca recebem page load e ficavam sem dados. Também exige cuidado: ao atualizar, os números gerais tendem a melhorar sem ganho real, e dashboards duplicados e alertas antigos precisam de ajuste. Para manter um alerta de page loads, o caminho é excluir soft-navigation e back-forward-cache, em vez de listar valores específicos.

Linha do tempo

  1. CEVIU noticia a bfcacheMetricsIntegration da Sentry para medir o cache back/forward.

  2. Sentry JavaScript SDK v11 passa a medir LCP, CLS e INP em soft navigations, exigindo Chromium 151 ou posterior.

Perguntas frequentes

Preciso configurar algo para medir Web Vitals em soft navigations?

Não. Com o SDK v11 e browserTracingIntegration, a medição vem ligada por padrão. Ela usa span streaming, também padrão na v11. Para desligar, use Sentry.webVitalsIntegration({ softNavigations: false }).

Quais navegadores reportam soft navigations?

Por enquanto, só Chromium 151 e posteriores. Os números descrevem apenas essa parcela dos usuários. Cada navegador pode implementar heurísticas próprias no futuro.

Por que meus números de LCP melhoraram depois de atualizar?

Soft navigations pulam a requisição do documento e costumam ser mais rápidas. Elas entram na mesma média das page loads. Use o filtro "Measured on" para separar os dois tipos.

Quais métricas valem para soft navigations?

Cada soft navigation tem seu próprio LCP, CLS e INP. TTFB, FP e FCP só são reportados em page loads.

Fontes

Avalie este artigo:
Categoria
CEVIU Web Dev
Publicado
30 de outubro de 2026
Editoria
CEVIU Web Dev

Quer receber mais sobre CEVIU Web Dev?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser