Aller au contenu

Débogage

Déboguez les programmes Elide : sortie d'erreur, débogueur, couverture, profilage du temps CPU, traçage avec des scripts Insight et signalement de bugs.

Lire hors ligneelide help --lang fr debugging

Sur cette page

Trouvez et signalez les problèmes des programmes exécutés avec Elide.

Lire les erreurs

Terminal
bash
elide --error-format=plain run app.js

Les erreurs brutes vont sur stderr avec une pile courte ; la sortie du programme reste sur stdout. --verbose ou --debug ajoute les journaux propres à Elide.

Affichage d'une erreur non interceptée d'un programme dans Elide
 ~/demo  elide ./checkout.js
╭Script Error────────────────────────────────────────────────────────────────╮
│ RangeError: discount must be a fraction, got 25                            │
│                                                                            │
│  In file checkout.js:3:11:                                                 │
│     ╭─                                                                     │
│   2 │   if (pct > 1) {                                                     │
│ → 3 │     throw new RangeError(`discount must be a fraction, got ${pct}`); │
│   4 │   }                                                                  │
│   5 │   return order.total * (1 - pct);                                    │
│   6 │ }                                                                    │
│   · │                                                                      │
│ Stack Trace────────────────────────────────                                │
│  ╭─ [js] applyDiscount checkout.js:3:11-67                                 │
│  │                                                                         │
│  · elide ./checkout.js                                                     │
│ Advice──────────────────────────────────────────────────────────────────── │
│  An error occurred while executing your code.                              │
╰────────────────────────────────────────────────────────────────────────────╯
 
OptionEffet
--abort-on-uncaught-exceptionAffiche l’erreur, puis lève SIGABRT (sortie 134) pour que le système écrive un core dump.
--redirect-warnings=FILEÉcrit les avertissements du processus, comme process.emitWarning(), dans FILE au lieu de stderr.
--timeout=DURATIONArrête le programme après DURATION (par exemple 30s) avec le code de sortie 124.
--max-mem=SIZELimite la taille du tas, par exemple 512m. Un dépassement échoue avec un code de sortie non nul.
elide --profiler et --debugger : rapport du profileur et points de débogage
 ~/demo  elide --profiler=cputracing pricing.js
total: 48
╭Profiler Report───────────────────────────────────────────────────────────────────────────────────╮
│   Location                 Root               Total             Interpreted             Compiled │
│ pricing.js                price             1 50.0%                1 100.0%               0 0.0% │
│ pricing.js             :program             1 50.0%                1 100.0%               0 0.0% │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ~/demo  elide --debugger=dap pricing.js
[Graal DAP] Starting server and listening on /127.0.0.1:4711
 






Attacher un débogueur

ProgrammeOptionÉcoute surClient
JavaScript, TypeScript, Python--debugger=cdpws://127.0.0.1:1337/…Chrome DevTools ou tout client CDP
JavaScript, TypeScript, Python--debugger=dap127.0.0.1:4711, attend un clientTout éditeur compatible DAP
Java, Kotlin--debugger127.0.0.1:5005 (JDWP), suspenduIntelliJ IDEA, VS Code, jdb
Terminal
bash
elide run --debugger=cdp app.js
text
Debugger listening on ws://127.0.0.1:1337/<id>/inspect
For help, see: https://docs.elide.dev/guides/debugging
E.g. in Chrome open: devtools://devtools/bundled/js_app.html?ws=127.0.0.1:1337/<id>/inspect
utf-8 · text · Lignes : 3

Ouvrez le lien devtools:// dans Chrome.

Terminal
bash
elide run --debugger=dap app.js
elide run --debugger Hello.kt
text
Listening for transport dt_socket at address: 5005
utf-8 · text · Lignes : 1

Changez l’adresse d’écoute avec --debugger-host et --debugger-port :

Terminal
bash
elide run --debugger=dap --debugger-port=5678 app.js
elide run --debugger=0.0.0.0:5005 Hello.kt

