Accueil › Vue.js › Simuler une API
Simuler une API
Tester une application Vueavance
Un composant qui charge des données ne doit pas joindre un vrai serveur pendant un test : le réseau est lent, variable, et il rend l'échec impossible à lire. On remplace donc la source par une doublure, et on teste les trois états que l'utilisateur peut voir : chargement, succès, erreur.
import { vi } from 'vitest'
import { render, screen } from '@testing-library/vue'
import * as api from '@/api/produits'
import ListeProduits from './ListeProduits.vue'
vi.mock('@/api/produits')
it('affiche les produits reçus', async () => {
vi.mocked(api.chargerProduits).mockResolvedValue([
{ id: 1, nom: 'Clavier' },
])
render(ListeProduits)
expect(screen.getByText('Chargement…')).toBeTruthy()
expect(await screen.findByText('Clavier')).toBeTruthy()
})
Deux détails font la différence. vi.mock remplace le module entier, et
Vitest remonte cet appel avant les imports : la doublure est en place quand
le composant est évalué. Et la seconde assertion utilise findByText, parce
qu'une promesse, même déjà résolue, ne rend la main qu'au tour suivant.
L'assertion d'erreur suit la même forme, avec mockRejectedValue. C'est
souvent le chemin le moins testé, et le plus visible quand il casse.
Les termes à connaître
- Doublure
Un objet qui remplace une dépendance réelle le temps du test. Selon ce qu'on en attend, on parle d'espion (il enregistre les appels), de bouchon (il renvoie une réponse fixe) ou de simulacre (il vérifie la façon dont il a été appelé).
- vi.fn
Crée une fonction espionne. Elle enregistre ses appels dans
mock.callset accepte une implémentation parmockResolvedValue,mockReturnValueoumockImplementation.- vi.mock
Remplace un module entier pour le fichier de test courant. L'appel est remonté en tête du fichier par Vitest, donc avant les imports qu'il concerne.
- vi.stubGlobal
Remplace une variable globale —
fetch,localStorage,matchMedia— pour la durée du test.vi.unstubAllGlobalsrétablit l'état d'origine.- MSW
Mock Service Worker : une bibliothèque qui intercepte les requêtes au niveau du réseau plutôt qu'au niveau du module. Le code applicatif appelle
fetchsans savoir qu'il est intercepté.- Minuteur simulé
vi.useFakeTimersremplacesetTimeoutet consorts par des versions pilotées à la main.vi.advanceTimersByTimefait avancer l'horloge sans attendre réellement.- État de chargement
La phase pendant laquelle la réponse n'est pas encore arrivée. Elle doit être testée pour elle-même : c'est ce que l'utilisateur voit le plus souvent sur une connexion lente.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.