.scriptrun (Ejecutar script)
El comando .scriptrun cargará y ejecutará un JavaScript.
.scriptrun ScriptFile
Parámetros
ScriptFile
Especifica el nombre del archivo de script que se va a cargar y ejecutar. ScriptFile debe incluir la extensión de nombre de archivo .js. Pueden utilizarse rutas absolutas o relativas. Las rutas relativas son relativas al directorio en el que inició el depurador. No se admiten rutas de archivos que contengan espacios.
Entorno
| Elemento | Descripción |
|---|---|
| Modos | Modo de usuario, modo kernel |
| Destinos | En tiempo real, volcado de errores |
| Platforms | All |
Información adicional
El comando .scriptrun cargará un script y ejecutará el siguiente código.
- root
- intializeScript
- invokeScript
Cuando se cargue y ejecute el código, aparecerá un mensaje de confirmación.
0:000> .scriptrun C:\WinDbg\Scripts\helloWorld.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\helloWorld.js'
Hello World! We are in JavaScript!
Cualquier manipulación del modelo de objeto realizada por el script permanecerá en su lugar hasta que el script se descargue posteriormente o se ejecute de nuevo con un contenido diferente.
En esta tabla se resume qué funciones son ejecutadas por .scriptload y .scriptrun.
| .scriptload | .scriptrun | |
| root | sí | sí |
| initializeScript | sí | sí |
| invokeScript | sí | |
| uninitializeScript |
Puede utilizar este código para ver qué funciones se llaman con el comando .script run.
// 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 obtener más información sobre cómo trabajar con JavaScript, consulte Depurador de script de JavaScript. Para obtener más información sobre los objetos de depurador, consulte Objetos nativos en las extensiones de JavaScript.
Requisitos
Antes de utilizar cualquiera de los comandos .script, es necesario cargar un proveedor de scripts. Utilice el comando .load (cargar DLL de extensión) para cargar el dll del proveedor de JavaScript.
0:000> .load C:\ScriptProviders\jsprovider.dll