npm package: @jk998/library
Description: 依赖 Vue 提供的插件注册功能，提供常用方法、指令、过滤器
Latest version: 0.1.34

# @jk998/library

依赖 Vue 提供的插件注册功能，提供常用方法、指令、过滤器

# 安装

```sh
yarn add @jk998/library
```

# 使用示例

```javascript
import { name, version } from './../../package.json'

// 全局注册
import Vue from 'vue'

import Peace from '@jk998/library'
Vue.use(Peace, {
  config: {
    appName: name,
    appVersion: version
  },
  // 如果需要自行拦截 http 请求
  http: {
    interceptors: {
      // 拦截 request
      // 参考 axios.interceptors.request.use([then], [catch])
      requestInterceptor: {
        then: function(request) {},
        catch: function(error) {}
      },
      // 拦截 response
      // 参考 axios.interceptors.response.use([then], [catch])
      responseInterceptor: {
        then: function(response) {},
        catch: function(error) {}
      }
    }
  }
})

// dayjs 进行日期操作
peace.dayjs(new Date()).format('YYYY-MM-DD')

// numeral 进行数字操作
peace.numeral(-1000).format('$0,0.00')

// cache 进行数据存储
peace.cache.sessionStorage.set('ID', 'UUID')
peace.cache.sessionStorage.get('ID')

// validate 进行数据验证
peace.validate.isUrl('https://github.com/iamkun/dayjs')

// util 常用方法
peace.util.isType('字符串').isObject
peace.util.encode('字符串')
```

# API 参考

- util

  - peace.util.platform

  - peace.util.sign

  - peace.util.isType

  - peace.util.queryUrlParam

  - peace.util.arrayToTree

  - peace.util.deepClone

  - peace.util.merge

  - peace.util.encode

  - peace.util.decode

  - peace.util.alert

    `peace.util.alert 依赖 Element-UI 外部库，未引用将使用 window.alert 代替`

  - peace.util.warning

    `peace.util.warning 依赖 Element-UI 外部库，未引用将使用 window.alert 代替`

  - peace.util.success

    `peace.util.success 依赖 Element-UI 外部库，未引用将使用 window.alert 代替`

  - peace.util.error

    `peace.util.error 依赖 Element-UI 外部库，未引用将使用 window.alert 代替`

  - peace.util.formatDate

  - peace.util.formatTime

- validate

  - peace.validate.pattern.username

  - peace.validate.pattern.password

  - peace.validate.pattern.url

  - peace.validate.pattern.number

  - peace.validate.pattern.numerical

  - peace.validate.pattern.pNumerical

  - peace.validate.pattern.interger

  - peace.validate.pattern.pInterger

  - peace.validate.pattern.nInterger

  - peace.validate.pattern.mobile

  - peace.validate.pattern.telephone

  - peace.validate.pattern.idCard

  - peace.validate.pattern.email

  - peace.validate.pattern.percente

  - peace.validate.isEmpty

  - peace.validate.isUrl

  - peace.validate.isNumber

  - peace.validate.isNumerical

  - peace.validate.isPNumerical

  - peace.validate.isInterger

  - peace.validate.isPInterger

  - peace.validate.isNInterger

  - peace.validate.isMobile

  - peace.validate.isEmail

  - peace.validate.isTelephone

  - peace.validate.isIDCard

  - peace.validate.isRange

- cache

  - peace.cache.sessionStorage.get

  - peace.cache.sessionStorage.set

  - peace.cache.sessionStorage.remove

  - peace.cache.sessionStorage.clear

  - peace.cache.localStorage.get

  - peace.cache.localStorage.set

  - peace.cache.localStorage.remove

  - peace.cache.localStorage.clear

  - peace.cache.memoryStorage.get

  - peace.cache.memoryStorage.set

  - peace.cache.memoryStorage.remove

  - peace.cache.memoryStorage.clear

  - peace.cache.cookie.get

  - peace.cache.cookie.set

  - peace.cache.cookie.has

  - peace.cache.cookie.remove

  - peace.cache.cookie.clear

