Ferramentas de desenvolvimento

Consulta Browserslist

Veja as versões selecionadas e compare duas regras. Abra a explicação para entender cada etapa.

consulta Browserslist

Consulta A

Versões de destino

Digite uma consulta em A.

As consultas são processadas no navegador, sem envio nem armazenamento.

Opções e dados

Somente texto de consulta. Separe por vírgulas ou novas linhas; # inicia um comentário.

Por entrada: 10.000 caracteres e 100 condições. Limite do worker: 5 segundos.

Retrato global incluído, não tráfego ao vivo nem audiência do seu site. Recarregar não atualiza a base.

Browserslist 4.28.9 · caniuse-lite 1.0.30001810 · Baseline 2.11.21

Resolvendo destinos…

Uma alteração na configuração Browserslist pode ampliar a lista de navegadores compatíveis sem deixar isso óbvio no código. A consulta Browserslist ajuda a revisar o resultado antes do build, principalmente quando a regra mistura vírgulas, and e exclusões.

Os identificadores e intervalos vêm do motor oficial, sem simplificação dos nomes. Se a máquina local, a CI e um playground discordarem, confira também as dependências. Percentuais parecidos não garantem que as versões dos navegadores selecionadas sejam as mesmas.

Entenda uma consulta Browserslist antes de alterar o build

Veja como o conjunto se forma

A explicação da consulta Browserslist mostra quantos destinos restam após cada condição. Vírgula e or fazem união, and cruza com todo o conjunto anterior e not remove correspondências. A expansão de defaults revela as condições por trás desse nome curto.

Filtros acrescentam cartões de navegadores à lista e retiram os cartões excluídos.

Confira mudanças que o total não revela

Use A para a regra atual e B para a proposta. Adicionados aparecem apenas em B, removidos apenas em A e comuns nas duas listas. A comparação considera navegador e versão completos, preservando os intervalos de Safari em vez de inventar registros de patches.

Dois conjuntos de cartões de navegadores mostram os elementos comuns no centro e os exclusivos nas laterais.

Confira três detalhes antes de exportar

01

Separe as regras do ambiente desejado

Aceitamos texto separado por vírgulas ou quebras de linha; # inicia um comentário. Uma linha terminada em and ou or continua na próxima linha com conteúdo. Extraia as consultas de package.json: o objeto inteiro e os cabeçalhos de ambiente não são aceitos.

02

Escolha o sentido da comparação

A começa com defaults. Ative a comparação para abrir B com last 2 versions. Adicionados são B menos A; removidos são A menos B. Essas contagens representam pares de navegador e versão, e não pontos percentuais de cobertura.

03

Aguarde o resultado atualizado

O modo automático espera 350 ms sem edição. Desative-o para usar o botão ou Ctrl/Cmd + Enter. Qualquer mudança bloqueia a exportação imediatamente. A tela mostra lotes de 50, mas o arquivo JSON guarda o relatório completo.

Sintaxe, destinos e origem dos dados

Seleção pelo motor oficial

Aliases, intervalos, últimas versões, ESR, limites globais, cover e o mapeamento Baseline incluído usam o parser oficial. A composição segue a ordem das condições; não há a precedência habitual de and sobre or das expressões booleanas.

Explicação ligada ao texto

Expanda A ou B para ler cada condição, a linha original, a operação e o total acumulado. defaults mostra sua expansão. Isso explica a escolha dos destinos, sem afirmar que todas as funcionalidades dos navegadores foram testadas.

Relatório com versões

O JSON reúne entrada original e normalizada, todos os destinos, etapas, diferenças, cobertura global, três versões de pacotes e horário da execução. Esse horário indica quando o cálculo ocorreu, não quando a estatística foi publicada ou atualizada.

Erros claros e substituição reversível

Versões desconhecidas e condições indisponíveis causam erro, sem ignorar filtros. Carregar o exemplo ou limpar apresenta uma prévia e a quantidade de caracteres. Depois de aplicar, desfazer uma vez restaura as entradas e o relatório anterior.

O que a lista permite concluir

Cobertura baseada em dados incluídos
O cálculo usa o retrato global de caniuse-lite distribuído com a página. Não é tráfego ao vivo nem a audiência do seu site. Recarregar não atualiza a base. Compare os números dos pacotes; regras com datas relativas dependem também do relógio do aparelho.
Sem configuração ou estatísticas externas
extends, browserslist config, JSON, seções de ambiente, países e estatísticas próprias são recusados. Cole apenas as consultas desejadas. A ferramenta não procura arquivos do projeto nem baixa pacotes de configuração ou dados de contas de análise.
Somente destinos de navegador
Node.js, Electron e current node não são aceitos. Consultas supports também não estão disponíveis neste build para navegador. Baseline usa o mapeamento incluído; a lista não prova que seu site, CSS, JavaScript ou polyfills funcionam em aparelhos reais.
Respeito aos registros de versão
Versões desconhecidas geram erro e o histórico móvel não é substituído pelo de desktop. ios_saf 15.6-15.8 representa um intervalo da base, não todos os patches detalhados. O valor especial all pertence ao Opera Mini.
Limites de entrada e resultados vazios
Cada entrada aceita 10.000 caracteres e 100 condições, com interrupção do worker após cinco segundos. Uma interseção vazia válida pode ser exportada. Limpar A remove o relatório; B precisa de uma consulta quando a comparação está ligada.

Dúvidas sobre a consulta Browserslist

Como vejo os navegadores escolhidos pela configuração?

Cole em A as regras do ambiente desejado. Para conferir a busca real de arquivos e a seleção do ambiente, execute npx browserslist no projeto. Aqui uma consulta Browserslist explícita permite guardar o resultado com as versões dos dados exibidas na tela.

O que acontece quando não existe configuração?

A CLI usa defaults se não encontrar configuração. Nesta página ele já vem preenchido: > 0.5%, last 2 versions, Firefox ESR, not dead. Ao limpar a entrada, a área permanece vazia, sem reaplicar essa regra silenciosamente.

É preciso atualizar a base de navegadores regularmente?

No projeto, use o procedimento atual de update-browserslist-db e revise as mudanças no lockfile e na lista de destinos. Os dados desta página mudam somente em um novo build. Um relatório com versões ajuda a explicar resultados diferentes no futuro.

Por que not and_uc all não funciona?

all é uma versão especial do Opera Mini, não um curinga universal. Para excluir UC Android, use uma condição válida, como defaults, not and_uc > 0. Antes de not deve haver uma consulta positiva formando o conjunto do qual as versões serão retiradas.

Por que last 2 versions pode incluir navegadores antigos?

A regra escolhe as últimas versões de cada família registrada, não os dois navegadores mais recentes no total. Famílias abandonadas e históricos móveis esparsos podem surpreender. Compare a lista com uma regra que contenha not dead; exemplos de problemas antigos talvez não apareçam mais nos dados atuais.

Por que informar um patch de iOS não retorna o esperado?

Can I Use costuma agrupar versões de iOS em intervalos. ios >= 15.7.2 não cria registros de patches ausentes. Confira os intervalos ios_saf retornados, use versões presentes na base e teste separadamente os aparelhos que precisam de suporte.

Resultado inesperado?

Revise a próxima mudança de configuração

Mantenha a consulta Browserslist atual em A e coloque a proposta em B. Confira inclusões e remoções antes de salvar o relatório.