ph-utils 0.0.12 → 0.1.1

package/lib/date.d.ts

@@ -17,3 +17,18 @@ export declare function parse(date?: Date | string | number): Date;
  * @param {Boolean} isEnd true则为 endOf
  */
 export declare function startOf(date?: Date | string | number, unit?: string, isEnd?: boolean): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date 指定的日期
+ * @param num  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit 需要添加的单位，date - 加减天数
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date    指定的日期, 传递为 null ，则表示为当前日期
+ * @param num     需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit    需要添加的单位，date - 加减天数
+ * @param fmt     如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string, fmt: string): string;

package/lib/date.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startOf = exports.parse = exports.format = void 0;
+exports.add = exports.startOf = exports.parse = exports.format = void 0;
 /**
  * node 和 web 端日期处理工具类
  */
@@ -21,6 +21,9 @@ function p(s, l = 2) {
      */
     return ('000' + s).slice(l * -1);
 }
+function getUnit(unit) {
+    return unit.substring(0, 1).toUpperCase() + unit.substring(1);
+}
 /**
  * 将日期格式化为指定形式的字符串
  * @param date      日期
@@ -88,9 +91,36 @@ function startOf(date, unit, isEnd = false) {
     const argumentStart = [0, 0, 0, 0];
     const argumentEnd = [23, 59, 59, 999];
     date = parse(date);
-    let fn = 'set' + unit || 'Hours';
+    let u = getUnit(unit || 'Hours');
+    let fn = 'set' + u;
     let args = isEnd === true ? argumentEnd : argumentStart;
     Date.prototype[fn].apply(date, args);
     return date;
 }
 exports.startOf = startOf;
+/**
+ * 日期加上指定时间后的日期
+ * @param date {Date | number | string | null}  指定的日期
+ * @param num {number}  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit {string}  需要添加的单位，date - 加减天数
+ * @param fmt {string}   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ * @returns {Date | string} 如果传递了 fmt 参数，则返回 string，否则返回 Date
+ */
+function add(date, num, unit, fmt) {
+    let sdate = new Date();
+    if (date != null) {
+        sdate = parse(date);
+    }
+    unit = getUnit(unit);
+    let fn = 'set' + unit;
+    let gn = 'get' + unit;
+    let oldValue = Date.prototype[gn].apply(sdate);
+    Date.prototype[fn].apply(sdate, [oldValue + num]);
+    if (typeof fmt === 'string') {
+        return format(sdate, fmt);
+    }
+    else {
+        return sdate;
+    }
+}
+exports.add = add;

package/lib/date_m.d.ts

@@ -17,3 +17,18 @@ export declare function parse(date?: Date | string | number): Date;
  * @param {Boolean} isEnd true则为 endOf
  */
 export declare function startOf(date?: Date | string | number, unit?: string, isEnd?: boolean): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date 指定的日期
+ * @param num  需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit 需要添加的单位，date - 加减天数
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string): Date;
+/**
+ * 日期加上指定时间后的日期
+ * @param date    指定的日期, 传递为 null ，则表示为当前日期
+ * @param num     需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit    需要添加的单位，date - 加减天数
+ * @param fmt     如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ */
+export declare function add(date: Date | string | number | null, num: number, unit: string, fmt: string): string;

package/lib/date_m.js

@@ -18,6 +18,9 @@ function p(s, l = 2) {
      */
     return ('000' + s).slice(l * -1);
 }
