Formations — 1 037 leçons en français

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.calls et accepte une implémentation par mockResolvedValue, mockReturnValue ou mockImplementation.

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.unstubAllGlobals ré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 fetch sans savoir qu'il est intercepté.

Minuteur simulé

vi.useFakeTimers remplace setTimeout et consorts par des versions pilotées à la main. vi.advanceTimersByTime fait 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.

Lire l'explication détaillée et faire le quiz →

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.