- dayjs

  - [参考](https://github.com/iamkun/dayjs)

- numeral

  - [参考](https://github.com/adamwdraper/Numeral-js)

# 更新记录

## [0.1.34] - 2021-06-07

- 🔥 更严谨的手机号码验证

## [0.1.33] - 2021-05-25

- 🔥 支持自行处理 http 请求

e.g. http.get('url', { `isInterceptor`: false, params: { param: '' } }).then().catch()
e.g. http.post('url', { param: '' }, { `isInterceptor`: false }).then().catch()

- 🔥 支持返回结构 msg 和 message

## [0.1.32] - 2021-04-07

- 🐛 修改 filterDictionaryFuzzy 错误

## [0.1.31] - 2021-03-04

- 🐛 修改验证类 isPInterger 错误

## [0.1.30] - 2021-03-04

### Added

- 🔥 1，filter 新增
  filterDictionaryFuzzy、
  filterLabel、
  filterLabelFuzzy、
  filterValue、
  filterValueFuzzy

- 🔥 2，dictionary 新增
  formatLabelFuzzy、
  formatValueFuzzy

## [0.1.29] - 2021-02-25

### Added

- 🔥 新增 Peace.util.isNull、Peace.util.isArray、Peace.util.isSymbol、Peace.util.isObject、Peace.util.isNumber、Peace.util.isString、Peace.util.isBoolean、Peace.util.isFunction、Peace.util.isUndefined 方法

## [0.1.28] - 2021-02-23

### Added

- 🔥 新增 Peace.util.deepCompare 方法

## [0.1.27] - 2021-02-04

### Changed

- 🔥 修改 Peace.cache.sessionStorage.clear 、Peace.cache.localStorage.clear 方法必须符合签名要求

## [0.1.26] - 2021-01-27

### Added

- 🔥 新增 Peace.util.formatLabel、 Peace.util.formatValue

### Changed

- 🔥 更新 docs-src
- 🔥 修改 Peace.validate.idCard 支持 15、18 位身份证

## [0.1.25] - 2021-01-21

### Changed

- 🐛 修改 强制输入指令 v-force 中文输入法不生效的问题

## [0.1.24] - 2021-01-20

### Changed

- 🔥 新增 强制输入指令 v-force
  - 目前支持 正整数(pInterger) | 负整数(nInterger)， v-force="'pInterger'" | v-force="'nInterger'"
  - <input type="number" v-force="'nInterger'">

## [0.1.23] - 2021-01-12

### Changed

- 🐛 peace.validate.pattern.mobile 修改位仅验证首位为 1

## [0.1.22] - 2021-01-12

### Changed

- 🐛 支持 peace.validate.pattern.mobilephone 、peace.validate.pattern.phone

## [0.1.21] - 2020-11-20

### Changed

- 🐛 peace.util.merge 增加传参校验

## [0.1.20] - 2020-11-09

### Added

- 🔥 增加 peace.util.merge

## [0.1.19] - 2020-11-04

### Changed

- 🐛 修改 filterDictionary 函数入参为空、或者不匹配时引起的 bug

## [0.1.18] - 2020-11-03

### Changed

- 🐛 移除 401，403 的错误引导，由 websocket 处理，如有特殊需求，可使用 interceptors 自行拦截

## [0.1.17] - 2020-10-15

### Changed

- 🐛 修改 peace.\$router 在初始化之前访问失败问题

## [0.1.16] - 2020-10-14

### Changed

- 🐛 修改 qs 打包

## [0.1.15] - 2020-10-14

### Changed

- 🐛 支持 peace.http.download

## [0.1.14] - 2020-10-13

### Chnaged

- 🐛 新增 peace.\$router 在初始化之前访问失败问题

## [0.1.13] - 2020-10-12

### Added

- 🔥 增加 peace.cache.memoryStorage

## [0.1.12] - 2020-09-28

### Changed

- 🔥 增加 http 请求成功返回

## [0.1.11] - 2020-09-28

### Changed

- 🔥 完善说明文档

## [0.1.10] - 2020-09-27

### Added

- 🔥 新增必选配置：appName、appVersion

- 🔥 新增 peace.util.sign

## [0.1.9] - 2020-09-25

### Added

- 🐛 新增 filter
  - filterNumeral 数字过滤器
  - filterDictionary 字典过滤器
  - filterCurrency 货币过滤器

## [0.1.8] - 2020-09-24

### Changed

- 🐛 修正更新记录

## [0.1.7] - 2020-09-24

### Changed

- 🐛 统一 http 错误处理

## [0.1.6] - 2020-09-24

### Changed

- 🐛 修改 peace.http.download 支持 post 方法

- 🐛 修改 http status 401、http response data 401/403 鉴权失败，跳转 '/401'

## [0.1.5] - 2020-09-21

### Changed

- 🐛 修改 entry

## [0.1.4] - 2020-09-21

### Changed

- 🔥 修改 rollup config

- 🔥 修改 demo 验证形式

### Removed

- 🐛 移除 optional chaining

- 🐛 移除 peace.util.sign

## [0.1.3] - 2020-09-18

### Removed

- 🐛 移除 peace.util.platform 的 ssr 依赖

## [0.1.2] - 2020-09-18

### Added

- 🐛 提交编译结果

## [0.1.1] - 2020-09-18

### Removed

- 🐛 移除 optional chaining 导致的编译错误

## [0.1.0] - 2020-09-18

### Added

- 🔥 发布首个公开版本