.scriptload (Skript laden)
Mit dem Befehl .scriptload wird die angegebene Skriptdatei geladen und ausgeführt.
.scriptload ScriptFile
Parameter
ScriptFile
Gibt den Namen der zu ladenden Skriptdatei an. ScriptFile sollte die Dateinamenerweiterung .js enthalten. Es können absolute oder relative Pfade verwendet werden. Relative Pfade sind relativ zu dem Verzeichnis, in dem Sie den Debugger gestartet haben. Dateipfade, die Leerzeichen enthalten, werden nicht unterstützt.
Environment
| Element | Beschreibung |
|---|---|
| Modi | Benutzermodus, Kernel-Modus |
| Ziele | Live, Crash Dump |
| Plattformen | Alle |
Zusätzliche Informationen
Der Befehl .scriptload lädt ein Skript und führt ein Skript aus. Der folgende Befehl zeigt das erfolgreiche Laden von TestScript.js.
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
Wenn beim anfänglichen Laden und Ausführen des Skripts Fehler auftreten, werden diese auf der Konsole angezeigt, einschließlich der Zeilennummer und der Fehlermeldung.
0:000:x86> .scriptload C:\WinDbg\Scripts\TestScript.js
0:000> "C:\WinDbg\Scripts\TestScript.js" (line 11 (@ 1)): Error (0x80004005): Syntax error
Error: Unable to execute JavaScript script 'C:\WinDbg\Scripts\TestScript.js'
Der Befehl .scriptload führt folgendes in einem JavaScript aus.
- wurzelcode
- intializeScript-Funktion (falls im Skript vorhanden)
Wenn ein Skript mit dem Befehl .scriptload geladen wird, wird die Funktion intializeScript und der Root-Code des Skripts ausgeführt, die im Skript vorhandenen Namen werden in den Root-Namespace des Debuggers (dx Debugger) gebrückt und das Skript bleibt im Speicher resident, bis es entladen wird und alle Referenzen auf seine Objekte freigegeben werden.
Das Skript kann neue Funktionen für den Ausdrucksauswerter des Debuggers bereitstellen, das Objektmodell des Debuggers ändern oder als Visualisierer fungieren, ähnlich wie ein NatVis-Visualisierer. Weitere Informationen zu NavVis und zum Debugger finden Sie unter dx (NatVis-Ausdruck anzeigen).
Weitere Informationen zur Arbeit mit JavaScript finden Sie unter Debuggerskripts mit JavaScript. Weitere Informationen zu den Debugger-Objekten finden Sie unter Native Objects in JavaScript Extensions.
Anforderungen
Bevor Sie einen der .script-Befehle verwenden können, muss ein Scripting Provider geladen werden. Verwenden Sie den Befehl .scriptproviders, um zu bestätigen, dass der JavaScript-Anbieter geladen ist.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')