.scriptload(스크립트 로드)
.scriptload 명령은 지정된 스크립트 파일을 로드하고 실행합니다.
.scriptload ScriptFile
매개 변수
ScriptFile
로드할 스크립트 파일의 이름을 지정합니다. ScriptFile 에는 .js 파일 이름 확장명을 포함해야 합니다. 절대 또는 상대 경로를 사용할 수 있습니다. 상대 경로는 디버거를 시작한 디렉터리를 기준으로 합니다. 공백을 포함하는 파일 경로는 지원되지 않습니다.
환경
| 항목 | 설명 |
|---|---|
| 모드 | 사용자 모드, 커널 모드 |
| 대상 | 라이브, 크래시 덤프 |
| 플랫폼 | 모두 |
추가 정보
.scriptload 명령은 스크립트를 로드하고 스크립트를 실행합니다. 다음 명령은 TestScript.js 성공적으로 로드하는 방법을 보여줍니다.
0:000> .scriptload C:\WinDbg\Scripts\TestScript.js
JavaScript script successfully loaded from 'C:\WinDbg\Scripts\TestScript.js'
스크립트의 초기 로드 및 실행에 오류가 있는 경우 오류는 줄 번호 및 오류 메시지를 포함하여 콘솔에 표시됩니다.
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'
.scriptload 명령은 JavaScript에서 다음을 실행합니다.
- 루트 코드
- intializeScript 함수(스크립트에 있는 경우)
.scriptload 명령을 사용하여 스크립트를 로드하면 intializeScript 함수와 스크립트의 루트 코드가 실행되고, 스크립트에 있는 이름은 디버거(dx 디버거)의 루트 네임스페이스에 브리지되고 스크립트는 언로드되고 해당 개체에 대한 모든 참조가 해제될 때까지 메모리에 유지됩니다.
스크립트는 디버거의 식 계산자에 새 함수를 제공하거나, 디버거의 개체 모델을 수정하거나, NatVis 시각화 도우미와 거의 동일한 방식으로 시각화 도우미 역할을 할 수 있습니다. NavVis 및 디버거에 대한 자세한 내용은 dx(NatVis 식 표시)를 참조하세요.
JavaScript 작업에 대한 자세한 내용은 JavaScript 디버거 스크립팅을 참조 하세요. 디버거 개체에 대한 자세한 내용은 JavaScript 확장의 네이티브 개체를 참조 하세요.
요구 사항
.script 명령을 사용하기 전에 스크립팅 공급자를 로드해야 합니다. .scriptproviders 명령을 사용하여 JavaScript 공급자가 로드되어 있는지 확인합니다.
0:000> .scriptproviders
Available Script Providers:
NatVis (extension '.NatVis')
JavaScript (extension '.js')