Tests
Les tests vous aident à écrire et à maintenir un code Astro fonctionnel. Astro prend en charge de nombreux outils populaires pour les tests unitaires, les tests de composants et les tests de bout en bout, notamment Jest, Mocha, Jasmine, Cypress et Playwright. Vous pouvez même installer des bibliothèques de test spécifiques au framework, telles que React Testing Library, pour tester les composants de votre framework d’interface utilisateur.
Les frameworks de test vous permettent d’énoncer des assertions ou des attentes sur la manière dont votre code devrait se comporter dans des situations spécifiques, puis de les comparer au comportement réel de votre code actuel.
Tests unitaires et d’intégration
Section intitulée « Tests unitaires et d’intégration »Un framework de test unitaire natif de Vite avec prise en charge ESM, TypeScript et JSX propulsé par esbuild.
Utilisez l’aide Astro getViteConfig() dans votre fichier de configuration vitest.config.ts pour configurer Vitest avec les paramètres de votre projet Astro :
/// <reference types="vitest/config" />import { getViteConfig } from 'astro/config';
export default getViteConfig({ test: { // Options de configuration Vitest },});Par défaut, getViteConfig() essaiera de charger un fichier de configuration Astro dans votre projet et de l’appliquer à l’environnement de test.
À partir d’Astro 4.8, si vous avez besoin de personnaliser la configuration Astro pour vos tests, passez un second argument à getViteConfig() :
export default getViteConfig( { test: { /* Options de configuration de Vitest */ } }, { site: 'https://example.com/', trailingSlash: 'always', },);Voir le modèle de démarrage Astro + Vitest sur GitHub.
Vitest et l’API des conteneurs
Section intitulée « Vitest et l’API des conteneurs »
Ajouté à la version :
astro@4.9.0
Vous pouvez tester nativement les composants Astro en utilisant l’API des conteneurs. Tout d’abord, configurez vitest comme expliqué ci-dessus, puis créez un fichier .test.js pour tester votre composant :
import { experimental_AstroContainer as AstroContainer } from 'astro/container';import { expect, test } from 'vitest';import Card from '../src/components/Card.astro';
test('Carte avec des slots', async () => { const container = await AstroContainer.create(); const result = await container.renderToString(Card, { slots: { default: 'Contenu de la carte', }, });
expect(result).toContain('Ceci est une carte'); expect(result).toContain('Contenu de la carte');});Tests de bout en bout
Section intitulée « Tests de bout en bout »Playwright
Section intitulée « Playwright »Playwright est un outil de test de bout en bout pour les applications web modernes. Utilisez l’API de Playwright en JavaScript ou TypeScript pour tester votre code Astro sur tous les moteurs de rendu modernes, notamment Chromium, WebKit et Firefox.
Installation
Section intitulée « Installation »Vous pouvez démarrer et exécuter vos tests à l’aide de l’extension VS Code.
Vous pouvez également installer Playwright dans votre projet Astro à l’aide du gestionnaire de paquets de votre choix. Suivez les étapes de la CLI pour choisir JavaScript/TypeScript, nommer votre dossier de test et ajouter un flux de travail GitHub Actions facultatif.
npm init playwright@latestpnpm create playwrightyarn create playwrightCréer votre premier test Playwright
Section intitulée « Créer votre premier test Playwright »-
Choisissez une page à tester. Cet exemple testera la page d’exemple
index.astroci-dessous.src/pages/index.astro ------<html lang="fr"><head><title>Astro est génial !</title><meta name="description" content="Extrayez du contenu de n'importe où et diffusez-le rapidement grâce à l'architecture en îlots de nouvelle génération d'Astro." /></head><body></body></html>