Le 8 juillet 2026, GitHub a publié npm 12 et en a fait la version par défaut. Le changement le plus important depuis des années : npm install n’exécute plus les scripts d’installation de tes dépendances sans ton accord. Les dépendances Git et les URL distantes sont elles aussi bloquées par défaut.

📦 npm🔒 Chaîne d’approvisionnement🛠️ Guide de migration⏱️ 7 min de lecture

Pendant plus de quinze ans, chaque npm install a pu lancer du code arbitraire venu de n’importe quelle dépendance, même indirecte. C’est précisément la porte qu’ont utilisée les vers comme Shai-Hulud. Avec npm 12, cette porte est fermée par défaut.

Dans ce guide, tu vas voir ce qui change exactement dans npm 12, ce qui risque de casser dans tes projets, et la marche à suivre pour migrer sans mauvaise surprise.

npm 12 : les scripts d’installation des dépendances sont bloqués par défaut
Avec npm 12, un postinstall non approuvé ne s’exécute plus.
⚠️
À retenir

si ton projet dépend d’un paquet qui compile du code natif ou télécharge un binaire à l’installation (esbuild, sharp, bcrypt, sqlite3…), il faudra l’approuver explicitement avec npm 12, sinon il ne fonctionnera pas correctement.

npm 12 en bref : les 3 changements par défaut

Le journal des changements de GitHub, publié le 9 juin 2026, annonçait trois comportements qui passent d’« autorisé » à « bloqué par défaut ». npm 12 les active.

ComportementAvant npm 12Avec npm 12
Scripts preinstall, install, postinstall des dépendancesExécutés automatiquementBloqués sauf approbation (allowScripts)
Dépendances Git (directes ou indirectes)RésoluesRefusées sauf --allow-git
Dépendances depuis une URL distante (tarball https)RésoluesRefusées sauf --allow-remote

Deux précisions importantes du changelog : les builds natifs node-gyp sont bloqués eux aussi, même quand le paquet ne déclare aucun script mais contient un fichier binding.gyp. Et les scripts prepare des dépendances Git, fichier ou lien sont traités de la même façon.

ℹ️
Bon à savoir

seuls les scripts de tes dépendances sont concernés. Les scripts de ton propre package.json (build, test, postinstall de ton projet) continuent de fonctionner normalement.

npm 12 : scripts preinstall, install et postinstall bloqués par défaut
npm 12 : ce qui est bloqué par défaut

Pourquoi npm 12 bloque les scripts d’installation

Un script postinstall s’exécute avec les droits de l’utilisateur qui lance npm install, sur ton poste comme dans ta CI. Si un seul paquet de ton arbre de dépendances est compromis, il peut lire tes fichiers .env, voler tes jetons npm ou GitHub et se propager. GitHub qualifie ces scripts de plus grande surface d’exécution de code de l’écosystème npm.

Plusieurs attaques récentes sur la chaîne d’approvisionnement npm ont exploité cette mécanique pour se propager. npm rattrape ainsi pnpm et Bun, qui bloquaient déjà les scripts des dépendances par défaut.

Ce qui risque de casser dans tes projets

Les paquets à binaireesbuild, sharp, swc… téléchargent un exécutable dans leur postinstall.
Les modules natifsbcrypt, sqlite3, canvas… se compilent via node-gyp.
Les dépendances Gitun "lib": "github:moi/lib" dans package.json est refusé.
Les tarballs distantsune dépendance pointant vers une URL https est refusée.

Le piège : un script bloqué n’empêche pas l’installation de se terminer. npm affiche un avertissement, puis l’erreur n’apparaît qu’au moment où ton application utilise le paquet incomplet.

Migrer vers npm 12 en 5 étapes

Étape 1 : vérifier ta version de npm

npm -v
# installer npm 12 globalement
npm install -g npm@12
Terminal
npm 12 : approuver un paquet avec npm approve-scripts
Approuver un paquet de confiance avec npm 12

Si tu préfères préparer le terrain avant de passer à npm 12, le changelog indique que les trois changements sont visibles sous forme d’avertissements dès npm 11.16.0.

Étape 2 : lancer une installation et lire les avertissements

