通过

.scriptload（加载脚本）

  • 项目

.scriptload 命令将加载并执行指定的脚本文件。

.scriptload ScriptFile

参数

ScriptFile
指定要加载的脚本文件的名称。 ScriptFile 应包含 .js 文件扩展名。 可以使用绝对路径或相对路径。 相对路径相对于启动调试器的目录。 不支持包含空格的文件路径。

环境

项 说明
模式 用户模式、内核模式
目标 实时、崩溃转储
平台 全部

其他信息

.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 调制器）的根命名空间中，并且脚本将一直驻留在内存中，直到卸载该脚本并释放对其对象的所有引用。

该脚本可以为调试器的表达式计算器提供新函数、修改调试器的对象模型，也可以像 NatVis 可视化工具那样充当可视化工具。 有关 NavVis 和调试器的详细信息，请参阅 dx（显示 NatVis 表达式）。

有关使用 JavaScript 的详细信息，请参阅 JavaScript 调试器脚本。 有关调试器对象的详细信息，请参阅 JavaScript 扩展中的本机对象。

要求

在使用任何 .script 命令之前，需要加载脚本提供程序。 使用 .scriptproviders 命令确认 JavaScript 提供程序已加载。

0:000> .scriptproviders
Available Script Providers:
    NatVis (extension '.NatVis')
    JavaScript (extension '.js')

另请参阅

.scriptload（卸载脚本）

JavaScript 调试器脚本