JScript 可以依據條件編譯變數的值來控制程式碼的編譯。除了使用 JScript 內建的變數,也可以用 @set 指令或 /define 命令列選項定義自己的變數。
@cc_on 啟動條件編譯支援。
@if 依運算式的值,有條件地執行一組語句。
@set 建立供條件編譯使用的變數。
@cc_on、@if 或 @set 都能啟動條件編譯。幾個典型用途包括:在 JScript 中使用新功能、把除錯支援嵌進同一份程式碼、以及追蹤程式碼執行流程。
撰寫由瀏覽器執行的程式碼時,務必把條件編譯碼放在註解中,這樣不支援條件編譯的宿主才能直接忽略它。示例如下:
/*@cc_on
@*/
/*@if (@_jscript_version >= 5)
document.write("JScript Version 5.0 以上.<BR>");
@else @*/
document.write("需要更新的指令碼引擎.<BR>");
/*@end @*/
這個範例使用特殊的註解分隔符,只有在 @cc_on 啟動條件編譯之後才會生效。不支援條件編譯的引擎只會顯示建議更新引擎的訊息而不會報錯;支援的引擎則會依版本編譯第一或第二段 document.write。請注意,7.x 版代表 JScript .NET。
條件編譯對伺服器端程式碼與命令列程式同樣有用。在這些環境中,可以用它把除錯用的額外功能編進同一份程式,方便在除錯模式下分析。
@_win32 在 Win32 系統上執行(且未指定 /platform 或指定 /platform:anycpu)時為 true,否則為 NaN。
@_win16 在 Win16 系統上執行時為 true,否則為 NaN。
@_mac 在 Apple Macintosh 系統上執行時為 true,否則為 NaN。
@_alpha 在 DEC Alpha 處理器上執行時為 true,否則為 NaN。
@_x86 在 Intel 處理器上執行(且未指定 /platform 或指定 /platform:anycpu)時為 true,否則為 NaN。
@_mc680x0 在 Motorola 680x0 處理器上執行時為 true,否則為 NaN。
@_PowerPC 在 Motorola PowerPC 處理器上執行時為 true,否則為 NaN。
@_jscript 永遠為 true。
@_jscript_build JScript 指令碼引擎的內部版本號。
@_jscript_version 以 major.minor 格式表示的 JScript 版本號數字。
@_debug 在除錯模式下編譯時為 true,否則為 false。
@_fast 在快速模式下編譯時為 true,否則為 false。
要注意版本號的對應關係:JScript .NET 回報 7.x,而 JScript 8.0 回報 8.x。
使用前必須先啟動條件編譯,也就是加上 @cc_on。這些變數主要用於針對瀏覽器撰寫的程式碼;在 ASP、ASP.NET 頁面或命令列程式中較少使用,因為那些環境有其他方式可以判斷編譯器的相容性。
/*@cc_on
document.write("JScript version: " + @_jscript_version + ".<BR>");
@if (@_win32)
document.write("在 32 位元 Windows 上執行.<BR>");
@elif (@_win16)
document.write("在 16 位元 Windows 上執行.<BR>");
@else
document.write("在其他平台上執行.<BR>");
@end
@*/
最後補一句現實狀況:條件編譯是 IE 獨有的 JScript 功能,在 IE11 之後已被完全移除,Edge 與其他現代瀏覽器一律不支援。這套語法今天只有維護上古系統時才會遇到;判斷執行環境請改用標準的 navigator.userAgent 或更好的「特性偵測」(例如 if ('addEventListener' in window))。