@funren/tool-func v1.0.1

常用工具函数

• timeStamp,//时间戳格式转换

• totalPage,//分页计算

• isTest,//判断当前处于测试模式

• isWeixin,//判断微信端
• isMobile,//判断移动端
• isApple,//判断苹果移动端

• isAndroid,//判断安卓移动端

• urlParamAdd,//url参数封装

• urlParamGet,//获取url参数
• cookieAdd,//新增cookie值
• cookieGet,//获取cookie值
• sessionStorageAdd,//存储sessionStorage值
• sessionStorageGet,//获取sessionStorage值
• localStorageAdd,//存储localStorage值

• localStorageGet,//获取localStorage值

• strJoin,//自定义连接符拼接字符串

• strTrim,//清除字符串空格
• strDelRight,//删除右侧字符串
• lengthRange,//验证字符串长度是否在规定范围
• letterBegin,//验证字符串是否以字母开头
• pureNum,//验证字符串是否为纯数字
• isMail,//验证大陆邮政编码
• isIdCard,//验证二代身份证
• isURL,//验证网址
• isQQ,//验证QQ号
• isEmail,//验证电子邮箱
• isPhone,//验证手机号
• haveSpace,//判断字符串是否包含空格
• haveCNChars,//判断字符串是否包含中文

安装方式

npm install @funren/tool-func

调用方式

const $tf = require('@funren/tool-func')
$tf.isWeixin()

Functions

cookieAdd(datas)

新增cookie;支持以json字符串形式传入多个cookie值；

Kind: global function

Example

cookieAdd({
  name:'Tom',
  age:18
})

cookieGet(cookieName) ⇒

获取cookie值；默认以json数组格式返回所有cookie；也可获取指定cookie值

Kind: global function
Returns: cookie值

Example

cookieGet()
// return {name:'tom',age:'18'}

Example

cookieGet('name')
// return 'tom'

isAndroid() ⇒

判断是否为安卓设备

Kind: global function
Returns: Boolean

isApple() ⇒

判断苹果移动设备

Kind: global function
Returns: Boolean

isMobile() ⇒

判断是否为移动端设备访问

Kind: global function
Returns: Boolean

isTest() ⇒

判断开发测试环境；（方便外网测试及输出）

Kind: global function
Returns: Boolean；当url参数中isTest为true或1时返回true；

isWeixin() ⇒

判断微信端

Kind: global function
Returns: Boolean

localStorageAdd(obj)

存储本地数据；（可存储多个数据，支持对象存储；）

Kind: global function

Example

let opt={
   uid:'01',
   userInfo:{ //以对象方式存储
      name:'Tom',
      age:18
   }
}
localStorageAdd(opt)

localStorageGet(dataName) ⇒

获取localStorage值；可以使用'.'多级链式查询,如：userInfo.name;

Kind: global function
Returns: 参数值/undefined

Example

let obj={
   uid:'001',
   userInfo:{
      name:'tom',
      age:'18',
   }
}

localStorageGet('uid')
//return 001

// 多级参数名链式查找
localStorageGet('userInfo.age')
//return 18

sessionStorageAdd(obj)

存储窗口数据；（可存储多个数据，支持对象存储；）

Kind: global function

Example

let opt={
   uid:'01',
   userInfo:{ //以对象方式存储
      name:'Tom',
      age:18
   }
}
sessionStorageAdd(opt)

sessionStorageGet(dataName) ⇒

获取sessionStorage值；可以使用'.'多级链式查询,如：userInfo.name;

Kind: global function
Returns: 查询参数值/undefined

Example

let obj={
   uid:'001',
   userInfo:{
      name:'tom',
      age:'18',
   }
}

sessionStorageGet('uid')
//return 001

// 多级参数名链式查找
sessionStorageGet('userInfo.age')
//return 18

strDelRight(string, number) ⇒

删除字符串右侧

Kind: global function
Returns: 新字符串

haveSpace(str) ⇒

判断字符串是否包含空格

Kind: global function
Returns: Boolean

haveCNChars(str) ⇒

判断字符串是否包含中文

Kind: global function
Returns: Boolean

strJoin(arr, string) ⇒

自定义连接符拼接字符串

Kind: global function
Returns: 返回拼接完成后的字符串

Example

strJoin(['a','b','c'],'-')
//return a-b-c

strTrim(str, type) ⇒

字符串空格处理

Kind: global function
Returns: 字符串

Example

let str=' 8 8 ';

strTrim(str);
//8 8清除了左右空格

strTrim(str,'all');
//88清除全部空格

strTrim(str,'left');
//8 8 清除左侧空格

strTrim(str,'right');
// 8 8清除了右侧空格

lengthRange(value, minLength, maxLength) ⇒

验证字符串长度范围

