原文地址:https://juejin.im/post/5a091afe6fb9a044ff30f402

API文档

Array

  arrayEqual  判断两个数组是否相等

Class

  addClass  为元素添加class

  hasClass  判断元素是否有某个class

  removeClass  为元素移除class

Cookie

  getCookie  根据name读取Cookie

  removeCookie  根据name删除Cookie

  setCookie  添加Cookie

Device

  getExplore  获取浏览器类型和版本号

  getOS  获取操作系统类型

Dom

  getScrollTop  获取滚动条距顶部的距离

  offset  获取一个元素的距离文档(document)的位置,类似jQ中的offset()

  scrollTo  在${duration}时间内,滚动条平滑滚动到${to}指定位置

  setScrollTop  设置滚动条距顶部的距离

Function

  debounce  函数防抖

  throttle  函数节流

Keycode

  getKeyName  根据keycode获得键名

Object

  deepClone  深拷贝,支持常见类型

  isEmptyObject  判断Object是否为空

Random

  randomColor   随机生成颜色

  randomNum  生成指定范围随机数

Regexp

  isEmail  判断是否为邮箱地址

  isIdCard  判断是否为身份证号

  isPhoneNum  判断是否为手机号

  isUrl  判断是否为URL地址

String

  digitUppercase  现金额转大写

Support

  isSupportWebP  判断浏览器是否支持webP格式图片

Time

  formatPassTime  格式化${startTime}距现在的已过时间

  formatRemainTime  格式化现在距${endTime}的剩余时间

Url

  parseQueryString  url参数转对象

  stringfyQueryString  对象序列化

作为战斗在业务一线的前端,要想少加班,就要想办法提高工作效率。这里提一个小点,我们在业务开发过程中,经常会重复用到日期格式化url参数转对象浏览器类型判断节流函数等一类函数,这些工具类函数,基本上在每个项目都会用到,为避免不同项目多次复制粘贴的麻烦,我们可以统一封装,发布到npm,以提高开发效率。

这里,笔者已经封装并发布了自己的武器库 outils,如果你对本项目感兴趣,欢迎 star 本项目。当然你也可以在本项目的基础上封装自己的武器库。

常用函数汇总

这里先分类整理下,之前项目中多次用到的工具函数。

1.Array

1.1 arrayEqual

/*** * @desc 判断两个数组是否相等* @param {Array} arr1 * @param {Array} arr2 * @return {Boolean}*/
function arrayEqual(arr1, arr2) {if (arr1 === arr2) return true;if (arr1.length != arr2.length) return false;for (var i = 0; i < arr1.length; ++i) {if (arr1[i] !== arr2[i]) return false;}return true;
}

2.Class

2.1 addClass

/*** * @desc   为元素添加class* @param  {HTMLElement} ele * @param  {String} cls */var hasClass = require('./hasClass');function addClass(ele, cls) {if (!hasClass(ele, cls)) {ele.className += ' ' + cls;}
}

2.2 hasClass

/*** * @desc 判断元素是否有某个class* @param {HTMLElement} ele * @param {String} cls * @return {Boolean}*/
function hasClass(ele, cls) {return (new RegExp('(\\s|^)' + cls + '(\\s|$)')).test(ele.className);
}

2.3 removeClass

/*** * @desc 为元素移除class* @param {HTMLElement} ele * @param {String} cls */var hasClass = require('./hasClass');function removeClass(ele, cls) {if (hasClass(ele, cls)) {var reg = new RegExp('(\\s|^)' + cls + '(\\s|$)');ele.className = ele.className.replace(reg, ' ');}
}

3.Cookie

3.1 getCookie

/*** * @desc 根据name读取cookie* @param  {String} name * @return {String}*/
function getCookie(name) {var arr = document.cookie.replace(/\s/g, "").split(';');for (var i = 0; i < arr.length; i++) {var tempArr = arr[i].split('=');if (tempArr[0] == name) {return decodeURIComponent(tempArr[1]);}}return '';
}

3.2 removeCookie

