日常開發中反覆要用的那些小函數,值得整理成一份備忘錄。以下按用途分類收錄,方便隨時翻查。需要說明的是,這批代碼寫於瀏覽器兼容性還很重要的年代,部分寫法今天已有更簡潔的標準替代方案,我會在每節末尾標註。
var BrowserInfo = {
userAgent: navigator.userAgent.toLowerCase(),
isAndroid: Boolean(navigator.userAgent.match(/android/ig)),
isIphone: Boolean(navigator.userAgent.match(/iphone|ipod/ig)),
isIpad: Boolean(navigator.userAgent.match(/ipad/ig)),
isWeixin: Boolean(navigator.userAgent.match(/MicroMessenger/ig)),
}
如今更推薦基於 matchMedia 的響應式判斷,或用 navigator.userAgentData 這類結構化數據取代正則嗅探。
function strLength(str) {
var a = 0;
for (var i = 0; i < str.length; i++) {
if (str.charCodeAt(i) > 255)
a += 2; // 非 ASCII 字符按 2 計
else
a++;
}
return a;
}
原理是 ASCII 範圍內字符碼不超過 255,超出即視為全角字符。注意它按 UTF-16 碼元遍歷,emoji 這類代理對字符會被算成 2 個(結果剛好是 4),不一定符合預期。
function GetQueryStringRegExp(name, url) {
var reg = new RegExp("(^|\\?|\|)" + name + "=([^&]*)(\s|\||$)", "i");
if (reg.test(url)) return decodeURIComponent(RegExp.$2.replace(/\+/g, " "));
return "";
}
今天直接用 new URLSearchParams(location.search).get(name) 一行搞定,還自動處理編碼與加號還原。
function eventBind(obj, eventType, callBack) {
if (obj.addEventListener) {
obj.addEventListener(eventType, callBack, false);
}
else if (window.attachEvent) {
obj.attachEvent('on' + eventType, callBack);
}
else {
obj['on' + eventType] = callBack;
}
};
eventBind(document, 'click', bodyClick);
三層降級:標準 addEventListener、舊 IE 的 attachEvent、以及最原始的 DOM0 寫法。attachEvent 這條分支在 IE11 之後已無用武之地。
function getjsversion(){
var n = navigator;
var u = n.userAgent;
var apn = n.appName;
var v = n.appVersion;
var ie = v.indexOf('MSIE ');
if (ie > 0){
apv = parseInt(i = v.substring(ie + 5));
if (apv > 3) {
apv = parseFloat(i);
}
} else {
apv = parseFloat(v);
}
var isie = (apn == 'Microsoft Internet Explorer');
var ismac = (u.indexOf('Mac') >= 0);
var javascriptVersion = "1.0";
if (String && String.prototype) {
javascriptVersion = '1.1';
if (javascriptVersion.match) {
javascriptVersion = '1.2';
var tm = new Date;
if (tm.setUTCDate) {
javascriptVersion = '1.3';
if (isie && ismac && apv >= 5) javascriptVersion = '1.4';
var pn = 0;
if (pn.toPrecision) {
javascriptVersion = '1.5';
a = new Array;
if (a.forEach) {
javascriptVersion = '1.6';
i = 0;
o = new Object;
tcf = new Function('o', 'var e,i=0;try{i=new Iterator(o)}catch(e){}return i');
i = tcf(o);
if (i && i.next) {
javascriptVersion = '1.7';
}
}
}
}
}
}
return javascriptVersion;
}
這段代碼的做法是「逐個特性探測」,用某個 API 是否存在來反推語言版本。思路本身值得學習——特性檢測至今仍是處理兼容性的正道,只是具體要探測的 API 早已更新换代。
function getEvent() {
if (document.all) {
return window.event; // 舊 IE
}
func = getEvent.caller;
while (func != null) {
var arg0 = func.arguments[0];
if (arg0) {
if ((arg0.constructor == Event || arg0.constructor == MouseEvent) ||
(typeof (arg0) == "object" && arg0.preventDefault && arg0.stopPropagation)) {
return arg0;
}
}
func = func.caller;
}
return null;
};
依賴 arguments.callee.caller 沿調用棧回溯找事件對象,如今 caller 在嚴格模式下已被廢棄。標準做法是把事件參數直接接收進來:element.addEventListener('click', function(e){ ... })。
getCharactersLen: function (charStr, cutCount) {
if (charStr == null || charStr == '') return '';
var totalCount = 0;
var newStr = '';
for (var i = 0; i < charStr.length; i++) {
var c = charStr.charCodeAt(i);
if (c < 255 && c > 0) {
totalCount++;
} else {
totalCount += 2;
}
if (totalCount >= cutCount) {
newStr += charStr.charAt(i);
break;
}
else {
newStr += charStr.charAt(i);
}
}
return newStr;
}
常用於按「顯示寬度」截斷文本,比如列表標題最多顯示 40 個字符寬。
var tmp = window.open("about:blank", "", "fullscreen=1")
tmp.moveTo(0, 0);
tmp.resizeTo(screen.width + 20, screen.height);
tmp.focus();
tmp.location.href = 'https://www.che168.com/pinggu/eva_' + msgResult.message[0] + '.html';
var config_ = "left=0,top=0,width=" + (window.screen.Width) + ",height=" + (window.screen.Height);
window.open('https://www.che168.com/pinggu/eva_' + msgResult.message[0] + '.html', "winHanle", config_);
// 模擬 form 提交打開新頁面
var f = document.createElement("form");
f.setAttribute('action', 'https://www.che168.com/pinggu/eva_' + msgResult.message[0] + '.html');
f.target = '_blank';
document.body.appendChild(f);
f.submit();
注意現代瀏覽器出於安全與體驗考慮,已大幅限制 resizeTo、moveTo 這類窗口操作,且 window.open 必須在用戶點擊的同步調用鏈中觸發,否則會被攔截為彈窗。
function selectAll(objSelect) {
if (objSelect.checked == true) {
$("input[name='chkId']").attr("checked", true);
$("input[name='chkAll']").attr("checked", true);
}
else if (objSelect.checked == false) {
$("input[name='chkId']").attr("checked", false);
$("input[name='chkAll']").attr("checked", false);
}
}
jQuery 1.6 之後操作 checked 狀態應用 .prop("checked", true),用 attr 在某些版本下不生效。
// 判斷是否是 IE 瀏覽器
if (document.all){
alert("IE瀏覽器");
}else{
alert("非IE瀏覽器");
}
if (!!window.ActiveXObject){
alert("IE瀏覽器");
}else{
alert("非IE瀏覽器");
}
// 判斷是 IE 幾
var isIE = !!window.ActiveXObject;
var isIE6 = isIE && !window.XMLHttpRequest;
var isIE8 = isIE && !!document.documentMode;
var isIE7 = isIE && !isIE6 && !isIE8;
if (isIE){
if (isIE6){
alert("ie6");
}else if (isIE8){
alert("ie8");
}else if (isIE7){
alert("ie7");
}
}
function getOs() {
if (navigator.userAgent.indexOf("MSIE 8.0") > 0) {
return "MSIE8";
}
else if (navigator.userAgent.indexOf("MSIE 6.0") > 0) {
return "MSIE6";
}
else if (navigator.userAgent.indexOf("MSIE 7.0") > 0) {
return "MSIE7";
}
else if (isFirefox = navigator.userAgent.indexOf("Firefox") > 0) {
return "Firefox";
}
if (navigator.userAgent.indexOf("Chrome") > 0) {
return "Chrome";
}
else {
return "Other";
}
}
這裡有一個隱藏 bug:isFirefox = navigator.userAgent.indexOf(...) 用了賦值而非比較,會污染全局變量。應寫成 == 或直接去掉變量。
// 得到日期值並轉化成日期格式,replace(/\-/g, "\/") 是根據表達式把日期轉換成標準格式,這樣再進行判斷就好判斷了
function ValidateDate() {
var beginDate = $("#t_datestart").val();
var endDate = $("#t_dateend").val();
if (beginDate.length > 0 && endDate.length > 0) {
var sDate = new Date(beginDate.replace(/\-/g, "\/"));
var eDate = new Date(endDate.replace(/\-/g, "\/"));
if (sDate > eDate) {
alert('開始日期要小於結束日期');
return false;
}
}
}
把 2012-09-09 中的橫線換成斜線,是為了規避舊 Safari 與 IE 對 YYYY-MM-DD 解析不一致的問題,讓它同時兼容 2012-09-09 與 2012-9-9。今天更穩妥的寫法是 new Date('2012-09-09T00:00:00'),帶上時間部分即符合 ISO 8601。
this.moveBind = function (objId, eventType, callBack) {
var obj = document.getElementById(objId);
if (obj.removeEventListener) {
obj.removeEventListener(eventType, callBack, false);
}
else if (window.detachEvent) {
obj.detachEvent('on' + eventType, callBack);
}
else {
obj['on' + eventType] = null;
}
}
與前面的綁定函數一一對應,注意 removeEventListener 要求傳入的函數引用與綁定時完全一致,匿名函數是無法移除的。
$("id").onkeypress = function (event) {
event = (event) ? event : ((window.event) ? window.event : "")
keyCode = event.keyCode ? event.keyCode : (event.which ? event.which : event.charCode);
if (keyCode == 13) {
$("SubmitLogin").onclick();
}
}
timeStart = new Date().getTime();
timesEnd = new Date().getTime();
document.getElementById("time").innerHTML = timesEnd - timeStart;
精度更高的替代方案是 performance.now(),它返回帶小數的毫秒值,不受系統時間調整影響。
function setCookie(name, value, expires, path, domain) {
if (!expires) expires = -1;
if (!path) path = "/";
var d = "" + name + "=" + value;
var e;
if (expires < 0) {
e = "";
}
else if (expires == 0) {
var f = new Date(1970, 1, 1);
e = ";expires=" + f.toUTCString();
}
else {
var now = new Date();
var f = new Date(now.getTime() + expires * 1000);
e = ";expires=" + f.toUTCString();
}
var dm;
if (!domain) {
dm = "";
}
else {
dm = ";domain=" + domain;
}
document.cookie = name + "=" + value + ";path=" + path + e + dm;
};
參數 expires 的單位是秒:小於 0 表示會話 Cookie(關閉瀏覽器即失效),等於 0 表示立即刪除,大於 0 則是有效秒數。
function readCookie(name) {
var nameEQ = name + "=";
var ca = document.cookie.split(';');
for (var i = 0; i < ca.length; i++) {
var c = ca[i];
while (c.charAt(0) == ' ') c = c.substring(1, c.length);
if (c.indexOf(nameEQ) == 0) {
return decodeURIComponent(c.substring(nameEQ.length, c.length))
}
} return null
}
寫入時編碼、讀取時解碼,成對出現才能正確處理中文與特殊字符。另外要提醒:HttpOnly 標記的 Cookie 在 JS 中是不可見的,這正是敏感憑證應放在 HttpOnly Cookie 裡的原因。
C.ajax = function (args) {
var self = this;
this.options = {
type: 'GET',
async: true,
contentType: 'application/x-www-form-urlencoded',
url: 'about:blank',
data: null,
success: {},
error: {}
};
this.getXmlHttp = function () {
var xmlHttp;
try {
xmlhttp = new XMLHttpRequest();
}
catch (e) {
try {
xmlhttp = new ActiveXObject("Msxml2.XMLHTTP");
}
catch (e) {
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
}
}
if (!xmlhttp) {
alert('您的浏覽器不支持AJAX');
return false;
}
return xmlhttp;
};
this.send = function () {
C.each(self.options, function (key, val) {
self.options[key] = (args[key] == null) ? val : args[key];
});
var xmlHttp = new self.getXmlHttp();
if (self.options.type.toUpperCase() == 'GET') {
xmlHttp.open(self.options.type, self.options.url + (self.options.data == null ? "" : ((/[?]$/.test(self.options.url) ? '&' : '?') + self.options.data)), self.options.async);
}
else {
xmlHttp.open(self.options.type, self.options.url, self.options.async);
xmlHttp.setRequestHeader('Content-Length', self.options.data.length);
}
xmlHttp.setRequestHeader('Content-Type', self.options.contentType);
xmlHttp.onreadystatechange = function () {
if (xmlHttp.readyState == 4) {
if (xmlHttp.status == 200 || xmlHttp.status == 0) {
if (typeof self.options.success == 'function') self.options.success(xmlHttp.responseText);
xmlHttp = null;
}
else {
if (typeof self.options.error == 'function') self.options.error('Server Status: ' + xmlHttp.status);
}
}
};
xmlHttp.send(self.options.type.toUpperCase() == 'POST' ? self.options.data.toString() : null);
};
this.send();
};
結構清晰:默認配置 + 用戶參數合併、三層降級創建 XHR 對象、GET 時把 data 拼到 URL 後並智能選擇 ? 或 &、POST 時設置 Content-Length、根據 readyState 與 status 分派回調。今天的明顯替代是 fetch() 或 XMLHttpRequest 的 Promise 封裝。
function StringBuilder() {
this.strings = new Array;
};
StringBuilder.prototype.append = function (str) {
this.strings.push(str);
};
StringBuilder.prototype.toString = function () {
return this.strings.join('');
};
思路借鑑 Java:把大量字符串拼接改成先 push 進數組最後 join,避免反覆創建中間字符串。在舊引擎上這確實更快,現代 JS 引擎已對 += 做了優化,差異不明顯,但這個封裝在需要中途插入、清空時仍方便。
function loadJS (url, fn) {
var ss = document.getElementsByName('script'),
loaded = false;
for (var i = 0, len = ss.length; i < len; i++) {
if (ss[i].src && ss[i].getAttribute('src') == url) {
loaded = true;
break;
}
}
if (loaded) {
if (fn && typeof fn != 'undefined' && fn instanceof Function) fn();
return false;
}
var s = document.createElement('script'),
b = false;
s.setAttribute('type', 'text/javascript');
s.setAttribute('src', url);
s.onload = s.onreadystatechange = function () {
if (!b && (!this.readyState || this.readyState == 'loaded' || this.readyState == 'complete')) {
b = true;
if (fn && typeof fn != 'undefined' && fn instanceof Function) fn();
}
};
document.getElementsByTagName('head')[0].appendChild(s);
}
function JSLoad (args) {
s = document.createElement("script");
s.setAttribute("type", "text/javascript");
s.setAttribute("src", args.url);
s.onload = s.onreadystatechange = function () {
if (!s.readyState || s.readyState == "loaded" || s.readyState == "complete") {
if (typeof args.callback == "function") args.callback(this, args);
s.onload = s.onreadystatechange = null;
try {
s.parentNode && s.parentNode.removeChild(s);
} catch (e) { }
}
};
document.getElementsByTagName("head")[0].appendChild(s);
}
兩個要點:先查重避免重複加載,再用 onload + onreadystatechange 雙寫兼容舊 IE 的腳本加載事件,並用 b 標誌防止回調被觸發兩次。第二個版本更進一步,加載完畢後把自己從 DOM 上移除,保持文檔乾淨。
function ClearHeadJs (src) {
var js = document.getElementsByTagName('head')[0].children;
var obj = null;
for (var i = 0; i < js.length; i++) {
if (js[i].tagName.toLowerCase() == "script" && js[i].attributes['src'].value.indexOf(src) > 0) {
obj = js[i];
}
}
document.getElementsByTagName('head')[0].removeChild(obj);
};
function URLencode(sStr) {
return escape(sStr).replace(/\+/g, '%2B').replace(/\"/g, '%22').replace(/\'/g, '%27').replace(/\//g, '%2F');
};
escape() 已被標準廢棄且不能處理非 ASCII 字符,請改用 encodeURIComponent()。
document.body.onkeydown = function (evt) {
evt = evt ? evt : (window.event ? window.event : null);
if (13 == evt.keyCode && evt.ctrlKey) {
evt.returnValue = false;
evt.cancel = true;
PostData();
}
};
function GetCurrentDate() {
var d = new Date();
var y = d.getYear() + 1900;
month = add_zero(d.getMonth() + 1),
days = add_zero(d.getDate()),
hours = add_zero(d.getHours());
minutes = add_zero(d.getMinutes()),
seconds = add_zero(d.getSeconds());
var str = y + '-' + month + '-' + days + ' ' + hours + ':' + minutes + ':' + seconds;
return str;
};
function add_zero(temp) {
if (temp < 10) return "0" + temp;
else return temp;
}
getYear() 是遗留方法,返回的是「年份減 1900」,所以這裡要加回來。規範做法是 getFullYear()。另外 month 等變量未用 var 聲明,會洩漏成全局變量,在嚴格模式下直接報錯。
String.prototype.Trim = function()
{ return this.replace(/(^\s*)|(\s*$)/g, ""); }
String.prototype.LTrim = function()
{ return this.replace(/(^\s*)/g, ""); }
String.prototype.RTrim = function()
{ return this.replace(/(\s*$)/g, ""); }
ES5 之後 String.prototype.trim() 已是標準,無需自行擴展內建對象原型。
function CreateFrom(url, params) {
var f = document.createElement("form");
f.setAttribute("action", url);
for (var i = 0; i < params.length; i++) {
var input = document.createElement("input");
input.setAttribute("type", "hidden");
input.setAttribute("name", params[i].paramName);
input.setAttribute("value", params[i].paramValue);
f.appendChild(input);
}
f.target = "_blank";
document.body.appendChild(f);
f.submit();
};
這是繞過 GET 網址長度限制、用 POST 方式打開新頁面的經典技巧,在需要傳遞大量參數或敏感參數時比拼 URL 更合適。
<script language="javascript"> var jsversion = 1.0; </script> <script language="javascript1.1"> jsversion = 1.1; </script> <script language="javascript1.2"> jsversion = 1.2; </script> <script language="javascript1.3"> jsversion = 1.3; </script> <script language="javascript1.4"> jsversion = 1.4; </script> <script language="javascript1.5"> jsversion = 1.5; </script> <script language="javascript1.6"> jsversion = 1.6; </script> <script language="javascript1.7"> jsversion = 1.7; </script> <script language="javascript1.8"> jsversion = 1.8; </script> <script language="javascript1.9"> jsversion = 1.9; </script> <script language="javascript2.0"> jsversion = 2.0; </script> alert(jsversion);
原理是:不支持某版本的瀏覽器會直接跳過那個 <script> 塊,於是變量停在最後一個被支持的版本上。language 屬性早已從 HTML 標準中移除,這段代碼今天只具備歷史價值。
這批方法名單的價值不在於「照抄使用」——其中不少已有更好的標準替代品——而在於呈現背後的思路:特性檢測取代硬編碼、多層降級保證兼容、字符串拼接的優化意識。把思路留下來,比記住具體 API 更長久。