JSConstraintsDebug （JSConstraintsDebug.exe） 是一個命令列工具，在開發 V4 印表機驅動程式時為 JavaScript Constraints 提供偵錯支援。
| 哪裡可以下載 JSConstraintsDebug？ |
|---|
JSConstraintsDebug.exe 包含在 Microsoft Windows 驅動程式套件 （WDK） 中。 如需取得 WDK 的相關資訊，請參閱 Windows 驅動程式套件下載。 |
此工具會針對使用者提供的列印票證，在目標驅動程式的 JavaScript 條件約束上執行下列每個相關進入點 API：
TConvertPrintTicketToDevMode（轉換列印票據為開發模式）
在執行期間，工具會提示適當的 IDE 偵錯工具，例如 Visual Studio。 一旦選擇，限制條件的原始碼會在 JavaScript 偵錯工具中的陳述式處開啟並停止。
若要偵錯 JS 約束文件，請遵循下列步驟：
開啟命令提示字元視窗。
執行 JSConstraintsDebug.exe 工具，並至少指定印表機名稱和測試列印票證的路徑。
選擇您要使用的偵錯工具。
在使用者模式中執行 JSConstraintsDebug
要啟用 JavaScript 函數的除錯，需要高級權限。 若要在使用者模式中執行，必須先設定下列登錄機碼，才能執行 JSConstraintsDebug.exe：
鍵名稱 |
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print |
值名稱 |
啟用JavaScript偵錯 |
類型 |
DWORD |
價值觀 |
1 |
JavaScript 偵錯工具陳述式
您可以使用偵錯工具陳述式在 JavaScript 來源中建立岔斷點。 這將暫停 Visual Studio 的操作，並允許逐步偵錯。 這些陳述式可以插入任何 JavaScript 限制 API 中。
例如：
function validatePrintTicket(PrintTicket, scriptContext)
{
debugger; // debug tool will pause at this breakpoint
...
}
JSConstraintsDebug 命令語法
JSConstraintsDebug <PrinterName> <PrintTicket> [MergePrintTicket] [Constraints]
指令參數
| 參數 | 說明 |
|---|---|
印表機名稱 |
必須的。 指定包含 JS 限制來源檔的列印驅動程式的字串名稱。 此驅動程式將用於所有偵錯作業。 |
列印票證 |
必須的。 指定要驗證的列印票證 XML 檔案的路徑和名稱。 |
合併列印票證 |
選擇性。 指定將用來驗證合併作業的列印票證 XML 檔案的路徑和名稱。 如果未設定此參數，預設 DevMode 將會轉換成列印票證，並傳遞至合併和驗證 API。 |
條件約束 |
選擇性。 指定 JavaScript 限制檔案的路徑和名稱，該檔案將在偵錯之前取代目標印表機驅動程式中找到的現有限制來源檔案。 |
注意 使用約束參數指定條件約束檔案會覆寫目標驅動程式中的既有程式碼。
範例
針對已知的測試列印票證偵錯列印驅動程式。
JSConstraintsDebug “Contoso Printer” PrintTicket.xml
針對已知的測試列印票證，使用新的限制來源檔案進行列印驅動程式的偵錯程序。
JSConstraintsDebug “Contoso Printer” PrintTicket.xml Constraints.js
測試兩個自訂列印票證之間的合併和驗證作業。
JSConstraintsDebug “Contoso Printer” PrintTicket.xml PrintTicket2.xml