JavaScript 的原型繼承機制允許我們為內建類型(如 String、Array、Number)擴充自訂方法,實現類似 C# 擴展方法的鏈式調用風格。本文將系統性介紹原型擴展的核心概念、實作技巧、常用工具方法與最佳實踐。
所有 JavaScript 物件皆繼承自其建構函式的 prototype。透過修改 String.prototype,所有字串實例即可獲得新方法,並支援鏈式調用:
// 基礎擴展範例:合併多個空白為單一空白
String.prototype.ResetBlank = function() {
var regEx = /\s+/g; // 修正:原碼漏寫反斜線
return this.replace(regEx, ' ');
};
// 使用方式
var str = "你 在 他 想 還好嗎?";
console.log(str.ResetBlank()); // "你 在 他 想 還好嗎?"
以下整理常見實務需求的擴展方法,建議整理為獨立模組檔案引用:
// 去除首尾空白
String.prototype.trim = function() {
return this.replace(/^\s+|\s+$/g, '');
};
// 合併連續空白
String.prototype.ResetBlank = function() {
return this.replace(/\s+/g, ' ');
};
// 僅保留數字
String.prototype.GetNum = function() {
return this.replace(/\D/g, '');
};
// 僅保留中文字
String.prototype.GetCN = function() {
return this.replace(/[^\u4e00-\u9fa5\uF900-\uFA2D]/g, '');
};
// 字串轉整數(非數字返回原字串)
String.prototype.ToInt = function() {
return isNaN(parseInt(this)) ? this.toString() : parseInt(this);
};
// 取得位元組長度(中文算 2 位元組)
String.prototype.GetLen = function() {
var chineseReg = /^[\u4e00-\u9fa5\uF900-\uFA2D]+$/;
if (chineseReg.test(this)) {
return this.length * 2;
}
var matches = this.match(/[\x00-\xff]/g);
return this.length * 2 - (matches ? matches.length : 0);
};
// 取得檔案完整名稱
String.prototype.GetFileName = function() {
return this.replace(/^.*[\\\/]([^\\\/?]*).*$/, '$1');
};
// 取得副檔名
String.prototype.GetExtensionName = function() {
return this.replace(/^.*[^\\\/]*(\.[^\.?]*).*$/, '$1');
};
// 替換所有符合項(支援字串或正則)
String.prototype.replaceAll = function(find, replace, ignoreCase) {
if (!(find instanceof RegExp)) {
return this.replace(new RegExp(find, (ignoreCase ? 'gi' : 'g')), replace);
}
return this.replace(find, replace);
};
// 字串格式化(類似 C# String.Format)
String.Format = function() {
if (arguments.length === 0) return '';
if (arguments.length === 1) return arguments[0];
var format = arguments[0];
for (var i = 1; i < arguments.length; i++) {
var reg = new RegExp('\\{' + (i - 1) + '\\}', 'g');
format = format.replace(reg, arguments[i]);
}
return format;
};
// 使用範例
var msg = String.Format('你好,{0}!歡迎來到 {1}', '張三', '本網站');
console.log(msg); // "你好,張三!歡迎來到 本網站"
$.str.trim())String.prototype.trim),避免覆蓋標準實作interface String { trim(): string; }ES6+ 模組化開發下,建議採用「工具函式」而非原型擴展:
// string-utils.js
export const trim = (str) => str.trim();
export const getNum = (str) => str.replace(/\D/g, '');
// ...
// 使用時
import { trim, getNum } from './string-utils';
console.log(trim(' hello ')); // "hello"
此方式避免全域污染、支援 Tree-shaking、利於單元測試與型別檢查,是現代專案的首選架構。