Aller au contenu
Floskool

Chapitre 4 · Chapitre 4 · Ce que le hook reçoit et ce qu'il répond

4.4 Tester un hook à la main

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Inutile d'attendre que Claude modifie un fichier pour savoir si ton hook marche. Tu peux lancer la commande toi-même en lui envoyant un faux événement. C'est exactement ce qui a été fait pour la vidéo, et c'est la méthode que la doc recommande quand un hook renvoie une erreur.

1. Écris un événement de test

Crée evenement.json :

{
  "hook_event_name": "PostToolUse",
  "tool_name": "Write",
  "tool_input": { "file_path": "C:\\chemin\\vers\\mon-projet\\site\\menu.js", "content": "..." },
  "tool_response": { "filePath": "C:\\chemin\\vers\\mon-projet\\site\\menu.js", "type": "create" }
}

Remplace le chemin par celui d'un vrai fichier de ton projet. Dans un JSON, chaque \ s'écrit \\.

2. Envoie-le à la commande

Sous macOS ou Linux, la doc montre : echo '{...}' | ./mon-hook.sh puis echo $? pour voir le code de sortie.

Sous Windows, le plus fiable est l'invite de commandes classique (cmd), depuis la racine du projet :

set CLAUDE_PROJECT_DIR=%CD%
node .claude\hooks\verifier.mjs < evenement.json
echo %ERRORLEVEL%

La première ligne définit la variable que Claude Code fournit normalement au hook. Sans elle, le script cherche Prettier à partir du dossier courant, ce qui marche aussi si tu es bien à la racine.

Un piège rencontré pendant le tournage

Dans Windows PowerShell 5.1, la commande Get-Content evenement.json | node verifier.mjs ajoute un caractère invisible (BOM, une marque d'encodage) au début du texte envoyé. Le script plante alors avec « Unexpected token » en lisant le JSON. Ce n'est pas un bug de ton hook ! Utilise la redirection < de l'invite de commandes, ou fais retirer ce caractère par ton script avant JSON.parse :

const donnees = JSON.parse(entree.replace(/^\uFEFF/, ''));

3. Vérifie trois cas

  1. Un cas normal : le hook fait son travail et sort avec 0.
  2. Un cas d'erreur : le hook sort avec 2 et affiche un message clair sur stderr.
  3. Un cas hors sujet (un fichier .png, par exemple) : le hook ne fait rien et sort avec 0.

Quand ces trois cas se comportent comme prévu, ton hook est prêt.

4. Fais préparer les tests par Claude Code

Pour le hook .claude/hooks/<nom>.mjs, crée trois fichiers d'événement
de test dans un dossier tests-hooks/ : un cas normal, un cas d'erreur
et un cas hors sujet, au format d'entrée officiel de l'événement <événement>.
Donne-moi les commandes cmd pour les lancer et le code de sortie attendu
pour chacun. Ne lance rien toi-même.

5. Puis le test en conditions réelles

Le test manuel prouve que le script fonctionne. Il reste à vérifier qu'il est bien branché : /hooks, puis une vraie demande à Claude, puis Ctrl+O pour voir le résultat.

Exercice

Ton hook sort toujours avec 0, même quand le fichier est cassé. Quelle est la cause la plus probable ?

Corrigé : l'erreur de l'outil lancé n'est pas interceptée. En Node, si tu utilises execFileSync, entoure l'appel d'un try … catch et appelle process.exit(2) dans le catch, après avoir écrit le message avec console.error.

Si ça coince

  • « Unexpected token » sous PowerShell. C'est le BOM : passe par cmd et <, ou retire \uFEFF dans le script.
  • echo %ERRORLEVEL% affiche toujours 0. Lance-le juste après la commande node, sans autre commande entre les deux.
  • Le script attend indéfiniment. Tu l'as lancé sans lui envoyer de JSON : il attend sur stdin. Ajoute < evenement.json.
  • Le chemin du fichier n'est pas trouvé. Vérifie les \\ dans le JSON de test.

À retenir

  • Un faux événement + la commande du hook = un test en quelques secondes.
  • Sous Windows : cmd et <, puis echo %ERRORLEVEL%.
  • Trois cas à valider : normal (0), erreur (2), hors sujet (0).
  • Le test manuel ne remplace pas le test dans Claude Code : fais les deux.