+function getUnit(unit) {
+    return unit.substring(0, 1).toUpperCase() + unit.substring(1);
+}
 /**
  * 将日期格式化为指定形式的字符串
  * @param date      日期
@@ -83,8 +86,34 @@ export function startOf(date, unit, isEnd = false) {
     const argumentStart = [0, 0, 0, 0];
     const argumentEnd = [23, 59, 59, 999];
     date = parse(date);
-    let fn = 'set' + unit || 'Hours';
+    let u = getUnit(unit || 'Hours');
+    let fn = 'set' + u;
     let args = isEnd === true ? argumentEnd : argumentStart;
     Date.prototype[fn].apply(date, args);
     return date;
 }
+/**
+ * 日期加上指定时间后的日期
+ * @param date  指定的日期
+ * @param num   需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
+ * @param unit  需要添加的单位，date - 加减天数
+ * @param fmt   可选参数，如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ * @returns {Date | string} 如果传递了 fmt 参数，则返回 string，否则返回 Date
+ */
+export function add(date, num, unit, fmt) {
+    let sdate = new Date();
+    if (date != null) {
+        sdate = parse(date);
+    }
+    unit = getUnit(unit);
+    let fn = 'set' + unit;
+    let gn = 'get' + unit;
+    let oldValue = Date.prototype[gn].apply(sdate);
+    Date.prototype[fn].apply(sdate, [oldValue + num]);
+    if (typeof fmt === 'string') {
+        return format(sdate, fmt);
+    }
+    else {
+        return sdate;
+    }
+}

package/lib/dom.d.ts

@@ -35,3 +35,31 @@ export declare function transform(element: HTMLElement, value: string): void;
  * @param {boolean}     once      是否是只运行一次的处理函数
  */
 export declare function on(element: HTMLElement, listener: string, event: (e?: Event) => void, once?: boolean): void;
+/**
+ * 设置或获取节点的 innerHTML 属性
+ * @param element
+ * @param htmlstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export declare function html(element: HTMLElement, htmlstr?: string): string;
+/**
+ * 设置或获取节点的 textContent 属性
+ * @param element
+ * @param textstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export declare function text(element: HTMLElement, textstr?: string): string;
+/**
+ * 节点列表遍历
+ * @param elems
+ * @param fn 遍历到节点时的回调，回调第一个参数为遍历到的节点，第2个参数为 index；如果回调函数返回 true，则会终止遍历(break)
+ */
+export declare function iterate(elems: NodeList, fn: (el: HTMLElement, index: number) => any): void;
+/**
+ * 设置或获取节点 data-* 属性
+ * @param elem
+ * @param key data- 后面跟随的值
+ * @param value 如果传递该值表示获取；否则表示设置
+ * @returns
+ */
+export declare function attr(elem: HTMLElement, key: string, value?: string): string;

package/lib/dom.js

