.scriptload (Load Script)
La commande .scriptload chargera et exécutera le fichier de script spécifié.
.scriptload ScriptFile
Paramètres
ScriptFile
Spécifie le nom du fichier de script à charger. ScriptFile doit inclure l’extension de nom de fichier .js. Des chemins absolus ou relatifs peuvent être utilisés. Les chemins relatifs sont relatifs au répertoire dans lequel vous avez démarré le débogueur. Les chemins de fichiers contenant des espaces ne sont pas pris en charge.
Environnement
| Élément | Description |
|---|---|
| Modes | Mode utilisateur, mode noyau |
| Targets | Live, vidage de la mémoire |
| Platforms | Tous |
Informations supplémentaires
La commande .scriptload chargera un script et l’exécutera. La commande suivante montre le chargement réussi de TestScript.js.
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
Si des erreurs surviennent lors du chargement initial et de l’exécution du script, les erreurs seront affichées dans la console, y compris le numéro de ligne et le message d’erreur.
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'
La commande .scriptload exécutera ce qui suit dans un JavaScript :
- code racine
- fonction intializeScript (si présente dans le script)
Lorsqu’un script est chargé à l’aide de la commande .scriptload, la fonction intializeScript et le code racine du script sont exécutés, les noms qui sont présents dans le script sont intégrés dans l’espace de noms racine du débogueur (dx Debugger) et le script reste résident en mémoire jusqu’à ce qu’il soit déchargé et que toutes les références à ses objets soient libérées.
Le script peut fournir de nouvelles fonctions à l’évaluateur d’expressions du débogueur, modifier le modèle d’objet du débogueur ou agir en tant que visualiseurs de la même manière qu’un visualiseur NatVis. Pour plus d’informations sur NavVis et le débogueur, veuillez consulter dx (Display NatVis Expression).
Pour plus d’informations sur le travail avec JavaScript, veuillez consulter la section Script du débogueur JavaScript. Pour plus d’informations sur les objets de débogage, veuillez consulter la section Objets natifs dans les extensions JavaScript.
Spécifications
Avant d’utiliser l’une des commandes .script, un fournisseur de script doit être chargé. Utilisez la commande .scriptproviders pour confirmer que le fournisseur JavaScript est chargé.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')