.scriptload (Cargar script)
El comando .scriptload cargará y ejecutará el archivo de script especificado.
.scriptload ScriptFile
Parámetros
ScriptFile
Especifica el nombre del archivo de script que se va a cargar. 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 .scriptload cargará un script y lo ejecutará. El siguiente comando muestra la carga correcta de TestScript.js.
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
Si se produce algún error en la carga inicial y la ejecución del script, los errores se mostrarán en la consola, incluidos el número de línea y el mensaje de error.
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'
El comando .scriptload ejecutará lo siguiente en un JavaScript.
- código raíz
- Función intializeScript (si está presente en el script)
Cuando se carga un script mediante el comando .scriptload, se ejecuta la función intializeScript y el código raíz del script, los nombres presentes en el script se puentean al espacio de nombres raíz del depurador (depurador dx) y el script permanece residente en memoria hasta que se descarga y se liberan todas las referencias a sus objetos.
El script puede proporcionar nuevas funciones al evaluador de expresiones del depurador, modificar el modelo de objetos del depurador o actuar como un visualizador de forma muy similar a como lo hace un visualizador NatVis. Para obtener más información sobre NavVis y el depurador, consulte dx (Display NatVis Expression).
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 .scriptproviders para confirmar que el proveedor de JavaScript está cargado.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')