@@ -59,3 +59,61 @@ export function transform(element, value) {
 export function on(element, listener, event, once = false) {
     element.addEventListener(listener, event, { once });
 }
+/**
+ * 设置或获取节点的 innerHTML 属性
+ * @param element
+ * @param htmlstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export function html(element, htmlstr) {
+    if (htmlstr == null) {
+        return element.innerHTML;
+    }
+    else {
+        element.innerHTML = htmlstr;
+        return undefined;
+    }
+}
+/**
+ * 设置或获取节点的 textContent 属性
+ * @param element
+ * @param textstr 可选，如果传递该参数，则表示设置；否则表示获取
+ * @returns
+ */
+export function text(element, textstr) {
+    if (textstr == null) {
+        return element.textContent;
+    }
+    else {
+        element.textContent = textstr;
+        return undefined;
+    }
+}
+/**
+ * 节点列表遍历
+ * @param elems
+ * @param fn 遍历到节点时的回调，回调第一个参数为遍历到的节点，第2个参数为 index；如果回调函数返回 true，则会终止遍历(break)
+ */
+export function iterate(elems, fn) {
+    for (let i = 0, len = elems.length; i < len; i++) {
+        let r = fn(elems[i], i);
+        if (r === true) {
+            break;
+        }
+    }
+}
+/**
+ * 设置或获取节点 data-* 属性
+ * @param elem
+ * @param key data- 后面跟随的值
+ * @param value 如果传递该值表示获取；否则表示设置
+ * @returns
+ */
+export function attr(elem, key, value) {
+    if (value != null) {
+        elem.setAttribute('data-' + key, value);
+    }
+    else {
+        return elem.getAttribute('data-' + key);
+    }
+}

package/lib/index.js

@@ -60,6 +60,11 @@ exports.isBoolean = isBoolean;
  * 带有错误名称标记的错误类型
  */
 class BaseError extends Error {
+    /**
+     * 错误名称，类似于 Java 中的不同的 Exception[NullPointerException]；
+     * 增加 name 字段，表明不同的错误，当需要根据不同的错误执行不同的处理的时候，会很有用
+     */
+    name;
     constructor() {
         if (arguments.length === 1) {
             super(arguments[0]);

package/lib/web.d.ts

@@ -3,13 +3,15 @@
  * @param form {object} Form 节点对象
  */
 export declare const formJson: <T>(form: HTMLFormElement) => T;
+interface QueryRes {
+    [index: string]: number | boolean | string | string[];
+}
 /**
  * 获取 url query 参数 (get 请求的参数)
- * @param key 获取指定 key 的参数，可选，如果不传该参数，则返回解析到的所有的参数列表
  * @param search 如果是 React 应用就需要传递 useLocation().search
  * @returns
  */
-export declare function query(key?: string | string[], search?: string | string[]): unknown;
+export declare function query(search?: string): QueryRes;
 interface RandomOpts {
     /** 生成的随机数是整形还是小数形 */
     isInt?: boolean;

package/lib/web.js

@@ -30,54 +30,39 @@ export const formJson = function (form) {
 };
 /**
  * 获取 url query 参数 (get 请求的参数)
- * @param key 获取指定 key 的参数，可选，如果不传该参数，则返回解析到的所有的参数列表
  * @param search 如果是 React 应用就需要传递 useLocation().search
  * @returns
  */
-export function query(key, search) {
+export function query(search) {
     if (isBlank(search)) {
         search = location.search;
     }
     let query = {};
-    if (search.indexOf('?') !== -1) {
-        search = search.substring(1).split('&');
-        search.forEach((item) => {
-            item = item.split('=');
-            let oldValue = query[item[0]];
-            let value = decodeURIComponent(item[1]);
-            if (isBoolean(value)) {
-                // boolean
-                value = Boolean(value);
-            }
-            else if (isNumeric(value)) {
-                // 数字
-                value = Number(value);
+    /*
+      使用正则表达式解析，主要利用 反向字符集
+    */
+    search.replace(/([^?&=]+)=([^&]+)/g, (_, k, v) => {
+        let oldValue = query[k];
+        let value = decodeURIComponent(v);
+        if (isBoolean(value)) {
+            value = Boolean(value);
+        }
+        else if (isNumeric(value)) {
+            value = Number(value);
+        }
+        if (oldValue != null) {
+            if (oldValue instanceof Array) {
+                oldValue.push(value);
+                value = oldValue;
             }
-            if (oldValue != null) {
-                if (oldValue instanceof Array) {
-                    oldValue.push(value);
-                    value = oldValue;
-                }
-                else {
-                    value = [oldValue, value];
-                }
+            else {
+                value = [value, oldValue];
             }
-            query[item[0]] = value;
-        });
-    }
-    if (key == null) {
-        return query;
-    }
-    else if (typeof key === 'string') {
-        return query[key];
-    }
-    else {
-        const res = {};
-        key.forEach((ki) => {
-            res[ki] = query[ki];
-        });
-        return res;
-    }
+        }
+        query[k] = value;
+        return v;
+    });
+    return query;
 }
 export function random() {
     let r = Math.random();

package/package.json

@@ -5,7 +5,7 @@
   "module": "lib/index_m.js",
   "types": "lib/index.d.ts",
   "browser": "lib/index_m.js",
-  "version": "0.0.12",
+  "version": "0.1.1",
   "repository": {
     "type": "git",
     "url": "git+https//gitee.com/towardly/ph.git",
@@ -19,7 +19,7 @@
   "homepage": "https://gitee.com/towardly/ph/tree/master/packages/utils",
   "devDependencies": {
     "@types/node": "^15.0.3",
-    "typescript": "^4.2.4"
+    "typescript": "^4.4.4"
   },
   "scripts": {
     "build": "node scripts/build.js"