Trouvez et signalez les problèmes des programmes exécutés avec Elide.
Lire les erreurs
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.
~/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. │
╰────────────────────────────────────────────────────────────────────────────╯
| Option | Effet |
|---|---|
--abort-on-uncaught-exception | Affiche l’erreur, puis lève SIGABRT (sortie 134) pour que le système écrive un core dump. |
--redirect-warnings= | Écrit les avertissements du processus, comme process.emitWarning(), dans FILE au lieu de stderr. |
--timeout=DURATION | Arrête le programme après DURATION (par exemple 30s) avec le code de sortie 124. |
--max-mem=SIZE | Limite la taille du tas, par exemple 512m. Un dépassement échoue avec un code de sortie non nul. |
~/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
| Programme | Option | Écoute sur | Client |
|---|---|---|---|
| JavaScript, TypeScript, Python | --debugger=cdp | ws://127.0.0.1:1337/… | Chrome DevTools ou tout client CDP |
| JavaScript, TypeScript, Python | --debugger=dap | 127.0.0.1:4711, attend un client | Tout éditeur compatible DAP |
| Java, Kotlin | --debugger | 127.0.0.1:5005 (JDWP), suspendu | IntelliJ IDEA, VS Code, jdb |
elide run --debugger=cdp app.js
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
Ouvrez le lien devtools:// dans Chrome.
elide run --debugger=dap app.js
elide run --debugger Hello.kt
Listening for transport dt_socket at address: 5005
Changez l’adresse d’écoute avec --debugger-host et --debugger-port :
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 :
{"version":1,"event":"listening","mode":"dap","host":"127.0.0.1","port":49152}
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
elide test --debugger
elide test --debugger=dap sample.test.mts
elide test --debugger=5005
| Option | Débogue |
|---|---|
--debugger | Les tests JavaScript via CDP et les tests JVM via JDWP sur 5005 |
--debugger=cdp ou dap | Les tests JavaScript uniquement |
--debugger=PORT | Les 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
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
elide run --profiler=cputracing app.js
╭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% │
╰──────────────────────────────────────────────────────────────────────────────╯
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
// insight.js
insight.on("enter", (ctx) => {
console.log("enter", ctx.name);
}, { roots: true });
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
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.