Zum Inhalt springen

Debugging

Elide-Programme debuggen: Fehlerausgabe lesen, Debugger anhängen, Abdeckung messen, CPU-Zeit profilieren, mit Insights-Skripten tracen und Fehler melden.

Offline lesenelide help --lang de debugging

Auf dieser Seite

Probleme in Programmen finden und melden, die Sie mit Elide ausführen.

Fehler lesen

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

Schlichte Fehler gehen mit einem kurzen Stack auf stderr; die Programmausgabe bleibt auf stdout. --verbose oder --debug fügt die eigenen Logs von Elide hinzu.

Einen nicht abgefangenen Programmfehler in Elide ansehen
 ~/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.                              │
╰────────────────────────────────────────────────────────────────────────────╯
 
FlagWirkung
--abort-on-uncaught-exceptionGibt den Fehler aus und löst dann SIGABRT aus (Exit-Code 134), damit das Betriebssystem einen Core-Dump schreibt.
--redirect-warnings=FILESchreibt Prozesswarnungen wie process.emitWarning() nach FILE statt auf stderr.
--timeout=DURATIONStoppt das Programm nach DURATION (zum Beispiel 30s) mit Exit-Code 124.
--max-mem=SIZEBegrenzt die Heap-Größe, zum Beispiel 512m. Eine Überschreitung endet mit einem Exit-Code ungleich null.
elide --profiler und --debugger: Profiler-Bericht und Debug-Endpunkte
 ~/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
 






Einen Debugger anhängen

ProgrammFlagLauscht aufClient
JavaScript, TypeScript, Python--debugger=cdpws://127.0.0.1:1337/…Chrome DevTools oder ein beliebiger CDP-Client
JavaScript, TypeScript, Python--debugger=dap127.0.0.1:4711, wartet auf einen ClientJeder Editor mit DAP-Unterstützung
Java, Kotlin--debugger127.0.0.1:5005 (JDWP), angehaltenIntelliJ 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 · Zeilen: 3

Öffnen Sie den devtools://-Link in 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 · Zeilen: 1

Ändern Sie die Adresse eines Listeners mit --debugger-host und --debugger-port:

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

DAP akzeptiert auch --debugger-port=0, damit das Betriebssystem einen freien Port zuweist. Die Listening-Meldung enthält den tatsächlichen Port; die Ausführung wartet, bis der Client die Breakpoints fertig konfiguriert hat.

Steuernde Werkzeuge können beim Start mit einer Loopback-Adresse ELIDE_DEBUGGER_METADATA=1 setzen. Nach dem Binden gibt stderr ein ASCII-Datensatztrennzeichen (0x1e) aus, gefolgt von ELIDE_DEBUGGER und einem JSON-Datensatz:

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

Lesen Sie den zugewiesenen Port aus diesem Datensatz, statt vor dem Start einen Port zu reservieren und wieder freizugeben. Der Datensatz ist opt-in und wird nur für einen verifizierten Loopback-Listener ausgegeben. CDP benötigt einen festen Port.

Eine Zahl oder host:port nach --debugger ist eine JDWP-Adresse und gilt nur für Java und Kotlin. JDWP hat keine Authentifizierung: Binden Sie nur in einem vertrauenswürdigen Netz über Loopback hinaus, oder verwenden Sie einen SSH-Tunnel.

Der DAP-Port hat kein Geheimnis: Jeder Prozess auf dem Host kann sich verbinden. Verwenden Sie --debugger=dap daher nur auf einem Einzelbenutzer-Host.

In einem Android-Projekt startet elide run --debugger die App angehalten auf einem Gerät und leitet ihren JDWP-Port an Loopback weiter (Ausführen und debuggen).

Tests debuggen

Terminal
bash
elide test --debugger
elide test --debugger=dap sample.test.mts
elide test --debugger=5005
FlagDebuggt
--debuggerJavaScript-Tests über CDP und JVM-Tests über JDWP auf 5005
--debugger=cdp oder dapNur JavaScript-Tests
--debugger=PORTNur JVM-Tests

Ein Pfad beschränkt JavaScript-Tests auf eine Datei; JVM-Tests beschränken Sie über den Paketnamen. Solange ein Debugger angehängt ist, laufen JavaScript-Testdateien nacheinander.

In Tern debuggen

Das Tern-Plugin debuggt die JavaScript-, TypeScript- und Python-Quellen eines Projekts sowie JavaScript- und TypeScript-Tests: Starten Sie aus dem Projekt-Arbeitsbereich, setzen Sie file:line- oder Gutter-Breakpoints, steppen Sie mit F10, F11 und Shift+F11, und untersuchen Sie Frames und Werte. Siehe Debugging in Tern.

Abdeckung messen

Terminal
bash
elide run --coverage app.js

Elide gibt nach dem Ende des Programms einen Coverage Report aus, mit den abgedeckten Anweisungen, Zeilen und Funktionen pro Datei. Die Abdeckung für JavaScript und TypeScript wird außerdem als LCOV nach .dev/reports/coverage/js/run/lcov.info im Projekt geschrieben, außerhalb eines Projekts ins Arbeitsverzeichnis.

CPU-Zeit profilieren

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 · Zeilen: 5

Total zählt die Aufrufe jeder Funktion. Für JFR-Aufzeichnungen, Heap-Dumps und Linux-perf siehe Überwachung und Profiling.

Mit Insights tracen

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

Jeder Eintritt in eine Funktion gibt eine Zeile wie enter fib aus. Ereignisse und Filter finden Sie unter Insight-Skripte.

Einen Fehler melden

Terminal
bash
elide info
elide agent diagnostics
elide agent bug

elide agent bug gibt die URL des Issue-Trackers und eine Markdown-Vorlage für den Bericht aus. Tragen Sie den genauen Befehl, das erwartete Verhalten und gegebenenfalls einen Absturzbericht ein.

War diese Seite hilfreich?