# JavaScript-Utils

**Repository Path**: xinyu185/utils

## Basic Information

- **Project Name**: JavaScript-Utils
- **Description**: JavaScript常用方法，开箱即用的JavaScript工具包。
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2022-04-14
- **Last Updated**: 2022-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JavaScript常用方法Utils

## 开发指南

1. utils
2. 一个接口一个类
3. 写好注释
4. 经常用的方法写进去，深刻理解OOP，让用户直接调用这个方法就可以得到想要的玩意
5. 每次更新，务必在readme里写好，`时间`、`日期`、`作者`以及这次更新了哪些类的哪些方法（把接口的抽象方法copy一下就行啦，大家应该都看得懂），git推上来备注可以写个大概就行
6. 接口和实现类命名规范：比如`RandomUtils`就是可以调用一切随机方法的类，对应接口就是`InterRandomUtils`在前面加个`Inter`
6. 新增里，只会增加每一次新增的方法
7. 没啥说的了:joy:

## 新增

### 2022/04/14/13:25:00

```typescript
/**
 * date: 2022/04/14/13:25:00
 * author: xinyu
 **/
//RandomUtils类
round(x:number|number[]):number|number[];//四舍五入
ceil(x:number):number|number[];//对数进行上舍入，即向上取整。
floor(x:number):number|number[];//对数进行下舍入，即向下取整。
RandomFullClose(x:number,y:number):number;//取得[n,m]范围随机数
RandomFullCloseRound(x:number,y:number):number;//取得[n,m]范围随机数-整数
RandomLeftOpen(x:number,y:number):number;//取得(n,m]范围随机数
RandomLeftOpenRound(x:number,y:number):number;//取得(n,m]范围随机数-整数
RandomFullOpen(x:number,y:number):number;//取得(n,m)范围随机数
RandomFullOpenRound(x:number,y:number):number;//取得(n,m)范围随机数-整数
RandomColorRgb():string;// 获取随机颜色（不支持IE678） rgba是IE9+才支持的
RandomColor16():string;//获取随机颜色16进制（支持任意浏览器）
RandomCode(length:number):string;//随机验证码
RandomName():string;//随机生成人名
RandomNickName():string;//随机NickName
//静态方法
 random():number //随机数

//ArrayUtils类
 StringToNum(arr:string[]):number[];//把数组里的字符串全部转换成number返回一个全是number的数组
```

### 2022/04/14/22:46:00

```typescript
/**
 * date: 2022/04/14/22:46:00
 * author: xinyu
 **/
//ArrayUtils类
SortCompareUp(arr: number[]): number[];//数组升序排列,返回一个已经升序排列的数组
SortCompareDown(arr:number[]):number[];//数组降序排列，返回一个已经降序排列的数组
//BaseUtils类
Compare(v1: number, v2: number): number; //比较函数，大于返回1，小于返回-1，等于返回0

```

### 2022/04/15/19:15:00

1. 使用`rollup`打包工具
2. 把`utils.ts`文件拆分为几个模块（src目录）
3. 入口文件为`main.js`
4. 使用`yarn`包管理工具

> 为什么不适用webpack打包呢？
>
> 我和狗子，从早上折腾到晚上，webpack打包成功了，但是用不了，因为我们的模块全是用的`ts`，用`ts`进行模块化开发比`JavaScript`强太多了，后期也好维护:joy:
>
> 但是我相信`webpack`是可以打包成功，并且成一个js文件后使用能成功的，因为`Vue`就是用的`webpack`打包，只能说我和狗子太`菜`了🏳️
>
> 使用一款专门用于插件开发的打包工具[rollup](https://rollupjs.org/guide/en/) 

### 项目目录结构

`utils`

├─index.html        ->测试文件
├─LICENSE           ->开源证书
├─package.json 
├─README.md
├─rollup.config.js  ->rollup打包配置，类似webpack
├─tsconfig.json     ->ts文件编译配置
├─yarn.lock
├─dist              ->打包输出路径                           
└─src  
    │ main.js       ->项目入口文件 
    │  
    └─module        ->模块目录


#### install

```shell
yarn install && npm install
```
#### build
```shell
// 生产环境，压缩体积
yarn run build && npm run build
```
#### dev
```shell
//开发环境，热更新
yarn run dev && npm run dev
```
### 注意事项

1. 打包前请把每一个模块编译后的js文件删掉，否则打包会起冲突导致失败！