**jboot-env对外暴露了Utils工具类,内部包含method章节中介绍的与实例无关的方法,用于在某些情况下不存在vue实例时使用,使用方式如下:**
<br/>
```
import {Utils} from 'jboot-env';
Utils.copy('1111'); //复制内容至剪切板
//值为空时则返回默认值
//const a = undefined;
const val = Utils.blank2Default(a, 'c'); //此时输入val的值为'c';
//其他方法,参照method章节中,与vue实例无关的方法。
```
> **注意:blank2Default方法,在3.1.3665版本以前(含该版本)名称为useIfDefault,之后的版本更名为blank2Default。**
|名称|参数|返回值|描述|
|---|---|---|---|
|previewImg(urlList, currentIndex)|urlList: 图片链接数组。currentIndex:当前预览第几个图片,默认为0,第一个。|无| **3.1.3728起新增!!!** 用于进行图片预览。|
|deepGet(target, key, defaultValue)|target:任意类型,代表取值的目标对象。key:string或string数组,支持传入 'name'或'china.people.name'或['china', 'people', 'name']。代表要获取哪个属性。defaultValue:未获取到值时的默认值。|返货获取到的值。| **3.1.3720起新增!!!** 用于获取嵌套对象中的某个属性值。|
|required(message)|message:异常抛出的文字提示。|无| **3.1.3699起新增!!!** 用于校验某些方法入参不能为空。例如 function test(id = Utils.required()){console.log(id);},此时入参id为空时,则触发校验并抛出异常。|
|file2Base64(file)|file:要被转换的文件。|Promise对象| **3.1.3694起新增!!!** 用于将文件转换为base64字符串|
|checkDomOverflow(dom, offset, parentWidth)|dom:要被检测的dom元素。offset:被检测dom节点需要抵消的偏移量 正数则dom节点加上偏移量 负数则代表dom节点减去偏移量。parentWidth:选填 可传入父元素可视区域,用于可视区域大小与父元素真实大小不一致的情况。|{overflow: 溢出时该值为true,反之为false, placement:'left' 或 'right' 或 undefined 溢出时为溢出方位,未溢出时为undefined}| **3.1.3685起新增!!!** 检测dom是否溢出父元素之外。|
|copy(str)|str:string类型,要复制的字符内容。|无|用于将字符添加到剪切板中|
|generateUUID(length)|length:number类型,要生成多少位的uuid,默认16位。|生成的uuid。|用于生成指定长度的uuid。|
|blank2Default(val, defaultVal)|val: any类型,defaultVal:any类型,默认值。|返回val或defaultVal。|用于处理数据为空的情况,如果val不为空,则返回val。如果val为空,则返回defaultVal。|
|getFileNameByPath(path, suffix)|path:string类型,代表文件路径。suffix:路径后缀,默认为'js'。|返回获取到的文件名。|用于结合require.context() API使用,可获取到路径中的文件名。|
|assert(condition, errorMessage)|condition:boolean类型,通常为一个表达式。errorMessage:string类型,condition不成立时抛出的异常信息,默认为'运行时异常'。|无|用于条件不成立时,终止程序执行且抛出异常,抛出的异常会打印在控制台。|
|text2Chars(text)|text:string类型,将要转换的字符串。|返回字符串的char数组。|用于将字符串转换为char数组。|
|byteHex(target)|target:number类型,将要转换的数字。|返回该数字的16进制。|用于将数字转换为16进制。|
|convertBoolean2Promise(result)|result:boolean类型或Promise类型。|返回一个Promise对象。|用于不同返回值方法,统一返回Promise对象使用。|
|convertHump2Link(text)|text:string类型,要转换的字符串。|返回转换完毕后的字符串。|用于将驼峰字符串转换为连字符格式,例如:contentWrap 转换为 content-wrap。|
|convertLink2Hump(text)|text:string类型,要转换的字符串。|返回转换完毕后的字符串。|用于将连字符格式转换为驼峰字符串,例如:content-wrap 转换为 contentWrap。|