.scriptrun (Exécuter le script)

  • Article

La commande .scriptrun chargera et exécutera un script JavaScript.

.scriptrun ScriptFile

Paramètres

ScriptFile
Spécifie le nom du fichier de script à charger et à exécuter. 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 sur incident
Plateformes Tous

Informations supplémentaires

La commande .scriptrun chargera un script et exécutera le code suivant.

  • root
  • intializeScript
  • invokeScript

Un message de confirmation est affiché lorsque le code est chargé et exécuté.

0:000> .scriptrun C:\WinDbg\Scripts\helloWorld.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\helloWorld.js'
Hello World!  We are in JavaScript!

Toutes les manipulations du modèle d’objet effectuées par le script resteront en place jusqu’à ce que le script soit ultérieurement déchargé ou soit exécuté à nouveau avec un contenu différent.

Ce tableau résume quelles fonctions sont exécutées par .scriptload et .scriptrun.

.scriptload .scriptrun
root Oui Oui
initializeScript Oui Oui
invokeScript Oui
uninitializeScript

Vous pouvez utiliser ce code pour voir quelles fonctions sont appelées avec la commande .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");
}

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 .load (Load Extension DLL) pour charger le fichier dll du fournisseur JavaScript.

0:000> .load C:\ScriptProviders\jsprovider.dll

Voir aussi

.scriptload (Load Script)

Script du débogueur JavaScript