.scriptload (スクリプトの読み込み)

その .scriptload コマンドは、指定されたスクリプトファイルをロードして実行する。

.scriptload ScriptFile

パラメーター

ScriptFile
ロードするスクリプトファイル名を指定する。 ScriptFile should include the .js file name extension. 絶対パスも相対パスも使用できる。 相対パスは、デバッガーを起動したディレクトリからの相対パスです。 スペースを含むファイルパスはサポートされていません。

環境

項目	説明
モード	ユーザー モード、カーネル モード
対象	ライブ、クラッシュ ダンプ
プラットフォーム	すべて

追加情報

.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')

関連項目

.scriptunload (スクリプトのアンロード)

JavaScript デバッガー スクリプト