Accueil › Node.js › Tester une API
Tester une API — entretien Node.js
5 questions posées en entretien sur 3 sujets, avec la bonne réponse et son explication.
Niveaux de test
Qu'est-ce qui caractérise un test unitaire par rapport à un test d'API ?
- Il appelle une fonction et vérifie sa valeur de retour, sans serveur ni base ✓
- Il teste une seule route de l'API à la fois
- Il est écrit par le développeur, là où le test d'API est écrit par les testeurs
- Il utilise `assert`, là où le test d'API utilise `expect`
Pourquoi : Le critère est ce que le test traverse, pas qui l'écrit ni quelle bibliothèque d'assertion il emploie. Un test unitaire n'a aucune dépendance externe, ce qui le rend rapide et permet d'en écrire des dizaines sur une même fonction. C'est aussi ce qui le rend aveugle à tout ce qui n'existe que dans la réponse HTTP — statut, en-têtes, forme sérialisée.
Niveau junior
Lequel de ces comportements se teste le mieux par un test unitaire ?
- Le calcul d'un prix remisé au-delà de dix articles ✓
- L'ordre dans lequel les intergiciels sont traversés
- Le code de statut renvoyé après une création
- La présence de l'en-tête `Location` dans la réponse
Pourquoi : Le calcul est de la logique pure : il ne dépend que de ses arguments, il a beaucoup de cas limites — la frontière à dix articles, l'arrondi, le cumul des remises — et chaque cas coûte une fraction de milliseconde. Les trois autres n'existent que dans la réponse HTTP, donc seul un appel complet les observe. Savoir trier ainsi est exactement ce qu'un entretien cherche à vérifier.
Niveau junior
Tests d'API
Pourquoi déclarer l'application Express dans un module qui n'appelle pas `listen` ?
- Pour que les tests importent l'application sans démarrer de serveur sur un port choisi ✓
- Parce qu'Express 5 interdit `listen` hors du point d'entrée
- Pour réduire la taille de l'image de production
- Parce que `listen` est bloquant et occuperait la boucle d'événements
Pourquoi : Importer un module qui appelle `listen` démarre un serveur comme effet de bord de l'import. Deux fichiers de test exécutés en parallèle tombent alors sur `EADDRINUSE`, et un fichier seul suffit à empêcher le processus de se terminer puisqu'un écouteur reste ouvert. La séparation `app.js` / `serveur.js` coûte trois lignes et supprime les deux problèmes.
Niveau junior
Que fait `app.listen(0)` dans un test ?
- Il demande au système un port libre, que `server.address().port` rend ensuite ✓
- Il démarre le serveur sans ouvrir de socket, en mode simulé
- Il écoute sur le port 0, réservé aux tests par convention
- Il échoue : zéro n'est pas un numéro de port valide
Pourquoi : Le port zéro est la convention qui demande au système d'en attribuer un libre ; `address()` vaut `null` jusqu'à l'émission de l'événement `listening`, puis rend un nombre. C'est ce mécanisme qui permet d'exécuter plusieurs fichiers de test en parallèle sans collision, et c'est exactement ce qu'un client de test comme supertest fait pour vous quand vous lui passez l'application.
Niveau confirme
Assertions
Pourquoi éviter de comparer le corps entier d'une réponse à un objet attendu ?
- Parce que tout champ ajouté, toute date et tout identifiant engendré font échouer le test sans qu'aucun bogue existe ✓
- Parce que `deepEqual` ne descend pas dans les objets imbriqués
- Parce que le corps d'une réponse HTTP est toujours une chaîne
- Parce que l'ordre des clés d'un objet JSON n'est pas garanti
Pourquoi : Un test trop précis n'est pas plus rigoureux, il est plus bruyant : il échoue à chaque évolution bénigne du contrat, et le bruit se termine en test désactivé. On vérifie le statut, les en-têtes qui font partie du contrat, les champs qui portent le comportement testé, et l'absence explicite des champs sensibles. Cette dernière assertion est la seule qui attrape une fuite de hachage de mot de passe.
Niveau confirme