var setCookie = require('./setCookie');
/*** * @desc 根据name删除cookie* @param  {String} name */
function removeCookie(name) {// 设置已过期,系统会立刻删除cookiesetCookie(name, '1', -1);
}

3.3 setCookie

/*** * @desc  设置Cookie* @param {String} name * @param {String} value * @param {Number} days */
function setCookie(name, value, days) {var date = new Date();date.setDate(date.getDate() + days);document.cookie = name + '=' + value + ';expires=' + date;
}

4.Device

4.1 getExplore

/*** * @desc 获取浏览器类型和版本* @return {String} */
function getExplore() {var sys = {},ua = navigator.userAgent.toLowerCase(),s;(s = ua.match(/rv:([\d.]+)\) like gecko/)) ? sys.ie = s[1]:(s = ua.match(/msie ([\d\.]+)/)) ? sys.ie = s[1] :(s = ua.match(/edge\/([\d\.]+)/)) ? sys.edge = s[1] :(s = ua.match(/firefox\/([\d\.]+)/)) ? sys.firefox = s[1] :(s = ua.match(/(?:opera|opr).([\d\.]+)/)) ? sys.opera = s[1] :(s = ua.match(/chrome\/([\d\.]+)/)) ? sys.chrome = s[1] :(s = ua.match(/version\/([\d\.]+).*safari/)) ? sys.safari = s[1] : 0;// 根据关系进行判断if (sys.ie) return ('IE: ' + sys.ie)if (sys.edge) return ('EDGE: ' + sys.edge)if (sys.firefox) return ('Firefox: ' + sys.firefox)if (sys.chrome) return ('Chrome: ' + sys.chrome)if (sys.opera) return ('Opera: ' + sys.opera)if (sys.safari) return ('Safari: ' + sys.safari)return 'Unkonwn'
}

4.2 getOS

/*** * @desc 获取操作系统类型* @return {String} */
function getOS() {var userAgent = 'navigator' in window && 'userAgent' in navigator && navigator.userAgent.toLowerCase() || '';var vendor = 'navigator' in window && 'vendor' in navigator && navigator.vendor.toLowerCase() || '';var appVersion = 'navigator' in window && 'appVersion' in navigator && navigator.appVersion.toLowerCase() || '';if (/mac/i.test(appVersion)) return 'MacOSX'if (/win/i.test(appVersion)) return 'windows'if (/linux/i.test(appVersion)) return 'linux'if (/iphone/i.test(userAgent) || /ipad/i.test(userAgent) || /ipod/i.test(userAgent)) 'ios'if (/android/i.test(userAgent)) return 'android'if (/win/i.test(appVersion) && /phone/i.test(userAgent)) return 'windowsPhone'
}

5.Dom

5.1 getScrollTop

/*** * @desc 获取滚动条距顶部的距离*/
function getScrollTop() {return (document.documentElement && document.documentElement.scrollTop) || document.body.scrollTop;
}

5.2 offset

/*** * @desc  获取一个元素的距离文档(document)的位置,类似jQ中的offset()* @param {HTMLElement} ele * @returns { {left: number, top: number} }*/
function offset(ele) {var pos = {left: 0,top: 0};while (ele) {pos.left += ele.offsetLeft;pos.top += ele.offsetTop;ele = ele.offsetParent;};return pos;
}

5.3 scrollTo

var getScrollTop = require('./getScrollTop');
var setScrollTop = require('./setScrollTop');
var requestAnimFrame = (function () {return window.requestAnimationFrame ||window.webkitRequestAnimationFrame ||window.mozRequestAnimationFrame ||function (callback) {window.setTimeout(callback, 1000 / 60);};
})();
/*** * @desc  在${duration}时间内,滚动条平滑滚动到${to}指定位置* @param {Number} to * @param {Number} duration */
function scrollTo(to, duration) {if (duration < 0) {setScrollTop(to);return}var diff = to - getScrollTop();if (diff === 0) returnvar step = diff / duration * 10;requestAnimationFrame(function () {if (Math.abs(step) > Math.abs(diff)) {setScrollTop(getScrollTop() + diff);return;}setScrollTop(getScrollTop() + step);if (diff > 0 && getScrollTop() >= to || diff < 0 && getScrollTop() <= to) {return;}scrollTo(to, duration - 16);});
}

