Avant TDD : Pourquoi avez-vous besoin de savoir ce que sont les Mocks, les Stubs et les Spies ?

Bonjour à tous ! Aujourd’hui, j’apporte un sujet que je trouve très intéressant. Je sais qu'il existe des dizaines d'articles en ligne traitant de TDD, BDD, des modèles de conception pour les tests, de la façon d'écrire des tests et de nombreux autres sujets connexes. Cependant, je vois très peu d'articles expliquant des termes plus basiques dans l'univers des tests, ces fonctions que nous utilisons souvent mais dont nous ne comprenons pas toujours pleinement ce qu'elles signifient ou comment elles se comportent. Si vous commencez tout juste à vous renseigner sur les tests et que vous ne savez pas exactement à quoi servent les fonctions de la bibliothèque, cet article est fait pour vous. Bonne lecture !

Que sont les moqueries ?

La première chose que vous pourriez rencontrer dès que vous commencez à rédiger des tests, ce sont les simulations. Parfois, vous les utilisez déjà mais vous ne savez pas exactement ce qu’ils signifient. Alors, allons-y.

Les simulations sont principalement utilisées dans les tests unitaires. Ce sont des outils utilisés pour simuler du contenu, des objets ou des réponses qui proviennent généralement d'une dépendance externe, ou lorsque vous avez besoin que le contenu contienne des informations spécifiques.

Imaginez que vous testez un système de recommandation de films. Ce système récupère une liste de films à partir d'une API et vous la renvoie.