DAP accepte aussi --debugger-port=0 pour laisser le système d’exploitation attribuer un port libre. Le message d’écoute contient le port réel ; l’exécution attend que le client ait fini de configurer les points d’arrêt.

Les outils de pilotage peuvent définir ELIDE_DEBUGGER_METADATA=1 lors d’un lancement avec une adresse loopback. Après la liaison, stderr émet un séparateur d’enregistrement ASCII (0x1e), suivi de ELIDE_DEBUGGER et d’un enregistrement JSON :

json
{"version":1,"event":"listening","mode":"dap","host":"127.0.0.1","port":49152}
utf-8 · json · Lignes : 1

Lisez le port attribué dans cet enregistrement plutôt que de réserver puis libérer un port avant le lancement. L’enregistrement est facultatif et n’est émis que pour un listener loopback vérifié. CDP exige un port fixe.

Un nombre ou host:port après --debugger est une adresse JDWP et ne s’applique qu’à Java et Kotlin. JDWP n’a pas d’authentification : n’écoutez au-delà de l’interface loopback que sur un réseau de confiance, ou utilisez un tunnel SSH.

Le port DAP n’a pas de secret : tout processus de l’hôte peut s’y attacher ; n’utilisez donc --debugger=dap que sur un hôte à utilisateur unique.

Dans un projet Android, elide run --debugger lance l’application suspendue sur un appareil et redirige son port JDWP vers loopback (Exécuter et déboguer).

Déboguer les tests

Terminal
bash
elide test --debugger
elide test --debugger=dap sample.test.mts
elide test --debugger=5005
OptionDébogue
--debuggerLes tests JavaScript via CDP et les tests JVM via JDWP sur 5005
--debugger=cdp ou dapLes tests JavaScript uniquement
--debugger=PORTLes tests JVM uniquement

Un chemin restreint les tests JavaScript à un fichier ; restreignez les tests JVM par nom de paquet. Tant qu’un débogueur est attaché, les fichiers de test JavaScript s’exécutent un par un.

Déboguer dans Tern

Le plugin Tern débogue les sources JavaScript, TypeScript et Python d’un projet ainsi que les tests JavaScript et TypeScript : lancez depuis l’espace de travail du projet, posez des points d’arrêt file:line ou dans la gouttière, avancez avec F10, F11 et Shift+F11, et inspectez les frames et les valeurs. Voir Débogage dans Tern.

Mesurer la couverture

Terminal
bash
elide run --coverage app.js

Elide affiche un rapport de couverture à la sortie du programme, avec les instructions, lignes et fonctions couvertes par fichier. La couverture JavaScript et TypeScript est aussi écrite au format LCOV dans .dev/reports/coverage/js/run/lcov.info du projet, ou dans le répertoire de travail hors d’un projet.

Profiler le temps CPU

Terminal
bash
elide run --profiler=cputracing app.js
text
╭Profiler Report───────────────────────────────────────────────────────────────╮
│ Location           Root               Total        Interpreted      Compiled │
│   app.js            fib       21.89k 100.0%      21.89k 100.0%        0 0.0% │
│   app.js       :program              1 0.0%           1 100.0%        0 0.0% │
╰──────────────────────────────────────────────────────────────────────────────╯
utf-8 · text · Lignes : 5

Total compte les appels de chaque fonction. Pour les enregistrements JFR, les vidages du tas et perf sous Linux, voir Surveillance et profilage.

Tracer avec Insight

javascript
// insight.js
insight.on("enter", (ctx) => {
  console.log("enter", ctx.name);
}, { roots: true });
utf-8 · javascript · Lignes : 4
Terminal
bash
elide run --insights=insight.js app.js

Chaque entrée dans une fonction affiche une ligne comme enter fib. Voir Scripts Insight pour les événements et les filtres.

Signaler un bug

Terminal
bash
elide info
elide agent diagnostics
elide agent bug

elide agent bug affiche l’URL du gestionnaire de tickets et un modèle de rapport en Markdown. Indiquez la commande exacte, le comportement attendu et tout rapport de plantage.

Cette page vous a-t-elle aidé ?