Accueil·Messages d’erreur

npm · npm

Le message

npm WARN EBADENGINE Unsupported engine

Ce que cela veut dire

Un paquet déclare une plage engines pour node ou npm que votre environnement ne satisfait pas — npm se contente d'avertir et installe quand même. Cela arrive quand vous êtes sur un vieux node installé comme paquet système, ou quand le projet est passé à un node plus récent que celui de votre shell. Basculez node vers une version comprise dans la plage affichée avec votre gestionnaire de versions ; la référence est le .nvmrc du projet ou le champ engines de package.json. Ce n'est qu'un avertissement par défaut, mais avec engine-strict=true dans .npmrc la même condition devient une erreur qui interrompt l'installation.

Le correctif

Pas de commande en une ligne ici. L’explication dit où regarder.

Émis par
npm
npm
20

Avec npm, la cause tient dans la première ligne code XXXX et non dans les six dernières lignes npm ERR!, et quand la panne vient de l'arbre de dépendances ou d'une compilation native plutôt que de votre code, supprimer node_modules puis réinstaller en règle environ la moitié.

Lire un message d’erreur

  • Lisez à partir de la première ligne. Plus on descend, plus il s’agit des entrailles de l’outil ; la cause est généralement en haut.
  • S’il y a un fichier et un numéro de ligne, commencez là — pas la première image de la pile, mais la ligne la plus haute qui nomme un fichier de vous.
  • Cherchez le message tel quel, mais retirez d’abord vos chemins et vos noms de variables : c’est cela qui empêche la correspondance.
  • La même situation se formule autrement selon la version de l’outil. Si les résultats sonnent faux, ajoutez le numéro de version.
  • Avant de coller un correctif, vérifiez ce qu’il jette. Certains sont irréversibles.

Questions fréquentes

Q. Que veut dire « npm WARN EBADENGINE Unsupported engine » ?

Un paquet déclare une plage engines pour node ou npm que votre environnement ne satisfait pas — npm se contente d'avertir et installe quand même. Cela arrive quand vous êtes sur un vieux node installé comme paquet système, ou quand le projet est passé à un node plus récent que celui de votre shell. Basculez node vers une version comprise dans la plage affichée avec votre gestionnaire de versions ; la référence est le .nvmrc du projet ou le champ engines de package.json. Ce n'est qu'un avertissement par défaut, mais avec engine-strict=true dans .npmrc la même condition devient une erreur qui interrompt l'installation.

Q. Comment le corriger ?

Pas de commande en une ligne. L’explication ci-dessus dit où regarder.

Q. Quel outil émet cela ?

npm. Cela relève de npm, et le message compte 5 mots.

Erreurs voisines