5.4 setScrollTop

/*** * @desc 设置滚动条距顶部的距离*/
function setScrollTop(value) {window.scrollTo(0, value);return value;
}

6.Keycode

6.1 getKeyName

var keyCodeMap = {8: 'Backspace',9: 'Tab',13: 'Enter',16: 'Shift',17: 'Ctrl',18: 'Alt',19: 'Pause',20: 'Caps Lock',27: 'Escape',32: 'Space',33: 'Page Up',34: 'Page Down',35: 'End',36: 'Home',37: 'Left',38: 'Up',39: 'Right',40: 'Down',42: 'Print Screen',45: 'Insert',46: 'Delete',48: '0',49: '1',50: '2',51: '3',52: '4',53: '5',54: '6',55: '7',56: '8',57: '9',65: 'A',66: 'B',67: 'C',68: 'D',69: 'E',70: 'F',71: 'G',72: 'H',73: 'I',74: 'J',75: 'K',76: 'L',77: 'M',78: 'N',79: 'O',80: 'P',81: 'Q',82: 'R',83: 'S',84: 'T',85: 'U',86: 'V',87: 'W',88: 'X',89: 'Y',90: 'Z',91: 'Windows',93: 'Right Click',96: 'Numpad 0',97: 'Numpad 1',98: 'Numpad 2',99: 'Numpad 3',100: 'Numpad 4',101: 'Numpad 5',102: 'Numpad 6',103: 'Numpad 7',104: 'Numpad 8',105: 'Numpad 9',106: 'Numpad *',107: 'Numpad +',109: 'Numpad -',110: 'Numpad .',111: 'Numpad /',112: 'F1',113: 'F2',114: 'F3',115: 'F4',116: 'F5',117: 'F6',118: 'F7',119: 'F8',120: 'F9',121: 'F10',122: 'F11',123: 'F12',144: 'Num Lock',145: 'Scroll Lock',182: 'My Computer',183: 'My Calculator',186: ';',187: '=',188: ',',189: '-',190: '.',191: '/',192: '`',219: '[',220: '\\',221: ']',222: '\''
};
/*** @desc 根据keycode获得键名* @param  {Number} keycode * @return {String}*/
function getKeyName(keycode) {if (keyCodeMap[keycode]) {return keyCodeMap[keycode];} else {console.log('Unknow Key(Key Code:' + keycode + ')');return '';}
};

7.Object

7.1 deepClone

/*** @desc 深拷贝,支持常见类型* @param {Any} values*/
function deepClone(values) {var copy;// Handle the 3 simple types, and null or undefinedif (null == values || "object" != typeof values) return values;// Handle Dateif (values instanceof Date) {copy = new Date();copy.setTime(values.getTime());return copy;}// Handle Arrayif (values instanceof Array) {copy = [];for (var i = 0, len = values.length; i < len; i++) {copy[i] = deepClone(values[i]);}return copy;}// Handle Objectif (values instanceof Object) {copy = {};for (var attr in values) {if (values.hasOwnProperty(attr)) copy[attr] = deepClone(values[attr]);}return copy;}throw new Error("Unable to copy values! Its type isn't supported.");
}

7.2 isEmptyObject

/*** * @desc   判断`obj`是否为空* @param  {Object} obj* @return {Boolean}*/
function isEmptyObject(obj) {if (!obj || typeof obj !== 'object' || Array.isArray(obj))return falsereturn !Object.keys(obj).length
}

8.Random

8.1 randomColor

/*** * @desc 随机生成颜色* @return {String} */
function randomColor() {return '#' + ('00000' + (Math.random() * 0x1000000 << 0).toString(16)).slice(-6);
}

8.2 randomNum 

/*** * @desc 生成指定范围随机数* @param  {Number} min * @param  {Number} max * @return {Number} */
function randomNum(min, max) {return Math.floor(min + Math.random() * (max - min));
}

