Como escolher a meta de referência

Publicado em: 20 de maio de 2025

Quando um recurso da plataforma Web é implementado em todos os navegadores, ele se torna "Recém-disponível na linha de base". Após 30 meses, esse recurso se torna a versão de referência amplamente disponível, que é um limite em que a maioria dos sites pode adotar recursos sem problemas de compatibilidade. Neste guia, explicamos como usar o valor de referência e, com os dados disponíveis dos usuários do seu site, como selecionar uma meta de valor de referência.

O que é uma meta de valor de referência?

Uma meta de linha de base é um agrupamento de recursos da Web que os desenvolvedores podem escolher oferecer suporte com base no status da linha de base. Há dois tipos de metas de comparativo de mercado: móveis e fixas.

As metas móveis, como "Disponível para todos" ou "Recém-disponível", são aquelas em que o conjunto de recursos pode mudar com o tempo. Alvos móveis fazem sentido quando você quer que o conjunto de recursos compatíveis evolua automaticamente à medida que novas versões do navegador são lançadas.

As metas fixas são aquelas em que o conjunto de recursos não muda com o tempo. Em geral, as metas fixas são baseadas em anos civis. Por exemplo, Valor de referência de 2023 é uma meta fixa que contém o conjunto de recursos da Web que se tornaram o valor de referência recém-disponível em 2023. O valor de referência de 2023 não inclui recursos que se tornaram o valor de referência depois de 2023. Isso significa que o conjunto de recursos do valor de referência de 2023 nunca muda.

As metas fixas são úteis quando a previsibilidade e o determinismo são fundamentais, mas podem ficar desatualizadas com o tempo. Por isso, é recomendável reavaliar sua meta regularmente.

Por que escolher uma meta?

A adoção de recursos na Web é prejudicada por problemas de compatibilidade, o que impede que a Web seja tão boa quanto poderia ser. A Baseline não apenas esclarece a questão do suporte a recursos em navegadores, mas também ajuda a entender quando você pode usar determinados recursos. Ao escolher uma segmentação que reflita seu público-alvo e requisitos, você pode usar os recursos desse grupo com confiança, sem precisar verificar cada um deles.

Usar dados para selecionar sua meta de referência

Sempre que possível, a escolha da meta de comparativo de mercado certa deve ser baseada em dados. Quando você tem os dados em mãos, fica mais fácil e fundamentada a decisão de qual meta selecionar.

Se você tiver dados de monitoramento de usuários reais do seu site, saiba como as metas de comparativo de mercado são mapeadas para seus usuários. Por exemplo, se você usa o Google Analytics, uma maneira sem custo financeiro de receber essas informações é usando o Verificador de valores de referência do Google Analytics.

Para usar, crie uma nova análise detalhada no Google Analytics, adicione algumas métricas e dimensões ao relatório e exporte-o como um arquivo TSV. Esse processo está detalhado nestas instruções. Ao importar o arquivo TSV para o verificador, você vai receber uma saída semelhante a esta:

A ferramenta de verificação de valor de referência do Google Analytics mostrando uma análise detalhada do suporte para várias metas de valor de referência por porcentagem. O suporte aumenta de metas mais recentes para mais antigas.
A saída da ferramenta de verificação de valores de referência do Google Analytics. A ferramenta segmenta o suporte de usuários reais para cada meta de Baseline. Observe como as metas de base mais antigas têm mais suporte entre os usuários reais.

Estamos começando a ver outras ferramentas implementarem o suporte para a referência, o que pode dar uma visão dinâmica de quanto do seu público apoia uma determinada meta. Por exemplo, a RUMvision inclui um painel que mostra a porcentagem do seu público-alvo que tem suporte para cada ano de comparativo.

Os dados de referência da RUMvision mostram dados de suporte para cada meta de referência, incluindo um detalhamento dos dados de suporte no nível do recurso.

E se meu provedor de análise ou RUM ainda não tiver um relatório de meta de comparativo de mercado?

Se você estiver usando uma ferramenta de análise ou RUM que ainda não oferece um relatório de meta de comparativo de mercado, mas tem dados sobre versões de navegador, poderá combinar seus dados reais com mapeamentos de versão do navegador do módulo baseline-browser-mapping. O módulo fornece uma função JavaScript, getAllVersions(), que mapeia navegadores por nome e versão para o ano de referência e o status de suporte para "Amplamente disponível". Esses mapeamentos podem ser fornecidos como matrizes, objetos com chaves ou um CSV. Por exemplo, o verificador de valores de referência do Google Analytics usa esse módulo para combinar dados do Analytics com metas de valor de referência.

As saídas dessa função também estão disponíveis como arquivos JSON ou CSV hospedados, que são atualizados diariamente. O arquivo all_versions_with_supports.csv contém dados que podem ser correspondidos aos dados da versão do navegador dos seus provedores de análise com os seguintes campos:

  • browser: o nome do navegador usado em baseline-browser-mapping
  • version: a versão do navegador. Alguns navegadores usam apenas um número de versão principal, outros usam um número de versão major.minor.
  • year: o conjunto de recursos do ano de referência compatível com esta versão do navegador. Se uma versão do navegador foi lançada antes que o suporte da linha de base pudesse ser determinado em julho de 2015, esse campo vai conter pre_baseline.
  • supports: esse campo contém widely ou newly para versões de navegador que oferecem suporte a esses conjuntos de recursos e fica vazio para versões que não oferecem suporte a nenhum deles. Todas as versões de navegador que oferecem suporte a "Recém-disponível" também oferecem suporte a "Disponível para todos".
  • release_date: a data de lançamento da versão do navegador, quando disponível.
  • engine: o nome do mecanismo para navegadores que são downstream de um navegador de base principal. Somente navegadores baseados no Blink estão incluídos, mas outros mecanismos de navegador podem ser representados no futuro.
  • engine_version: a versão do Chromium implementada por esta versão do navegador. Isso é usado para determinar qual conjunto de recursos de linha de base a versão downstream oferece suporte.

