早期的 JavaScript,想完成任何事幾乎都繞不開一些簡單函式——瀏覽器之間連基礎功能(如 addEventListener 與 attachEvent)都有差異。時代變了,但仍有些函式是每個開發者都該掌握的工具,能幫你完成功能、也提升效能。
對高耗能事件而言,debounce 是很實用的解法。如果你沒有對 scroll、resize、key* 事件做去抖動,幾乎等同寫錯。以下實作能讓程式碼保持高效:
// 回傳一個函式,若它被不間斷呼叫則不會執行;
// 停止呼叫 N 毫秒後再次呼叫才會執行。
// 若傳入 'immediate' 參數為真,則每串呼叫的第一次會立即執行。
function debounce(func, wait, immediate) {
var timeout;
return function () {
var context = this, args = arguments;
var later = function () {
timeout = null;
if (!immediate) func.apply(context, args);
};
var callNow = immediate && !timeout;
clearTimeout(timeout);
timeout = setTimeout(later, wait);
if (callNow) func.apply(context, args);
};
}
// 用法
var myEfficientFn = debounce(function () {
// 所有繁重的操作
}, 250);
window.addEventListener('resize', myEfficientFn);
debounce 保證回呼在指定時間內不會執行超過一次,對頻繁觸發的事件特別重要。順帶一提,若你需要的是「固定間隔執行一次」而非「停止後才執行」,那要的是 throttle。
當沒有對應事件可以監聽時,就得每隔一段時間主動檢查狀態是否已達成:
function poll(fn, callback, errback, timeout, interval) {
var endTime = Number(new Date()) + (timeout || 2000);
interval = interval || 100;
(function p() {
if (fn()) {
callback(); // 條件滿足,執行成功回呼
} else if (Number(new Date()) < endTime) {
setTimeout(p, interval); // 未超時,再試一次
} else {
errback(new Error('timed out for ' + fn)); // 超時,執行失敗回呼
}
})();
}
// 用法:確保某元素已可見
poll(
function () { return document.getElementById('lightbox').offsetWidth > 0; },
function () { /* 成功 */ },
function () { /* 失敗 */ }
);
輪詢在 Web 開發中被用了很久,即使有了 MutationObserver 與 requestIdleCallback,處理第三方腳本的載入等待時仍常派上用場。
function once(fn, context) {
var result;
return function () {
if (fn) {
result = fn.apply(context || this, arguments);
fn = null; // 執行後把函式清空,後續呼叫直接回傳快取值
}
return result;
};
}
// 用法
var canOnlyFireOnce = once(function () { console.log('Fired!'); });
canOnlyFireOnce(); // "Fired!"
canOnlyFireOnce(); // 什麼都不做
once 確保函式只被執行一次,能避免重複初始化,也常用於一次性的事件監聽。
從相對路徑得到完整絕對 URL,並不像想像中那麼單純——URL 建構子若參數不齊全會出問題,而你有時就是不知道該給什麼。這裡有個優雅的小技巧:
var getAbsoluteUrl = (function () {
var a;
return function (url) {
if (!a) a = document.createElement('a');
a.href = url;
return a.href;
};
})();
// 用法
getAbsoluteUrl('/something'); // https://example.com/something
原理是 a 元素的 href 屬性會自動依目前文件解析相對路徑,讀回來就是絕對 URL。a 元素被閉包保存並重複使用,不必每次建立。今天的標準寫法則是 new URL('/something', location.href).href。
(function () {
var toString = Object.prototype.toString;
var fnToString = Function.prototype.toString;
var reHostCtor = /^\[object .+?Constructor\]$/;
// 以 Object#toString 為模板編出用來比對原生方法的正則
var reNative = RegExp('^' +
String(toString)
.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
.replace(/toString|(function).*?(?=[\s'"]|for)| .+?(?=[,)\\])/g, '$1.*?') + '$');
function isNative(value) {
var type = typeof value;
return type == 'function'
? reNative.test(fnToString.call(value))
: (value && type == 'object' && reHostCtor.test(toString.call(value))) || false;
}
module.exports = isNative;
}());
// 用法
isNative(alert); // true
isNative(myCustomFunction); // false
它的原理是:原生函式的 toString() 會回傳 function foo() { [native code] },自製函式則會回傳實際程式碼。這個函式並不完美(可被偽造),但足以勝任大多數偵測需求。
我們都知道可以用 querySelectorAll 取得 NodeList 再逐一設定樣式。但有沒有更高效的方式?直接對樣式表插入規則:
var sheet = (function () {
var style = document.createElement('style');
// 若需要指定媒體類型或 media query,可在此設定:
// style.setAttribute('media', 'screen');
// style.setAttribute('media', 'only screen and (max-width: 1024px)');
// WebKit 的 hack:樣式元素需要有內容才會生效
style.appendChild(document.createTextNode(''));
document.head.appendChild(style);
return style.sheet;
}());
// 用法
sheet.insertRule("header { float: left; opacity: 0.8; }", 1);
這對重度依賴 AJAX 的動態網站特別有用:為一個選擇器寫一次規則,就不必為目前及未來所有符合的元素逐一設定 inline style,效能與維護性都更好。
我們常需要在下一步之前驗證輸入是否可靠、表單是否有效。那要怎麼確認「這個元素是否符合某個選擇器」?
function matchesSelector(el, selector) {
var p = Element.prototype;
var f = p.matches || p.webkitMatchesSelector || p.mozMatchesSelector
|| p.msMatchesSelector || function (s) {
return [].indexOf.call(document.querySelectorAll(s), this) !== -1;
};
return f.call(el, selector);
}
// 用法
matchesSelector(document.getElementById('myDiv'), 'div.someSelector[some-attribute=true]');
今天的標準寫法已經統一為 el.matches(selector),不需要再處理各家前綴;但理解它背後的 polyfill 思路仍有價值。
這七個函式有些已有原生或標準替代品(new URL()、el.matches()),有些則已內建於 lodash / underscore 等工具庫(_.debounce、_.once)。但知道它們的原理,你才判斷得出什麼時候該用哪一種,也才能在沒有函式庫的環境中自己寫出來。還有哪些你認為必備的函式?值得一併整理起來。