.scriptrun (Executar Script)
O comando .scriptrun carregará e executará um JavaScript.
.scriptrun ScriptFile
Parâmetros
Arquivo de script
Especifica o nome do arquivo de script a ser carregado e executado. ScriptFile deve incluir a extensão de nome de arquivo .js. Os caminhos absoluto ou relativo podem ser usados. Os caminhos relativos são relativos ao diretório no qual você iniciou o depurador. Não há suporte para caminhos de arquivo que contenham espaços.
Ambiente
| Item | Descrição |
|---|---|
| Modos | Modo de usuário, modo kernel |
| Destinos | Ao vivo, despejo de memória |
| Plataformas | Tudo |
Informações Adicionais
O comando .scriptrun carregará um script e executará o código a seguir.
- root
- intializeScript
- invokeScript
Uma mensagem de confirmação é exibida quando o código é carregado e executado.
0:000> .scriptrun C:\WinDbg\Scripts\helloWorld.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\helloWorld.js'
Hello World! We are in JavaScript!
Quaisquer manipulações de modelo de objeto feitas pelo script permanecerão no local até que o script seja descarregado subsequentemente ou seja executado novamente com conteúdo diferente.
Esta tabela resume quais funções são executadas por .scriptload e .scriptrun.
| .scriptload | .scriptrun | |
| root | sim | sim |
| initializeScript | sim | sim |
| invokeScript | sim | |
| uninitializeScript |
Você pode usar esse código para ver quais funções são chamadas com o comando .scriptrun.
// Root of Script
host.diagnostics.debugLog("***>; Code at the very top (root) of the script is always run \n");
function initializeScript()
{
// Add code here that you want to run every time the script is loaded.
// We will just send a message to indicate that function was called.
host.diagnostics.debugLog("***>; initializeScript was called \n");
}
function invokeScript()
{
// Add code here that you want to run every time the script is executed.
// We will just send a message to indicate that function was called.
host.diagnostics.debugLog("***>; invokeScript was called \n");
}
Para obter mais informações sobre como trabalhar com JavaScript, confira Script do Depurador JavaScript. Para obter mais informações sobre os objetos do depurador, confira Objetos Nativos em Extensões JavaScript.
Requisitos
Antes de usar qualquer um dos comandos .script, um provedor de script precisa ser carregado. Use o comando .load (Carregar DLL da Extensão) para carregar a dll do provedor JavaScript.
0:000> .load C:\ScriptProviders\jsprovider.dll