Node Modules et npm Expliqués pour les Ingénieurs QA

npm est le gestionnaire de paquets qui télécharge Playwright, TypeScript et toutes les autres dépendances de votre projet de tests. node_modules est le dossier où ces paquets résident sur le disque, et il ne doit jamais être committé dans le dépôt Git.

Ce qu'est npm

1. Maintient un registre de paquets JavaScript (plus de 2 millions)

2. Télécharge ces paquets dans votre projet

3. Suit quels paquets votre projet nécessite

Quand quelqu'un écrit du code utile (comme le framework Playwright), il le publie sous forme de paquet sur npm. Tout le monde peut ensuite installer ce paquet au lieu de réécrire le même code. Playwright, TypeScript, ESLint, Faker.js, dotenv : ce sont tous des paquets npm qui alimentent votre setup d'automatisation.

Le fichier package.json

Chaque projet Node.js a un fichier package.json. C'est le descripteur du projet : il indique ce qu'il est, ce dont il a besoin et comment l'exécuter.

Un package.json typique pour un projet Playwright ressemble à ceci :

{
  "name": "my-playwright-tests",
  "version": "1.0.0",
  "scripts": {
    "test": "npx playwright test",
    "test:headed": "npx playwright test --headed",
    "test:ui": "npx playwright test --ui"
  },
  "devDependencies": {
    "@playwright/test": "^1.44.0",
    "typescript": "^5.4.5"
  }
}

• name : le nom du projet
• scripts : les commandes exécutables avec npm run
• devDependencies : paquets nécessaires en développement (outils de test, linters)
• dependencies : paquets nécessaires en production (non pertinent pour un projet de tests uniquement)

dependencies vs. devDependencies

| | dependencies | devDependencies |

|---|---|---|

| Quand utilisé | En production (exécution de l'app) | En développement seulement (build, tests, lint) |

| Exemples | express, react, axios | playwright, typescript, eslint |

| Flag d'installation | npm install nom-du-paquet | npm install -D nom-du-paquet |

Pour les dépôts d'automatisation QA, presque tout va dans devDependencies. Vous construisez des outils de test, pas une application de production.

Le dossier node_modules

Quand vous lancez npm install, npm :

1. Lit package.json

2. Télécharge tous les paquets listés depuis le registre npm

3. Les place dans node_modules/

4. Installe aussi toutes leurs dépendances (et les dépendances de leurs dépendances...)

C'est pour ça que node_modules peut contenir des milliers de fichiers même pour un projet avec seulement 3 dépendances directes. Playwright, par exemple, embarque des dizaines de paquets dont il dépend en interne.

Vous ne touchez jamais directement les fichiers dans node_modules. Ils sont gérés par npm.

Vous ne committez jamais node_modules dans Git. Le dossier peut peser des centaines de mégaoctets. À la place, vous committez package.json et package-lock.json, et chaque personne qui clone le dépôt lance npm install pour le régénérer.

Vérifiez votre .gitignore :

node_modules/

Cette ligne doit s'y trouver. Si elle est absente, ajoutez-la.

package-lock.json

Quand npm installe des paquets, il crée ou met à jour package-lock.json. Ce fichier enregistre les versions exactes de chaque paquet installé, y compris les dépendances transitives.

Committez package-lock.json dans Git. Contrairement à node_modules, ce fichier est petit et déterministe.

Les commandes npm essentielles

# Installer toutes les dépendances listées dans package.json
npm install

# Installer un paquet spécifique et l'ajouter à devDependencies
npm install -D @faker-js/faker

# Installer un paquet spécifique et l'ajouter à dependencies
npm install dotenv

# Supprimer un paquet
npm uninstall @faker-js/faker

# Mettre à jour tous les paquets vers leurs dernières versions compatibles
npm update

# Vérifier les paquets avec des vulnérabilités de sécurité connues
npm audit

# Corriger les vulnérabilités automatiquement (quand c'est possible)
npm audit fix

# Exécuter un script défini dans package.json
npm run test
npm run test:headed

# Lister tous les paquets installés
npm list --depth=0

# Voir la version d'un paquet spécifique
npm list playwright

La commande npx

# Lancer le test runner Playwright (utilise la version locale dans node_modules)
npx playwright test

# Installer les navigateurs Playwright
npx playwright install

# Ouvrir le mode UI de Playwright
npx playwright test --ui

# Lancer le codegen
npx playwright codegen https://lab.becomeqa.com

Quand vous exécutez npx playwright test, npm trouve Playwright dans votre dossier local node_modules/.bin/ et le lance. Cela garantit que vous utilisez la version spécifique du projet, pas une version installée globalement.

Créer un nouveau projet Playwright from scratch

# Créer et accéder à un nouveau répertoire
mkdir my-test-project && cd my-test-project

# Initialiser le projet npm (crée package.json)
npm init -y

# Installer Playwright
npm init playwright@latest

# C'est tout — Playwright s'installe avec ses dépendances

Pour ajouter Playwright à un projet existant :

npm install -D @playwright/test
npx playwright install

Problèmes courants et solutions

Erreur "Cannot find module"

Error: Cannot find module '@playwright/test'

Navigateurs Playwright obsolètes

Error: Executable doesn't exist at /home/user/.cache/ms-playwright/chromium-XXX

Vulnérabilités de sécurité

found 3 vulnerabilities (1 moderate, 2 high)

Conflits dans node_modules après un git pull

Si quelqu'un a mis à jour les dépendances, votre node_modules local peut être obsolète :

rm -rf node_modules
npm install

C'est l'option radicale, mais elle fonctionne toujours.

Pourquoi les versions ont ^ et ~

Dans package.json :

"@playwright/test": "^1.44.0"

| Symbole | Signification | Exemple |

|---|---|---|

| ^1.44.0 | Compatible avec 1.44.0 (met à jour mineur et patch) | Accepte 1.45.0, 1.50.0 mais pas 2.0.0 |

| ~1.44.0 | Approximativement 1.44.0 (met à jour le patch uniquement) | Accepte 1.44.1, 1.44.9 mais pas 1.45.0 |

| 1.44.0 | Exactement 1.44.0 | Aucune mise à jour |

Pour les projets d'automatisation de tests, ^ (caret) est le standard. Il vous maintient à jour avec les améliorations mineures tout en vous protégeant des changements majeurs.

Ce que doit savoir un ingénieur QA

• Ce que fait npm install et quand le lancer (toujours après avoir cloné, après qu'on a mis à jour package.json)
• Ce que contient package.json et comment le lire
• La différence entre dependencies et devDependencies
• Comment fonctionne npm run test (il lance le script test de package.json)
• Pourquoi node_modules n'est pas committé dans Git

C'est suffisant pour configurer des projets, installer des dépendances, lancer des tests et déboguer les problèmes de setup les plus courants.