# jwg-toolkit-js 工具包使用说明书

### 引入工具包

```js
import jwg from "jwg-toolkit-js";
```

## 方法介绍

#### deepCopy: 深拷贝函数 (jwg.deepCopy)

```js
/* 该方法返回一个与之前值一样但引用地址不同的值, 主要用于引用类型 */
/* obj: 需要拷贝的值 */
const res = jwg.deepCopy(obj);
```

#### isSame: 判断两个值是否完全一样(jwg.isSame)

```js
/* 注意: 目前对于引用类型, 只判断 Object 和 Array 两种类型 */
/* 该方法返回一个布尔类型的值, 表示是否完全一样 */
/* obj1和obj2是需要比较的两个值 */
const res = jwg.isSame(obj1, obj2);
```

#### chooseFile: 文件选择(jwg.file.chooseFile)

    chooseFile为通用文件选择方法，与此类似的方法还有
    1.chooseImage: 选择图片
    2.chooseExcel: 选择Excel表格
    3.chooseDocument: 选择常用文档类型
    4.chooseWord: 选择word文档
    5.chooseText: 选择txt文档
    6.chooseTextWord: 选择txt文档word文档
    7.choosePDF: 选择pdf文档
    8.choosePPT: 选择演示ppt文档
    9.chooseArchive: 选择压缩包
    这些选择特定类型文件的方法，不用指定文件类型(参数options.type)

```js
/** 参数options对象
 * @options
 * multiple: 是否多选 默认false
 * size: 最大size 默认5M
 * type: 文件类型 同input type="file"时的属性accept
 */
const options = {
	multiple: true,
};
const res = await jwg.file.chooseFile(options);
```

#### getDate: 获取日期-年月日(jwg.file.getDate)

    与此相似还有以下方法:
    1.geMonth: 获取年月
    2.getYear: 获取年(参数flag无效)
    3.getDateRange: 获取timestamp月份的第一天和最后一天 返回[startDate, endDate]

```js
/* timestamp: 时间戳 || yyyy-MM-dd 默认为当前时间戳 */
/* flag: 间隔符 默认为：“-” */
const res = jwg.file.getDate(timestamp, flag);
```