@ivujs/i-utils 2.0.0 → 2.1.0

package/dist/cjs/color/index.cjs

@@ -1,48 +1,52 @@
 'use strict';
 
+/**
+ * @module 颜色
+ */
 /**
  * rgb颜色转hex
- * @param {String} rgb rgb颜色字符串
- * @returns {String} 返回生成的hex颜色
+ * @param {string} rgb rgb颜色字符串
+ * @returns {string} 返回生成的hex颜色
  */
 function rgbToHex(rgb) {
-    let arr = rgb.split(",");
-    let r = parseInt(arr[0].split("(")[1]);
-    let g = parseInt(arr[1]);
-    let b = parseInt(arr[2].split(")")[0]);
+    const arr = rgb.split(",");
+    const r = parseInt(arr[0].split("(")[1]);
+    const g = parseInt(arr[1]);
+    const b = parseInt(arr[2].split(")")[0]);
     return "#" + _hex(r) + _hex(g) + _hex(b);
 }
 /**
  * rgba颜色转hex
- * @param {String} rgba rgba颜色字符串
- * @returns {String} 返回生成的hex颜色
+ * @param {string} rgba rgba颜色字符串
+ * @returns {string} 返回生成的hex颜色
  */
 function rgbaToHex(rgba) {
-    let arr = rgba.split(",");
-    let r = parseInt(arr[0].split("(")[1]);
-    let g = parseInt(arr[1]);
-    let b = parseInt(arr[2]);
-    let a = parseFloat(arr[3].split(")")[0]);
+    const arr = rgba.split(",");
+    const r = parseInt(arr[0].split("(")[1]);
+    const g = parseInt(arr[1]);
+    const b = parseInt(arr[2]);
+    const a = parseFloat(arr[3].split(")")[0]);
     return `#${_hex(Math.round(a * 256 - 1))}${_hex(r)}${_hex(g)}${_hex(b)}`;
 }
 /**
  * rgba颜色转hsl
- * @param {String} rgba rgb颜色字符串
- * @returns {String} 返回生成的hsl颜色
+ * @param {string} rgba rgb颜色字符串
+ * @returns {string} 返回生成的hsl颜色
  */
 function rgbaToHsl(rgba) {
-    let arr = rgba.split(",");
-    let r = parseInt(arr[0].split("(")[1]) / 255;
-    let g = parseInt(arr[1]) / 255;
-    let b = parseInt(arr[2]) / 255;
-    let a = parseFloat(arr[3] && arr[3].split(")")[0]);
-    let max = Math.max(r, g, b), min = Math.min(r, g, b);
-    let h, s, l = (max + min) / 2;
+    const arr = rgba.split(",");
+    const r = parseInt(arr[0].split("(")[1]) / 255;
+    const g = parseInt(arr[1]) / 255;
+    const b = parseInt(arr[2]) / 255;
+    const a = parseFloat(arr[3] && arr[3].split(")")[0]);
+    const max = Math.max(r, g, b), min = Math.min(r, g, b);
+    let h = 0, s = 0;
+    const l = (max + min) / 2;
     if (max === min) {
         h = s = 0;
     }
     else {
-        let d = max - min;
+        const d = max - min;
         s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
         switch (max) {
             case r:
@@ -64,16 +68,19 @@ function rgbaToHsl(rgba) {
 }
 /**
  * hex颜色转rgb
- * @param {String} hex hex颜色字符串
- * @returns {String} 返回生成的rgb颜色
+ * @param {string} hex hex颜色字符串
+ * @returns {string} 返回生成的rgb颜色
  */
 function hexToRgb(hex) {
-    let color = {};
-    let rgx = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
-    let hexStr = hex.replace(rgx, function (m, r, g, b) {
+    const color = { r: 0, g: 0, b: 0};
+    const rgx = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
+    const hexStr = hex.replace(rgx, function (m, r, g, b) {
         return r + r + g + g + b + b;
     });
-    let rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+    const rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+    if (!rgb) {
+        throw new Error(`Invalid hex color: ${hex}`);
+    }
     color.r = parseInt(rgb[1], 16);
     color.g = parseInt(rgb[2], 16);
     color.b = parseInt(rgb[3], 16);
@@ -81,17 +88,20 @@ function hexToRgb(hex) {
 }
 /**
  * hex颜色转rgba
- * @param {String} hex hex颜色字符串
- * @param {Number} opacity 透明度
- * @returns {String} 返回生成的rgba颜色
+ * @param {string} hex hex颜色字符串
+ * @param {number} opacity 透明度
+ * @returns {string} 返回生成的rgba颜色
  */
 function hexToRgba(hex, opacity = 1) {
-    let color = {};
-    let rgx = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
-    let hexStr = hex.replace(rgx, function (m, r, g, b) {
+    const color = { r: 0, g: 0, b: 0, o: 0 };
+    const rgx = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
+    const hexStr = hex.replace(rgx, function (m, r, g, b) {
         return r + r + g + g + b + b;
     });
-    let rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+    const rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+    if (!rgb) {
+        throw new Error(`Invalid hex color: ${hex}`);
+    }
     color.r = parseInt(rgb[1], 16);
     color.g = parseInt(rgb[2], 16);
     color.b = parseInt(rgb[3], 16);
@@ -100,27 +110,31 @@ function hexToRgba(hex, opacity = 1) {
 }
 /**
  * hex颜色转hsl
- * @param {String} hex hex颜色字符串
- * @returns {String} 返回生成的hsl颜色
+ * @param {string} hex hex颜色字符串
+ * @returns {string} 返回生成的hsl颜色
  */
 function hexToHsl(hex) {
     // 先解析为rgb
-    let rgx = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
-    let hexStr = hex.replace(rgx, function (m, r, g, b) {
+    const rgx = /^#?([a-f\d])([a-f\d])([a-f\d])$/i;
+    const hexStr = hex.replace(rgx, function (m, r, g, b) {
         return r + r + g + g + b + b;
     });
-    let rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+    const rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
+    if (!rgb) {
+        throw new Error(`Invalid hex color: ${hex}`);
+    }
     // 再组装为hsl格式
-    let r = parseInt(rgb[1], 16) / 255;
-    let g = parseInt(rgb[2], 16) / 255;
-    let b = parseInt(rgb[3], 16) / 255;
-    let max = Math.max(r, g, b), min = Math.min(r, g, b);
-    let h, s, l = (max + min) / 2;
+    const r = parseInt(rgb[1], 16) / 255;
+    const g = parseInt(rgb[2], 16) / 255;
+    const b = parseInt(rgb[3], 16) / 255;
+    const max = Math.max(r, g, b), min = Math.min(r, g, b);
+    let h = 0, s = 0;
+    const l = (max + min) / 2;
     if (max === min) {
         h = s = 0;
     }
     else {
-        let d = max - min;
+        const d = max - min;
         s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
         switch (max) {
             case r:
@@ -139,7 +153,7 @@ function hexToHsl(hex) {
 }
 /**
  * 随机生成hex颜色
- * @returns {String} 返回生成的十六进制颜色
+ * @returns {string} 返回生成的十六进制颜色
  */
 function getDrawHex() {
     return ("#" +
@@ -149,36 +163,36 @@ function getDrawHex() {
 }
 /**
  * 随机生成rgb颜色
- * @returns {String} 返回生成的 rgb 颜色
+ * @returns {string} 返回生成的 rgb 颜色
  */
 function getDrawRgb() {
-    let r = Math.floor(Math.random() * 256);
-    let g = Math.floor(Math.random() * 256);
-    let b = Math.floor(Math.random() * 256);
+    const r = Math.floor(Math.random() * 256);
+    const g = Math.floor(Math.random() * 256);
+    const b = Math.floor(Math.random() * 256);
     return `rgb(${r},${g},${b})`;
 }
 /**
  * 随机生成rgba颜色
- * @returns {String} 返回生成的 rgba 颜色
+ * @returns {string} 返回生成的 rgba 颜色
  */
 function getDrawRgba() {
-    let r = Math.floor(Math.random() * 256);
-    let g = Math.floor(Math.random() * 256);
-    let b = Math.floor(Math.random() * 256);
-    let a = Number(Math.random()).toFixed(2);
+    const r = Math.floor(Math.random() * 256);
+    const g = Math.floor(Math.random() * 256);
+    const b = Math.floor(Math.random() * 256);
+    const a = Number(Math.random()).toFixed(2);
     return `rgba(${r},${g},${b},${a})`;
 }
 // 内部函数
 /**
  * 颜色值转换
- * @param {Number} num 转换的值
+ * @param {number} num 转换的值
  * @returns
  */
 function _hex(num) {
     if (num > 255) {
         throw "'" + num + "'' is greater than 255(0xff);";
     }
-    let str = Number(num).toString(16);
+    const str = Number(num).toString(16);
     return ("0" + str).slice(-2);
 }
 

package/dist/cjs/cookie/index.cjs

@@ -2,9 +2,12 @@
 
 var index = require('../validate/index.cjs');
 
+/**
+ * @module 浏览器Cookie
+ */
 /**
  * 浏览器是否支持 Cookie
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isSupportCookie() {
     return window.navigator.cookieEnabled;
@@ -12,16 +15,16 @@ function isSupportCookie() {
 /* cookie存储 */
 /**
  * 通过name获取cookie
- * @param {String} name 参数name
- * @returns {String} 返回获取的值
+ * @param {string} name 参数name
+ * @returns {string} 返回获取的值
  */
 function getCookie(name) {
     if (typeof document == "undefined")
         return "";
     // cookie中每个分号后面是有个空格的，需要替换掉
-    let arr = document.cookie ? document.cookie.replace(/\s/g, "").split(";") : [];
-    for (let i in arr) {
-        let tempArr = arr[i].split("=");
+    const arr = document.cookie ? document.cookie.replace(/\s/g, "").split(";") : [];
+    for (const i in arr) {
+        const tempArr = arr[i].split("=");
         if (tempArr[0] === name) {
             return decodeURIComponent(tempArr[1]);
         }
@@ -31,9 +34,9 @@ function getCookie(name) {
 /**
  * 通过name设置cookie
  * 注：timestamp参数不填，则默认为session级别，浏览器关闭即cookie过期
- * @param {String} name 参数name
- * @param {String} value 设置的value
- * @param {Number} timestamp 过期的时间戳值，默认为一天，设置一天过期则为：24*60*60*1000
+ * @param {string} name 参数name
+ * @param {string} value 设置的value
+ * @param {number} timestamp 过期的时间戳值，默认为一天，设置一天过期则为：24*60*60*1000
  */
 function setCookie(name, value, timestamp = 24 * 60 * 60 * 1000) {
     if (typeof document == "undefined")
@@ -42,7 +45,7 @@ function setCookie(name, value, timestamp = 24 * 60 * 60 * 1000) {
 }
 /**
  * 通过name删除cookie
- * @param {String} name 参数name
+ * @param {string} name 参数name
  */
 function removeCookie(name) {
     if (index.isEmpty(name))
@@ -51,11 +54,11 @@ function removeCookie(name) {
 }
 /**
  * 清空当前站点域名的cookie
- * @param {String} domain 域名地址，默认是当前站点域名
+ * @param {string} domain 域名地址，默认是当前站点域名
  */
 function clearCookie(domain = document.domain) {
-    let names = document.cookie.match(/[^ =;]+(?==)/g);
-    if (names) {
+    const names = document.cookie.match(/[^ =;]+(?==)/g) || [];
+    if (names && names.length > 0) {
         for (let i = names.length; i--;) {
             document.cookie =
                 names[i] + "=0;path=/;" + domain ? "domain=" + domain + ";" : "" + "expires=" + new Date(0).toUTCString();