.scriptload (Carregar Script)
O comando .scriptload carregará e executará o arquivo de script especificado.
.scriptload ScriptFile
Parâmetros
Arquivo de script
Especifica o nome do arquivo de script a ser carregado. 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 .scriptload carregará e executará um script. O comando a seguir mostra o carregamento bem-sucedido de TestScript.js.
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
Se houver erros no carregamento inicial e na execução do script, os erros serão exibidos no console, incluindo o número da linha e a mensagem de erro.
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'
O comando .scriptload executará o seguinte em um JavaScript.
- código raiz
- função intializeScript (se presente no script)
Quando um script é carregado usando o comando .scriptload, a função intializeScript e o código raiz do script são executados, os nomes que estão presentes no script são transferidos para o namespace raiz do depurador (dx Debugger) e o script permanece na memória até que seja descarregado e todas as referências a seus objetos sejam liberadas.
O script pode fornecer novas funções para o avaliador de expressão do depurador, modificar o modelo de objeto do depurador ou atuar como um visualizador da mesma maneira que um visualizador NatVis. Para obter mais informações sobre o NatVis e o depurador, confira dx (Exibir Expressão NatVis).
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 .scriptproviders para confirmar se o provedor JavaScript está carregado.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')