Kind: global function
Returns: Boolean

Example

let str='ab'
lengthRange(str,1,2)

letterBegin(value) ⇒

验证字符串是否以字母开头

Kind: global function
Returns: Boolean

pureNum(value) ⇒

验证字符串是否为纯数字

Kind: global function
Returns: Boolean

isMail(value) ⇒

验证大陆邮政编码

Kind: global function
Returns: Boolean

isIdCard(value) ⇒

验证二代身份证；共18位，最后一位可为x

Kind: global function
Returns: Boolean

isURL(value) ⇒

验证是否为网址

Kind: global function
Returns: Boolean

isQQ(value) ⇒

验证QQ号；非0开头的5~13位整数

Kind: global function
Returns: Boolean

isEmail(value) ⇒

验证电子邮箱

Kind: global function
Returns: Boolean

isPhone(value) ⇒

验证手机号

Kind: global function
Returns: Boolean

isTel(value) ⇒

验证电话号码

Kind: global function
Returns: Boolean

timeStamp(time, type, separator) ⇒

将时间戳转换成自定义格式

Kind: global function
Returns: -返回自定义日期

Example (年-月-日)

timeStamp(1618298335,'nyr','-')
//return 2020-01-02

Example (年、月、日、时、分、秒可任意组合)

timeStamp(1618298335,'nr','|')
//return 2020|02

totalPage(total, pageNum) ⇒

分页计算；通过数据总条数与每页显示数据数量计算出总页数；

Kind: global function
Returns: 返回计算出的总页数

urlParamAdd(datas, url) ⇒

url参数封装(可添加多个)；支持中文字符串传参，输出base-64编码字符串

Kind: global function
Returns: 返回参数组合，如：name='tom'&age=18

Example

urlParamAdd({
   name:'tom',
   age:18
})

//return bmFtZSUzRCVFNSVCQyVBMCVFNCVCOCU4OSUyNmFnZSUzRDIw

Example

* urlParamAdd({
   name:'tom',
   age:18
},'http://localhost:8080')

//return http://localhost:8080?bmFtZSUzRCVFNSVCQyVBMCVFNCVCOCU4OSUyNmFnZSUzRDIw

urlParamGet(paramName) ⇒

获取url中参数，可解码URI和base-64

Kind: global function
Returns: 默认返回所有url参数，指定获取参数后则返回指定参数

Example

url='http://localhost:8080/?name=tom&age=18';

urlParamGet()
// return {name:'tom',age:'18'}

urlParamGet('name')
// return 'tom'

工具目录

timeStamp,//时间戳格式转换

totalPage,//分页计算

isTest,//判断当前处于测试模式

isWeixin,//判断微信端

isMobile,//判断移动端

isApple,//判断苹果移动端

isAndroid,//判断安卓移动端

urlParamAdd,//url参数封装

urlParamGet,//获取url参数

cookieAdd,//新增cookie值

cookieGet,//获取cookie值

sessionStorageAdd,//存储sessionStorage值

sessionStorageGet,//获取sessionStorage值

localStorageAdd,//存储localStorage值

localStorageGet,//获取localStorage值

strJoin,//自定义连接符拼接字符串

strTrim,//清除字符串空格

strDelRight,//删除右侧字符串

lengthRange,//验证字符串长度是否在规定范围

letterBegin,//验证字符串是否以字母开头

pureNum,//验证字符串是否为纯数字

isMail,//验证大陆邮政编码

isIdCard,//验证二代身份证

isURL,//验证网址

isQQ,//验证QQ号

isEmail,//验证电子邮箱

isPhone,//验证手机号

haveSpace,//判断字符串是否包含空格

haveCNChars,//判断字符串是否包含中文

Functions

cookieAdd(datas)

新增cookie;支持以json字符串形式传入多个cookie值；

Kind: global function

Example

cookieAdd({
  name:'Tom',
  age:18
})

cookieGet(cookieName) ⇒

获取cookie值；默认以json数组格式返回所有cookie；也可获取指定cookie值

Kind: global function
Returns: cookie值

Example

cookieGet()
// return {name:'tom',age:'18'}

Example

cookieGet('name')
// return 'tom'

isAndroid() ⇒

判断是否为安卓设备

Kind: global function
Returns: Boolean

isApple() ⇒

判断苹果移动设备

Kind: global function
Returns: Boolean

isMobile() ⇒

判断是否为移动端设备访问

Kind: global function
Returns: Boolean

isTest() ⇒

判断开发测试环境；（方便外网测试及输出）

Kind: global function
Returns: Boolean；当url参数中isTest为true或1时返回true；

isWeixin() ⇒

判断微信端

Kind: global function
Returns: Boolean

localStorageAdd(obj)

存储本地数据；（可存储多个数据，支持对象存储；）

