.scriptload (Carica script)

  • Articolo

Il comando .scriptload caricherà ed eseguirà il file di script specificato.

.scriptload ScriptFile

Parametri

ScriptFile
Specifica il nome del file di script da caricare. ScriptFile deve includere l'estensione .js nome file. È possibile usare percorsi assoluti o relativi. I percorsi relativi sono relativi alla directory in cui è stato avviato il debugger. I percorsi di file contenenti spazi non sono supportati.

Ambiente

Articolo Descrizione
Modalità Modalità utente, modalità kernel
Target Live, crash dump
Piattaforme Tutte le date

Informazioni aggiuntive

Il comando .scriptload caricherà uno script ed eseguirà uno script. Il comando seguente mostra il caricamento corretto di TestScript.js.

0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'

Se si verificano errori nel caricamento iniziale e nell'esecuzione dello script, gli errori verranno visualizzati nella console, inclusi il numero di riga e il messaggio di errore.

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'

Il comando .scriptload eseguirà quanto segue in javaScript.

  • codice radice
  • funzione intializeScript (se presente nello script)

Quando uno script viene caricato usando il comando .scriptload, la funzione intializeScript e il codice radice dello script vengono eseguiti, i nomi presenti nello script vengono inseriti nello spazio dei nomi radice del debugger (dx Debugger) e lo script rimane residente in memoria finché non viene scaricato e tutti i riferimenti ai relativi oggetti vengono rilasciati.

Lo script può fornire nuove funzioni all'analizzatore di espressioni del debugger, modificare il modello a oggetti del debugger o fungere da visualizzatori nello stesso modo in cui un visualizzatore NatVis esegue. Per altre informazioni su NavVis e il debugger, vedere dx (Display NatVis Expression).

Per altre informazioni sull'uso di JavaScript, vedere Scripting del debugger JavaScript. Per altre informazioni sugli oggetti debugger, vedere Oggetti nativi nelle estensioni JavaScript.

Requisiti

Prima di usare uno dei comandi con estensione script, è necessario caricare un provider di script. Usare il comando .scriptproviders per verificare che il provider JavaScript sia caricato.

0:000> .scriptproviders
Available Script Providers:
    NatVis (extension '.NatVis')
    JavaScript (extension '.js')

Vedi anche

.scriptunload (Scarica script)

JavaScript Debugger Scripting