Ir para o conteúdo principal
Version: 2.0.0-beta.9

Suporte ao navegador

O Docusaurus permite que os sites definam a lista de navegadores suportados através da configuração de lista de navegadores.

Propósito

Os sites precisam se equilibrar entre compatibilidade com versões anteriores e tamanho do pacote. Como navegadores antigos não suportam APIs ou sintaxe moderna, mais código é necessário para implementar a mesma funcionalidade, penalizando todos os outros usuários com maior tempo de carregamento do site. Como compensação, o empacotador Docusaurus só oferece suporte a versões de navegador definidas na lista de navegadores.

A lista de navegadores por padrão é fornecida através do arquivo package.json como um campo raiz browserslist.

caution

Em navegadores antigos, a saída compilada usará sintaxe JS não suportada (muito recente) fazendo com que React falhe inicializar e acabar com um site estático com apenas HTML/CSS e sem JS.

Valores padrão

Websites inicializados com o modelo clássico padrão tem o seguinte conteúdo no package.json:

package.json
{
"name": "docusaurus",
// ...
"browserslist": {
"production": [">0.5%", "not dead", "not op_mini all"],
"development": [
"last 1 chrome version",
"last 1 firefox version",
"last 1 safari version"
]
}
// ...
}

Explicado em linguagem natural, os navegadores com suporte na produção são os seguintes:

  • Com mais de 0,5% de market share; e
  • Tem suporte oficial ou atualizações nos últimos 24 meses (o oposto de "dead"); e
  • Não é Opera Mini.

E os navegadores usados em desenvolvimento são:

  • A versão mais recente do Chrome ou Firefox ou Safari.

Você pode "avaliar" qualquer configuração com o browserlist cli para obter a lista atual:

npx browserslist --env="production"

A saída são todos os navegadores com suporte na produção. Abaixo está a saída em maio, 2021:

and_chr 89
and_uc 12.12
chrome 89
chrome 88
chrome 87
edge 89
edge 88
firefox 86
ie 11
ios_saf 14.0-14.5
ios_saf 13.4-13.7
safari 14
safari 13.1
samsung 13.0

Leia mais

Você pode querer visitar a documentação de lista de navegadores para obter mais especificações, especialmente os valores de consulta e as melhores práticas aceitas.