Chapter 5 · Chapitre 5 · Tutoriel : formater et vérifier le code automatiquement
5.2 Le script du hook, ligne par ligne
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeVoici le script complet de la démonstration, à enregistrer dans .claude/hooks/verifier.mjs :
// Hook PostToolUse (Edit|Write) : formate le fichier que Claude vient de modifier avec Prettier.
import { execFileSync } from 'node:child_process';
import { extname, basename, join } from 'node:path';
// Prettier installé dans le projet, lancé sans shell
const PRETTIER = join(process.env.CLAUDE_PROJECT_DIR || '.', 'node_modules', 'prettier', 'bin', 'prettier.cjs');
let entree = '';
for await (const morceau of process.stdin) entree += morceau;
const fichier = JSON.parse(entree).tool_input?.file_path;
// seuls les fichiers que Prettier sait lire
if (!fichier || !['.js', '.mjs', '.css', '.html', '.json', '.md'].includes(extname(fichier))) process.exit(0);
try {
execFileSync(process.execPath, [PRETTIER, '--write', fichier], { stdio: 'pipe' });
console.log(JSON.stringify({
hookSpecificOutput: { hookEventName: 'PostToolUse', additionalContext: `✓ ${basename(fichier)} vérifié et formaté par Prettier` },
}));
} catch (e) {
const erreur = String(e.stderr || e.message).split('\n').find((l) => l.includes('SyntaxError')) || 'erreur inconnue';
console.error(`✗ ${basename(fichier)} : Prettier n'a pas pu le lire. ${erreur.replace(/^\[error\]\s*/, '').trim()}`);
process.exit(2);
}
Ce que fait chaque partie
- Lire l'événement : le script accumule le texte reçu sur stdin, le transforme en objet et récupère
tool_input.file_path. - Ignorer ce qui ne le concerne pas : une image ou un fichier inconnu ? Sortie immédiate avec 0, sans rien faire.
- Lancer Prettier : avec
--write, Prettier réécrit le fichier proprement. On l'appelle directement avec Node, sans passer par un shell. Le chemin du fichier n'est donc jamais interprété comme une commande, ce qui est plus sûr. - En cas de succès : un JSON
additionalContextinforme Claude. - En cas d'échec : si le code est invalide, Prettier ne peut pas le lire. Le script extrait la ligne « SyntaxError », l'écrit sur stderr et sort avec 2. Claude voit l'erreur et peut corriger.
Les détails qui comptent
process.execPath: le chemin exact du programme Node qui exécute le script. On relance donc Prettier avec le même Node, sans dépendre duPATH(la liste des dossiers où le système cherche les programmes).join(process.env.CLAUDE_PROJECT_DIR || '.', ...): on cherche Prettier à la racine du projet fournie par Claude Code, ou dans le dossier courant pour les tests à la main.{ stdio: 'pipe' }: on capture ce que Prettier affiche, au lieu de le laisser se mélanger à notre propre sortie. C'est indispensable, car notre stdout doit contenir seulement le JSON.extname(fichier): l'extension du fichier, comme.js. La liste blanche (seules les extensions autorisées passent) évite de lancer Prettier sur une image ou un fichier.env.JSON.stringify: le JSON est fabriqué par un encodeur, jamais à la main.
Pourquoi un script plutôt qu'une ligne ?
La doc propose une version en une ligne, à mettre directement dans "command" :
f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown "$f"
Elle marche très bien sur macOS et Linux, mais elle demande jq et un shell bash. --ignore-unknown dit à Prettier d'ignorer les fichiers qu'il ne connaît pas. Le script Node fonctionne partout où Node est installé, et il transforme proprement l'erreur de Prettier en message utile pour Claude.
Fais-le relire avant de l'activer
Même pour un script fourni dans une formation, prends l'habitude :
Explique-moi ligne par ligne .claude/hooks/verifier.mjs : quels fichiers
il peut modifier, quelles commandes il lance, s'il utilise un shell,
et s'il envoie des données hors de ma machine. Ne modifie rien.
Tu dois retrouver : il modifie seulement le fichier reçu (si son extension est dans la liste), il lance seulement Prettier, sans shell, et n'envoie rien sur Internet.
Si ça coince
- « Cannot find module …prettier.cjs ». Prettier n'est pas installé dans le projet, ou
CLAUDE_PROJECT_DIRpointe ailleurs. Relancenpm install --save-dev prettierà la racine. - « Cannot use import statement outside a module ». Le fichier doit finir par
.mjs, pas.js. - Le message d'erreur dit « erreur inconnue ». Prettier a échoué pour une autre raison qu'une erreur de syntaxe. Affiche temporairement
e.stderrcomplet sur stderr pour comprendre. - Le JSON de succès est ignoré. Quelque chose d'autre écrit sur stdout : garde
stdio: 'pipe'.
À retenir
- Le script lit
file_path, filtre par extension, lance Prettier sans shell. - Succès : exit 0 +
additionalContext. Code cassé : exit 2 + message sur stderr. - Stdout ne doit contenir que le JSON.
- Fais expliquer chaque script avant de l'activer, même celui-ci.