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, descomputedet des fonctions. Il s'appelle directement dans un test, sans monter de composant.- Composable lié au composant
Un composable qui appelle
onMounted,onUnmounted,inject,provideougetCurrentInstance. 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
watchou un rendu déclenché par une écriture.- flush
L'option d'un
watchqui décide du moment du rappel :preavant le rendu (par défaut),postaprès,syncimmédiatement à l'écriture.
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.