Erreurs et débogage

Mode code

Les messages d’erreur d’Opale disent quoi corriger. Voici les plus fréquents.

Dans l’éditeur

MessageCorrection
« La commande /x n’est pas déclarée »Clique sur Déclarer, ou ajoute-la dans Commandes et listes.
« L’événement « x » n’existe pas »Vérifie le nom dans la liste des événements.
« eval() n’est pas autorisé »Les constructions dynamiques sont interdites : écris le code directement.
« Identifiant invalide »Boutons, menus, formulaires : minuscules, chiffres et tirets, 31 caractères.
« Route Discord non autorisée »La route n’est pas ouverte aux modules : voir Routes.
« Le site x est utilisé sans être déclaré »Ajoute module.uses('x') ou écris l’adresse en entier.

À l’exécution

MessageCause
« Permission non accordée : … »Le code fait une action que la version installée ne demandait pas. Republie : la permission sera ajoutée et l’admin devra l’accepter en mettant à jour.
« Ce salon n’appartient pas à ce serveur »Un identifiant de salon vient d’un autre serveur (souvent écrit en dur).
« Le rôle x est au-dessus de celui d’Opale »L’admin doit placer le rôle d’Opale plus haut.
« Ce membre est protégé »Propriétaire, administrateur ou membre au-dessus d’Opale.
« Un formulaire doit être la première réponse »Ouvre le formulaire avant tout reply ou defer.
« Le module a pris trop de temps »Plus de 15 secondes : découpe le travail ou utilise ctx.later.
« Le module a utilisé trop de calcul »Une boucle trop lourde (800 ms de calcul pur).
« Plus de 150 actions pour un seul événement »Regroupe les actions (ex. bulkDelete au lieu de 100 delete).
« Module mis en pause automatiquement »5 erreurs en 10 minutes sur le serveur : corrige, publie, l’admin relance.

Méthode

  1. Reproduis le cas dans l’onglet Tester : le simulateur montre chaque appel et l’erreur exacte.
  2. Ajoute des await ctx.log(...) pour suivre les valeurs : elles apparaissent dans le journal du module.
  3. Dans les statistiques du module (Studio › Modules), l’onglet Erreurs regroupe les erreurs de tous les serveurs.
Erreurs et débogage · Documentation Opale