L'API $debug

Signature de la fonction

$debug<T>(
  level: 'error' | 'warning' | 'info' | 'debug' | 'success' | 'trace',
  payload: string | Error | T,
  options?: {
    showStack?: boolean
    showSource?: boolean
    tag?: string
    prefix?: string // remplace le préfixe affiché pour cet appel
  }
): void

showSource prend par défaut la valeur de l'option showSourceLocation du plugin, et prefix retombe sur le prefix configuré s'il est omis. tag sert aussi d'espace de noms pour le filtre à l'exécution. En 0.6, l'emplacement désigne le code du plugin ; voir showSourceLocation.

Type de charge utile	Rendu
string	tel quel
Error	error.message (pile d'appels ajoutée si showStack: true)
objet / tableau	JSON.stringify avec protection contre les références circulaires, tronqué à 500 caractères
Map / Set	converti en forme simple, puis sérialisé
ref Vue	.value extrait, puis règles standard appliquées
nœud DOM	résumé <tag#id.class>
Promise	[Promise] (non attendue)

$debug expose aussi des contrôles à l'exécution (ns, enable, disable, setLevel, setPrefixFilter ; voir Espaces de noms et filtrage) et des fonctions utilitaires (assert, time/timeEnd, count, group/groupEnd).

Niveaux

Niveau	Libellé par défaut	Couleur par défaut (navigateur / terminal)	Méthode console du navigateur	Ordre
trace	Trace	#a855f7 / magenta	console.trace	0
debug	Debug	#6b7280 / gris	console.debug	1
info	Info	#3b82f6 / bleu	console.info	2
success	Success	#10b981 / vert	console.log	3
warning	Warning	#f59e0b / jaune	console.warn	4
error	Error	#ef4444 / rouge	console.error	5

minLevel conserve tous les niveaux supérieurs ou égaux au seuil (trace < debug < info < success < warning < error) ; levels est une liste blanche explicite. Les libellés et les couleurs se modifient niveau par niveau avec l'option colors.

Fonctions utilitaires

$debug porte des fonctions utilitaires à la manière de console. Chacune est retirée des builds de production avec les appels de base, y compris les formes méthode ($debug.time(...)) et chaînée ($debug.ns('x')('info')).

$debug.assert(user.id != null, "user must have an id", { tag: "auth" });
// logue au niveau "error" UNIQUEMENT quand la condition est fausse

$debug.time("render");
renderExpensiveThing();
$debug.timeEnd("render"); // → MARS-TECH Debug [render] - render: 12.4ms

$debug.count("api-call"); // → api-call: 1
$debug.count("api-call"); // → api-call: 2

$debug.group("checkout");
$debug("info", "validating cart"); // indenté sous le groupe
$debug("info", "charging card");
$debug.groupEnd();

Fonction	Comportement
assert(condition, payload, opts?)	Logue payload au niveau error uniquement quand condition est fausse.
time(label?) / timeEnd(label?)	Logue le temps écoulé (ms) entre les deux appels au niveau debug. Libellé par défaut : default.
count(label?)	Incrémente et logue un compteur nommé au niveau debug.
group(label?) / groupEnd()	Indente la sortie suivante d'un niveau (le libellé, s'il est fourni, est logué comme titre).

Le libellé sert aussi d'espace de noms ou de tag : les fonctions utilitaires respectent donc le filtre actif. Le chronométrage utilise performance.now() quand il est disponible.