Kind: global function

Example

let opt={
   uid:'01',
   userInfo:{ //以对象方式存储
      name:'Tom',
      age:18
   }
}
localStorageAdd(opt)

localStorageGet(dataName) ⇒

获取localStorage值；可以使用'.'多级链式查询,如：userInfo.name;

Kind: global function
Returns: 参数值/undefined

Example

let obj={
   uid:'001',
   userInfo:{
      name:'tom',
      age:'18',
   }
}

localStorageGet('uid')
//return 001

// 多级参数名链式查找
localStorageGet('userInfo.age')
//return 18

sessionStorageAdd(obj)

存储窗口数据；（可存储多个数据，支持对象存储；）

Kind: global function

Example

let opt={
   uid:'01',
   userInfo:{ //以对象方式存储
      name:'Tom',
      age:18
   }
}
sessionStorageAdd(opt)

sessionStorageGet(dataName) ⇒

获取sessionStorage值；可以使用'.'多级链式查询,如：userInfo.name;

Kind: global function
Returns: 查询参数值/undefined

Example

let obj={
   uid:'001',
   userInfo:{
      name:'tom',
      age:'18',
   }
}

sessionStorageGet('uid')
//return 001

// 多级参数名链式查找
sessionStorageGet('userInfo.age')
//return 18

strDelRight(string, number) ⇒

删除字符串右侧

Kind: global function
Returns: 新字符串

haveSpace(str) ⇒

判断字符串是否包含空格

Kind: global function
Returns: Boolean

haveCNChars(str) ⇒

判断字符串是否包含中文

Kind: global function
Returns: Boolean

strJoin(arr, string) ⇒

自定义连接符拼接字符串

Kind: global function
Returns: 返回拼接完成后的字符串

Example

strJoin(['a','b','c'],'-')
//return a-b-c

strTrim(str, type) ⇒

字符串空格处理

Kind: global function
Returns: 字符串

Example

let str=' 8 8 ';

strTrim(str);
//8 8清除了左右空格

strTrim(str,'all');
//88清除全部空格

strTrim(str,'left');
//8 8 清除左侧空格

strTrim(str,'right');
// 8 8清除了右侧空格

lengthRange(value, minLength, maxLength) ⇒

验证字符串长度范围

Kind: global function
Returns: Boolean

Example

let str='ab'
lengthRange(str,1,2)

letterBegin(value) ⇒

验证字符串是否以字母开头

Kind: global function
Returns: Boolean

pureNum(value) ⇒

验证字符串是否为纯数字

Kind: global function
Returns: Boolean

isMail(value) ⇒

验证大陆邮政编码

Kind: global function
Returns: Boolean

isIdCard(value) ⇒

验证二代身份证；共18位，最后一位可为x

Kind: global function
Returns: Boolean

isURL(value) ⇒

验证是否为网址

Kind: global function
Returns: Boolean

isQQ(value) ⇒

验证QQ号；非0开头的5~13位整数

Kind: global function
Returns: Boolean

isEmail(value) ⇒

验证电子邮箱

Kind: global function
Returns: Boolean

isPhone(value) ⇒

验证手机号

Kind: global function
Returns: Boolean

isTel(value) ⇒

验证电话号码

Kind: global function
Returns: Boolean

timeStamp(time, type, separator) ⇒

将时间戳转换成自定义格式

Kind: global function
Returns: -返回自定义日期

Example (年-月-日)

timeStamp(1618298335,'nyr','-')
//return 2020-01-02

Example (年、月、日、时、分、秒可任意组合)

timeStamp(1618298335,'nr','|')
//return 2020|02

totalPage(total, pageNum) ⇒

分页计算；通过数据总条数与每页显示数据数量计算出总页数；

Kind: global function
Returns: 返回计算出的总页数

urlParamAdd(datas, url) ⇒

url参数封装(可添加多个)；支持中文字符串传参，输出base-64编码字符串

Kind: global function
Returns: 返回参数组合，如：name='tom'&age=18

Example

urlParamAdd({
   name:'tom',
   age:18
})

//return bmFtZSUzRCVFNSVCQyVBMCVFNCVCOCU4OSUyNmFnZSUzRDIw

Example

* urlParamAdd({
   name:'tom',
   age:18
},'http://localhost:8080')

//return http://localhost:8080?bmFtZSUzRCVFNSVCQyVBMCVFNCVCOCU4OSUyNmFnZSUzRDIw

urlParamGet(paramName) ⇒

获取url中参数，可解码URI和base-64

Kind: global function
Returns: 默认返回所有url参数，指定获取参数后则返回指定参数

Example

url='http://localhost:8080/?name=tom&age=18';

urlParamGet()
// return {name:'tom',age:'18'}

urlParamGet('name')
// return 'tom'