日常開發中,有些動作幾乎每個專案都要重寫一次:型別判斷、日期格式化、物件複製與合併、uuid 產生……與其在每個專案裡複製貼上,不如整理成一套工具函式庫。lao-utils 就是這樣誕生的。
Node.js 環境:
npm install lao-utils --save
AMD / CMD 或瀏覽器環境:
直接引入 dist 目錄下的原始碼檔案即可。
uuid() — 產生一個 uuid 字串(偽 guid)is(x, y) — 比較兩個值是否相等。特殊案例:laoUtils.is(-0, +0) 回傳 false,laoUtils.is(NaN, NaN) 回傳 trueisInteger(value) — 是否為整數isNumber(value) — 是否為數字isString(value) — 是否為字串isNaN(value) — 是否為 NaNisDom(obj) — 判斷是否為 DOM 物件date(format, timestamp) — 格式化日期,例如 laoUtils.date('yyyy-MM-dd') 得到 2016-02-26copyObject(obj) — 複製物件(淺拷貝,undefined 屬性不會被複製)clone(obj) — 深度拷貝一個物件merge(a, b, c, ...rest) — 合併多個物件,例如 laoUtils.merge({a:1},{b:2},{b:3,c:3}) 得到 {a:1, b:3, c:3}arrayOf(a, b, c, ...rest) — 把一組參數轉為陣列,例如 laoUtils.arrayOf(1,2,3) 得到 [1,2,3]includes(arr, value) — 陣列是否包含指定值,例如 laoUtils.includes([1,2,3], 3) 回傳 truecontains(str, value) — 字串是否包含另一字串,例如 laoUtils.contains('giscafer', 'g') 回傳 trueisArray(arr) — 是否為陣列inherits(clazz, baseClazz) — 建立建構函式之間的繼承關係(clazz 繼承自 baseClazz)extend(des, source) — 把 source 的所有屬性複製到 des(undefined 屬性不會被複製)is() 不是 ===。它更接近 ECMAScript 的 SameValue 演算法,因此能正確處理 NaN 與 -0/+0 這兩個 === 會出錯的邊界情況。ES6 之後語言本身提供了 Object.is(),效果相同。copyObject 只複製第一層,clone 才會遞迴到底。對含巢狀結構的設定檔或表單資料,用錯就會出現「改 B 卻動到 A」的 bug。lodash、ramda、date-fns 等成熟函式庫已能涵蓋絕大多數場景,且測試覆蓋率與效能都經過驗證。輕量工具集適合小型專案或學習用途;若需求會持續成長,直接使用成熟方案通常更划算。本站下載:https://xiazai.jb51.net/201603/yuanma/lao-utils-master(jb51.net).zip
專案位置:GitHub