# hjai-utils
> js工具库
Latest version **1.0.6** (published 2018-10-19) · ISC license · 0 weekly downloads
## Install
```sh
npm install hjai-utils
pnpm add hjai-utils
yarn add hjai-utils
bun add hjai-utils
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.0.6 |
| Published | 2018-10-19 |
| First published | 2018-05-02 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 43.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | hjai |
| Maintainers | haojun |
## Links
- npm: https://www.npmjs.com/package/hjai-utils
- npm.io page: https://npm.io/package/hjai-utils
## Recent versions
- 1.0.6 (latest) — 2018-10-19
- 1.0.5 — 2018-07-12
- 1.0.4 — 2018-07-12
- 1.0.3 — 2018-07-10
- 1.0.2 — 2018-05-27
- 1.0.1 — 2018-05-03
- 1.0.0 — 2018-05-02
## README
[](https://www.npmjs.com/package/hjai-utils)
[](https://travis-ci.org/hjaiim/utils)
[](https://www.npmjs.com/package/hjai-utils)
前端业务代码工具库
> 目的：高效率完成前端业务代码
## 安装使用
1. 直接下载`dist`目录下的[utils.min.js](https://github.com/hjaiim/utils/blob/master/dist/utils.min.js)使用，支持UMD通用模块规范
2. 使用npm安装
### 浏览器:
``` html
```
### npm:
``` bash
$ npm install --save hjai-utils
```
webpack、RequireJS、SeaJS等
``` javascript
// 完整引入
const utils = require('hjai-utils/dist/utils.min.js');
const OS = utils.getOS();
import * as utils from 'hjai-utils/dist/utils.min.js';
utils.getOS();
```
**推荐使用方法**
也可以不需要完整引入所有函数，所以只引入需要使用的方法即可。
``` javascript
// 只引入部分方法('hjai-utils/<方法名>')
const getOS = require('hjai-utils/getOS');
const OS = getOS();
import * as utils from 'hjai-utils/getOS';
utils.getOS();
```
## API文档
### Array
#### [arrayEqual][arrayEqual] 判断两个数组是否相等
[arrayEqual]:https://github.com/hjaiim/utils/blob/master/src/array/arrayEqual.js
### Device
#### [getExplore][getExplore] 获取浏览器类型和版本号
[getExplore]:https://github.com/hjaiim/utils/blob/master/src/device/getExplore.js
#### [getOS][getOS] 获取操作系统类型
[getOS]:https://github.com/hjaiim/utils/blob/master/src/device/getOS.js
### Random
#### [randomColor][randomColor] 随机生成颜色
#### [randomNum][randomNum] 生成指定范围随机数
[randomColor]:https://github.com/hjaiim/utils/blob/master/src/random/randomColor.js
[randomNum]:https://github.com/hjaiim/utils/blob/master/src/random/randomNum.js
### Regexp
#### [isEmail][isEmail] 判断是否为邮箱地址
#### [isIdCard][isIdCard] 判断是否为身份证号
#### [isPhoneNum][isPhoneNum] 判断是否为手机号
#### [isUrl][isUrl] 判断是否为URL地址
[isEmail]:https://github.com/hjaiim/utils/blob/master/src/regexp/isEmail.js
[isIdCard]:https://github.com/hjaiim/utils/blob/master/src/regexp/isIdCard.js
[isPhoneNum]:https://github.com/hjaiim/utils/blob/master/src/regexp/isPhoneNum.js
[isUrl]:https://github.com/hjaiim/utils/blob/master/src/regexp/isUrl.js
### Time
#### [getTimer][time] 获取当前已经运行了多少豪秒
#### [getNowStamp][time] 获取当前时间戳
#### [getFullDate][time] 根据时间戳获取完整日期 yy-mm-dd hh:mm:ss
#### [getFullDateArray][time] 根据时间戳获取日期的数组形式 [yy,mm,dd,hh,mm,ss]
#### [getTime][time] 根据时间戳获取时间的日期格式 hh:mm:ss
#### [getTimeArray][time] 根据时间戳，获取时间的数组形式[hh,mm,ss]
#### [getDate][time] 根据时间戳，获取日期的日期形式 yy-mm-dd
#### [getFullDate][time] 根据时间戳获取完整日期 yy-mm-dd hh:mm:ss
#### [getFullDateArray][time] 根据时间戳获取日期的数组形式 [yy,mm,dd,hh,mm,ss]
#### [getCountDown][time] 根据传入的时间（秒/时间戳10位/时间戳13位），返回倒计时的数组形式[dd,hh,mm,ss]
#### [getPastSecond][time] 获取指定时间戳距离0点已经过去了多少秒（不传，就是今天过去了多少秒）
#### [getTimeArray][time] 根据时间戳，获取时间的数组形式[hh,mm,ss]
#### [getDateArray][time] 根据时间戳，获取日期的数组形式 [yy,mm,dd]
#### [getWeek][time] 获取指定的week的日期数据
#### [getMonthByOffset][time] 获取指定的month的日期列表
#### [getWeekNum][time] 根据时间戳/日期，获取属于今年第几周（周一开始）
[time]:https://github.com/hjaiim/utils/blob/master/src/time/time.js
### Event
#### [addEventListenerOnce][event] 添加一次监听
#### [addEventListener][event] 添加监听
#### [removeEventListener][event] 移除监听
#### [dispatchEvent][event] 派发监听回调
#### [removeAllListener][event] 移除所有监听
[event]:https://github.com/hjaiim/utils/blob/master/src/event/event.js
### Data (默认为localStorage存储,传'ses'则为sessionStorage存储)
#### [setData][data] 存储数据到localStorage
#### [getData][data] 从localStorage取数据
#### [delData][data] 清除localStorage指定的键值对应的数据
#### [delAllData][data] 清空localStorage全部数据
[data]:https://github.com/hjaiim/utils/blob/master/src/data/data.js
### Merge
#### [merge][merge] 合并对象
[merge]:https://github.com/hjaiim/utils/blob/master/src/merge/merge.js
---
_Source: https://npm.io/package/hjai-utils · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._