Aller au contenu

Vous lisez la documentation de la version 0.6, qui n'est pas la dernière publiée.

Rendu côté serveur (SSR)

$debug est disponible dans le code rendu côté serveur — gardes de route, réducteurs de store, initialisation de page, middleware serveur. Le plugin installe la globale des deux côtés :

  • Navigateur — environnement d'exécution injecté via transformIndexHtml ; journalise dans console.{error|warn|info|debug|log|trace} puis transmet via le WebSocket Vite au terminal de développement.
  • Serveur — un environnement d'exécution Node est injecté automatiquement dans chaque module transformé en SSR qui référence $debug (via le module virtuel virtual:mt-debug/ssr). Il écrit directement la sortie colorée ANSI sur process.stdout. En complément, pour les configurations SSR dans le même processus, le plugin installe aussi $debug sur le globalThis du serveur de développement Vite via configureServer.

En production (vite build, y compris les builds SSR), chaque site d'appel est remplacé par void 0 quel que soit le côté. Aucun environnement d'exécution SSR n'est embarqué dans la sortie. Voir Comportement en production.

Activation manuelle du SSR

Pour les exécuteurs SSR lancés dans un worker thread ou un processus séparé qui ne partagent pas globalThis avec Vite, importez le module virtuel depuis votre point d'entrée serveur :

ts
// par ex. src/main.server.ts (Analog) ou un plugin serveur Nuxt
import "virtual:mt-debug/ssr";

Le module est idempotent (if (!globalThis[GLOBAL_NAME])) et ne se charge qu'en développement — la suppression au build retire toute référence en production.