日常開發中,有些功能會反覆出現:字串截斷、格式驗證、瀏覽器判斷、編碼轉換、頁面尺寸計算……與其每次重新 Google,不如整理成一份自己的工具箱。以下依功能分類,挑選最實用的原生 JavaScript 函式並附上說明。
function cutstr(str, len) {
var temp, icount = 0;
var patrn = /[^\x00-\xff]/; // 非 ASCII 視為全形
var strre = "";
for (var i = 0; i < str.length; i++) {
if (icount < len - 1) {
temp = str.substr(i, 1);
icount += (patrn.exec(temp) == null) ? 1 : 2;
strre += temp;
} else {
break;
}
}
return strre + "...";
}
String.prototype.trim = function () {
return this.replace(/^\s*(.*?)\s+$/, "$1");
};
String.prototype.replaceAll = function (s1, s2) {
return this.replace(new RegExp(s1, "gm"), s2);
};
現代寫法可直接用原生的 str.trim() 與 str.replaceAll()(後者 ES2021 起標準支援)。若要動態組字串成正則,記得先跳脫特殊字元。
String.prototype.startWith = function (s) { return this.indexOf(s) === 0; };
String.prototype.endWith = function (s) {
var d = this.length - s.length;
return (d >= 0 && this.lastIndexOf(s) === d);
};
function isNULL(chars) {
if (chars == null) return true;
return String(chars).replace(/^\s+|\s+$/g, "").length === 0;
}
function ToDBC(str) { // 全形 → 半形
var result = "";
for (var i = 0; i < str.length; i++) {
var code = str.charCodeAt(i);
if (code >= 65281 && code <= 65374) {
result += String.fromCharCode(code - 65248);
} else if (code === 12288) {
result += String.fromCharCode(32);
} else {
result += str.charAt(i);
}
}
return result;
}
function ToCDB(str) { // 半形 → 全形
var result = "";
for (var i = 0; i < str.length; i++) {
var code = str.charCodeAt(i);
if (code >= 33 && code <= 126) {
result += String.fromCharCode(code + 65248);
} else if (code === 32) {
result += String.fromCharCode(12288);
} else {
result += str.charAt(i);
}
}
return result;
}
function HtmlEncode(text) {
return text.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"');
}
function HtmlDecode(text) {
return text.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"')
.replace(/&/g, '&');
}
注意還原時 & 必須最後才處理,否則 &lt; 會被連續還原成 <,造成 XSS 風險。
function isDigit(value) { return /^[0-9]*$/.test(value) && value !== ""; }
function isEmail(str) {
return /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/.test(str);
}
function isNumber(chars) { return /^\d*$/.test(chars); } // 整數
function isFloat(str) { return /^-?\d+(\.\d+)?$/.test(str); } // 浮點數
function isLetters(str) { return /^[A-Za-z]+$/.test(str); }
function isValidPost(c) { return /^\d{6}$/.test(c); } // 郵遞區號
function isValidLength(c, len) { return c.length >= len; }
function IsURL(strUrl) {
return /^(https?:\/\/)?[\w-]+(\.[\w-]+)+([\/?%=&.-]*)?$/i.test(strUrl);
}
function stripscript(s) {
var pattern = new RegExp("[`~!@#$^&*()=|{}':;',\\[\\].<>/?~!@#¥……&*()——|{}【】‘;:”“'。,、?]");
var rs = "";
for (var i = 0; i < s.length; i++) {
rs += s.substr(i, 1).replace(pattern, '');
}
return rs;
}
實務上更推薦用白名單而非黑名單:明確定義允許的字元集,其餘一律拒絕。黑名單永遠列不完,也容易誤傷正常輸入。
function checkAllTextValid(form) {
var resultTag = 0, flag = 0;
for (var i = 0; i < form.elements.length; i++) {
if (form.elements[i].type === "text") {
flag++;
if (/^[^|"'<>]*$/.test(form.elements[i].value)) {
resultTag++;
} else {
form.elements[i].select(); // 選中有問題的欄位方便修正
}
}
}
if (resultTag === flag) return true;
alert("文字欄位不可包含單引號、雙引號、豎線與尖括號,請檢查輸入!");
return false;
}
function checkAll() {
var selectall = document.getElementById("selectall");
var allbox = document.getElementsByName("allbox");
for (var i = 0; i < allbox.length; i++) {
allbox[i].checked = selectall.checked;
}
}
function get_checkbox_value(field) {
if (field && field.length) {
for (var i = 0; i < field.length; i++) {
if (field[i].checked && !field[i].disabled) return field[i].value;
}
}
return "";
}
function get_get() {
var querystr = window.location.href.split("?");
var GET = {};
if (querystr[1]) {
querystr[1].split("&").forEach(function (pair) {
var kv = pair.split("=");
GET[kv[0]] = decodeURIComponent(kv[1] || "");
});
}
return GET;
}
// 取單一參數(正則版)
function getUrlParam(name) {
var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)");
var r = window.location.search.substr(1).match(reg);
return r != null ? decodeURIComponent(r[2]) : null;
}
現代寫法一行搞定:new URLSearchParams(location.search).get('cid')。
function getHost(url) {
if (url == null) url = window.location.href;
var match = url.match(/^w*:\/\/([^\/]*).*/);
return (match != null) ? match[1] : "null";
}
function setCookie(name, value, Hours) {
var exp = new Date(Date.now() + Hours * 60 * 60 * 1000);
document.cookie = name + "=" + encodeURIComponent(value)
+ ";path=/;expires=" + exp.toUTCString();
}
function getCookie(name) {
var arr = document.cookie.match(new RegExp("(^| )" + name + "=([^;]*)(;|$)"));
return arr != null ? decodeURIComponent(arr[2]) : null;
}
Date.prototype.Format = function (formatStr) {
var Week = ['日', '一', '二', '三', '四', '五', '六'];
var pad = function (n) { return n > 9 ? String(n) : '0' + n; };
var map = {
'yyyy': this.getFullYear(),
'yy': String(this.getFullYear() % 100),
'MM': pad(this.getMonth() + 1),
'dd': pad(this.getDate()),
'HH': pad(this.getHours()),
'mm': pad(this.getMinutes()),
'ss': pad(this.getSeconds()),
'ww': Week[this.getDay()]
};
return formatStr.replace(/yyyy|yy|MM|dd|HH|mm|ss|ww/g, function (k) {
return map[k];
});
};
// 用法:new Date().Format('yyyy-MM-dd HH:mm:ss')
用單次全域 replace 搭配對照表,比連續十幾個 replace 更簡潔,也避免了「先取代 MM 再取代 M」造成的連鎖誤換。
function $(id) { return !id ? null : document.getElementById(id); }
function insertAfter(newChild, refChild) {
var parElem = refChild.parentNode;
if (parElem.lastChild === refChild) {
refChild.appendChild(newChild);
} else {
parElem.insertBefore(newChild, refChild.nextSibling);
}
}
function display(id) {
var obj = $(id);
if (obj.style.visibility) {
obj.style.visibility = (obj.style.visibility === 'visible') ? 'hidden' : 'visible';
} else {
obj.style.display = (obj.style.display === '') ? 'none' : '';
}
}
function addEventSamp(obj, evt, fn) {
if (obj.addEventListener) {
obj.addEventListener(evt, fn, false);
} else if (obj.attachEvent) {
obj.attachEvent('on' + evt, fn);
}
}
function getElementsByClassName(name) {
var tags = document.getElementsByTagName('*') || document.all;
var els = [];
for (var i = 0; i < tags.length; i++) {
if ((' ' + tags[i].className + ' ').indexOf(' ' + name + ' ') > -1) {
els.push(tags[i]);
}
}
return els;
}
現代瀏覽器請直接用 document.getElementsByClassName(name) 或 querySelectorAll。
function backTop(btnId) {
var btn = document.getElementById(btnId);
var d = document.documentElement, b = document.body;
window.onscroll = function () {
btn.style.display = (d.scrollTop + b.scrollTop > 100) ? 'block' : 'none';
};
btn.onclick = function () {
btn.style.display = "none";
window.onscroll = null;
this.timer = setInterval(function () {
d.scrollTop -= Math.ceil((d.scrollTop + b.scrollTop) * 0.1);
b.scrollTop -= Math.ceil((d.scrollTop + b.scrollTop) * 0.1);
if ((d.scrollTop + b.scrollTop) === 0) clearInterval(btn.timer);
}, 10);
};
}
function getPageCoord(element) {
var coord = { X: 0, Y: 0 };
while (element) {
coord.X += element.offsetLeft;
coord.Y += element.offsetTop;
element = element.offsetParent;
}
return coord;
}
function getOffset(e) {
var pageCoord = getPageCoord(e.target);
var eventCoord = {
X: window.pageXOffset + e.clientX,
Y: window.pageYOffset + e.clientY
};
return { X: eventCoord.X - pageCoord.X, Y: eventCoord.Y - pageCoord.Y };
}
function getPageHeight() {
var g = document, a = g.body, f = g.documentElement;
var d = (g.compatMode === "BackCompat") ? a : g.documentElement;
return Math.max(f.scrollHeight, a.scrollHeight, d.clientHeight);
}
function getPageWidth() {
var g = document, a = g.body, f = g.documentElement;
var d = (g.compatMode === "BackCompat") ? a : g.documentElement;
return Math.max(f.scrollWidth, a.scrollWidth, d.clientWidth);
}
function getPageScrollTop() { return document.documentElement.scrollTop || document.body.scrollTop; }
function getPageScrollLeft() { return document.documentElement.scrollLeft || document.body.scrollLeft; }
function getPageViewWidth() {
var d = document;
return (d.compatMode === "BackCompat" ? d.body : d.documentElement).clientWidth;
}
function getViewSize() {
var de = document.documentElement, db = document.body;
return [
de.clientWidth === 0 ? db.clientWidth : de.clientWidth,
de.clientHeight === 0 ? db.clientHeight : de.clientHeight
];
}
var _IE = (function () {
var v = 3, div = document.createElement('div'), all = div.getElementsByTagName('i');
while (
div.innerHTML = '<!--[if gt IE ' + (++v) + ']><i></i><![endif]-->',
all[0]
);
return v > 4 ? v : false;
}());
這個技巧的優點是完全不依賴 userAgent 字串,而 userAgent 因為歷史包袱早被各家瀏覽器改得面目全非(IE11 的 UA 甚至完全不含 "MSIE")。若無特殊相容需求,現代專案更應改用特性偵測。
function isMobileUserAgent() {
return /iphone|ipod|android.*mobile|windows.*phone|blackberry.*mobile/i
.test(navigator.userAgent.toLowerCase());
}
function isAppleMobileDevice() {
return /iphone|ipod|ipad|macintosh/i.test(navigator.userAgent.toLowerCase());
}
function isAndroidMobileDevice() {
return /android/i.test(navigator.userAgent.toLowerCase());
}
function isTouchScreen() {
return ('ontouchstart' in window)
|| (window.DocumentTouch && document instanceof DocumentTouch);
}
function empty(v) {
switch (typeof v) {
case 'undefined': return true;
case 'string': return v.replace(/^\s+|\s+$/g, "").length === 0;
case 'boolean': return !v;
case 'number': return v === 0;
case 'object':
if (v === null) return true;
if (v.length !== undefined && v.length === 0) return true;
for (var k in v) { return false; }
return true;
}
return false;
}
function isExitsFunction(funcName) {
try {
return typeof (eval(funcName)) === "function";
} catch (e) { return false; }
}
function isExitsVariable(variableName) {
try {
return typeof (eval(variableName)) !== "undefined";
} catch (e) { return false; }
}
function _ip2int(ip) {
var p = ip.split(".");
var num = Number(p[0]) * 256 * 256 * 256
+ Number(p[1]) * 256 * 256
+ Number(p[2]) * 256
+ Number(p[3]);
return num >>> 0; // 轉為無正負號整數
}
function _int2ip(num) {
return [
(num >>> 24) >>> 0,
((num << 8) >>> 24) >>> 0,
((num << 16) >>> 24) >>> 0,
(num << 24) >>> 24
].join(".");
}
function base64_decode(data) {
var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
var o1, o2, o3, h1, h2, h3, h4, bits, i = 0, ac = 0, dec = "", tmp_arr = [];
if (!data) return data;
data += '';
do {
h1 = b64.indexOf(data.charAt(i++));
h2 = b64.indexOf(data.charAt(i++));
h3 = b64.indexOf(data.charAt(i++));
h4 = b64.indexOf(data.charAt(i++));
bits = h1 << 18 | h2 << 12 | h3 << 6 | h4;
o1 = bits >> 16 & 0xff;
o2 = bits >> 8 & 0xff;
o3 = bits & 0xff;
if (h3 === 64) tmp_arr[ac++] = String.fromCharCode(o1);
else if (h4 === 64) tmp_arr[ac++] = String.fromCharCode(o1, o2);
else tmp_arr[ac++] = String.fromCharCode(o1, o2, o3);
} while (i < data.length);
return utf8_decode(tmp_arr.join(''));
}
function utf8_decode(str_data) {
var tmp_arr = [], i = 0, ac = 0, c1, c2, c3;
str_data += '';
while (i < str_data.length) {
c1 = str_data.charCodeAt(i);
if (c1 < 128) {
tmp_arr[ac++] = String.fromCharCode(c1); i++;
} else if (c1 > 191 && c1 < 224) {
c2 = str_data.charCodeAt(i + 1);
tmp_arr[ac++] = String.fromCharCode(((c1 & 31) << 6) | (c2 & 63));
i += 2;
} else {
c2 = str_data.charCodeAt(i + 1);
c3 = str_data.charCodeAt(i + 2);
tmp_arr[ac++] = String.fromCharCode(((c1 & 15) << 12) | ((c2 & 63) << 6) | (c3 & 63));
i += 3;
}
}
return tmp_arr.join('');
}
現代專案請直接使用 btoa() / atob(),並注意它們只處理 Latin-1,處理中文需先 encodeURIComponent 或改用 TextEncoder。
function transform(tranvalue) {
try {
var dw2 = new Array("", "萬", "億"); // 大單位
var dw1 = new Array("拾", "佰", "仟"); // 小單位
var dw = new Array("零", "壹", "貳", "叁", "肆", "伍", "陸", "柒", "捌", "玖");
var source = String(tranvalue).split(".");
var num = source[0], dig = source[1] || "";
var k1 = 0, k2 = 0, sum = 0, str = "";
var len = num.length;
for (var i = 1; i <= len; i++) {
var n = num.charAt(len - i);
var bn = (len - i - 1 >= 0) ? num.charAt(len - i - 1) : 0;
sum += Number(n);
if (sum !== 0) {
str = dw[Number(n)] + str;
if (n === '0') sum = 0;
}
if (len - i - 1 >= 0) {
if (k1 !== 3) {
if (bn !== 0) str = dw1[k1] + str;
k1++;
} else {
k1 = 0;
var temp = str.charAt(0);
if (temp === "萬" || temp === "億") str = str.substr(1);
str = dw2[k2] + str;
sum = 0;
}
}
if (k1 === 3) k2++;
}
var strdig = "";
if (dig !== "") {
var d1 = dig.charAt(0), d2 = dig.charAt(1);
if (Number(d1) !== 0) strdig += dw[Number(d1)] + "角";
if (Number(d2) !== 0) strdig += dw[Number(d2)] + "分";
}
return str + "元" + strdig;
} catch (e) {
return "0元";
}
}
這段邏輯的核心是從個位數往高處理,每三位插入一個大單位(萬、億),並處理連續零的合併。實務上若對格式要求嚴格(如財務報表),建議改用經過驗證的成熟函式庫並補齊測試案例。
// 數字類
非負整數 /^\d+$/
正整數 /^[0-9]*[1-9][0-9]*$/
負整數 /^-[0-9]*[1-9][0-9]*$/
整數 /^-?\d+$/
浮點數 /^-?\d+(\.\d+)?$/
// 字元類
中文字符 /[\u4e00-\u9fa5]/
雙位元組 /[^\x00-\xff]/
英文字串 /^[A-Za-z]+$/
帳號 /^[a-zA-Z][a-zA-Z0-9_]{4,15}$/
// 聯絡資訊
Email /^[\w.-]+@[\w-]+(\.[\w-]+)+$/
URL /^[a-zA-Z]+:\/\/[^\s]+$/
手機號碼 /^1[3-9]\d{9}$/
郵遞區號 /^[1-9]\d{5}$/
// 其他
空白行 /\n\s*\r/
首尾空白 /^\s+|\s+$/g
HTML 標記 /<(\S*?)[^>]*>.*?<\/\1>|<.*?\/>/
IP 位址 /((2[0-4]\d|25[0-5]|[01]?\d?\d)\.){3}(2[0-4]\d|25[0-5]|[01]?\d?\d)/
這份工具箱的價值不在於「收藏」,而在於理解每一段程式碼背後的原理:為什麼中文要算兩個字元、為什麼 HTML 還原時 & 要最後處理、為什麼 IP 轉整數要用無號右移。理解了原理,你才能判斷哪些函式該留、哪些該被原生 API 取代。
同時要提醒:這類網路流傳的函式集合年代久遠,其中不少已有更好的原生替代(trim()、replaceAll()、URLSearchParams、Intl.DateTimeFormat、btoa()、querySelectorAll())。使用前請先確認目標環境是否支援,並優先選擇標準 API。