1.0.2 • Published 2 years ago

zhao-tools v1.0.2

Weekly downloads
-
License
ISC
Repository
-
Last release
2 years ago

Classes

使用实例

const ztools = require('zhao-tools');
## 网络相关
// JSONP文本转JSON
ztools.z_request.jsonptojson()
## url路径相关
// 解析路径得到内容
ztools.z_url.parseUrl()
## 时间相关 
//将时间戳格式化为各种时间格式,
ztoolss.z_time.formatTimestamp()
## js相关
ztoolss.z_js.getType()
## 字符串相关
ztoolss.z_str.truncateString()//返回一个截断到指定长度的字符串,
..............replaceAll()//ES2020的replaceAll进行ES5重写
.............getAllTextBetween()//指定开始值和结束值之间的所有字符串

更多

ztools

class工具类

Kind: global class

ztools.z_request

网络请求相关

Kind: instance property of ztools

ztools.z_url

处理网址相关

Kind: instance property of ztools

ztools.z_time

处理时间格式化相关

Kind: instance property of ztools

ztools.z_js

js相关

Kind: instance property of ztools

ztools.z_str

字符串相关

Kind: instance property of ztools

ztools.z_html

html相关

Kind: instance property of ztools

ztools.z_regex

正则表达式相关

Kind: instance property of ztools

jsonptojson(jsonpStr) ⇒ object

jsonp文本 转 json对象

Kind: global function 注意,此函数只适用于标准的 JSONP 格式,即 callbackName(jsonData) 形式的字符串。如果你需要处理其他格式的跨域请求响应,请自行修改代码。 法的 JSONP 格式,则函数会返回 null。

ParamTypeDescription
jsonpStrstringjsonp格式字符串

parseUrl(url) ⇒ object

解析 URL,返回包含其参数键值对的对象,以及路径、查询参数、主机名

Kind: global function Returns: object - - 包含路径、查询参数、主机名和参数键值对的对象

ParamTypeDescription
urlstring要解析的 URL

formatTimestamp(timestamp) ⇒ object

将时间戳格式化为各种时间格式,并计算出距离当前时间的时间差,并以键值对形式返回

Kind: global function Returns: object - - 包含各种时间格式和发布时间的键值对

ParamTypeDescription
timestampnumber要格式化的时间戳(Unix 时间戳,单位为毫秒)

getType(variable) ⇒ string

判断变量的类型,并返回类型字符串

Kind: global function Returns: string - - 变量的类型字符串

ParamTypeDescription
variable*要检查类型的变量

truncateString(str, maxLength) ⇒ string

返回一个截断到指定长度的字符串,如果字符串长度超过指定长度,则添加省略号。

Kind: global function Returns: string - - 截断后的字符串。 Throws:

  • TypeError 如果输入的参数不是字符串或数字类型,则抛出异常。
ParamTypeDescription
strstring要截断的字符串。
maxLengthnumber最大允许的字符串长度。

replaceAll(str, find, replace) ⇒ string

将源字符串中的所有出现的子字符串替换为指定的目标字符串。

Kind: global function Returns: string - - 一个新字符串,其中所有匹配项都被替换为目标字符串。 Throws:

  • TypeError 如果任何一个参数不是字符串类型,则抛出异常。
  • Error 如果查找字符串为空,则抛出异常。
ParamTypeDescription
strstring要进行替换操作的源字符串。
findstring要查找和替换的子字符串。
replacestring用于替换每个匹配项的目标字符串。

getAllTextBetween(text, start, end) ⇒ array

获取文本中指定开始值和结束值之间的所有子字符串(全局匹配)

Kind: global function Returns: array - - 匹配到的所有子字符串组成的数组,如果未找到任何匹配项,则返回空数组。

ParamTypeDescription
textstring要搜索的文本
startstring搜索范围的开始值
endstring搜索范围的结束值

getTagAttrValues(html, tag, attr, limit) ⇒ array | object

在给定的 HTML 片段中,查找前 n 个指定标签的指定属性的值

Kind: global function Returns: array | object - - 如果未指定属性名称,则返回包含每个匹配项的所有属性的对象。否则,返回包含匹配项的属性值组成的数组。

ParamTypeDescription
htmlstring要搜索的 HTML 片段
tagstring要搜索的 HTML 标签名称
attrstring要搜索的 HTML 属性名称(可选)
limitnumber要返回的值的数量(可选)

validate(optionsObject) ⇒ Object

验证给定的对象是否符合指定的格式要求

Kind: global function Returns: Object - 包含每个属性是否符合对应格式要求的结果的对象 Throws:

  • TypeError 如果参数不是一个对象类型,则抛出一个类型错误
ParamTypeDescription
optionsObjectObject包含需要验证的属性和值的对象