Simulations et espions

Il arrive qu’une fonction dépende d’un élément lent ou externe, comme un appel réseau ou un système de journalisation. Les doubles de test remplacent ces dépendances par des substituts contrôlables.

busted en fournit trois types : les espions, les bouchons et les objets simulés. Chacun répond à un besoin différent.

Un espion entoure une fonction et enregistre la manière dont elle est appelée tout en exécutant la fonction originale. Il vous permet de vérifier qu’un élément a bien été appelé.

Créez-en un avec spy.new autour d’une fonction, ou espionnez un champ de table.

Utilisez spy.on pour surveiller une méthode d’une table existante. La fonction originale continue de s’exécuter, mais busted suit chaque appel.

C’est idéal pour confirmer un effet secondaire, comme l’appel d’un système de journalisation.

Les espions enregistrent le nombre de fois où ils ont été appelés. Utilisez was.called(n) pour vérifier un nombre exact d’appels.

Cela permet de détecter les bogues où une fonction s’exécute trop souvent ou jamais.

Vous pouvez vérifier les arguments reçus par un espion avec was.called_with. busted compare les arguments enregistrés à ceux que vous attendiez.

Cela vérifie non seulement qu’une fonction s’est exécutée, mais aussi qu’elle l’a fait correctement.

Un bouchon remplace entièrement une fonction, de sorte que l’originale ne s’exécute jamais. Utilisez-le pour éviter un travail lent ou indésirable, comme un véritable accès au réseau ou au disque.

Créez-en un avec stub sur un champ de table. Par défaut, le bouchon ne fait rien et renvoie nil.

Vous pouvez faire renvoyer une valeur fixe à un bouchon avec returns. Cela fournit des données contrôlées au code testé.

Votre test ne dépend alors plus du tout de la dépendance réelle.

Un objet simulé prend une table existante et transforme toutes ses fonctions en espions ou en bouchons à la fois. C’est une manière pratique de suivre un objet entier.

Appelez mock(obj) pour l’envelopper, puis vérifiez ses méthodes individuellement.

En transmettant true comme deuxième argument à mock, vous remplacez toutes les méthodes par des bouchons, de sorte qu’aucune fonction originale ne s’exécute. L’objet est ainsi complètement isolé.

Utilisez cette approche lorsque les méthodes réelles ont des effets secondaires à éviter.

Les espions, les bouchons et les objets simulés modifient les tables partagées. Vous devez donc les restaurer, sinon les tests suivants verront le double. Appelez :revert() ou mock.revert.

Placez la restauration dans after_each pour garantir un état propre entre les tests.

Utilisez un espion pour observer une fonction réelle, un bouchon pour la remplacer par un comportement contrôlé et un objet simulé pour envelopper un objet entier en une seule fois.

Privilégiez le double le plus simple qui répond au besoin. Une utilisation excessive des doubles peut rendre les tests fragiles et masquer de vrais bogues.

Testez votre compréhension des doubles de test de busted.

Les doubles de test isolent le code des dépendances lentes ou externes. Un espion enregistre les appels tout en exécutant la fonction originale, un bouchon remplace une fonction par un comportement contrôlé et un objet simulé enveloppe un objet entier.

Utilisez was.called et was.called_with pour les vérifications, et restaurez toujours les doubles avec revert dans after_each afin de garder les tests isolés.