---
title: Comprendre la configuration Jest (cloned)
slug: oip-project-starter-v2/comprendre-la-configuration-jest-cloned
icon: 📁
createdAt: 2023-11-15T15:20:10.748Z
---

# Les tests en React

Pour les tests de composants React, le framework utilisé est [Testing Library](https://testing-library.com/) et l'outil de lancement des tests est [Jest.](https://jestjs.io/) Ces deux outils ne sont pas spécifiques à React, mais ils ont une implémentation React ou un fonctionnement compatible avec React.


Le principe pour écrire un test est le suivant :

- **Rendre&#x20;**&#x75;ne suite de composant : [Render  ](https://testing-library.com/docs/react-testing-library/api#render)
- **Récupérer&#x20;**&#x64;es éléments du **DOM&#x20;**(ou vérifier leur présence) : [Queries ](https://testing-library.com/docs/queries/about)(par défaut, utilisez getByRole, celui à bannir est getByDataTestId.)
- **Interagir&#x20;**&#x61;vec le DOM (cliquer sur un bouton) > [User interaction](https://testing-library.com/docs/user-event/intro) (utilisez impérativement userEvent et non fireEvent.)
- **Attendre** un résultat > [Expect · Jest](https://jestjs.io/docs/29.6/expect)  et [Appearance and Disappearance](https://testing-library.com/docs/guide-disappearance/)

Pour allez plus loin,voici plusieurs liens :

- [https://kentcdodds.com/blog/introducing-the-react-testing-library](https://kentcdodds.com/blog/introducing-the-react-testing-library)
- [https://kentcdodds.com/blog/common-mistakes-with-react-testing-library](https://kentcdodds.com/blog/common-mistakes-with-react-testing-library)

Donc ici, si l'on suit cette logique, nous n'avons pas besoin de mocker nos hooks, utils, ou autres, car nos composants sont **construits comme sur le navigateur**. On teste directement toute une page ! On peut bien sûr les découper pour spécialiser nos tests.
Vous allez me dire : c'est bien beau tout ça, mais comment je fais pour tester un composant qui fait un appel d'API REST et/ou GraphQL ?

La solution est [MSW v1 ](https://v1.mswjs.io/):

Cette petite librairie permet de faire des **mocks d'API** mais **intégrée&#x20;**&#x66;acilement **aux tests** (notamment pour les CI). Très facile à appréhender, elle permet d'utiliser Axios, Fetch ou Apollo, ou autre, sans aucune différence et **simule réellement** un appel avec un `delay`, un `status`, etc.&#x20;

# FASST testings

Nos projets sont composés de trois parties, chacune nécessitant sa propre configuration : **app, server, views**. Chaque configuration se trouve dans le dossier portant sont nom, exemple : `app/jest.config.mjs`

La configuration **app&#x20;**&#x65;t **views&#x20;**&#x65;st similaire : elles sont sur un environnement **JSDOM,&#x20;**&#x61;lors que la partie **server&#x20;**&#x65;st testée dans un environnement **Node**. Chaque partie génère la couverture de code des fichiers testés dans un sous-dossier du dossier `/coverage/`, (si aucun tests n'est effectué sur un fichier, il ne sera pas présent dans le tableau récapitulatif).

Il y a donc trois scripts disponibles pour lancer chaque partie, ainsi qu'un script pour tous les lancer et un script pour le lancement de CI :

:::CodeblockTabs
package.json

```json
"test": "yarn test:server && yarn test:app && yarn test:views",
"test:app": "yarn jest --config=app/jest.config.mjs",
"test:views": "yarn jest --config=views/jest.config.mjs",
"test:server": "cross-env NODE_OPTIONS=--experimental-vm-modules yarn jest --config=server/jest.config.mjs",
"test:ci": "yarn test:server --ci && yarn test:app --ci && yarn test:views --ci",
```
:::

Seules les commandes `test:app`, `test:views` et `test:server` ci-dessus est compatibles avec la [syntaxe du CLI de jest.](https://jestjs.io/fr/docs/29.6/cli#ex%C3%A9cution-en-ligne-de-commande) Les commandes `test` et `test:ci` ne le sont pas. Par exemple, pour lancer un fichier spécifique : `yarn test:views MaSuperView`

## App and views

Pour les parties `app` et `views`, la configuration utilise un fichier de setup et un fichier de setupAfterEnv :

```javascript
  setupFiles: ['<rootDir>/tests/__utils__/init-app.mjs'],
  setupFilesAfterEnv: ['<rootDir>/tests/__utils__/init-app-after-env.mjs'],
```

- Le premier permet de configurer les clefs `process.env` nécessaires et d'ajouter à l'env JSDOM **whatwg-fetch.** (**Fetch&#x20;**&#x65;st devenu natif sur les navigateurs et nodejs 18+ , mais toujours pas en JSDOM, il est donc nécessaire de le rajouter manuellement).
- Le second permet de [configuré MSW v1](https://v1.mswjs.io/) qui interceptera tous les appels d'API partant de vos composants. Certaines configuration (comme l'appel de récupération du token) sont nécessaires pour tous les tests et sont donc directement placées dans ce fichier. Il est possible d'en rajouter suivant les besoins de votre projet.

### Providers&#x20;

Les composants utilisent des **hooks&#x20;**&#x6F;u un **context&#x20;**&#x66;ourni par des **providers&#x20;**&#x64;es composants parents (pouvant être situés à différents endroits). Pour les tests, il est nécessaire de les fournir afin que le composant enfant qui les utilise puisse être construit et rendu. Pour cela, les **providers&#x20;**&#x73;ont **découpés** dans le fichier `/app/index.js` et se trouvent dans le dossier `/providers.` un **nouveau composant** (appelé `<ProjectProviders />`), permettant d’instancier tous les providers globaux au projet, est donc créé.

Le `ProjectProviders` est ensuite appelé au niveau des tests via le composant surcouche situé dans `/test/__custom__/TestProviders.jsx` (ce composant, pour le moment, ne fait rien mais peut être surchargé pour avoir des configurations de providers plus spécifiques aux tests) qui sera ensuite ajouté en tant que **wrapper&#x20;**&#x61;u moment de rendre le composant dans les tests :

```javascript
render(<MyAwesomeComponentThatUseSomeContext/>, {
  wrapper: ({ children }) => <TestsProviders>{children}</TestsProviders>,
});
```

Maintenant que notre composant est rendu avec les différents providers, il peut utiliser les informations du `Process`.

## Server

La configuration `server` utilise un fichier de setup permettant de vérifier après chaque fichier de tests si la connexion **mongo&#x20;**&#x61; bien été **fermée&#x20;**&#x65;t si les **models&#x20;**&#x70;résents ont bien été supprimés pour ne pas impacter les tests suivants.

```javascript
  setupFiles: ['<rootDir>/tests/__utils__/init-server.mjs'],
```

Il est tout à fait possible de changer cela pour ne pas avoir à faire de **start and stop** à chaque test, mais de garder l'environnement ouvert pour toute l’exécution des tests (mais attention, tous vos tests s'impacteront entre eu car ils  utiliseront les mêmes données). Pour cela, il faut passer par des configurations globales de setup et teardown : [https://jestjs.io/fr/docs/29.6/configuration#globalsetup-string](https://jestjs.io/fr/docs/29.6/configuration#globalsetup-string)
