.scriptload (Load Script)
Perintah .scriptload akan memuat dan menjalankan file skrip yang ditentukan.
.scriptload ScriptFile
Parameter
ScriptFile
Menentukan nama file skrip yang akan dimuat. ScriptFile harus menyertakan ekstensi nama file .js. Jalur absolut atau relatif dapat digunakan. Jalur relatif relatif terhadap direktori tempat Anda memulai debugger. Jalur file yang berisi spasi tidak didukung.
Lingkungan
| Item | Deskripsi |
|---|---|
| Mode | Mode pengguna, mode kernel |
| Target | Live, crash dump |
| Platform | Semua |
Informasi Tambahan
Perintah .scriptload akan memuat skrip dan menjalankan skrip. Perintah berikut menunjukkan beban TestScript.js yang berhasil.
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
Jika ada kesalahan dalam beban awal dan eksekusi skrip, kesalahan akan ditampilkan ke konsol, termasuk nomor baris dan pesan kesalahan.
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'
Perintah .scriptload akan menjalankan yang berikut ini dalam JavaScript.
- kode akar
- fungsi intializeScript (jika ada dalam skrip)
Ketika skrip dimuat menggunakan perintah .scriptload, fungsi intializeScript dan kode akar skrip dijalankan, nama yang ada dalam skrip dihubungkan ke dalam namespace layanan akar debugger (dx Debugger) dan skrip tetap tinggal dalam memori sampai dibongkar dan semua referensi ke objeknya dirilis.
Skrip dapat menyediakan fungsi baru ke evaluator ekspresi debugger, memodifikasi model objek debugger, atau dapat bertindak sebagai visualizer dengan cara yang sama seperti yang dilakukan visualizer NatVis. Untuk informasi selengkapnya tentang NavVis dan debugger, lihat dx (Tampilkan Ekspresi NatVis).
Untuk informasi selengkapnya tentang bekerja dengan JavaScript, lihat Pembuatan Skrip JavaScript Debugger. Untuk informasi selengkapnya tentang objek debugger, lihat Objek Asli di Ekstensi JavaScript.
Persyaratan
Sebelum menggunakan salah satu perintah .script, penyedia skrip perlu dimuat. Gunakan perintah .scriptproviders untuk mengonfirmasi bahwa penyedia JavaScript dimuat.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')