Lance ton npm install habituel. Chaque paquet dont le script a été bloqué est listé dans un avertissement install-scripts, avec le script concerné (par exemple postinstall: node install.js).

Étape 3 : lister les paquets en attente

npm approve-scripts --allow-scripts-pending
Terminal

Cette commande affiche tous les paquets dont les scripts ne sont couverts par aucune règle. Prends le temps de vérifier pourquoi chacun a besoin d’un script : un paquet de formatage de dates n’a aucune raison d’exécuter du code à l’installation.

Étape 4 : approuver ce qui est légitime, refuser le reste

# autoriser un paquet de confiance
npm approve-scripts esbuild

# refuser explicitement un paquet
npm deny-scripts nom-du-paquet
Terminal

Ta liste d’autorisations est enregistrée dans ton package.json, dans un champ allowScripts. Par exemple :

{
  "dependencies": {
    "esbuild": "^0.25.0"
  },
  "allowScripts": {
    "[email protected]": true
  }
}
package.json

Étape 5 : versionner et adapter la CI

Commite le package.json mis à jour : c’est lui qui garantit que ta CI et tes collègues obtiennent le même comportement. Dans ta CI, fige aussi la version de npm pour ne pas changer de comportement par surprise quand latest bouge.

- uses: actions/setup-node@v4
  with:
    node-version: 22
- run: npm install -g npm@12
- run: npm ci
.github/workflows/ci.yml

Les dépendances Git et les URL distantes

Si ton projet utilise une dépendance Git, l’installation échoue désormais avec une erreur EALLOWGIT. Deux solutions : publier la bibliothèque sur un registre (la plus propre), ou l’autoriser explicitement.

# autoriser les dépendances Git pour cette installation
npm install --allow-git=all

# même logique pour les tarballs distants
npm install --allow-remote=all
Terminal
💡
Conseil

n’autorise pas --allow-git=all « pour que ça marche ». Chaque dépendance Git échappe aux vérifications du registre npm : remplace-les dès que possible par des paquets publiés.

Les bons réflexes à garder avec npm 12

  • Relis la liste allowScripts à chaque nouvelle dépendance, comme une revue de code.
  • Préfère npm ci en CI : il respecte exactement le package-lock.json.
  • Continue d’auditer tes dépendances : npm 12 limite l’exécution à l’installation, pas le code malveillant appelé par ton application.
  • Garde tes secrets hors du dépôt avec un fichier .env bien protégé.
  • Révise les commandes utiles avec notre antisèche des commandes npm.
Migrer vers npm 12 en 4 réflexes
Migrer vers npm 12 en 4 réflexes

FAQ

npm 12 bloque-t-il les scripts de mon propre projet ?

Non. Seuls les scripts preinstall, install et postinstall de tes dépendances sont bloqués. Les scripts définis dans ton propre package.json continuent de s’exécuter.

Mon installation réussit mais mon application plante : pourquoi ?

Un paquet dont le script a été bloqué est installé incomplètement (binaire manquant, module natif non compilé). Lis les avertissements install-scripts et approuve le paquet avec npm approve-scripts.

Où est stockée la liste des paquets autorisés ?

Dans le champ allowScripts de ton package.json. Il faut le committer pour que toute l’équipe et la CI aient le même comportement.

Comment installer une dépendance Git avec npm 12 ?

Avec l’option –allow-git, par exemple npm install –allow-git=all. Mieux vaut toutefois publier la bibliothèque sur un registre et l’installer comme un paquet classique.

npm 12 : le résumé à retenir

  • Depuis le 8 juillet 2026, npm 12 ne lance plus les scripts d’installation des dépendances sans approbation.
  • Les dépendances Git et les URL distantes sont refusées par défaut.
  • npm approve-scripts --allow-scripts-pending liste ce qui est bloqué, npm approve-scripts autorise, npm deny-scripts refuse.
  • La liste d’autorisations vit dans le package.json et doit être commitée.

Conclusion

npm 12 ne rend pas l’écosystème JavaScript invulnérable, mais il supprime le moyen le plus simple de compromettre une machine de développeur : un postinstall caché dans une dépendance. La migration demande quelques minutes par projet, à condition de lire les avertissements plutôt que de tout autoriser en bloc.

Sources

Comments

No comments yet. Why don’t you start the discussion?

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *