Maison interface Web js tutoriel Tester les applications React avec Vitest : un guide complet

Tester les applications React avec Vitest : un guide complet

Aug 28, 2024 am 06:01 AM

Testing React Applications with Vitest: A Comprehensive Guide

Les tests sont un aspect essentiel du développement logiciel moderne, garantissant que votre code fonctionne comme prévu et empêchant les régressions à mesure que votre application évolue. Dans l'écosystème React, des outils comme Vitest offrent un cadre de test rapide, puissant et facile à utiliser qui s'intègre parfaitement aux applications React modernes. Dans cet article, nous explorerons comment configurer et utiliser Vitest pour tester efficacement vos composants, hooks et utilitaires React.


1. Introduction à Vitest

Vitest est un framework de test ultra-rapide conçu pour les projets JavaScript et TypeScript modernes, en particulier ceux utilisant Vite comme outil de construction. Vitest s'inspire de Jest, l'un des frameworks de test les plus populaires de la communauté React, mais il est optimisé pour la vitesse et la simplicité, ce qui en fait un excellent choix pour les projets React alimentés par Vite.

Principales caractéristiques :

  • Exécution rapide : Vitest exécute des tests en parallèle et exploite les capacités de construction rapide de Vite.
  • Prise en charge native d'ESM : Vitest est conçu pour le JavaScript moderne, offrant une prise en charge prête à l'emploi pour les modules ES.
  • Compatibilité avec Jest : Si vous êtes familier avec Jest, vous trouverez l'API de Vitest familière, rendant la transition fluide.
  • Prise en charge de TypeScript intégrée : Vitest prend en charge nativement TypeScript, offrant ainsi une sécurité de type dans vos tests.

2. Configuration de Vitest dans un projet React

Commençons par configurer Vitest dans un projet React. Nous supposerons que vous disposez d'une application React créée à l'aide de Vite. Sinon, vous pouvez en créer un rapidement à l'aide de la commande suivante :

npm create vite@latest my-react-app -- --template react
cd my-react-app
Copier après la connexion

Étape 1 : Installer Vitest et les dépendances associées

Installez Vitest avec la bibliothèque de tests React et d'autres dépendances nécessaires :

npm install --save-dev vitest @testing-library/react @testing-library/jest-dom @testing-library/user-event
Copier après la connexion
  • vitest : Le framework de test.
  • @testing-library/react : Fournit des utilitaires pour tester les composants React.
  • @testing-library/jest-dom : ajoute des correspondants personnalisés à Jest et Vitest pour les assertions de nœuds DOM.
  • @testing-library/user-event : simule les interactions des utilisateurs avec le DOM.

Étape 2 : Configurer Vitest

Ensuite, configurez Vitest en créant ou en modifiant votre fichier vitest.config.ts à la racine de votre projet :

import { defineConfig } from 'vitest/config';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  test: {
    environment: 'jsdom',
    globals: true,
    setupFiles: './src/setupTests.ts',
  },
});
Copier après la connexion
  • environnement : 'jsdom' : se moque d'un environnement de navigateur à des fins de test.
  • globals : true : permet d'utiliser des variables globales comme décrire, it, attendre sans les importer.
  • setupFiles : un fichier pour configurer les configurations de test, similaire au setupFilesAfterEnv de Jest.

Étape 3 : Créer un fichier d'installation

Créez un fichier setupTests.ts dans votre répertoire src pour configurer @testing-library/jest-dom :

import '@testing-library/jest-dom';
Copier après la connexion

Cette configuration inclura automatiquement les correspondants personnalisés fournis par jest-dom dans vos tests.


3. Écriture de tests pour les composants React

Une fois Vitest configuré, écrivons quelques tests pour un simple composant React. Considérez le composant Button suivant :

// src/components/Button.tsx
import React from 'react';

type ButtonProps = {
  label: string;
  onClick: () => void;
};

const Button: React.FC<ButtonProps> = ({ label, onClick }) => {
  return <button onClick={onClick}>{label}</button>;
};

export default Button;
Copier après la connexion

Maintenant, écrivons des tests pour ce composant :

// src/components/Button.test.tsx
import { render, screen } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import Button from './Button';

describe('Button Component', () => {
  it('renders the button with the correct label', () => {
    render(<Button label="Click Me" onClick={() => {}} />);
    expect(screen.getByText('Click Me')).toBeInTheDocument();
  });

  it('calls the onClick handler when clicked', async () => {
    const handleClick = vi.fn();
    render(<Button label="Click Me" onClick={handleClick} />);
    await userEvent.click(screen.getByText('Click Me'));
    expect(handleClick).toHaveBeenCalledTimes(1);
  });
});
Copier après la connexion

Explication :

  • render : restitue le composant pour les tests.
  • screen : interroge le DOM rendu.
  • userEvent.click : simule un événement de clic sur le bouton.
  • vi.fn() : se moque d'une fonction pour suivre ses appels.

4. Exécuter vos tests

Vous pouvez exécuter vos tests à l'aide de la commande suivante :

npx vitest
Copier après la connexion

Cela exécutera tous les fichiers de test qui suivent le modèle *.test.tsx ou *.spec.tsx par défaut. Vous pouvez également exécuter des tests en mode montre avec :

npx vitest --watch
Copier après la connexion

Vitest fournira un résultat détaillé, vous montrant l'état de chaque test et toutes les erreurs survenues.


5. Test des hooks et des utilitaires personnalisés

Vitest peut également être utilisé pour tester des hooks et des utilitaires React personnalisés. Disons que vous avez un hook personnalisé useCounter :

// src/hooks/useCounter.ts
import { useState } from 'react';

export function useCounter(initialValue = 0) {
  const [count, setCount] = useState(initialValue);

  const increment = () => setCount((prev) => prev + 1);
  const decrement = () => setCount((prev) => prev - 1);

  return { count, increment, decrement };
}
Copier après la connexion

Vous pouvez écrire des tests pour ce hook comme suit :

// src/hooks/useCounter.test.ts
import { renderHook, act } from '@testing-library/react-hooks';
import { useCounter } from './useCounter';

describe('useCounter Hook', () => {
  it('initializes with the correct value', () => {
    const { result } = renderHook(() => useCounter(10));
    expect(result.current.count).toBe(10);
  });

  it('increments the counter', () => {
    const { result } = renderHook(() => useCounter());
    act(() => {
      result.current.increment();
    });
    expect(result.current.count).toBe(1);
  });

  it('decrements the counter', () => {
    const { result } = renderHook(() => useCounter(10));
    act(() => {
      result.current.decrement();
    });
    expect(result.current.count).toBe(9);
  });
});
Copier après la connexion

Explication :

  • renderHook : restitue un hook React dans un environnement de test.
  • act : garantit que toutes les mises à jour de l'état ou des effets sont traitées avant de faire des assertions.

6.Conclusion

Vitest fournit un moyen puissant et efficace de tester les applications React, en particulier lorsqu'il est combiné avec des outils modernes comme Vite. Sa simplicité, sa rapidité et sa compatibilité avec les pratiques Jest existantes en font un excellent choix pour les petits et grands projets React.

By integrating Vitest into your workflow, you can ensure that your React components, hooks, and utilities are thoroughly tested, leading to more robust and reliable applications. Whether you’re testing simple components or complex hooks, Vitest offers the tools you need to write effective tests quickly.

For more information, visit the Vitest documentation.

Feel free to explore more advanced features of Vitest, such as mocking, snapshot testing, and parallel test execution, to further enhance your testing capabilities.

Happy Coding ?‍?
Copier après la connexion

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Déclaration de ce site Web
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn

Outils d'IA chauds

Undresser.AI Undress

Undresser.AI Undress

Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover

AI Clothes Remover

Outil d'IA en ligne pour supprimer les vêtements des photos.

Undress AI Tool

Undress AI Tool

Images de déshabillage gratuites

Clothoff.io

Clothoff.io

Dissolvant de vêtements AI

AI Hentai Generator

AI Hentai Generator

Générez AI Hentai gratuitement.

Article chaud

R.E.P.O. Crystals d'énergie expliqués et ce qu'ils font (cristal jaune)
2 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Repo: Comment relancer ses coéquipiers
4 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island Adventure: Comment obtenir des graines géantes
3 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Combien de temps faut-il pour battre Split Fiction?
3 Il y a quelques semaines By DDD

Outils chauds

Bloc-notes++7.3.1

Bloc-notes++7.3.1

Éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise

SublimeText3 version chinoise

Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1

Envoyer Studio 13.0.1

Puissant environnement de développement intégré PHP

Dreamweaver CS6

Dreamweaver CS6

Outils de développement Web visuel

SublimeText3 version Mac

SublimeText3 version Mac

Logiciel d'édition de code au niveau de Dieu (SublimeText3)

Remplacer les caractères de chaîne en javascript Remplacer les caractères de chaîne en javascript Mar 11, 2025 am 12:07 AM

Remplacer les caractères de chaîne en javascript

jQuery Vérifiez si la date est valide jQuery Vérifiez si la date est valide Mar 01, 2025 am 08:51 AM

jQuery Vérifiez si la date est valide

jQuery obtient un rembourrage / marge d'élément jQuery obtient un rembourrage / marge d'élément Mar 01, 2025 am 08:53 AM

jQuery obtient un rembourrage / marge d'élément

10 onglets jQuery Accordion 10 onglets jQuery Accordion Mar 01, 2025 am 01:34 AM

10 onglets jQuery Accordion

10 vaut la peine de vérifier les plugins jQuery 10 vaut la peine de vérifier les plugins jQuery Mar 01, 2025 am 01:29 AM

10 vaut la peine de vérifier les plugins jQuery

Http débogage avec le nœud et le http-console Http débogage avec le nœud et le http-console Mar 01, 2025 am 01:37 AM

Http débogage avec le nœud et le http-console

Tutoriel de configuration de l'API de recherche Google personnalisé Tutoriel de configuration de l'API de recherche Google personnalisé Mar 04, 2025 am 01:06 AM

Tutoriel de configuration de l'API de recherche Google personnalisé

jQuery Ajouter une barre de défilement à div jQuery Ajouter une barre de défilement à div Mar 01, 2025 am 01:30 AM

jQuery Ajouter une barre de défilement à div

See all articles