Início·Mensagens de erro

npm · npm

A mensagem

npm WARN EBADENGINE Unsupported engine

O que significa

Algum pacote declara um intervalo de engines para node ou npm que o seu ambiente não satisfaz — o npm apenas avisa e instala do mesmo jeito. Acontece quando você está num node antigo instalado como pacote do sistema, ou quando o projeto passou para um node mais novo que o do seu shell. Troque o node para uma versão dentro do intervalo impresso com o seu gerenciador de versões; o que vale é o .nvmrc do projeto ou o campo engines do package.json. Por padrão é só um aviso, mas com engine-strict=true no .npmrc a mesma condição se torna um erro que interrompe a instalação.

A correção

Não há um comando de uma linha. A explicação diz o que verificar.

Impresso por
npm
npm
20

No npm a causa está na primeira linha code XXXX e não nas seis últimas linhas npm ERR!, e quando a falha vem da árvore de dependências ou de uma compilação nativa em vez do seu código, apagar node_modules e instalar de novo resolve metade dos casos.

Como ler uma mensagem de erro

  • Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
  • Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
  • Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
  • A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
  • Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.

Perguntas frequentes

Q. O que significa “npm WARN EBADENGINE Unsupported engine”?

Algum pacote declara um intervalo de engines para node ou npm que o seu ambiente não satisfaz — o npm apenas avisa e instala do mesmo jeito. Acontece quando você está num node antigo instalado como pacote do sistema, ou quando o projeto passou para um node mais novo que o do seu shell. Troque o node para uma versão dentro do intervalo impresso com o seu gerenciador de versões; o que vale é o .nvmrc do projeto ou o campo engines do package.json. Por padrão é só um aviso, mas com engine-strict=true no .npmrc a mesma condição se torna um erro que interrompe a instalação.

Q. Como corrigir?

Não há comando de uma linha. A explicação acima diz o que verificar.

Q. Qual ferramenta imprime isso?

npm. Fica em npm e a mensagem tem 5 palavras.

Erros próximos