zhao-tools

Classes

使用实例

``js
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工具类

Functions

jsonptojson(jsonpStr) ⇒ object

jsonp文本 转 json对象

parseUrl(url) ⇒ object

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

formatTimestamp(timestamp) ⇒ object

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

getType(variable) ⇒ string

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

truncateString(str, maxLength) ⇒ string

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

replaceAll(str, find, replace) ⇒ string

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

getAllTextBetween(text, start, end) ⇒ array

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

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

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

validate(optionsObject) ⇒ Object

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

ztools

class工具类

Kind: global class

* ztools
* .z_request
* .z_url
* .z_time
* .z_js
* .z_str
* .z_html
* .z_regex

$3

网络请求相关

Kind: instance property of ztools

$3

处理网址相关

Kind: instance property of ztools

$3

处理时间格式化相关

Kind: instance property of ztools

$3

js相关

Kind: instance property of ztools

$3

字符串相关

Kind: instance property of ztools

$3

html相关

Kind: instance property of ztools

$3

正则表达式相关

Kind: instance property of ztools

jsonptojson(jsonpStr) ⇒ object

jsonp文本 转 json对象

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

| Param | Type | Description |
| --- | --- | --- |
| jsonpStr | string | jsonp格式字符串 |

parseUrl(url) ⇒ object

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

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

| Param | Type | Description |
| --- | --- | --- |
| url | string | 要解析的 URL |

formatTimestamp(timestamp) ⇒ object

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

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

| Param | Type | Description |
| --- | --- | --- |
| timestamp | number | 要格式化的时间戳（Unix 时间戳，单位为毫秒） |

getType(variable) ⇒ string

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

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

| Param | Type | Description |
| --- | --- | --- |
| variable | \* | 要检查类型的变量 |

truncateString(str, maxLength) ⇒ string

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

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

- TypeError 如果输入的参数不是字符串或数字类型，则抛出异常。


| Param | Type | Description |
| --- | --- | --- |
| str | string | 要截断的字符串。 |
| maxLength | number | 最大允许的字符串长度。 |

replaceAll(str, find, replace) ⇒ string

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

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

- TypeError 如果任何一个参数不是字符串类型，则抛出异常。
- Error 如果查找字符串为空，则抛出异常。


| Param | Type | Description |
| --- | --- | --- |
| str | string | 要进行替换操作的源字符串。 |
| find | string | 要查找和替换的子字符串。 |
| replace | string | 用于替换每个匹配项的目标字符串。 |

getAllTextBetween(text, start, end) ⇒ array

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

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

| Param | Type | Description |
| --- | --- | --- |
| text | string | 要搜索的文本 |
| start | string | 搜索范围的开始值 |
| end | string | 搜索范围的结束值 |

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

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

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

| Param | Type | Description |
| --- | --- | --- |
| html | string | 要搜索的 HTML 片段 |
| tag | string | 要搜索的 HTML 标签名称 |
| [attr] | string | 要搜索的 HTML 属性名称（可选） |
| [limit] | number | 要返回的值的数量（可选） |

validate(optionsObject) ⇒ Object

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

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

- TypeError 如果参数不是一个对象类型，则抛出一个类型错误


| Param | Type | Description |
| --- | --- | --- |
| optionsObject | Object | 包含需要验证的属性和值的对象 |