.scriptload (スクリプトの読み込み)
その .scriptload コマンドは、指定されたスクリプトファイルをロードして実行する。
.scriptload ScriptFile
パラメーター
ScriptFile
ロードするスクリプトファイル名を指定する。 ScriptFile should include the .js file name extension. 絶対パスも相対パスも使用できる。 相対パスは、デバッガーを起動したディレクトリからの相対パスです。 スペースを含むファイルパスはサポートされていません。
Environment
| 項目 | 説明 |
|---|---|
| モード | ユーザー モード、カーネル モード |
| 対象 | ライブ、クラッシュ ダンプ |
| プラットフォーム | すべて |
追加情報
.scriptloadコマンドはスクリプトをロードし、スクリプトを実行する。 次のコマンドは、TestScript.jsのロードに成功したことを示している。
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
スクリプトの初期ロードと実行でエラーが発生した場合は、行番号とエラーメッセージを含めてコンソールに表示される。
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'
.scriptloadコマンドはJavaScriptで以下を実行する。
- ルートコード
- intializeScript関数（スクリプト内に存在する場合）
.scriptloadコマンドを使用してスクリプトがロードされると、intializeScript関数とスクリプトのルートコードが実行され、スクリプトに存在する名前がデバッガ（dx Debugger）のルート名前空間にブリッジされ、スクリプトがアンロードされ、そのオブジェクトへのすべての参照が解放されるまで、スクリプトはメモリに常駐します。
スクリプトは、デバッガーの式評価器に新しい関数を提供したり、デバッガーのオブジェクト・モデルを変更したり、NatVisビジュアライザーと同じようにビジュアライザーとして機能したりできます。 NavVisとデバッガの詳細については、以下を参照してください dx (Display NatVis Expression).
JavaScriptの詳細については JavaScriptデバッガ・スクリプト. デバッガー・オブジェクトの詳細については JavaScript拡張機能のネイティブオブジェクト.
要件
.scriptコマンドを使用する前に、スクリプト・プロバイダをロードする必要がある。 .scriptprovidersコマンドを使用して、JavaScriptプロバイダがロードされていることを確認します。
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')