Formations — 1 037 leçons en français

Accueil › Vue.js › Tester un composable isolément

Tester un composable isolément

Tester une application Vueavance

Un composable est une fonction. S'il ne crée que des ref, des computed et des fonctions, il se teste comme n'importe quelle fonction : on l'appelle, on agit, on lit.

import { useFiltre } from '@/composables/useFiltre'

it('filtre sur le terme saisi', () => {
  const { terme, resultats } = useFiltre([
    { nom: 'Clavier' }, { nom: 'Souris' },
  ])

  terme.value = 'cla'

  expect(resultats.value).toHaveLength(1)
})

Aucun composant n'est monté. C'est le gros avantage d'un composable : la logique devient testable sans DOM, sans rendu, sans attente.

La frontière est nette. Dès que le composable appelle onMounted, onUnmounted, inject, provide ou getCurrentInstance, il lui faut une instance de composant active. On lui en donne une, minimale.

import { createApp } from 'vue'

function withSetup(composable) {
  let resultat
  const app = createApp({
    setup() { resultat = composable(); return () => {} },
  })
  app.mount(document.createElement('div'))
  return [resultat, app]
}

app.unmount() déclenche ensuite onUnmounted, ce qui permet de vérifier qu'un écouteur est bien retiré.

Les termes à connaître

Composable sans contexte

Un composable qui ne crée que des ref, des computed et des fonctions. Il s'appelle directement dans un test, sans monter de composant.

Composable lié au composant

Un composable qui appelle onMounted, onUnmounted, inject, provide ou getCurrentInstance. Il exige une instance active, donc un composant hôte.

Composant hôte

Un composant minimal monté uniquement pour fournir un contexte de mise en place au composable testé. Souvent écrit une fois dans un utilitaire withSetup.

effectScope

Crée une portée qui collecte les effets — watch, computed, watchEffect — créés en son sein. scope.stop() les arrête tous d'un coup, ce qui permet de tester le nettoyage sans composant.

nextTick

Renvoie une promesse résolue après l'application de la file de mises à jour de Vue. Indispensable pour observer un watch ou un rendu déclenché par une écriture.

flush

L'option d'un watch qui décide du moment du rappel : pre avant le rendu (par défaut), post après, sync immédiatement à l'écriture.

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.