.scriptload (Load Script)
Команда .scriptload загружает и выполняет указанный файл скрипта.
.scriptload ScriptFile
Параметры
ScriptFile
Указывает имя загружаемого файла скрипта. ScriptFile должен включать расширение имени файла .js. Можно использовать абсолютные или относительные пути. Относительные пути относятся к каталогу, в который был запущен отладчик. Пути к файлам, содержащие пробелы, не поддерживаются.
Среда
| Позиция | Description |
|---|---|
| Режимы | Режим пользователя, режим ядра |
| Целевые объекты | Динамический, аварийный дампа |
| Платформы | Все |
Дополнительная информация
Команда .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.
Требования
Перед использованием любой из команд скрипта необходимо загрузить поставщика сценариев. Используйте команду scriptproviders, чтобы убедиться, что поставщик JavaScript загружен.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')