A Javascript Common Functions Library
This project is working in progress.
$ npm install bay-utils.js
import { isMobileUA } from 'bay-utils';
console.log(isMobileUA(navigator.userAgent));
> true;
The easiest way to use utils is to load the built script:
<!-- development -->
<script type="text/javascript" src="https://static.baydn.com/baydn/public/bay-utils/v1.1.6/bay-utils.js"></script>
<!-- production -->
<script type="text/javascript" src="https://static.baydn.com/baydn/public/bay-utils/v1.1.6/bay-utils.min.js"></script>
Having include the dependencies, the library can be used:
bayUtils.isMobileUA(navigator.userAgent);
/**
* 获取一个日期对象
* @param {string} time 日期
* @return {Object} date 一个日期对象
*/
const date = parseDate(time);
/**
* 获取某一格式的日期
* @param {string} date 日期
* @param {string} format 自定义格式,默认为 yyyy-MM-DD
比如: yyyy-MM-DD hh:mm:ss SSS 或者 YY年MM月DD日 hh时mm分ss秒 SSS毫秒, 其中 y 大小写均可
* @return {string} dateStr 格式为 format 的日期
*/
> formatDate('2016-08-09 08:01:23');
> 2016-08-09
> formatDate('2016-11-09 08:01:23', 'YYYY.M.D');
> 2016.11.9
> formatDate(new Date('2016-08-09 08:01:23'), 'yy年MM月DD日');
> 16年08月09日
> formatDate(new Date('2016-08-09 08:01:23'), 'yyyy年MM月DD日 hh小时mm分钟ss秒');
> 2016年08月09日 08时01分23秒
> formatDate(new Date('2017-02-16 08:01:23), '星期d');
> 星期四
/**
* 截取字符串
* @param {string} str 字符串
* @param {number} length 截取长度
* @return {string} symbol 截取字符串代表剩余部分的符号,默认为'...'
*/
> trimString('China will', 3);
> Chi...
> trimString('China will', 3, '***');
> Chi***
/**
* 获取一部分为明文的字符串
* @param {string} str 字符串
* @param {number} start 截取字符串符号的开始位置,从字符串开始计算,以 1 开始
* @param {number} end 截取字符串符号的结束位置,从字符串结尾计算,以 1 开始
* @param {string} symbol 截取字符串符号,默认为 *
* @param {number} symbolLen 截取字符串符号的长度,默认是字符串长度减去开始和结尾部分的字符串长度和;如果传入数字参数,那么截取字符串符号的长度就是传入的参数
* @return {string} str 一部分为明文的字符串,比如:1****com
*/
> formatSafetyStr('12345com', 1, 3, '+', 5);
> '1+++++com'
/**
* 获取一部分为明文的邮箱地址
* @param {string} email 邮箱地址
* @param {number} start 同 formatSafetyStr,默认值为邮箱地址长度的 1/4
* @param {number} end 同 formatSafetyStr,默认值为邮箱地址长度的 1/4
* @param {string} symbol 截取字符串符号,默认为 *
* @param {number} symbolLen 截取字符串符号的长度,同 formatSafetyStr
* @return {string} str 一部分为明文的邮箱地址,比如:1****com
*/
> formatSafetyEmail('1234567@qq.com')
> '123********com'
/**
* 获取一部分为明文的电话号码
* @param {string} mobilephone 电话号码
* @param {number} start 同 formatSafetyStr,默认值为 3
* @param {number} end 同 formatSafetyStr,默认值为 4
* @param {string} symbol 截取字符串符号,默认为 *
* @return {string} str 一部分为明文的电话号码,比如:181****3344
*/
> formatSafetyMobilephone('18111223344');
> '181****3344'
/**
* 将数字转化为中文
* @param {number} number 数字
* @return {string} str 中文
*/
> formatNumToCn(21);
> '二十一'
验证输入是否是字符串
> assertString(111)
> false
> toString({x: 1})
> false
合并两个 object,第二个参数的 key 不会覆盖前面的。
> merge({x: 1}, {x: 2, y: 4})
> false
判断是否是标准的浏览器环境
> isStandardBrowserEnv()
> false
> isFunction(function(){})
> true
判断 Agent 是否是微信
> isWechatUA(navigator.userAgent)
> false
判断 Agent 是否是手机
> isMobileUA(navigator.userAgent)
> false
判断 Agent 是否是 Android
> isAndroidUA(navigator.userAgent)
> false
判断 Agent 是否是 iOS
> isIOSUA(navigator.userAgent)
> false
判断 Agent 是否是扇贝 APP
> isShanbayAppUA(navigator.userAgent)
> false
判断字符串是否是手机号
> isMobilePhone(13323432221)
> true
判断字符串是否是邮箱
> isEmail('133@qq.com')
> true
判断字符串是否是 url
> isUrl('https://www.shanbay.com/')
> true
转义 <, >, &, ', " 和 /。
> escapeStr('<p>hi</p>')
> "<p>hi</p>"
> unescapeStr("<p>hi</p>")
> "<p>hi</p>"
第二个参数是 options,默认为 {min:0, max: undefined}
> isStrLength('hello', {min: 2, max: 5})
> true
判断字符串是不是 json,使用 json.parse
> isJSON('hello')
> false
> isJSON(JSON.stringify({x: 1}))
> true
判读字符串是否为数字
> isNumeric('123');
> true
判断字符串是否为空
> isEmptyStr('123');
> false
判断是否为空对象
> isEmptyObj({});
> true
判断是否为数组
> isArray([]);
> true
/**
* 判断元素是否有某个 class
* @param {element} el 元素
* @param {string} className
* @return {boolean}
*/
hasClass(el, 'foo');
/**
* 给元素添加某个 class
* @param {element} el 元素
* @param {string} className 添加的 class
*/
addClass(el, 'foo');
/**
* 给元素删除某个 class
* @param {element} el 元素
* @param {string} className 删除的 class
*/
removeClass(el, 'foo');
/**
* 获取表单数据
* @param {element} formEl 表单元素
* @return {Object} data 表单中 name 有值的输入框的数据,数据结构与 FormData 相同。
当输入框 type 为 radio 的时候,只返回选中状态的值。
*/
const data = getFormData(formEl);
/**
* 清空表单输入框的值
* @param {element} formEl 表单元素
*/
clearFormData(formEl);
/**
* 选择元素中的内容
* @param {element} el 元素
*/
selectElement(el);
/**
* 复制文字到剪贴板
* @param {string} text 复制的内容
*/
copyToClipboard(text);
/**
* 图片懒加载
*/
lazyloadImage();
/**
* 按钮倒计时
* @param {element} el 按钮元素
* @param {object} options 选项,具体如下:
* time: 倒计时时间,默认为 60,单位为 s
* getProcessText: 倒计时时每隔 1s 的调用,传入倒计时剩余的秒数,返回需要显示的文字,默认为 countDownTime => `${countDownTime}s后重发`,
* endText: 倒计时结束的文字,默认为'重新获取验证码'
* @return {string} cdInterval 倒计时标记
**/
/**
* 将 clipboard 中的内容转为 markdown
* @param {event} e 事件
* @param {array} disabledList 选项,具体如下:
* color: 颜色, 转为 <span style="color: rgb(255, 0, 0)">text</span>
* bold: 加粗, 转为 **text**
* italic: 斜体, 转为 *text*(加粗且斜体时,__text__)
* @return {string} 解析后的 markdown
**/
/**
* @param {string} options 类似 jquery ajax 的 options。
* 不同的是当 isOriginal 为 false 时,success 判断了 status_code 为 0,success 会返回 data,
* 而 error 是在请求失败时调用的(包括 status_code 不为 0),会返回 status 和 msg 两个参数。
* @param {string} isOriginal 为 true 时,将不会对 success 和 error 做任何处理,默认为 false
* @param {object} configure 当 key 为 LOGIN_URL 时,值是请求 401 或 403 时 redirect 的 url,默认为 '/accounts/login'。
*/
ajax(options, isOriginal, configure);
/**
* 获取链接中 search 的值
* @param {string} name 名称
* @param {string} url 链接,默认为当前链接
*/
const value = getSearchValue(name);
/**
* 获取 cookie 中的值
* @param {string} cookie 名称
* @param {string} name 名称
*/
const value = getCookie(cookie, name);
/**
* 获取两个日期相差的天数
* @param {string} day1 日期
* @param {string} day2 日期
* @return {number} dayDiff 相差的天数
*/
> getDayDiff('2017-2-11', '2017-2-12');
> 1
/**
* 获取 Frontend 版本号
* @params {object} ua userAgent,默认为 window.navigator.userAgent
* @return {number} version 版本号
*/
> getFrontendVersion();
> 1.1
/**
* 对 array 去重
* @param {Array} 原数组
* @return {Array} 新数组
*/
const newArr = uniqArr(arr);
/**
* 获取 string 中的 urls
* @param {String} 字符串
* @return {Array} 包含 url 的数组
*/
const urlsArr = getUrlsFromStr(str);
/**
* 将字符串中的 url 转化成 html 中的 a 元素
* @params {String} 字符串
* @return {String} 包含 a 元素的字符串
*/
const newStr = transformUrlToAnchor(str);
/**
* 微信JSSDK分享接口
*
* @param {object} param 参数
* 参数说明:
* shareData: Object, 用以分享的信息,{title, link, imgUrl, success, cancel, codename},
* trackObject: Object, track链接,
* jsApiList: Array, 需要使用的JS接口列表,
* onReady: 成功验证后的回调函数,
* isDev: 是否为开发环境,默认为false,
* isDebug: 是否开启调试模式
*/
wxSdkConfig(params);
/**
* 分享到自习室接口
* @params {Object} 参数
* 参数说明:
* data: {Object}, 用以分享的信息,具体为下
* content: 用户分享的内容
* share_content: 分享需要的参数
* title: 分享标题,默认为当前页面的title
* content: 分享内容
* image_url: 图片,默认为扇贝logo
* redirect_url: 重定向地址,默认为当前页面
* isDev: 是否为开发环境, 默认为false,
* onSuccess: 发送成功后的回调函数,
* onError: 发送失败后的回调函数,
*/
studyroomShare(params);
/**
* 根据 agent 获取当前 app 的 name,name 与 xbay 的 appsData 相同
* @param {string} agent
*/
> getAppNameFromAgent(window.navigator.userAgent);
> bdc