**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。|