@ivujs/i-utils 2.0.0 → 2.1.0

package/dist/es/desensitized/index.d.ts

@@ -1,38 +1,41 @@
+/**
+ * @module 脱敏
+ */
 /**
  * 指定位置的字符串转为星号
- * @param {String|Number} value 字符串参数
- * @param {Number} start 转换开始位置
- * @param {Number} len 显示星号的长度
- * @returns {String} 返回转化后字符串
+ * @param {string|number} value 字符串参数
+ * @param {number} start 转换开始位置
+ * @param {number} len 显示星号的长度
+ * @returns {string} 返回转化后字符串
  */
-export function formatStartOf(value: string | number, start: number, len: number): string;
+export declare function formatStartOf(value: string, start: number, len: number): string;
 /**
  * 姓名中间转为星号
- * @param {String} value 姓名
- * @returns {String} 返回转化后字符串
+ * @param {string} value 姓名
+ * @returns {string} 返回转化后字符串
  */
-export function formatStartOfName(value: string): string;
+export declare function formatStartOfName(value: string): string;
 /**
  * 手机号码固定位数转为星号
- * @param {String} value 手机号码
- * @param {Number} start 前缀长度，默认3位
- * @param {Number} len 显示星号的长度，默认4位
- * @returns {String} 返回转化后字符串
+ * @param {string} value 手机号码
+ * @param {number} start 前缀长度，默认3位
+ * @param {number} len 显示星号的长度，默认4位
+ * @returns {string} 返回转化后字符串
  */
-export function formatStartOfMobile(value: string, start?: number, len?: number): string;
+export declare function formatStartOfMobile(value: string, start?: number, len?: number): string;
 /**
  * 身份证号码固定位数转为星号
- * @param {String} value 身份证号码
- * @param {Number} start 前缀长度，默认4位
- * @param {Number} len 显示星号的长度，默认8位
- * @returns {String} 返回转化后字符串
+ * @param {string} value 身份证号码
+ * @param {number} start 前缀长度，默认4位
+ * @param {number} len 显示星号的长度，默认8位
+ * @returns {string} 返回转化后字符串
  */
-export function formatStartOfIDCard(value: string, start?: number, len?: number): string;
+export declare function formatStartOfIDCard(value: string, start?: number, len?: number): string;
 /**
  * 银行卡号固定位数转为星号
- * @param {String} value 银行卡号
- * @param {Number} start 前缀长度，默认4位
- * @param {Number} len 显示星号的长度，默认10位
- * @returns {String} 返回转化后字符串
+ * @param {string} value 银行卡号
+ * @param {number} start 前缀长度，默认4位
+ * @param {number} len 显示星号的长度，默认10位
+ * @returns {string} 返回转化后字符串
  */
-export function formatStartOfBankCard(value: string, start?: number, len?: number): string;
+export declare function formatStartOfBankCard(value: string, start?: number, len?: number): string;

package/dist/es/desensitized/index.mjs

