與 querystring.escape 相對應,querystring.unescape 則是負責解碼的一環。它可用來重寫 querystring.parse 的解碼邏輯。
這個方法作為一個可被覆寫的解碼函式存在,讓你能自訂 querystring.parse 在解析時所採用的解碼方式。
querystring.unescape
無參數需特別設定。
Node.js 內部實作了一個名為 unescapeBuffer 的方法,作為 decodeURIComponent 的安全高效替代品。它以狀態機(CHAR、HEX0、HEX1)的方式逐字元掃描,把 %XX 形式的十六進位序列還原為對應位元組,並可選擇是否把 '+' 還原為空格:
// a safe fast alternative to decodeURIComponent
QueryString.unescapeBuffer = function(s, decodeSpaces) {
var out = new Buffer(s.length);
var state = 'CHAR'; // states: CHAR, HEX0, HEX1
var n, m, hexchar;
for (var inIndex = 0, outIndex = 0; inIndex <= s.length; inIndex++) {
var c = s.charCodeAt(inIndex);
switch (state) {
case 'CHAR':
switch (c) {
case charCode('%'):
n = 0;
m = 0;
state = 'HEX0';
break;
case charCode('+'):
if (decodeSpaces) c = charCode(' ');
// pass thru
default:
out[outIndex++] = c;
break;
}
break;
case 'HEX0':
state = 'HEX1';
hexchar = c;
if (charCode('0') <= c && c <= charCode('9')) {
n = c - charCode('0');
} else if (charCode('a') <= c && c <= charCode('f')) {
n = c - charCode('a') + 10;
} else if (charCode('A') <= c && c <= charCode('F')) {
n = c - charCode('A') + 10;
} else {
out[outIndex++] = charCode('%');
out[outIndex++] = c;
state = 'CHAR';
break;
}
break;
case 'HEX1':
state = 'CHAR';
if (charCode('0') <= c && c <= charCode('9')) {
m = c - charCode('0');
} else if (charCode('a') <= c && c <= charCode('f')) {
m = c - charCode('a') + 10;
} else if (charCode('A') <= c && c <= charCode('F')) {
m = c - charCode('A') + 10;
} else {
out[outIndex++] = charCode('%');
out[outIndex++] = hexchar;
out[outIndex++] = c;
break;
}
out[outIndex++] = 16 * n + m;
break;
}
}
return out.slice(0, outIndex - 1);
};
正因為解碼被抽成獨立函式,你才能在有特殊需求時,把它替換成自訂的解碼規則。