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

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 89and_uc 12.12chrome 89chrome 88chrome 87edge 89edge 88firefox 86ie 11ios_saf 14.0-14.5ios_saf 13.4-13.7safari 14safari 13.1samsung 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.