@@ -1,9 +1,12 @@
+/**
+ * @module 脱敏
+ */
 /**
  * 指定位置的字符串转为星号
- * @param {String|Number} value 字符串参数
- * @param {Number} start 转换开始位置
- * @param {Number} len 显示星号的长度
- * @returns {String} 返回转化后字符串
+ * @param {string|number} value 字符串参数
+ * @param {number} start 转换开始位置
+ * @param {number} len 显示星号的长度
+ * @returns {string} 返回转化后字符串
  */
 function formatStartOf(value, start, len) {
     value = String(value);
@@ -21,8 +24,8 @@ function formatStartOf(value, start, len) {
 }
 /**
  * 姓名中间转为星号
- * @param {String} value 姓名
- * @returns {String} 返回转化后字符串
+ * @param {string} value 姓名
+ * @returns {string} 返回转化后字符串
  */
 function formatStartOfName(value) {
     if (value.length === 2) {
@@ -37,30 +40,30 @@ function formatStartOfName(value) {
 }
 /**
  * 手机号码固定位数转为星号
- * @param {String} value 手机号码
- * @param {Number} start 前缀长度，默认3位
- * @param {Number} len 显示星号的长度，默认4位
- * @returns {String} 返回转化后字符串
+ * @param {string} value 手机号码
+ * @param {number} start 前缀长度，默认3位
+ * @param {number} len 显示星号的长度，默认4位
+ * @returns {string} 返回转化后字符串
  */
 function formatStartOfMobile(value, start = 3, len = 4) {
     return formatStartOf(value, start, len);
 }
 /**
  * 身份证号码固定位数转为星号
- * @param {String} value 身份证号码
- * @param {Number} start 前缀长度，默认4位
- * @param {Number} len 显示星号的长度，默认8位
- * @returns {String} 返回转化后字符串
+ * @param {string} value 身份证号码
+ * @param {number} start 前缀长度，默认4位
+ * @param {number} len 显示星号的长度，默认8位
+ * @returns {string} 返回转化后字符串
  */
 function formatStartOfIDCard(value, start = 4, len = 8) {
     return formatStartOf(value, start, len);
 }
 /**
  * 银行卡号固定位数转为星号
- * @param {String} value 银行卡号
- * @param {Number} start 前缀长度，默认4位
- * @param {Number} len 显示星号的长度，默认10位
- * @returns {String} 返回转化后字符串
+ * @param {string} value 银行卡号
+ * @param {number} start 前缀长度，默认4位
+ * @param {number} len 显示星号的长度，默认10位
+ * @returns {string} 返回转化后字符串
  */
 function formatStartOfBankCard(value, start = 4, len = 11) {
     return formatStartOf(value, start, len);

package/dist/es/device/index.d.ts

@@ -1,67 +1,73 @@
+/**
+ * @module 浏览器Device
+ */
 /**
  * 获取浏览器信息
  * @description 会获取到浏览器对应的名称以及版本
  * @returns {Object} 返回浏览器信息
  */
-export function getBrowserInfo(): Object;
+export declare function getBrowserInfo(): "unknown" | {
+    name: string;
+    version: string;
+};
 /**
  * 判断是pc端
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isPc(): boolean;
+export declare function isPc(): boolean;
 /**
  * 判断是手机端
  * @description 包含 android、iphone、黑莓手机、微软手机 等多种操作系统机型
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isPhone(): boolean;
+export declare function isPhone(): boolean;
 /**
  * 判断是 android
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isAndroid(): boolean;
+export declare function isAndroid(): boolean;
 /**
  * 判断是 ios
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isIos(): boolean;
+export declare function isIos(): boolean;
 /**
  * 判断是 windows phone
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isWindowsPhone(): boolean;
+export declare function isWindowsPhone(): boolean;
 /**
  * 判断是 windows
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isWindows(): boolean;
+export declare function isWindows(): boolean;
 /**
  * 判断是 linux
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isLinux(): boolean;
+export declare function isLinux(): boolean;
 /**
  * 判断是 Mac
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isMac(): boolean;
+export declare function isMac(): boolean;
 /**
  * 判断是iphone
- *@returns {Boolean} 返回true和false
+ *@returns {boolean} 返回true和false
  */
-export function isIphone(): boolean;
+export declare function isIphone(): boolean;
 /**
  * 判断是ipad
- *@return {Boolean} 返回true和false
+ *@return {boolean} 返回true和false
  */
-export function isIpad(): boolean;
+export declare function isIpad(): boolean;
 /**
  * 判断是微信内置浏览器
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isWeixin(): boolean;
+export declare function isWeixin(): boolean;
 /**
  * 判断是QQ内置浏览器
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isQQ(): boolean;
+export declare function isQQ(): boolean;

package/dist/es/device/index.mjs

@@ -1,3 +1,6 @@
+/**
+ * @module 浏览器Device
+ */
 /* 浏览器信息 */
 /**
  * 获取浏览器信息
@@ -5,19 +8,19 @@
  * @returns {Object} 返回浏览器信息
  */
 function getBrowserInfo() {
-    let ua = window.navigator.userAgent.toLowerCase();
+    const ua = window.navigator.userAgent.toLowerCase();
     // ie
-    let ie = ua.match(/rv:([\d.]+)\) like gecko/) || ua.match(/msie ([\d\.]+)/);
+    const ie = ua.match(/rv:([\d.]+)\) like gecko/) || ua.match(/msie ([\d\.]+)/);
     // edge
-    let edge = ua.match(/edg\/([\d\.]+)/);
+    const edge = ua.match(/edg\/([\d\.]+)/);
     // firefox
-    let firefox = ua.match(/firefox\/([\d\.]+)/);
+    const firefox = ua.match(/firefox\/([\d\.]+)/);
     // opera
-    let opera = ua.match(/(?:opera|opr).([\d\.]+)/);
+    const opera = ua.match(/(?:opera|opr).([\d\.]+)/);
     // chrome
-    let chrome = ua.match(/chrome\/([\d\.]+)/);
+    const chrome = ua.match(/chrome\/([\d\.]+)/);
     // safari
-    let safari = ua.match(/version\/([\d\.]+).*safari/);
+    const safari = ua.match(/version\/([\d\.]+).*safari/);
     // 判断类型
     if (ie)
         return { name: "ie", version: ie[1] };
@@ -36,7 +39,7 @@ function getBrowserInfo() {
 /* 设备类型 */
 /**
  * 判断是pc端
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isPc() {
     return !isPhone();
@@ -44,93 +47,93 @@ function isPc() {
 /**
  * 判断是手机端
  * @description 包含 android、iphone、黑莓手机、微软手机 等多种操作系统机型
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isPhone() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /Android|webOS|iPhone|iPod|BlackBerry|Windows Phone|IEMobile/i.test(ua);
 }
 /* 操作系统类型 */
 /**
  * 判断是 android
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isAndroid() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /Android|BlackBerry/i.test(ua);
 }
 /**
  * 判断是 ios
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isIos() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /iPhone|iPad|iPod|iOS/i.test(ua);
 }
 /**
  * 判断是 windows phone
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isWindowsPhone() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /Windows Phone/i.test(ua);
 }
 /**
  * 判断是 windows
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isWindows() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /win/i.test(ua);
 }
 /**
  * 判断是 linux
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isLinux() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /linux/i.test(ua);
 }
 /**
  * 判断是 Mac
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isMac() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /mac/i.test(ua);
 }
 /* 苹果设备类型 */
 /**
  * 判断是iphone
- *@returns {Boolean} 返回true和false
+ *@returns {boolean} 返回true和false
  */
 function isIphone() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /iPhone/i.test(ua);
 }
 /**
  * 判断是ipad
- *@return {Boolean} 返回true和false
+ *@return {boolean} 返回true和false
  */
 function isIpad() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /iPod/i.test(ua);
 }
 /* 手机浏览器类型 */
 /**
  * 判断是微信内置浏览器
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isWeixin() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /MicroMessenger/i.test(ua);
 }
 /**
  * 判断是QQ内置浏览器
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isQQ() {
-    let ua = window.navigator.userAgent;
+    const ua = window.navigator.userAgent;
     return /QQ/i.test(ua);
 }
 

package/dist/es/dom/index.d.ts

@@ -1,57 +1,60 @@
+/**
+ * @module 浏览器Dom
+ */
 /**
  * 判断元素包含某个类名
- * @param {Element} elem 元素
- * @param {String} className 类名
- * @return {Boolean} 返回true和false
+ * @param {HTMLElement} elem 元素
+ * @param {string} className 类名
+ * @return {boolean} 返回true和false
  */
-export function hasClass(elem: Element, className: string): boolean;
+export declare function hasClass(elem: HTMLElement, className: string): boolean;
 /**
  * 元素添加类名
- * @param {Element} elem 元素
- * @param {String} className 类名
+ * @param {HTMLElement} elem 元素
+ * @param {string} className 类名
  */
-export function addClass(elem: Element, className: string): void;
+export declare function addClass(elem: HTMLElement, className: string): void;
 /**
  * 元素删除类名
- * @param {Element} elem 元素
- * @param {String} className 类名
+ * @param {HTMLElement} elem 元素
+ * @param {string} className 类名
  */
-export function removeClass(elem: Element, className: string): void;
+export declare function removeClass(elem: HTMLElement, className: string): void;
 /**
  * 元素替换类名
- * @param {Element} elem 元素
- * @param {String} newClassName 新的类名
- * @param {String} oldClassName 被替换掉的旧类名
+ * @param {HTMLElement} elem 元素
+ * @param {string} newClassName 新的类名
+ * @param {string} oldClassName 被替换掉的旧类名
  */
-export function replaceClass(elem: Element, newClassName: string, oldClassName: string): void;
+export declare function replaceClass(elem: HTMLElement, newClassName: string, oldClassName: string): void;
 /**
  * 添加元素的style样式
- * @param {Element} elem 元素
+ * @param {HTMLElement} elem 元素
  * @param {Object} styles 样式属性集合
  */
-export function addStyle(elem: Element, styles?: Object): void;
+export declare function addStyle(elem: HTMLElement, styles?: Record<string, string>): void;
 /**
  * 获取元素的style样式
- * @param {Element} elem 元素
- * @param {String} name 属性
- * @returns {String} 返回样式的值
+ * @param {HTMLElement} elem 元素
+ * @param {string} name 属性
+ * @returns {string|undefined} 返回样式的值
  */
-export function getStyle(elem: Element, name: string): string;
+export declare function getStyle(elem: HTMLElement, name: string): string | undefined;
 /**
  * 删除元素的style样式
- * @param {Element} elem 元素
- * @param {String} name 属性
+ * @param {HTMLElement} elem 元素
+ * @param {string} name 属性
  */
-export function removeStyle(elem: Element, name: string): void;
+export declare function removeStyle(elem: HTMLElement, name: string): void;
 /**
  * html标签转义
- * @param {String} htmlStr html字符串
- * @returns {String} 返回转义后的字符串
+ * @param {string} htmlStr html字符串
+ * @returns {string} 返回转义后的字符串
  */
-export function htmlEncode(htmlStr: string): string;
+export declare function htmlEncode(htmlStr: string): string;
 /**
  * html标签解码
- * @param {String} htmlStr html字符串
- * @returns {String} 返回解析后的字符串
+ * @param {string} htmlStr html字符串
+ * @returns {string} 返回解析后的字符串
  */
-export function htmlDecode(htmlStr: string): string;
+export declare function htmlDecode(htmlStr: string): string;

package/dist/es/dom/index.mjs

@@ -1,17 +1,20 @@
+/**
+ * @module 浏览器Dom
+ */
 /* Class操作 */
 /**
  * 判断元素包含某个类名
- * @param {Element} elem 元素
- * @param {String} className 类名
- * @return {Boolean} 返回true和false
+ * @param {HTMLElement} elem 元素
+ * @param {string} className 类名
+ * @return {boolean} 返回true和false
  */
 function hasClass(elem, className) {
     return elem.className.indexOf(className) > 0;
 }
 /**
  * 元素添加类名
- * @param {Element} elem 元素
- * @param {String} className 类名
+ * @param {HTMLElement} elem 元素
+ * @param {string} className 类名
  */
 function addClass(elem, className) {
     if (!hasClass(elem, className)) {
@@ -20,8 +23,8 @@ function addClass(elem, className) {
 }
 /**
  * 元素删除类名
- * @param {Element} elem 元素
- * @param {String} className 类名
+ * @param {HTMLElement} elem 元素
+ * @param {string} className 类名
  */
 function removeClass(elem, className) {
     if (hasClass(elem, className)) {
@@ -30,9 +33,9 @@ function removeClass(elem, className) {
 }
 /**
  * 元素替换类名
- * @param {Element} elem 元素
- * @param {String} newClassName 新的类名
- * @param {String} oldClassName 被替换掉的旧类名
+ * @param {HTMLElement} elem 元素
+ * @param {string} newClassName 新的类名
+ * @param {string} oldClassName 被替换掉的旧类名
  */
 function replaceClass(elem, newClassName, oldClassName) {
     removeClass(elem, oldClassName);
@@ -41,31 +44,31 @@ function replaceClass(elem, newClassName, oldClassName) {
 /* Style操作 */
 /**
  * 添加元素的style样式
- * @param {Element} elem 元素
+ * @param {HTMLElement} elem 元素
  * @param {Object} styles 样式属性集合
  */
 function addStyle(elem, styles = {}) {
     if (!elem)
         return;
-    for (let key in styles) {
-        elem.style[key] = styles[key];
+    for (const [key, value] of Object.entries(styles)) {
+        elem.style.setProperty(key, value);
     }
 }
 /**
  * 获取元素的style样式
- * @param {Element} elem 元素
- * @param {String} name 属性
- * @returns {String} 返回样式的值
+ * @param {HTMLElement} elem 元素
+ * @param {string} name 属性
+ * @returns {string|undefined} 返回样式的值
  */
 function getStyle(elem, name) {
     if (!elem)
         return;
-    return elem.style[name];
+    return elem.style.getPropertyValue(name);
 }
 /**
  * 删除元素的style样式
- * @param {Element} elem 元素
- * @param {String} name 属性
+ * @param {HTMLElement} elem 元素
+ * @param {string} name 属性
  */
 function removeStyle(elem, name) {
     if (!elem)
@@ -75,8 +78,8 @@ function removeStyle(elem, name) {
 /* Html转码 */
 /**
  * html标签转义
- * @param {String} htmlStr html字符串
- * @returns {String} 返回转义后的字符串
+ * @param {string} htmlStr html字符串
+ * @returns {string} 返回转义后的字符串
  */
 function htmlEncode(htmlStr) {
     const temp = {
@@ -96,8 +99,8 @@ function htmlEncode(htmlStr) {
 }
 /**
  * html标签解码
- * @param {String} htmlStr html字符串
- * @returns {String} 返回解析后的字符串
+ * @param {string} htmlStr html字符串
+ * @returns {string} 返回解析后的字符串
  */
 function htmlDecode(htmlStr) {
     const temp = {