Vous lisez la documentation de la version 0.6, qui n'est pas la dernière publiée.
Lire cette page dans la documentation la plus récente (v1.0)
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 dansconsole.{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 virtuelvirtual:mt-debug/ssr). Il écrit directement la sortie colorée ANSI surprocess.stdout. En complément, pour les configurations SSR dans le même processus, le plugin installe aussi$debugsur leglobalThisdu serveur de développement Vite viaconfigureServer.
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 :
// 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.