Esse arquivo é atualizado com frequência à medida que novas versões do navegador são lançadas e o status de suporte de diferentes navegadores muda. Atualize os dados diariamente.

E se eu não tiver dados de suporte de usuários reais?

Você pode se encontrar em uma situação em que não é possível acessar dados de usuários reais quando se trata de recursos que são de linha de base. A boa notícia é que você pode ter uma ideia geral do suporte para diferentes metas de Baseline usando os Insights do arquivo RUM, que permitem filtrar até o nível do país. Embora esses dados não sejam específicos para os usuários do seu site, É uma ferramenta informativa geral que demonstra que as seguintes proposições são geralmente seguras:

  • As metas de valor de referência mais recentes, como o ano atual ou o ano anterior, provavelmente terão menos apoio entre seus usuários. No entanto, como qualquer meta de comparativo de mercado, elas terão um suporte melhor com o tempo.
  • As metas de referência mais antigas, principalmente a "Referência disponível para todos", terão suporte adequado. Em caso de dúvida, "Amplamente disponível" é uma excelente meta que evolui conforme a janela de 30 meses avança com o tempo.
  • Até mesmo as metas de referência mais antigas, que estão muito além da janela de 30 meses de disponibilidade geral, terão o melhor suporte. Embora "Disponibilidade geral" seja uma boa opção padrão, há casos de uso especiais que exigem SLAs rigorosos.

É provável que, mesmo que você selecione uma meta de base com mais de cinco anos, seja possível adotar recursos que você não está usando no momento. No melhor cenário, você já está usando esses recursos, mas com polyfills que talvez não sejam necessários.

Como faço para aplicar uma meta de valor de referência escolhida no meu projeto?

O Browserslist é um método usado com frequência para segmentar os navegadores que você quer oferecer suporte. Ele é usado em bundlers e outras ferramentas associadas, como Babel e PostCSS, para decidir se determinados bits de código precisam ser transformados ou até mesmo preenchidos.

Agora é possível usar o Baseline com o Browserslist para que, ao selecionar uma meta de Baseline, você possa especificá-la como uma consulta válida do Browserslist. Isso garante que as ferramentas no projeto transformem o código de acordo com o destino selecionado. Para mais informações, leia Usar o valor de referência com o Browserslist.

E os recursos que não atendem à minha meta de valor de referência?

Depois de selecionar uma meta de valor de referência, talvez você tenha recursos que quer usar, mas que não se enquadram nessa meta. O valor de referência não informa o que você deve fazer aqui, e se você quer considerar o uso desses recursos depende do tipo de site que está criando e do público-alvo esperado.

Por exemplo, sites de e-commerce ou B2B podem ter um limite de suporte menor e lidar com problemas à medida que os usuários os apoiam, enquanto sites governamentais podem exigir um limite de suporte alto. Uma regra importante aqui é que nem todos os recursos da Web falham da mesma forma. Há muitas maneiras de categorizar os recursos com base em como eles falham, mas uma maneira de agrupar recursos que podem ser úteis é assim:

  • Melhoria:se o recurso for usado em um navegador não compatível, a experiência não será interrompida. A experiência pode ser degradada, mas provavelmente não será perceptível para o usuário. Exemplo: loading="lazy".
  • Aditivo:o recurso oferece alguns benefícios aditivos que podem ser perceptíveis, como mudanças no estilo da página ou em alguma funcionalidade. A diferença pode não ser perceptível para os usuários se o recurso não for compatível, impedindo a comparação em um navegador que seja compatível. Exemplo: Subgrid
  • Crítico:se o recurso não for compatível, o usuário terá uma experiência negativa, talvez até mesmo uma experiência totalmente interrompida. Exemplo: a API File System Access usada como um recurso central e necessário.

Você também pode descobrir que recursos específicos fora da sua meta têm mais suporte do que você imagina. É possível entender quantos usuários têm suporte para um recurso específico. O Can I Use pode verificar a compatibilidade de recursos individuais com seus dados de análise. A RUMvision também pode detalhar e analisar dados no nível do recurso, se isso for útil para você.

Assim, você pode usar a meta de valor de referência para reduzir o número de recursos que precisam ser considerados com cuidado. Não se preocupe com nada dentro da sua meta. Se houver um ou dois recursos fora da sua meta que seriam especialmente úteis, você terá as ferramentas para explorar mais e decidir se quer usar polyfill ou aprimoramento progressivo.

Conclusão

Cada aplicativo da Web tem requisitos diferentes, desde um site de e-commerce que pode tolerar mais problemas de incompatibilidade até um site governamental que precisa estar disponível e operacional para o maior número possível de usuários. Esses cálculos precisam ser feitos por você. O objetivo do Baseline não é dizer quais decisões tomar ao adotar novos recursos da Web, mas sim como.