asm.js 是 JavaScript 的嚴格子集,透過型別標註讓引擎能提前編譯為接近原生的機器碼。它約定每個 asm.js 模組都是一個普通函數,並在函數體第一行宣告 "use asm",然後依固定結構分成五個區段。
function mymodule(global, foreign, buffer) {
"use asm";
// -------------------------------------------------------------------------
// SECTION 1: imports —— 匯入外部值與視圖
var H32 = new global.Int32Array(buffer);
var HU32 = new global.Uint32Array(buffer);
var log = foreign.consoleDotLog;
// -------------------------------------------------------------------------
// SECTION 2: functions —— 函數定義
function f(x, y, z, w) {
// SECTION A: 參數型別宣告
x = x|0; // int 參數
y = +y; // double 參數
// SECTION B: 函數主體
log(x|0); // 呼叫外部函式,必須強制轉為整數
log(y); // 呼叫外部函式,已知是 double
x = (x+3)|0; // 帶號整數加法
// SECTION C: 無條件回傳
return ((((x+1)|0) >>> 0) / (x|0)) >>> 0; // 複合運算式
}
function g() {
g_f = +g_i; // 讀寫全域變數
return;
}
function g2() {
return;
}
function h(i, x) {
i = i|0;
x = x|0;
H32[(i & 0xffffffff) >> 4] = x; // 以 2^k-1 遮罩後再按位元組數位移
ftable_2[(x-2) & 2](); // 動態呼叫函數表 2 中的函數
}
// -------------------------------------------------------------------------
// SECTION 3: function tables —— 函數表,同表內函數需同型別
var ftable_1 = [f];
var ftable_2 = [g, g2];
// -------------------------------------------------------------------------
// SECTION 4: globals —— 全域變數
var g_i = 0; // int 全域
var g_f = 0.0; // double 全域
// -------------------------------------------------------------------------
// SECTION 5: exports —— 對外公開的介面
return { f_export: f, goop: g };
}
幾個關鍵語法約定值得記住:x = x|0 表示把參數定型為 32 位元帶號整數,y = +y 則定型為 double;讀寫外部函式時,整數參數要加上 |0 強制轉型,double 則可直接傳遞;對 typed array 的索引運算必須以 >>> 無號位移搭配遮罩,才能滿足 asm.js 對可預測效能的要求;最後一區以物件字面值列出要匯出的函數,讓外部程式碼得以呼叫。