9.Regexp

9.1 isEmail

/*** * @desc   判断是否为邮箱地址* @param  {String}  str* @return {Boolean} */
function isEmail(str) {return /\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*/.test(str);
}

9.2 isIdCard

/*** * @desc  判断是否为身份证号* @param  {String|Number} str * @return {Boolean}*/
function isIdCard(str) {return /^(^[1-9]\d{7}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}$)|(^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])((\d{4})|\d{3}[Xx])$)$/.test(str)
}

9.3 isPhoneNum

/*** * @desc   判断是否为手机号* @param  {String|Number} str * @return {Boolean} */
function isPhoneNum(str) {return /^(0|86|17951)?(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$/.test(str)
}

9.4 isUrl

/*** * @desc   判断是否为URL地址* @param  {String} str * @return {Boolean}*/
function isUrl(str) {return /[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)/i.test(str);
}

10.String

10.1 digitUppercase

/*** * @desc   现金额转大写* @param  {Number} n * @return {String}*/
function digitUppercase(n) {var fraction = ['角', '分'];var digit = ['零', '壹', '贰', '叁', '肆','伍', '陆', '柒', '捌', '玖'];var unit = [['元', '万', '亿'],['', '拾', '佰', '仟']];var head = n < 0 ? '欠' : '';n = Math.abs(n);var s = '';for (var i = 0; i < fraction.length; i++) {s += (digit[Math.floor(n * 10 * Math.pow(10, i)) % 10] + fraction[i]).replace(/零./, '');}s = s || '整';n = Math.floor(n);for (var i = 0; i < unit[0].length && n > 0; i++) {var p = '';for (var j = 0; j < unit[1].length && n > 0; j++) {p = digit[n % 10] + unit[1][j] + p;n = Math.floor(n / 10);}s = p.replace(/(零.)*零$/, '').replace(/^$/, '零') + unit[0][i] + s;}return head + s.replace(/(零.)*零元/, '元').replace(/(零.)+/g, '零').replace(/^整$/, '零元整');
};

11.Support

11.1 isSupportWebP

/*** * @desc 判断浏览器是否支持webP格式图片* @return {Boolean} */
function isSupportWebP() {return !![].map && document.createElement('canvas').toDataURL('image/webp').indexOf('data:image/webp') == 0;
}

12.Time

12.1 formatPassTime

/*** @desc   格式化${startTime}距现在的已过时间* @param  {Date} startTime * @return {String}*/
function formatPassTime(startTime) {var currentTime = Date.parse(new Date()),time = currentTime - startTime,day = parseInt(time / (1000 * 60 * 60 * 24)),hour = parseInt(time / (1000 * 60 * 60)),min = parseInt(time / (1000 * 60)),month = parseInt(day / 30),year = parseInt(month / 12);if (year) return year + "年前"if (month) return month + "个月前"if (day) return day + "天前"if (hour) return hour + "小时前"if (min) return min + "分钟前"else return '刚刚'
}

12.2 formatRemainTime

/*** * @desc   格式化现在距${endTime}的剩余时间* @param  {Date} endTime  * @return {String}*/
function formatRemainTime(endTime) {var startDate = new Date(); //开始时间var endDate = new Date(endTime); //结束时间var t = endDate.getTime() - startDate.getTime(); //时间差var d = 0,h = 0,m = 0,s = 0;if (t >= 0) {d = Math.floor(t / 1000 / 3600 / 24);h = Math.floor(t / 1000 / 60 / 60 % 24);m = Math.floor(t / 1000 / 60 % 60);s = Math.floor(t / 1000 % 60);}return d + "天 " + h + "小时 " + m + "分钟 " + s + "秒";
}

13.Url

13.1 parseQueryString

/*** * @desc   url参数转对象* @param  {String} url  default: window.location.href* @return {Object} */
function parseQueryString(url) {url = url == null ? window.location.href : urlvar search = url.substring(url.lastIndexOf('?') + 1)if (!search) {return {}}return JSON.parse('{"' + decodeURIComponent(search).replace(/"/g, '\\"').replace(/&/g, '","').replace(/=/g, '":"') + '"}')
}

13.2 stringfyQueryString

/*** * @desc   对象序列化* @param  {Object} obj * @return {String}*/
function stringfyQueryString(obj) {if (!obj) return '';var pairs = [];for (var key in obj) {var value = obj[key];if (value instanceof Array) {for (var i = 0; i < value.length; ++i) {pairs.push(encodeURIComponent(key + '[' + i + ']') + '=' + encodeURIComponent(value[i]));}continue;}pairs.push(encodeURIComponent(key) + '=' + encodeURIComponent(obj[key]));}return pairs.join('&');
}

14.Function

14.1 throttle

/*** @desc   函数节流。* 适用于限制`resize`和`scroll`等函数的调用频率** @param  {Number}    delay          0 或者更大的毫秒数。 对于事件回调,大约100或250毫秒(或更高)的延迟是最有用的。* @param  {Boolean}   noTrailing     可选,默认为false。*                                    如果noTrailing为true,当节流函数被调用,每过`delay`毫秒`callback`也将执行一次。*                                    如果noTrailing为false或者未传入,`callback`将在最后一次调用节流函数后再执行一次.*                                    (延迟`delay`毫秒之后,节流函数没有被调用,内部计数器会复位)* @param  {Function}  callback       延迟毫秒后执行的函数。`this`上下文和所有参数都是按原样传递的,*                                    执行去节流功能时,调用`callback`。* @param  {Boolean}   debounceMode   如果`debounceMode`为true,`clear`在`delay`ms后执行。*                                    如果debounceMode是false,`callback`在`delay` ms之后执行。** @return {Function}  新的节流函数*/
function throttle(delay, noTrailing, callback, debounceMode) {// After wrapper has stopped being called, this timeout ensures that// `callback` is executed at the proper times in `throttle` and `end`// debounce modes.var timeoutID;// Keep track of the last time `callback` was executed.var lastExec = 0;// `noTrailing` defaults to falsy.if (typeof noTrailing !== 'boolean') {debounceMode = callback;callback = noTrailing;noTrailing = undefined;}// The `wrapper` function encapsulates all of the throttling / debouncing// functionality and when executed will limit the rate at which `callback`// is executed.function wrapper() {var self = this;var elapsed = Number(new Date()) - lastExec;var args = arguments;// Execute `callback` and update the `lastExec` timestamp.function exec() {lastExec = Number(new Date());callback.apply(self, args);}// If `debounceMode` is true (at begin) this is used to clear the flag// to allow future `callback` executions.function clear() {timeoutID = undefined;}if (debounceMode && !timeoutID) {// Since `wrapper` is being called for the first time and// `debounceMode` is true (at begin), execute `callback`.exec();}// Clear any existing timeout.if (timeoutID) {clearTimeout(timeoutID);}if (debounceMode === undefined && elapsed > delay) {// In throttle mode, if `delay` time has been exceeded, execute// `callback`.exec();} else if (noTrailing !== true) {// In trailing throttle mode, since `delay` time has not been// exceeded, schedule `callback` to execute `delay` ms after most// recent execution.//// If `debounceMode` is true (at begin), schedule `clear` to execute// after `delay` ms.//// If `debounceMode` is false (at end), schedule `callback` to// execute after `delay` ms.timeoutID = setTimeout(debounceMode ? clear : exec, debounceMode === undefined ? delay - elapsed : delay);}}// Return the wrapper function.return wrapper;};

14.2 debounce

/*** @desc 函数防抖 * 与throttle不同的是,debounce保证一个函数在多少毫秒内不再被触发,只会执行一次,* 要么在第一次调用return的防抖函数时执行,要么在延迟指定毫秒后调用。* @example 适用场景:如在线编辑的自动存储防抖。* @param  {Number}   delay         0或者更大的毫秒数。 对于事件回调,大约100或250毫秒(或更高)的延迟是最有用的。* @param  {Boolean}  atBegin       可选,默认为false。*                                  如果`atBegin`为false或未传入,回调函数则在第一次调用return的防抖函数后延迟指定毫秒调用。如果`atBegin`为true,回调函数则在第一次调用return的防抖函数时直接执行* @param  {Function} callback      延迟毫秒后执行的函数。`this`上下文和所有参数都是按原样传递的,*                                  执行去抖动功能时,,调用`callback`。** @return {Function} 新的防抖函数。*/
var throttle = require('./throttle');
function debounce(delay, atBegin, callback) {return callback === undefined ? throttle(delay, atBegin, false) : throttle(delay, callback, atBegin !== false);
};

封装

除了对上面这些常用函数进行封装, 最重要的是支持合理化的引入,这里我们使用webpack统一打包成UMD 通用模块规范,支持webpackRequireJSSeaJS等模块加载器,亦或直接通过<script>标签引入。

但这样,还是不能让人满意。因为完整引入整个库,略显浪费,我们不可能用到所有的函数。那么,就支持按需引入

1.目录结构说明

│  .babelrc
│  .gitignore
│  .travis.yml
│  LICENSE
│  package.json
│  README.md
│  setCookie.js  // 拷贝到根路径的函数模块,方便按需加载
│  setScrollTop.js
│  stringfyQueryString.js
│   ...
│   ...
│
├─min
│      outils.min.js  // 所有函数统一打包生成的全量压缩包
│
├─script  // 本项目开发脚本目录
│      build.js  // 打包构建脚本
│      test.js  // 测试脚本
│      webpack.conf.js  // webpack打包配置文件
│
├─src // 源码目录
│  │  index.js  // webpack入口文件
│  │
│  ├─array
│  │
│  ├─class
│  │
│  ├─cookie
│  │
│  ├─device
│  │
│  ├─dom
│  │
│  ├─keycode
│  │
│  ├─object
│  │
│  ├─random
│  │
│  ├─regexp
│  │
│  ├─string
│  │
│  ├─support
│  │
│  ├─time
│  │
│  └─url
│
└─test // 测试用例目录│  array.test.js│  class.test.js│  cookie.test.js│  device.test.js│  dom.test.js│  index.html│  keycode.test.js│  object.test.js│  random.test.js│  regexp.test.js│  string.test.js│  support.test.js│  time.test.js│  url.test.js│  └─_lib // 测试所用到的第三方库mocha.cssmocha.jspower-assert.js

2.构建脚本

这里主要说明一下项目中 build.js 的构建过程
第一步,构建全量压缩包,先删除min目录中之前的outils.min.js,后通过webpack打包并保存新的压缩包至min目录中:

    ............// 删除旧的全量压缩包rm(path.resolve(rootPath, 'min', `${pkg.name}.min.js`), err => {if (err) throw (err)webpack(config, function (err, stats) {if (err) throw (err)building.stop()process.stdout.write(stats.toString({colors: true,modules: false,children: false,chunks: false,chunkModules: false}) + '\n\n')resolve()console.log(chalk.cyan('  Build complete.\n'))})})............

第二步,拷贝函数模块至根目录,先删除根目录中之前的函数模块,后拷贝src下面一层目录的所有js文件至根目录。这么做的目的是,拷贝到根路径,在引入的时候,直接require('outils/<方法名>')即可,缩短引入的路径,也算是提高点效率。

// 替换模块文件............// 先删除根目录中之前的函数模块rm('*.js', err => {if (err) throw (err)let folderList = fs.readdirSync(path.resolve(rootPath, 'src'))folderList.forEach((item, index) => {// 拷贝`src`下面一层目录的所有`js`文件至根目录copy(`src/${item}/*.js`, rootPath, function (err, files) {if (err) throw err;if (index === folderList.length - 1) {console.log(chalk.cyan('  Copy complete.\n'))copying.stop()}})})})............

3.书写测试用例

俗话说,不写测试用例的前端不是一个好程序员。那就不能怂,就是干。

但是因为时间关系,本项目暂时通过项目中的 test.js ,启动了一个koa静态服务器,来加载mocha网页端的测试页面,让笔者书写项目时,可以在本地对函数功能进行测试。
但是后续将使用travis-ci配合Github来做持续化构建,自动发布到npm。改用karmamochapower-assert做单元测试,使用Coverage测试覆盖率。这一部分,后续更新。

这里给大家推荐一个好用的断言库 power-assert ,这个库记住assert(value, [message])一个API就基本无敌,从此再也不用担心记不住断言库的API。

本项目的所有测试用例都在test目录下,大家可以作一定参考。

发布

首先放到Github托管一下,当然你也可以直接fork本项目,然后再加入你自己的函数。
以笔者项目,举个栗子:

1.添加自己的函数

src目录下,新建分类目录或者选择一个分类,在子文件夹中添加函数模块文件(建议一个小功能保存为一个JS文件)。

/*** * @desc   判断是否NaN* @param  {Any} value * @return {Boolean}*/
function isNaN(value) {    return value !== value;
};modules.export = isNaN

然后记得在src/index.js文件中暴露isNaN函数

2.单元测试

test文件新建测试用例

describe('#isNaN()', function () {it(`outils.isNaN(NaN) should return true`, function () {assert(outils.isNaN(NaN))})it(`outils.isNaN('value') should return false`, function () {assert.notEqual(outils.isNaN(NaN))})
})

然后记得在test/index.html中引入之前创建的测试用例脚本。

3.测试并打包

执行npm run test,看所有的测试用例是否通过。如果没有问题,执行npm run build构建,之后提交到个人的 github 仓库即可。

4.发布到npm

在 www.npmjs.com 注册账号,修改本地package.json中的nameversionauthor等信息,最后npm publish就大功告成了。
注意:向npm发包,要把镜像源切到 www.npmjs.com ,使用cnpm等第三方镜像源会报错。

使用

1.浏览器

直接下载min目录下的 outils.min.js ,通过<script>标签引入。

  <script src="outils.min.js"></script><script>var OS = outils.getOS()</script>

注意: 本仓库代码会持续更新,如果你需要不同版本的增量压缩包或源码,请到 github Release 页面下载对应版本号的代码。

2.Webpack、RequireJS、SeaJS等模块加载器

先使用npm安装outils

$ npm install --save-dev outils
// 完整引入
const outils = require('outils')
const OS = outils.getOS()

推荐使用方法

// 按需引入require('outils/<方法名>')
const getOS = require('outils/getOS')
const OS = getOS()

当然,你的开发环境有babel编译ES6语法的话,也可以这样使用:

import getOS from 'outils/getOS'
// 或
import { getOS } from "outils";

总结

这里只是简单封装,发布到npm上,省去下次复制粘贴的功夫,或者直接Goole的时间。如果笔者的库中,没有你常用的函数,或者你有更好的建议,欢迎来本项目的 Github Issues 交流,如果觉得不错,欢迎 star 本项目。

当然,更好的建议是 fork 本项目,或者直接新建自己的项目,添加自己 想要的常用的记不住的 函数,甚至是可以抽象出来的功能,封装成自己顺手、熟悉的库。 这样才能打造出你自己的武器库,瞬间提高你的单兵作战(开发)能力。

作者:SlaneYang
链接:https://juejin.im/post/5a091afe6fb9a044ff30f402
来源:掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

打造自己的JavaScript武器库相关推荐

  1. 打造自己的 JavaScript 武器库

    作为战斗在业务一线的前端,要想少加班,就要想办法提高工作效率.这里提一个小点,我们在业务开发过程中,经常会重复用到 日期格式化. url参数转对象. 浏览器类型判断. 节流函数等一类函数,这些工具类函 ...

  2. JavaScript武器库

    JavaScript武器库 前言 作为战斗在业务一线的前端,要想少加班,就要想办法提高工作效率.这里提一个小点,我们在业务开发过程中,经常会重复用到日期格式化.url参数转对象.浏览器类型判断.节流函 ...

  3. 几十行代码,打造一款JavaScript便签系统

    先看下效果: 载体就是一个网页,用html,css和JavaScript实现一个简单的便签系统. 动画效果用的是animation.css库,缓存用的localStorage. 除非手动清空便签,否则 ...

  4. 打造自己的Javascript工具类库

    基本扩展.工具包 // ------------------------ 基本扩展, 字符串,数组等---------------------------------// function exten ...

  5. 这些年掘金上的优质前端文章,篇篇经典,一次打包带走!

    前言:近日发现掘金上有所有的热门文章的排行榜,但是仅仅只是排行,不利于收藏查阅.于是乎我就把热门文章全部爬下来了(站长看到别打我啊?),相信这些获得高赞文章质量不会差,爬完做了分类后不敢私藏,和大家一 ...

  6. 2017下半年掘金日报优质文章合集:前端篇

    在掘金微信群里的小伙伴应该都有看每日小报吧!这是小饼每天为大家精选的优质掘金文章(大家都很爱学习,我已经跟不上了QAQ..)小饼已经被N位群友连续几周催着出小报合集了,2017年马上就要结束了,拖延症 ...

  7. 2017下半年优质文章合集:前端篇

    2017年马上就要结束了,拖延症绝不拖到明年!这就给大家整理出来--2017下半年优质小报合集. CSS/页面布局 border属性的多方位应用和实现自适应三角形 BEM实战之扒一扒淘票票页面 一劳永 ...

  8. 流行的javascript库介绍

    JavaScript简介 JavaScript是为了适应动态网页制作的需要而诞生的一种编程语言.它是由 Netscape公司开发的一种脚本语言(scripting language).JavaScri ...

  9. three.js根据高德地图的经纬度信息打造3D地图

    代码效果: 依据的数据: 高德地图 根据地图的经纬度,利用three.js框架打造3D地图,同时可以把飞机.高铁.汽车等元素加入其中,给他们指定的路线,让他们动起来. 源代码地址:three.js打造 ...

最新文章

  1. 英特尔分布式深度学习平台Nauta-安装、配置与管理指南
  2. 《The Age of Surge》作者访谈
  3. [转]UI设计小技巧
  4. Android BrocastReceiver解析
  5. 结对编程项目作业-结对编项目设计文档
  6. Oracle存储过程和自定义函数
  7. JS导出 excel
  8. leetcode 418 整数转罗马数字
  9. Linux C/C++ Openssl RSA Encrypt/Decrypt(加密/解密) 简单示例教程
  10. 不同串口通信速率超时时间_串口知识详解 串口功能及电路介绍
  11. esp8266 html文件,ESP8266 基ESP8266_RTOS_SDK (ESP-IDF )中嵌入网页文件(示例代码)
  12. python常用的库_这几个常用的python库你需要知道
  13. 数据结构思维 第三章 `ArrayList`
  14. 计算机ppt试题训练,powerpoint2010操作题 计算机POWERPOINT操作题
  15. Xcode因为证书问题经常报的那些错
  16. 系统补丁不适用计算机,无法安装IE11 安装补丁“此更新不适用于你的计算机”解决办法...
  17. Windows安装redis教程
  18. php表格中的caption,HTML中的caption属性是什么意思?caption标签在HTML中的用法(附实例)...
  19. VS2010 旗舰版序列号
  20. 计算机如何格式化和重装系统,怎样格式化c盘重新安装系统_重装系统时如何格式化C盘...

热门文章

  1. 羽毛球馆的两个基础设施你了解多少?
  2. PyQt5界面、美化(pyqt炫酷界面好看界面)
  3. android dat怎么打开方式,安卓手机如何打开.dat文件?
  4. 百度和Snapchat续约 强强联手拓展海外市场
  5. echarts自定义legend样式
  6. dreamweaver快捷方式
  7. 5 精通matlab深入学习结构体看这篇文章就够了
  8. c语言倒序输出英文字母表音标,C语言初学问题(分析过程)1) 输出所有的大写英文字母(2) 倒序输出所有大写英文字母(3) 分别输...
  9. DNSPod十问赵东方:除了上网,路由器还能干什么?
  10. 捷径智慧物业系统打造真正“学区房”