mazey 3.1.0 → 3.3.0

package/src/index.ts

@@ -5,9 +5,9 @@
  * @description Computes the longest common substring of two strings.
  * @param {string} aStr String
  * @param {string} bStr String
- * @return {number} Length
+ * @returns {number} Length
  */
-export function calLongestCommonSubstring(aStr = '', bStr = ''): number {
+export function calLongestCommonSubstring(aStr: string, bStr: string): number {
   const aLen = aStr.length;
   const bLen = bStr.length;
   // 创建二维数组并且深拷贝
@@ -35,9 +35,9 @@ export function calLongestCommonSubstring(aStr = '', bStr = ''): number {
  * @description 计算两个字符串的最长公共子序列
  * @param {string} aStr 字符串
  * @param {string} bStr 字符串
- * @return {number} 长度
+ * @returns {number} 长度
  */
-export function calLongestCommonSubsequence(aStr = '', bStr = ''): number {
+export function calLongestCommonSubsequence(aStr: string, bStr: string): number {
   const aLen = aStr.length;
   const bLen = bStr.length;
   // 创建二维数组并且深拷贝
@@ -73,13 +73,14 @@ export function calLongestCommonSubsequence(aStr = '', bStr = ''): number {
  * @method getQueryParam
  * @description Get the query param's value of the current Web URL(`location.search`).
  * @param {string} param Query param.
- * @return {string} value
- * */
-export function getQueryParam(param = ''): string {
+ * @returns {string} value
+ */
+export function getQueryParam(param: string): string {
   const reg = new RegExp('(^|&)' + param + '=([^&]*)(&|$)');
   const r = location.search.substr(1).match(reg);
   if (r !== null) {
-    return decodeURIComponent(unescape(r[2]));
+    // return decodeURIComponent(unescape(r[2]));
+    return decodeURIComponent(r[2]);
   }
   return '';
 }
@@ -89,10 +90,12 @@ export function getQueryParam(param = ''): string {
  * @description Get the query param's value of the input URL.
  * @param {string} url URL string.
  * @param {string} param Query param.
- * @return {string} value
- * */
-export function getUrlParam(url = '', param = ''): string {
-  const result: any = {};
+ * @returns {string} value
+ */
+export function getUrlParam(url: string, param: string): string | string[] {
+  const result: {
+    [key: string]: string | string[] | any;
+  } = {};
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace
   url.replace(/\??(\w+)=([^&]*)&?/g, function (a, k, v): any {
     if (result[k] !== undefined) {
@@ -116,9 +119,9 @@ export function getUrlParam(url = '', param = ''): string {
  * @param {string} url URL string.
  * @param {string} param Query param.
  * @param {string} value Param's value.
- * @return {string} URL.
- * */
- export function updateQueryParam(url = '', param = '', value = ''): string {
+ * @returns {string} URL.
+ */
+ export function updateQueryParam(url: string, param: string, value: string): string {
   const re = new RegExp('([?&])' + param + '=.*?(&|$)', 'i');
   const separator = url.indexOf('?') !== -1 ? '&' : '?';
   if (url.match(re)) {
@@ -132,9 +135,9 @@ export function getUrlParam(url = '', param = ''): string {
  * @method getHashQueryParam
  * @description Get the hash query param's value of the current Web URL(`location.hash`).
  * @param {string} param Query param.
- * @return {string} value
+ * @returns {string} value
  */
-export function getHashQueryParam(param = ''): string {
+export function getHashQueryParam(param: string): string {
   const hashs = location.hash.split('?');
   if (hashs.length === 1) {
     return '';
@@ -149,8 +152,8 @@ export function getHashQueryParam(param = ''): string {
  * @description Get the domain of URL, and other params.
  * @param {string} url
  * @param {array} rules Object.keys(location), ['href', 'protocol', 'host', 'hostname', 'port', 'pathname', 'search', 'hash'], ['hostname', 'pathname'] = 'km.mazey.net/plugins/servlet/mobile'
- * */
-export function getDomain(url = '', rules = ['hostname']): string {
+ */
+export function getDomain(url: string, rules = ['hostname']): string {
   const aEl: any = document.createElement('a');
   aEl.href = url;
   return rules.reduce((ret, v) => {
@@ -163,9 +166,9 @@ export function getDomain(url = '', rules = ['hostname']): string {
  * @method camelCaseToKebabCase
  * @description Transfer CamelCase to KebabCase.
  * @param {string} camelCase 'aBC' or 'ABC'
- * @return {string} 'a-b-c'
- * */
-export function camelCaseToKebabCase(camelCase = ''): string {
+ * @returns {string} 'a-b-c'
+ */
+export function camelCaseToKebabCase(camelCase: string): string {
   const kebabCase = camelCase.replace(/([A-Z])/g, '-$1').toLowerCase();
   return kebabCase[0] === '-' ? kebabCase.substr(1) : kebabCase;
 }
@@ -174,9 +177,9 @@ export function camelCaseToKebabCase(camelCase = ''): string {
  * @method camelCase2Underscore
  * @description Transfer CamelCase to Underscore.
  * @param {string} camelCase 'aBC' or 'ABC'
- * @return {string} 'a_b_c'
- * */
-export function camelCase2Underscore(camelCase = ''): string {
+ * @returns {string} 'a_b_c'
+ */
+export function camelCase2Underscore(camelCase: string): string {
   const kebabCase = camelCase.replace(/([A-Z])/g, '_$1').toLowerCase();
   return kebabCase[0] === '_' ? kebabCase.substr(1) : kebabCase;
 }
@@ -185,9 +188,9 @@ export function camelCase2Underscore(camelCase = ''): string {
  * @method mTrim
  * @description Remove leading and trailing whitespace or specified characters from string.
  * @param {string} str The string to trim.
- * @return {string} Trimmed string.
- * */
-export function mTrim(str = ''): string {
+ * @returns {string} Trimmed string.
+ */
+export function mTrim(str: string): string {
   str = str.replace(/^\s+/, ''); // 去除头部空格
   let end = str.length - 1;
   const ws = /\s/;
@@ -201,9 +204,9 @@ export function mTrim(str = ''): string {
  * @method newLine
  * @description Make a newline of HTML.
  * @param {string} str The string to make a newline.
- * @return {string} A newline with `br`.
- * */
-export function newLine(str = ''): string {
+ * @returns {string} A newline with `br`.
+ */
+export function newLine(str: string): string {
   if (!str) {
     return '';
   }
@@ -215,8 +218,8 @@ export function newLine(str = ''): string {
  * @method deepCopyObject
  * @description Clone Object deeply.
  * @param {object} obj The value to clone.
- * @return {object} Returns the deep cloned value.
- * */
+ * @returns {object} Returns the deep cloned value.
+ */
 export function deepCopyObject(obj: any): any {
   return JSON.parse(JSON.stringify(obj));
 }
@@ -225,9 +228,9 @@ export function deepCopyObject(obj: any): any {
  * @method isJsonString
  * @description Check whether it is a valid JSON string.
  * @param {string} str The string to check.
- * @return {boolean} Return the result of checking.
- * */
-export function isJsonString(str = ''): boolean {
+ * @returns {boolean} Return the result of checking.
+ */
+export function isJsonString(str: string): boolean {
   try {
     if (typeof JSON.parse(str) === 'object') {
       return true;
@@ -242,8 +245,8 @@ export function isJsonString(str = ''): boolean {
  * @method generateRndNum
  * @description Produce a random string of number, `generateRndNum(7)` => '7658495'.
  * @param {number} n Length
- * @return {string} Return the random string.
- * */
+ * @returns {string} Return the random string.
+ */
 export function generateRndNum(n = 5): string {
   let ret = '';
   while (n--) {
@@ -256,7 +259,7 @@ export function generateRndNum(n = 5): string {
  * @method generateUniqueNum
  * @description 根据时间生成唯一标志的数字 mGenerateUniqueNum() => 1538324722364123。
  * @param {number} n 随机数的长度
- * */
+ */
 export function generateUniqueNum(n = 3): string {
   const [now, rnd] = [mNow(), generateRndNum(n || 3)];
   return now + rnd;
@@ -267,8 +270,8 @@ export function generateUniqueNum(n = 3): string {
  * @description 浮点数转为百分比 0.2 => 20%。
  * @param {number} num 浮点数
  * @param {number} fixSize 保留几位浮点数
- * */
-export function floatToPercent(num = 0, fixSize = 0): string {
+ */
+export function floatToPercent(num: number, fixSize = 0): string {
   let ret = '';
   if (fixSize) {
     ret = (num * 100).toFixed(fixSize);
@@ -281,7 +284,7 @@ export function floatToPercent(num = 0, fixSize = 0): string {
 /**
  * @method floatFixed
  * @description 浮点数保留指定位。
- * */
+ */
 export function floatFixed(num: string, size = 0): string {
   return parseFloat(num).toFixed(size);
 }
@@ -289,7 +292,7 @@ export function floatFixed(num: string, size = 0): string {
 /**
  * @method cancelBubble
  * @description 阻止冒泡。
- * */
+ */
 export function cancelBubble(e: any): void {
   const ev = e || window.event;
   if (ev.stopPropagation) {
@@ -303,7 +306,7 @@ export function cancelBubble(e: any): void {
 
 /**
  * @method hasClass
- * */
+ */
 export function hasClass(obj: any, cls: string): boolean {
   const oriCls = obj.className; // 获取对象的class值
   const oriClsArr = oriCls.split(/\s+/); // 分隔空格转换成数组
@@ -317,7 +320,7 @@ export function hasClass(obj: any, cls: string): boolean {
 
 /**
  * @method addClass
- * */
+ */
 export function addClass(obj: any, cls: string): void {
   const oriCls = obj.className;
   let space = '';
@@ -331,7 +334,7 @@ export function addClass(obj: any, cls: string): void {
 
 /**
  * @method removeClass
- * */
+ */
 export function removeClass(obj: any, cls: string): void {
   const oriCls = obj.className;
   let newCls; // 获取对象的class值
@@ -343,19 +346,25 @@ export function removeClass(obj: any, cls: string): void {
 }
 
 /**
- * @method throttle
- * @description 节流。
- * */
-export function throttle(func: any, wait: number, options: any): any {
+ * EN: Throttle
+ * ZH: 节流
+ * 
+ * @see https://lodash.com/docs/4.17.15#throttle
+ */
+export function throttle(func: any, wait: number, options: { leading?: boolean; trailing?: boolean; } = {}): any {
+  options = Object.assign(
+    {},
+    options,
+  );
   // timeout: setTimeout Handle
   // previous: 上次时间戳
   let context: any = null;
   let args: any = null;
   let timeout: any = null;
   let [result, previous] = [null, 0];
-  if (!options) {
-    options = {};
-  }
+  // if (!options) {
+  //   options = {};
+  // }
   const later = function () {
     previous = options.leading === false ? 0 : mNow();
     timeout = null;
@@ -390,10 +399,11 @@ export function throttle(func: any, wait: number, options: any): any {
 }
 
 /**
- * @method debounce
- * @description 去抖。
- * */
-export function debounce(func: any, wait: number, immediate: any): any {
+ * EN: Debounce
+ * 
+ * ZH: 去抖
+ */
+export function debounce(func: any, wait: number, immediate?: any): any {
   let context: any = null;
   let timeout: any = null;
   let timestamp: any = null;
@@ -434,14 +444,15 @@ export function debounce(func: any, wait: number, immediate: any): any {
  * @description 获取间隔时间。
  * @param {number/Date} start 开始时间戳 1585325367122
  * @param {number/Date} end 结束时间戳 1585325367122
- * @type {string} type 返回类型 d: 2(天) text: 2 天 4 时...
- * @return {String/number} 取决于 type
- * */
-export function friendlyInterval(start = 0, end = 0, { type = 'd' } = {}): number | string {
+ * @param {string} options.type 返回类型 d: 2(天) text: 2 天 4 时...
+ * @returns {String/number} 取决于 type
+ */
+export function friendlyInterval(start = 0, end = 0, options: { type?: string; } = { type: 'd' }): number | string {
+  const { type } = options;
   if (!isNumber(start)) start = new Date(start).getTime();
   if (!isNumber(end)) end = new Date(end).getTime();
   const t = end - start;
-  let ret = null;
+  let ret = '';
   let [d, h, m, s] = new Array(4).fill(0);
   if (t >= 0) {
     d = Math.floor(t / 1000 / 60 / 60 / 24);
@@ -470,11 +481,15 @@ export function friendlyInterval(start = 0, end = 0, { type = 'd' } = {}): numbe
  * @method isNumber
  * @description 判断是否有效数字
  * @param {*} num 被判断的值
- * @param {boolean} isNaNAsNumber 是否 NaN 算数字（默认不算）
- * @param {boolean} isUnFiniteAsNumber 是否 无限 算数字（默认不算）
- * @return {boolean} true 是数字
+ * @param {boolean} options.isNaNAsNumber 是否 NaN 算数字（默认不算）
+ * @param {boolean} options.isUnFiniteAsNumber 是否 无限 算数字（默认不算）
+ * @returns {boolean} true 是数字
  */
-export function isNumber(num: any, { isNaNAsNumber = false, isUnFiniteAsNumber = false } = {}): boolean {
+export function isNumber(num: any, options: { isNaNAsNumber?: boolean; isUnFiniteAsNumber?: boolean; } = { isNaNAsNumber: false, isUnFiniteAsNumber: false }): boolean {
+  const { isNaNAsNumber, isUnFiniteAsNumber } = Object.assign(
+    { isNaNAsNumber: false, isUnFiniteAsNumber: false },
+    options,
+  );
   let ret = true;
   // 数字类型
   if (typeof num !== 'number') {
@@ -497,7 +512,7 @@ export function isNumber(num: any, { isNaNAsNumber = false, isUnFiniteAsNumber =
  * @method doFn
  * @description 执行有效函数
  * @param {function} fn 等待被执行的未知是否有效的函数
- * */
+ */
 export function doFn(fn: any, ...params: any[]): any {
   let ret = null;
   if (fn && typeof fn === 'function') {
@@ -511,7 +526,7 @@ export function doFn(fn: any, ...params: any[]): any {
  * @description 存储数据到 sessionStorage
  * @param {string} key 键
  * @param {string} value 值
- * */
+ */
 export function setSessionStorage(key: string, value: any = null): void {
   if (key) {
     sessionStorage.setItem(key, JSON.stringify(value));
@@ -522,8 +537,8 @@ export function setSessionStorage(key: string, value: any = null): void {
  * @method getSessionStorage
  * @description 存储数据到 sessionStorage
  * @param {string} key 键
- * @return {*} 返回值
- * */
+ * @returns {*} 返回值
+ */
 export function getSessionStorage(key: string): any {
   let ret = null;
   if (key) {
@@ -540,7 +555,7 @@ export function getSessionStorage(key: string): any {
  * @description 存储数据到 localStorage
  * @param {string} key 键
  * @param {string} value 值
- * */
+ */
 export function setLocalStorage(key: string, value: any = null): void {
   if (key) {
     localStorage.setItem(key, JSON.stringify(value));
@@ -551,8 +566,8 @@ export function setLocalStorage(key: string, value: any = null): void {
  * @method getLocalStorage
  * @description 存储数据到 localStorage
  * @param {string} key 键
- * @return {*} 返回值
- * */
+ * @returns {*} 返回值
+ */
 export function getLocalStorage(key: string): any {
   let ret = null;
   if (key) {
@@ -568,18 +583,20 @@ export function getLocalStorage(key: string): any {
  * @method loadCSS
  * @description 动态加载css文件
  * @param {string} url -- css资源路径
- * @param {string} id -- link标签id
- * @return {Promise<boolean>} true -- 加载成功
+ * @param {string} options.id -- link标签id
+ * @returns {Promise<boolean>} true -- 加载成功
  */
-export function loadCSS(url = '', { id = '' } = {}): Promise<any> {
-  let success: any = null;
-  let fail: any = null;
+export function loadCSS(url: string, options: { id?: string } = { id: '' }): Promise<boolean | Error | any> {
+  const { id } = options;
+  let success: (v: boolean) => void;
+  let fail: (v: Error) => void;
   const status = new Promise((resolve, reject) => {
     ([success, fail] = [resolve, reject]);
   });
   // const tempCB = (typeof callback === 'function' ? callback : function () { });
   const callback = function () {
-    doFn(success, true);
+    // doFn(success, true);
+    success(true);
   };
   let node: any = document.createElement('link');
   const supportOnload = 'onload' in node;
@@ -689,13 +706,22 @@ export function loadCSS(url = '', { id = '' } = {}): Promise<any> {
  * @method loadScript
  * @description 动态加载js文件
  * @param {string} url -- js资源路径
- * @param {string} id -- DOM ID
- * @param {function} callback -- 加载后回调函数
- * @param {number} timeout -- 超时时长
- * @param {boolean} isDefer -- 是否添加 defer 标签
- * @return {Promise<boolean>} -- true 成功
+ * @param {string} options.id -- DOM ID
+ * @param {function} options.callback -- 加载后回调函数
+ * @param {number} options.timeout -- 超时时长
+ * @param {boolean} options.isDefer -- 是否添加 defer 标签
+ * @returns {Promise<boolean>} -- true 成功
  */
-export function loadScript(url = '', { id = '', callback = function () { /* pass */ }, timeout = 5000, isDefer = false } = {}): Promise<any> {
+export function loadScript(url: string, options: {
+  id: string;
+  callback: (...params: any[]) => any;
+  timeout: number;
+  isDefer: boolean;
+} = { id: '', callback: function () { /* pass */ }, timeout: 5000, isDefer: false }): Promise<boolean | string | Error> {
+  const { id, callback, timeout, isDefer } = Object.assign(
+    { id: '', callback: function () { /* pass */ }, timeout: 5000, isDefer: false },
+    options,
+  );
   let success: any = null;
   let fail: any = null;
   const script: any = document.createElement('script');
@@ -729,7 +755,7 @@ export function loadScript(url = '', { id = '', callback = function () { /* pass
   return new Promise((resolve, reject) => {
     ([success, fail] = [resolve, reject]);
     if (timeout) {
-      setTimeout(fail.bind(null, 'timeout'), timeout);
+      setTimeout(fail.bind(null, Error('timeout')), timeout);
     }
   });
 }
@@ -807,16 +833,20 @@ export function getCookie(name: string): string {
   return '';
 }
 
+interface WebPerformance {
+  [key: string]: string | number;
+}
+
 /**
  * @method getPerformance
  * @description 获取页面加载相关的各项数据
  * @param {boolean} camelCase -- true（默认） 以驼峰形式返回数据 false 以下划线形式返回数据
- * @return {Promise<object>} 加载数据
+ * @returns {Promise<object>} 加载数据
  */
-export function getPerformance(camelCase = true): Promise<any> {
-  let success: any;
-  let fail: any;
-  const status = new Promise((resolve, reject) => {
+export function getPerformance(camelCase = true): Promise<WebPerformance | Error> {
+  let success: (v: WebPerformance) => void;
+  let fail: (v: Error) => void;
+  const status: Promise<WebPerformance> = new Promise((resolve, reject) => {
     ([success, fail] = [resolve, reject]);
   });
   const timing = window.performance.timing;
@@ -909,10 +939,10 @@ export function getPerformance(camelCase = true): Promise<any> {
         }
         success(Underscore || data);
       } else {
-        fail('startTime');
+        fail(Error('startTime'));
       }
     } else {
-      fail('getEntries');
+      fail(Error('getEntries'));
     }
   }
   //获取当前操作系统
@@ -1021,7 +1051,7 @@ export function getPerformance(camelCase = true): Promise<any> {
  * @method inRate
  * @description 百分位概率
  * @param {number} rate -- 0.1 ~ 1 => 1% ~ 100%
- * @return {boolean} true 命中
+ * @returns {boolean} true 命中
  */
 export function inRate(rate: number): boolean {
   if(Math.random() < rate) {
@@ -1033,7 +1063,7 @@ export function inRate(rate: number): boolean {
 /**
  * @method isSafePWAEnv
  * @description 判断是否是安全的 PWA 环境
- * @return {boolean} true 是
+ * @returns {boolean} true 是
  */
 export function isSafePWAEnv(): boolean {
   // 判断是否支持 async await
@@ -1076,16 +1106,53 @@ export function isSafePWAEnv(): boolean {
 }
 
 /**
- * @method getBrowserInfo
- * @description 返回浏览器信息 https://github.com/JowayYoung/juejin-code/blob/master/browser-type.js
- * @return {object} 浏览器信息
+ * EN: Browser Information
+ * 
+ * ZH: 返回浏览器信息 https://github.com/JowayYoung/juejin-code/blob/master/browser-type.js
+ * 
+ * ```
+ * getBrowserInfo(); // {"engine":"webkit","engineVs":"537.36","platform":"desktop","supporter":"chrome","supporterVs":"85.0.4183.121","system":"windows","systemVs":"10"}
+ * ```
+ * 
+ * | Index | Field | Description |
+ * | --- | --- | --- |
+ * | System | system | android, ios, windows, macos, linux |
+ * | System version | systemVs | windows: 2000, xp, 2003, vista, 7, 8, 8.1, 10 <br />macos: ... |
+ * | Platform | platform | desktop, mobile |
+ * | Engine | engine | webkit, gecko, presto, trident |
+ * | Engine version | engineVs | - |
+ * | Supporter | supporter | edge, opera, chrome, safari, firefox, iexplore |
+ * | Supporter version | supporterVs | - |
+ * | Shell | shell | (Optional) wechat, qq_browser, qq_app, uc, 360, 2345, sougou, liebao, maxthon, bilibili |
+ * | Shell version | shellVs | (Optional) |
+ * | Apple device type | appleType | (Optional) iphone, ipad, ipod, iwatch |
+ * 
+ * Example: Determine the environment of the mobile QQ.
+ * 
+ * ```
+ * const { system, shell } = getBrowserInfo();
+ * const isMobileQQ = ['android', 'ios'].includes(system) && ['qq_browser', 'qq_app'].includes(shell);
+ * ```
+ * 
+ * @returns 浏览器信息
  */
-export function getBrowserInfo(): any {
+export function getBrowserInfo(): {
+  engine: string; // webkit gecko presto trident
+  engineVs: string;
+  platform: string; // desktop mobile
+  supporter: string; // chrome safari firefox opera iexplore edge
+  supporterVs: string;
+  system: string; // windows macos linux android ios
+  systemVs: string;
+  shell?: string; // wechat qq uc 360 2345 sougou liebao maxthon
+  shellVs?: string;
+  appleType?: string;
+} {
   try {
     // 权重：系统 + 系统版本 > 平台 > 内核 + 载体 + 内核版本 + 载体版本 > 外壳 + 外壳版本
-    const ua: any = navigator.userAgent.toLowerCase();
-    const testUa: (regexp: any) => any = regexp => regexp.test(ua);
-    const testVs: (regexp: any) => any = regexp => {
+    const ua: string = navigator.userAgent.toLowerCase();
+    const testUa: (regexp: RegExp) => boolean = regexp => regexp.test(ua);
+    const testVs: (regexp: RegExp) => string = regexp => {
       const matchRes = ua.match(regexp);
       let ret = '';
       if (matchRes) {
@@ -1248,18 +1315,26 @@ export function getBrowserInfo(): any {
     });
   } catch (err) {
     console.warn('mazey:', err);
-    return {};
+    return {
+      engine: '', // webkit gecko presto trident
+      engineVs: '',
+      platform: '', // desktop mobile
+      supporter: '', // chrome safari firefox opera iexplore edge
+      supporterVs: '',
+      system: '', // windows macos linux android ios
+      systemVs: '',
+    };
   }
 }
 
 /**
  * @method clearHtml
  * @description 去除HTML标签
- * @param {string} string 带html标签的字符串
- * @return {string} 字符串
+ * @param {string} str 带html标签的字符串
+ * @returns {string} 字符串
  */
-export function clearHtml (string = ''): string {
-  return string.replace(/<\/?.+?>/g, '').replace(/[\r\n]/g, '');
+export function clearHtml (str: string): string {
+  return str.replace(/<\/?.+?>/g, '').replace(/[\r\n]/g, '');
 }
 
 /**
@@ -1268,9 +1343,9 @@ export function clearHtml (string = ''): string {
  * @param {string} str 要截取的字符串
  * @param {number} len
  * @param {boolean} hasDot
- * @returns {string} 返回截取后的字符串
+ * @returnss {string} 返回截取后的字符串
  */
-export function cutCHSString(str = '', len = str.length, hasDot = false): string {
+export function cutCHSString(str: string, len: number, hasDot = false): string {
   if (str == '' || !str) {
     return '';
   } else {
@@ -1304,12 +1379,12 @@ export function cutCHSString(str = '', len = str.length, hasDot = false): string
  * @method windowLoaded
  * @description 页面加载完成
  * @param {number} timeout 超时时间 / 单位：秒
- * @return {Promise<string>} document is loaded? 'complete' 'load' / 'timeout'
-*/
-export function windowLoaded(timeout = 90): Promise<string> {
+ * @returns {Promise<string>} document is loaded? 'complete' 'load' / 'timeout'
+ */
+export function windowLoaded(timeout = 90): Promise<string | Error> {
   let loaded: (value: string) => void = () => undefined;
-  let loadFail: (value: string) => void = () => undefined;
-  const status = new Promise((resolve: (value: string) => void, reject: (value: string) => void) => {
+  let loadFail: (value: Error) => void;
+  const status = new Promise((resolve: (value: string) => void, reject: (value: Error) => void) => {
       loaded = resolve;
       loadFail = reject;
   });
@@ -1319,42 +1394,83 @@ export function windowLoaded(timeout = 90): Promise<string> {
       window.addEventListener('load', () => loaded('load'));
   }
   // 超过 timeout 秒后加载失败
-  setTimeout(() => loadFail('timeout'), timeout * 1000);
+  setTimeout(() => loadFail(Error('timeout')), timeout * 1000);
   return status;
 }
 
 /**
- * @method addInlineStyle
- * @description 添加内联样式
- * @param {string} inlineStyle 内联样式字符串
- * @param {string} id style 标签的 ID
- * @return {boolean} 添加成功/失败 
-*/
-export function addInlineStyle(inlineStyle = '', { id = '' } = {}): boolean {
-  if (!inlineStyle) {
+ * EN: Add `<style>` in `<head>`.
+ * 
+ * ZH: 添加样式标签; style: 样式标签内的字符串; id: `<style>` 标签的 `id`; 返回: 添加成功/失败.
+ * 
+ * Example 1: Add the `<style>` with `id`, and repeated invoking will update the content instead of adding a new one.
+ * 
+ * ```
+ * addStyle(
+ *   `
+ *     body {
+ *       background-color: #333;
+ *     }
+ *   `,
+ *   {
+ *     id: 'test',
+ *   }
+ * );
+ * // <style id="test">
+ * //   body {
+ * //     background-color: #333;
+ * //   }
+ * // </style>
+ * ```
+ * 
+ * Example 2: Add the `<style>` without `id`, and repeated invoking will adding a new one.
+ * 
+ * ```
+ * addStyle(
+ *   `
+ *     body {
+ *       background-color: #333;
+ *     }
+ *   `
+ * );
+ * // <style>
+ * //   body {
+ * //     background-color: #333;
+ * //   }
+ * // </style>
+ * ```
+ * 
+ * @param style Style string.
+ * @param options.id `id` in `<style>`
+ * @returns Success/Fail
+ */
+export function addStyle(style: string, options: { id?: string; } = { id: '' }): boolean {
+  // console.log('_ style', style);
+  // console.log('_ options', options);
+  if (!style) {
     return false;
   }
   // 创建 style 文档碎片
   const styleFrag = document.createDocumentFragment();
-  let idDom = null;
+  let idDom: HTMLElement | null = null;
   let domId = '';
   // Custom Style
   const customStyle = document.createElement('style');
   // 如果需要 ID
-  if (id) {
-    domId = `${id}`;
+  if (options.id) {
+    domId = `${options.id}`;
     idDom = document.getElementById(domId);
     // 如果 Dom 不存在，插入 style
     if (!idDom) {
-      customStyle.setAttribute('id', id);
-      customStyle.innerHTML = inlineStyle;
+      customStyle.setAttribute('id', options.id);
+      customStyle.innerHTML = style;
       styleFrag.appendChild(customStyle);
       document.head.appendChild(styleFrag);
     } else { // 如果 Dom 存在，直接更新
-      idDom.innerHTML = inlineStyle;
+      idDom.innerHTML = style;
     }
   } else { // 不需要 ID，直接添加新标签
-    customStyle.innerHTML = inlineStyle;
+    customStyle.innerHTML = style;
     styleFrag.appendChild(customStyle);
     document.head.appendChild(styleFrag);
   }
@@ -1366,9 +1482,9 @@ export function addInlineStyle(inlineStyle = '', { id = '' } = {}): boolean {
  * @description 生成自定义控制台打印
  * @param {string} prefix 前缀
  * @param {function} allowFn 允许打印的判断函数
- * @return {object} 新实例
-*/
-export function genCustomConsole(prefix = ''): any {
+ * @returns {object} 新实例
+ */
+export function genCustomConsole(prefix = ''): Console {
   const methods = ['log', 'info', 'warn', 'error'];
   const newConsole = Object.create(null);
   methods.forEach(method => {
@@ -1382,3 +1498,98 @@ export function genCustomConsole(prefix = ''): any {
   });
   return newConsole;
 }
+
+/**
+ * Verify the validity of axios response.
+ */
+export function zAxiosIsValidRes(res: any, options: {
+  validStatus: number[];
+  validCode: number[];
+} = {
+  validStatus: [200],
+  validCode: [0],
+}): boolean {
+  const { validStatus, validCode } = Object.assign(
+    {
+      validStatus: [200],
+      validCode: [0],
+    },
+    options,
+  );
+  let ret = false;
+  if (res && res.status && validStatus.includes(res.status)) {
+    ret = true;
+    const resData = res.data;
+    if (resData && validCode.includes(resData.code)) {
+      ret = true;
+    }
+  }
+  return ret;
+}
+
+/**
+ * Verify the validity of a non-empty array.
+ */
+export function isNonEmptyArray(arr: any[]): boolean {
+  let ret = false;
+  if (Array.isArray(arr) && arr.length) {
+    ret = true;
+  }
+  return ret;
+}
+
+/**
+ * 语义化文件大小, 把字节转换成正常文件大小.
+ */
+export function getFileSize(size: number): string {
+	const toCeilStr: (v: number) => string = n => String(Math.ceil(n));
+	if (!size) return '';
+	const num = 1024.0; // byte
+	if (size < num) {
+		return size + ' B';
+	}
+	if (size < Math.pow(num, 2)) {
+		return toCeilStr(size / num) + ' KB';
+	} // kb
+	if (size < Math.pow(num, 3)) {
+		return toCeilStr(size / Math.pow(num, 2)) + ' MB';
+	} // M
+	if (size < Math.pow(num, 4)) {
+		return toCeilStr(size / Math.pow(num, 3)) + ' G';
+	} // G
+	return toCeilStr(size / Math.pow(num, 4)) + ' T';
+}
+
+/**
+ * Detect webp support.
+ *
+ * @see https://davidwalsh.name/detect-webp
+ */
+export function isSupportWebp(): Promise<boolean> {
+  const fn = (resolve: (v: boolean) => void) => {
+		const img = new Image();
+		img.onload = () => {
+			resolve(img.width > 0 && img.height > 0);
+		};
+		img.onerror = () => {
+			resolve(false);
+		};
+		img.src = "data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAAAAAAfQ//73v/+BiOh/AAA=";
+	};
+	return new Promise(fn);
+}
+
+/**
+ * Generate a Hash Code from a string.
+ *
+ * @see https://stackoverflow.com/questions/7616461/generate-a-hash-from-string-in-javascript-jquery
+ */
+export function genHashCode(str: string): number {
+	let hash = 0, i, chr;
+	for (i = 0; i < str.length; i++) {
+		chr = str.charCodeAt(i);
+		hash = ((hash << 5) - hash) + chr;
+		hash |= 0;
+	}
+	return hash;
+}