Le problème est le suivant : si à chaque fois que vous exécutez les tests, la véritable API est appelée, elle pourrait être lente et incohérente (les films peuvent varier ou l'API peut être en panne), ce qui rend les tests peu fiables.

Très bien, Leo, je comprends le problème, mais comment une simulation résout-elle ce problème ?Eh bien, c'est simple : au lieu d'appeler l'API, vous utilisez sa réponse comme une liste statique de films. Il s’agit essentiellement de « simuler » la réponse de l’API avec cette liste de films.

Dans l'exemple du système de films, si vous souhaitez tester une fonction appelée fetchMoviesFromAPI() qui utilise l'API pour récupérer des films, vous pouvez créer une simulation pour simuler la réponse de l'API comme ceci :

// This is the mock
const MOVIES_FROM_API = [
    {
        id: 1,
        name: "Interstellar"
    },
    {
        id: 2,
        name: "Nosferatu"
    }
]

// Here, we’re telling fetchMoviesFromAPI to return our mock instead of calling the real API. This is a stub, which you’ll learn about in the next section.
const fetchMoviesFromAPI = jest.fn().mockResolvedValue(MOVIES_FROM_API)

;(async () => {
    {
        const expectedMovies = MOVIES_FROM_API
        const movies = await fetchMoviesFromAPI()

        expect(movies).toEqual(MOVIES_FROM_API)
    }
})()

Avec les mocks, vos tests deviennent plus efficaces puisqu'ils ne dépendent pas de services externes. De plus, ils gagnent en fiabilité car vous avez un contrôle total sur les retours, ce qui vous permet de vous concentrer sur la validation de la fonctionnalité sans vous soucier des instabilités ou des temps d'arrêt potentiels de l'API.

Les simulations sont des objets statiques qui simulent les réponses aux appels ou à d'autres objets nécessaires aux tests.

En fin de compte, c’est comme tester une voiture sans utiliser de vraie essence. Vous créez un environnement contrôlé pour vous assurer que le moteur fonctionne avant de le mettre sur la route.

Je reçois des moqueries, maintenant que sont les talons ?

Les Stubs sont également des outils de test mais ont un objectif légèrement différent. Ils remplacent le comportement des fonctions par quelque chose de prédéterminé, utilisant souvent des simulations pour renvoyer des valeurs spécifiques.

Les stubs remplacent le comportement de la fonction. Par exemple, lorsque j'accède à cette API de film, la fonction ne fera pas le véritable appel mais examinera notre simulation (la liste statique des films).

Ils rappellent également que nos tests ne doivent pas dépendre de services externes ou d'Internet.

Laissez-moi vous donner un peu de contexte : imaginez que vous testez une application qui calcule la valeur totale d'un achat en ligne. Le calcul inclut les frais récupérés auprès d’un service externe. Chaque fois que vous exécutez le test, ce calcul doit être effectué, ce qui signifie que le service externe devra être appelé. Cela pourrait entraîner un test lent, instable, coûteux (car le service externe peut facturer par demande) et incohérent (les valeurs peuvent changer).

À l'aide d'un stub, vous remplacerez le véritable appel de service par une valeur fixe et prédéfinie (oui, une simulation). Au lieu d'appeler le service de frais, vous dites : « Renvoyez toujours la valeur 10 comme frais. »

Imaginez que vous souhaitiez tester la fonction calculateTotalPurchase() qui résume les valeurs des articles du panier et ajoute les frais d'expédition. À l’aide de talons, vous remplacez le service de frais d’expédition par une valeur qui renvoie toujours « 10 » comme frais d’expédition. Comme ça :

// This is the mock
const MOVIES_FROM_API = [
    {
        id: 1,
        name: "Interstellar"
    },
    {
        id: 2,
        name: "Nosferatu"
    }
]

// Here, we’re telling fetchMoviesFromAPI to return our mock instead of calling the real API. This is a stub, which you’ll learn about in the next section.
const fetchMoviesFromAPI = jest.fn().mockResolvedValue(MOVIES_FROM_API)

;(async () => {
    {
        const expectedMovies = MOVIES_FROM_API
        const movies = await fetchMoviesFromAPI()

        expect(movies).toEqual(MOVIES_FROM_API)
    }
})()

Cela simplifie le test et garantit sa reproductibilité, ce qui signifie qu'il fonctionnera toujours de la même manière. De plus, les stubs aident à isoler le test, éliminant ainsi le besoin de s'inquiéter de l'état ou de la disponibilité de l'API payante.

En résumé, c'est comme tester une recette de gâteau en utilisant un verre doseur qui indique toujours 200 ml de lait au lieu de mesurer la quantité réelle de lait. De cette façon, vous testez uniquement si vous pouvez mélanger les ingrédients sans vous soucier de savoir si le lait est mesuré correctement.

Des moqueries, des talons... et enfin, que sont les espions ?

Nous avons exploré les simulations, qui simulent des objets, et les stubs, qui imitent les comportements des fonctions. Parlons maintenant des espions : que font-ils exactement ?

Les espions surveillent les fonctions, enregistrant combien de fois ils ont été appelés, quels paramètres ils ont reçus et les résultats de chaque exécution. Ils vous permettent d'observer le comportement de la fonction sans la modifier, garantissant ainsi que tout fonctionne comme prévu.

Imaginez que vous testez le module de notification de votre projet. Chaque fois qu'une commande est terminée, le système doit envoyer un message au client et enregistrer une entrée. Dans ce cas, vous souhaitez uniquement vous assurer que ces actions sont effectuées, mais vous ne souhaitez en remplacer aucune. Avec un espion, vous surveillez ces fonctions sans altérer leur comportement. Cela vous permet de voir :

• Si la fonction a été appelée
• Combien de fois il a été appelé
• Quels arguments il a reçu

Par exemple, si vous souhaitez tester la fonction completeOrder() qui envoie une notification au client et enregistre l'entrée, avec un espion, vous pouvez vérifier :

• Si la fonction de notification a été appelée
• Si la fonction de journalisation a été appelée
• Quels arguments ces fonctions ont reçus.

// This is the mock
const MOVIES_FROM_API = [
    {
        id: 1,
        name: "Interstellar"
    },
    {
        id: 2,
        name: "Nosferatu"
    }
]

// Here, we’re telling fetchMoviesFromAPI to return our mock instead of calling the real API. This is a stub, which you’ll learn about in the next section.
const fetchMoviesFromAPI = jest.fn().mockResolvedValue(MOVIES_FROM_API)

;(async () => {
    {
        const expectedMovies = MOVIES_FROM_API
        const movies = await fetchMoviesFromAPI()

        expect(movies).toEqual(MOVIES_FROM_API)
    }
})()

Pour conclure, c’est comme placer une caméra pour observer ce que fait un chef en cuisine. Vous n’interférez pas avec ce qu’ils font ; il vous suffit de vérifier s'ils suivent correctement la recette.

Alors, c'est tout ! Vous avez appris et compris les termes mocks, stubs et espions, qui sont des éléments fondamentaux pour créer des tests fiables et efficaces. Vous pouvez désormais continuer à approfondir vos études. À bientôt, au revoir !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!