@whitesev/domutils 1.8.7 → 1.8.9

package/dist/types/src/ElementAnimate.d.ts

@@ -1,6 +1,6 @@
+import { ElementWait } from "./ElementWait";
 import type { DOMUtilsTargetElementType } from "./types/global";
 import type { WindowApiOption } from "./types/WindowApi";
-import { ElementWait } from "./ElementWait";
 import { WindowApi } from "./WindowApi";
 declare class ElementAnimate extends ElementWait {
     windowApi: typeof WindowApi.prototype;

package/dist/types/src/ElementWait.d.ts

@@ -48,7 +48,7 @@ declare class ElementWait extends ElementSelector {
      *  console.log($div); // $div => HTMLDivELement
      * })
      */
-    waitNode<K>(selectorFn: () => K | null | undefined): Promise<K>;
+    waitNode<K = HTMLElement>(selectorFn: () => K | null | undefined): Promise<K>;
     /**
      * 等待元素出现
      * @param selectorFn 获取元素的函数
@@ -58,7 +58,7 @@ declare class ElementWait extends ElementSelector {
      *  console.log($div); // $div => HTMLDivELement | null
      * })
      */
-    waitNode<K>(selectorFn: () => K | null | undefined, timeout: number): Promise<K | null | undefined>;
+    waitNode<K = HTMLElement>(selectorFn: () => K | null | undefined, timeout: number): Promise<K | null | undefined>;
     /**
      * 等待元素出现
      * @param selectorFn 获取元素的函数
@@ -72,7 +72,7 @@ declare class ElementWait extends ElementSelector {
      *  console.log($div); // $div => HTMLDivELement | null
      * })
      */
-    waitNode<K>(selectorFn: () => K | null | undefined, parent: Node | Element | Document | HTMLElement, timeout?: number): Promise<K | null | undefined>;
+    waitNode<K = HTMLElement>(selectorFn: () => K | null | undefined, parent: Node | Element | Document | HTMLElement, timeout?: number): Promise<K | null | undefined>;
     /**
      * 等待元素出现
      * @param selector CSS选择器
@@ -86,7 +86,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNode<K extends keyof HTMLElementTagNameMap>(selector: K, parent?: Node | Element | Document | HTMLElement): Promise<HTMLElementTagNameMap[K]>;
-    waitNode<T extends Element>(selector: string, parent?: Node | Element | Document | HTMLElement): Promise<T>;
+    waitNode<T extends Element = HTMLElement>(selector: string, parent?: Node | Element | Document | HTMLElement): Promise<T>;
     /**
      * 等待元素出现
      * @param selectorList CSS选择器数组
@@ -100,7 +100,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNode<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent?: Node | Element | Document | HTMLElement): Promise<HTMLElementTagNameMap[K][]>;
-    waitNode<T extends Element[]>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
+    waitNode<T extends Element[] = HTMLElement[]>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
     /**
      * 等待元素出现
      * @param selector CSS选择器
@@ -112,7 +112,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNode<K extends keyof HTMLElementTagNameMap>(selector: K, parent: Node | Element | Document | HTMLElement, timeout: number): Promise<HTMLElementTagNameMap[K] | null>;
-    waitNode<T extends Element>(selector: string, parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
+    waitNode<T extends Element = HTMLElement>(selector: string, parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
     /**
      * 等待元素出现
      * @param selectorList CSS选择器数组
@@ -124,7 +124,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNode<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<HTMLElementTagNameMap[K] | null>;
-    waitNode<T extends Element[]>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
+    waitNode<T extends Element[] = HTMLElement[]>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
     /**
      * 等待元素出现
      * @param selector CSS选择器
@@ -135,7 +135,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNode<K extends keyof HTMLElementTagNameMap>(selector: K, timeout: number): Promise<HTMLElementTagNameMap[K] | null>;
-    waitNode<T extends Element>(selector: string, timeout: number): Promise<T | null>;
+    waitNode<T extends Element = HTMLElement>(selector: string, timeout: number): Promise<T | null>;
     /**
      * 等待元素出现
      * @param selectorList CSS选择器数组
@@ -146,7 +146,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNode<K extends keyof HTMLElementTagNameMap>(selectorList: K[], timeout: number): Promise<HTMLElementTagNameMap[K] | null>;
-    waitNode<T extends Element[]>(selectorList: string[], timeout: number): Promise<T | null>;
+    waitNode<T extends Element[] = HTMLElement[]>(selectorList: string[], timeout: number): Promise<T | null>;
     /**
      * 等待任意元素出现
      * @param selectorList CSS选择器数组
@@ -160,7 +160,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitAnyNode<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent?: Node | Element | Document | HTMLElement): Promise<HTMLElementTagNameMap[K]>;
-    waitAnyNode<T extends Element>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
+    waitAnyNode<T extends Element = HTMLElement>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
     /**
      * 等待任意元素出现
      * @param selectorList CSS选择器数组
@@ -172,7 +172,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitAnyNode<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<HTMLElementTagNameMap[K] | null>;
-    waitAnyNode<T extends Element>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
+    waitAnyNode<T extends Element = HTMLElement>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
     /**
      * 等待任意元素出现
      * @param selectorList CSS选择器数组
@@ -183,7 +183,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitAnyNode<K extends keyof HTMLElementTagNameMap>(selectorList: K[], timeout: number): Promise<HTMLElementTagNameMap[K] | null>;
-    waitAnyNode<T extends Element>(selectorList: string[], timeout: number): Promise<T | null>;
+    waitAnyNode<T extends Element = HTMLElement>(selectorList: string[], timeout: number): Promise<T | null>;
     /**
      * 等待元素数组出现
      * @param selector CSS选择器
@@ -197,7 +197,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNodeList<T extends keyof HTMLElementTagNameMap>(selector: T, parent?: Node | Element | Document | HTMLElement): Promise<NodeListOf<HTMLElementTagNameMap[T]>>;
-    waitNodeList<T extends NodeListOf<Element>>(selector: string, parent?: Node | Element | Document | HTMLElement): Promise<T>;
+    waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(selector: string, parent?: Node | Element | Document | HTMLElement): Promise<T>;
     /**
      * 等待元素数组出现
      * @param selectorList CSS选择器数组
@@ -211,7 +211,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNodeList<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent?: Node | Element | Document | HTMLElement): Promise<NodeListOf<HTMLElementTagNameMap[K]>[]>;
-    waitNodeList<T extends NodeListOf<Element>[]>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
+    waitNodeList<T extends NodeListOf<Element>[] = NodeListOf<HTMLElement>[]>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
     /**
      * 等待元素数组出现
      * @param selector CSS选择器
@@ -222,7 +222,7 @@ declare class ElementWait extends ElementSelector {
      *  console.log($result); // $result => NodeListOf<HTMLDivElement> | null
      * })
      */
-    waitNodeList<T extends NodeListOf<Element>>(selector: string, parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
+    waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(selector: string, parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
     waitNodeList<K extends keyof HTMLElementTagNameMap>(selector: K, parent: Node | Element | Document | HTMLElement, timeout: number): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
     /**
      * 等待元素数组出现
@@ -235,7 +235,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNodeList<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<NodeListOf<HTMLElementTagNameMap[K]>[] | null>;
-    waitNodeList<T extends NodeListOf<Element>[]>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
+    waitNodeList<T extends NodeListOf<Element>[] = NodeListOf<HTMLElement>[]>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<T | null>;
     /**
      * 等待元素数组出现
      * @param selector CSS选择器数组
@@ -246,7 +246,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNodeList<K extends keyof HTMLElementTagNameMap>(selector: K[], timeout: number): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
-    waitNodeList<T extends NodeListOf<Element>>(selector: string[], timeout: number): Promise<T | null>;
+    waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(selector: string[], timeout: number): Promise<T | null>;
     /**
      * 等待元素数组出现
      * @param selectorList CSS选择器数组
@@ -257,7 +257,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitNodeList<K extends keyof HTMLElementTagNameMap>(selectorList: K[], timeout: number): Promise<NodeListOf<HTMLElementTagNameMap[K]>[] | null>;
-    waitNodeList<T extends NodeListOf<Element>>(selectorList: string[], timeout: number): Promise<T[] | null>;
+    waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(selectorList: string[], timeout: number): Promise<T[] | null>;
     /**
      * 等待任意元素数组出现
      * @param selectorList CSS选择器数组
@@ -271,7 +271,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitAnyNodeList<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent?: Node | Element | Document | HTMLElement): Promise<NodeListOf<HTMLElementTagNameMap[K]>>;
-    waitAnyNodeList<T extends Element>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<NodeListOf<T>>;
+    waitAnyNodeList<T extends Element = HTMLElement>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<NodeListOf<T>>;
     /**
      * 等待任意元素数组出现
      * @param selectorList CSS选择器数组
@@ -283,7 +283,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitAnyNodeList<K extends keyof HTMLElementTagNameMap>(selectorList: K[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
-    waitAnyNodeList<T extends Element>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<NodeListOf<T> | null>;
+    waitAnyNodeList<T extends Element = HTMLElement>(selectorList: string[], parent: Node | Element | Document | HTMLElement, timeout: number): Promise<NodeListOf<T> | null>;
     /**
      * 等待任意元素出现
      * @param selectorList CSS选择器数组
@@ -294,7 +294,7 @@ declare class ElementWait extends ElementSelector {
      * })
      */
     waitAnyNodeList<K extends keyof HTMLElementTagNameMap>(selectorList: K[], timeout: number): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
-    waitAnyNodeList<T extends Element>(selectorList: string[], timeout: number): Promise<NodeListOf<T> | null>;
+    waitAnyNodeList<T extends Element = HTMLElement>(selectorList: string[], timeout: number): Promise<NodeListOf<T> | null>;
 }
 declare const elementWait: ElementWait;
 export { elementWait, ElementWait };

package/dist/types/src/index.d.ts

@@ -1,8 +1,8 @@
-import type { DOMUtilsCreateElementAttributesMap } from "./types/DOMUtilsEvent";
-import { type DOMUtilsCSSProperty, type DOMUtilsCSSPropertyType } from "./types/DOMUtilsCSSProperty";
-import type { WindowApiOption } from "./types/WindowApi";
 import { ElementHandler } from "./ElementHandler";
+import { type DOMUtilsCSSProperty, type DOMUtilsCSSPropertyType } from "./types/DOMUtilsCSSProperty";
+import type { DOMUtilsCreateElementAttributesMap } from "./types/DOMUtilsEvent";
 import type { DOMUtilsTargetElementType } from "./types/global";
+import type { WindowApiOption } from "./types/WindowApi";
 declare class DOMUtils extends ElementHandler {
     constructor(option?: WindowApiOption);
     /** 版本号 */
@@ -304,43 +304,52 @@ declare class DOMUtils extends ElementHandler {
     /**
      * 函数在元素内部末尾添加子元素或HTML字符串
      * @param $el 目标元素
-     * @param content 子元素或HTML字符串
+     * @param args 子元素或HTML字符串
      * @example
      * // 元素a.xx的内部末尾添加一个元素
-     * DOMUtils.append(document.querySelector("a.xx"),document.querySelector("b.xx"))
-     * DOMUtils.append("a.xx","'<b class="xx"></b>")
+     * DOMUtils.append(document.querySelector("a.xx"), document.querySelector("b.xx"))
+     * DOMUtils.append("a.xx", "<b class="xx"></b>")
+     * DOMUtils.append(document, [document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx")])
+     * DOMUtils.append(document, document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx"))
      * */
-    append($el: DOMUtilsTargetElementType | DocumentFragment, content: HTMLElement | string | (HTMLElement | string | Element)[] | NodeList): void;
+    append($el: DOMUtilsTargetElementType | DocumentFragment, ...args: (HTMLElement | string | (HTMLElement | string | Element)[] | NodeList)[]): void;
     /**
      * 函数 在元素内部开头添加子元素或HTML字符串
      * @param $el 目标元素
-     * @param content 子元素或HTML字符串
+     * @param args 子元素或HTML字符串
      * @example
      * // 元素a.xx内部开头添加一个元素
      * DOMUtils.prepend(document.querySelector("a.xx"),document.querySelector("b.xx"))
      * DOMUtils.prepend("a.xx","'<b class="xx"></b>")
+     * DOMUtils.prepend(document, [document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx")])
+     * DOMUtils.prepend(document, document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx"))
      * */
-    prepend($el: DOMUtilsTargetElementType | DocumentFragment, content: HTMLElement | string): void;
+    prepend($el: DOMUtilsTargetElementType | DocumentFragment, ...args: (HTMLElement | string | (HTMLElement | string | Element)[] | NodeList)[]): void;
     /**
      * 在元素后面添加兄弟元素或HTML字符串
      * @param $el 目标元素
-     * @param content 兄弟元素或HTML字符串
+     * @param args 兄弟元素或HTML字符串
      * @example
      * // 元素a.xx后面添加一个元素
      * DOMUtils.after(document.querySelector("a.xx"),document.querySelector("b.xx"))
      * DOMUtils.after("a.xx","'<b class="xx"></b>")
+     * DOMUtils.after(document, [document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx")])
+     * DOMUtils.after(document, document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx"))
      * */
-    after($el: DOMUtilsTargetElementType, content: HTMLElement | string): void;
+    after($el: DOMUtilsTargetElementType, ...args: (HTMLElement | string | (HTMLElement | string | Element)[] | NodeList)[]): void;
     /**
      * 在元素前面添加兄弟元素或HTML字符串
      * @param $el 目标元素
-     * @param content 兄弟元素或HTML字符串
+     * @param args 兄弟元素或HTML字符串
      * @example
      * // 元素a.xx前面添加一个元素
      * DOMUtils.before(document.querySelector("a.xx"),document.querySelector("b.xx"))
      * DOMUtils.before("a.xx","'<b class="xx"></b>")
+     * DOMUtils.before(document, [document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx")])
+     * DOMUtils.before(document, document.querySelector("b.xx"), document.querySelector("c.xx"), document.querySelector("d.xx"))
+     *
      * */
-    before($el: DOMUtilsTargetElementType, content: HTMLElement | string): void;
+    before($el: DOMUtilsTargetElementType, ...args: (HTMLElement | string | (HTMLElement | string | Element)[] | NodeList)[]): void;
     /**
      * 移除元素
      * @param $el 目标元素，可以是数组、单个元素、NodeList、元素选择器
@@ -352,7 +361,7 @@ declare class DOMUtils extends ElementHandler {
      * */
     remove($el: DOMUtilsTargetElementType | Element): void;
     /**
-     * 移除元素的所有子元素
+     * 移除元素内所有的子元素
      * @param $el 目标元素
      * @example
      * // 移除元素a.xx元素的所有子元素

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@whitesev/domutils",
-  "version": "1.8.7",
+  "version": "1.8.9",
   "type": "module",
   "description": "适合在浏览器中操作DOM的常用工具类",
   "main": "dist/index.cjs.js",
@@ -58,7 +58,7 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier . --write",
-    "dev": "pnpm run format && pnpm run lint && rollup -c -w",
+    "dev": "vue-tsc --noEmit && vite --force",
     "build": "pnpm run format && pnpm run lint && rollup -c"
   }
 }

package/src/CommonUtils.ts

@@ -1,10 +1,4 @@
 import { WindowApi } from "./WindowApi";
-import {
-  clearInterval as WorkerClearInterval,
-  clearTimeout as WorkerClearTimeout,
-  setInterval as WorkerSetInterval,
-  setTimeout as WorkerSetTimeout,
-} from "worker-timers";
 
 /** 通用工具类 */
 export const CommonUtils = {
@@ -151,54 +145,6 @@ export const CommonUtils = {
       delete target[propName];
     }
   },
-  /**
-   * 自动使用 Worker 执行 setTimeout
-   */
-  setTimeout(callback: (...args: any[]) => any, timeout: number = 0) {
-    try {
-      return WorkerSetTimeout(callback, timeout);
-    } catch {
-      return this.windowApi.setTimeout(callback, timeout);
-    }
-  },
-  /**
-   * 配合 .setTimeout 使用
-   */
-  clearTimeout(timeId: number | undefined) {
-    try {
-      if (timeId != null) {
-        WorkerClearTimeout(timeId);
-      }
-    } catch {
-      // TODO
-    } finally {
-      this.windowApi.clearTimeout(timeId);
-    }
-  },
-  /**
-   * 自动使用 Worker 执行 setInterval
-   */
-  setInterval(callback: (...args: any[]) => any, timeout: number = 0) {
-    try {
-      return WorkerSetInterval(callback, timeout);
-    } catch {
-      return this.windowApi.setInterval(callback, timeout);
-    }
-  },
-  /**
-   * 配合 .setInterval 使用
-   */
-  clearInterval(timeId: number | undefined) {
-    try {
-      if (timeId != null) {
-        WorkerClearInterval(timeId);
-      }
-    } catch {
-      // TODO
-    } finally {
-      this.windowApi.clearInterval(timeId);
-    }
-  },
   /**
    * 判断是否是元素列表
    * @param $ele

package/src/ElementAnimate.ts

@@ -1,8 +1,8 @@
 import { CommonUtils } from "./CommonUtils";
 import { elementSelector } from "./ElementSelector";
+import { ElementWait } from "./ElementWait";
 import type { DOMUtilsTargetElementType } from "./types/global";
 import type { WindowApiOption } from "./types/WindowApi";
-import { ElementWait } from "./ElementWait";
 import { WindowApi } from "./WindowApi";
 
 class ElementAnimate extends ElementWait {
@@ -66,7 +66,7 @@ class ElementAnimate extends ElementWait {
       from[prop] = element.style[prop] || context.windowApi.globalThis.getComputedStyle(element)[prop];
       to[prop] = styles[prop];
     }
-    const timer = CommonUtils.setInterval(function () {
+    const timer = setInterval(function () {
       const timePassed = performance.now() - start;
       let progress = timePassed / duration;
       if (progress > 1) {
@@ -76,7 +76,7 @@ class ElementAnimate extends ElementWait {
         element.style[prop] = from[prop] + (to[prop] - from[prop]) * progress + "px";
       }
       if (progress === 1) {
-        CommonUtils.clearInterval(timer);
+        clearInterval(timer);
         if (callback) {
           callback();
         }

package/src/ElementEvent.ts

@@ -743,7 +743,7 @@ class ElementEvent extends ElementAnimate {
     function check() {
       if (checkDOMReadyState()) {
         /* 检查document状态 */
-        CommonUtils.setTimeout(completed, 0);
+        setTimeout(completed, 0);
       } else {
         /* 添加监听 */
         addDomReadyListener();
@@ -1440,7 +1440,7 @@ class ElementEvent extends ElementAnimate {
         if (evt.pointerType === "touch") {
           isMobileTouch = true;
         }
-        CommonUtils.clearTimeout(timer);
+        clearTimeout(timer);
         timer = void 0;
         if (isDoubleClick && $click === selectorTarget) {
           isDoubleClick = false;
@@ -1450,7 +1450,7 @@ class ElementEvent extends ElementAnimate {
             isDoubleClick: true,
           });
         } else {
-          timer = CommonUtils.setTimeout(() => {
+          timer = setTimeout(() => {
             isDoubleClick = false;
             // 判断为单击
             dblclick_handler(evt, {

package/src/ElementWait.ts

@@ -1,4 +1,3 @@
-import { CommonUtils } from "./CommonUtils";
 import { ElementSelector, elementSelector } from "./ElementSelector";
 import type { WindowApiOption } from "./types/WindowApi";
 import { utils } from "./Utils";
@@ -90,7 +89,7 @@ class ElementWait extends ElementSelector {
         },
       });
       if (__timeout__ > 0) {
-        CommonUtils.setTimeout(() => {
+        setTimeout(() => {
           // 取消观察器
           if (typeof observer?.disconnect === "function") {
             observer.disconnect();
@@ -108,7 +107,7 @@ class ElementWait extends ElementSelector {
    *  console.log($div); // $div => HTMLDivELement
    * })
    */
-  waitNode<K>(selectorFn: () => K | null | undefined): Promise<K>;
+  waitNode<K = HTMLElement>(selectorFn: () => K | null | undefined): Promise<K>;
   /**
    * 等待元素出现
    * @param selectorFn 获取元素的函数
@@ -118,7 +117,7 @@ class ElementWait extends ElementSelector {
    *  console.log($div); // $div => HTMLDivELement | null
    * })
    */
-  waitNode<K>(selectorFn: () => K | null | undefined, timeout: number): Promise<K | null | undefined>;
+  waitNode<K = HTMLElement>(selectorFn: () => K | null | undefined, timeout: number): Promise<K | null | undefined>;
   /**
    * 等待元素出现
    * @param selectorFn 获取元素的函数
@@ -132,7 +131,7 @@ class ElementWait extends ElementSelector {
    *  console.log($div); // $div => HTMLDivELement | null
    * })
    */
-  waitNode<K>(
+  waitNode<K = HTMLElement>(
     selectorFn: () => K | null | undefined,
     parent: Node | Element | Document | HTMLElement,
     timeout?: number
@@ -153,7 +152,10 @@ class ElementWait extends ElementSelector {
     selector: K,
     parent?: Node | Element | Document | HTMLElement
   ): Promise<HTMLElementTagNameMap[K]>;
-  waitNode<T extends Element>(selector: string, parent?: Node | Element | Document | HTMLElement): Promise<T>;
+  waitNode<T extends Element = HTMLElement>(
+    selector: string,
+    parent?: Node | Element | Document | HTMLElement
+  ): Promise<T>;
   /**
    * 等待元素出现
    * @param selectorList CSS选择器数组
@@ -170,7 +172,10 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     parent?: Node | Element | Document | HTMLElement
   ): Promise<HTMLElementTagNameMap[K][]>;
-  waitNode<T extends Element[]>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
+  waitNode<T extends Element[] = HTMLElement[]>(
+    selectorList: string[],
+    parent?: Node | Element | Document | HTMLElement
+  ): Promise<T>;
   /**
    * 等待元素出现
    * @param selector CSS选择器
@@ -186,7 +191,7 @@ class ElementWait extends ElementSelector {
     parent: Node | Element | Document | HTMLElement,
     timeout: number
   ): Promise<HTMLElementTagNameMap[K] | null>;
-  waitNode<T extends Element>(
+  waitNode<T extends Element = HTMLElement>(
     selector: string,
     parent: Node | Element | Document | HTMLElement,
     timeout: number
@@ -206,7 +211,7 @@ class ElementWait extends ElementSelector {
     parent: Node | Element | Document | HTMLElement,
     timeout: number
   ): Promise<HTMLElementTagNameMap[K] | null>;
-  waitNode<T extends Element[]>(
+  waitNode<T extends Element[] = HTMLElement[]>(
     selectorList: string[],
     parent: Node | Element | Document | HTMLElement,
     timeout: number
@@ -224,7 +229,7 @@ class ElementWait extends ElementSelector {
     selector: K,
     timeout: number
   ): Promise<HTMLElementTagNameMap[K] | null>;
-  waitNode<T extends Element>(selector: string, timeout: number): Promise<T | null>;
+  waitNode<T extends Element = HTMLElement>(selector: string, timeout: number): Promise<T | null>;
   /**
    * 等待元素出现
    * @param selectorList CSS选择器数组
@@ -238,7 +243,7 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     timeout: number
   ): Promise<HTMLElementTagNameMap[K] | null>;
-  waitNode<T extends Element[]>(selectorList: string[], timeout: number): Promise<T | null>;
+  waitNode<T extends Element[] = HTMLElement[]>(selectorList: string[], timeout: number): Promise<T | null>;
   waitNode<T extends Element | Element[]>(...args: any[]): Promise<T | null> {
     // 过滤掉undefined
     args = args.filter((arg) => arg !== void 0);
@@ -337,7 +342,10 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     parent?: Node | Element | Document | HTMLElement
   ): Promise<HTMLElementTagNameMap[K]>;
-  waitAnyNode<T extends Element>(selectorList: string[], parent?: Node | Element | Document | HTMLElement): Promise<T>;
+  waitAnyNode<T extends Element = HTMLElement>(
+    selectorList: string[],
+    parent?: Node | Element | Document | HTMLElement
+  ): Promise<T>;
   /**
    * 等待任意元素出现
    * @param selectorList CSS选择器数组
@@ -353,7 +361,7 @@ class ElementWait extends ElementSelector {
     parent: Node | Element | Document | HTMLElement,
     timeout: number
   ): Promise<HTMLElementTagNameMap[K] | null>;
-  waitAnyNode<T extends Element>(
+  waitAnyNode<T extends Element = HTMLElement>(
     selectorList: string[],
     parent: Node | Element | Document | HTMLElement,
     timeout: number
@@ -371,8 +379,8 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     timeout: number
   ): Promise<HTMLElementTagNameMap[K] | null>;
-  waitAnyNode<T extends Element>(selectorList: string[], timeout: number): Promise<T | null>;
-  waitAnyNode<T extends Element>(...args: any[]): Promise<T | null> {
+  waitAnyNode<T extends Element = HTMLElement>(selectorList: string[], timeout: number): Promise<T | null>;
+  waitAnyNode<T extends Element = HTMLElement>(...args: any[]): Promise<T | null> {
     // 过滤掉undefined
     args = args.filter((arg) => arg !== void 0);
     const UtilsContext = this;
@@ -438,7 +446,7 @@ class ElementWait extends ElementSelector {
     selector: T,
     parent?: Node | Element | Document | HTMLElement
   ): Promise<NodeListOf<HTMLElementTagNameMap[T]>>;
-  waitNodeList<T extends NodeListOf<Element>>(
+  waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(
     selector: string,
     parent?: Node | Element | Document | HTMLElement
   ): Promise<T>;
@@ -458,7 +466,7 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     parent?: Node | Element | Document | HTMLElement
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]>[]>;
-  waitNodeList<T extends NodeListOf<Element>[]>(
+  waitNodeList<T extends NodeListOf<Element>[] = NodeListOf<HTMLElement>[]>(
     selectorList: string[],
     parent?: Node | Element | Document | HTMLElement
   ): Promise<T>;
@@ -472,7 +480,7 @@ class ElementWait extends ElementSelector {
    *  console.log($result); // $result => NodeListOf<HTMLDivElement> | null
    * })
    */
-  waitNodeList<T extends NodeListOf<Element>>(
+  waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(
     selector: string,
     parent: Node | Element | Document | HTMLElement,
     timeout: number
@@ -497,7 +505,7 @@ class ElementWait extends ElementSelector {
     parent: Node | Element | Document | HTMLElement,
     timeout: number
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]>[] | null>;
-  waitNodeList<T extends NodeListOf<Element>[]>(
+  waitNodeList<T extends NodeListOf<Element>[] = NodeListOf<HTMLElement>[]>(
     selectorList: string[],
     parent: Node | Element | Document | HTMLElement,
     timeout: number
@@ -515,7 +523,10 @@ class ElementWait extends ElementSelector {
     selector: K[],
     timeout: number
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
-  waitNodeList<T extends NodeListOf<Element>>(selector: string[], timeout: number): Promise<T | null>;
+  waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(
+    selector: string[],
+    timeout: number
+  ): Promise<T | null>;
   /**
    * 等待元素数组出现
    * @param selectorList CSS选择器数组
@@ -529,7 +540,10 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     timeout: number
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]>[] | null>;
-  waitNodeList<T extends NodeListOf<Element>>(selectorList: string[], timeout: number): Promise<T[] | null>;
+  waitNodeList<T extends NodeListOf<Element> = NodeListOf<HTMLElement>>(
+    selectorList: string[],
+    timeout: number
+  ): Promise<T[] | null>;
   waitNodeList<T extends NodeListOf<Element> | NodeListOf<Element>[]>(...args: any[]): Promise<T | null> {
     // 过滤掉undefined
     args = args.filter((arg) => arg !== void 0);
@@ -629,7 +643,7 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     parent?: Node | Element | Document | HTMLElement
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]>>;
-  waitAnyNodeList<T extends Element>(
+  waitAnyNodeList<T extends Element = HTMLElement>(
     selectorList: string[],
     parent?: Node | Element | Document | HTMLElement
   ): Promise<NodeListOf<T>>;
@@ -648,7 +662,7 @@ class ElementWait extends ElementSelector {
     parent: Node | Element | Document | HTMLElement,
     timeout: number
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
-  waitAnyNodeList<T extends Element>(
+  waitAnyNodeList<T extends Element = HTMLElement>(
     selectorList: string[],
     parent: Node | Element | Document | HTMLElement,
     timeout: number
@@ -666,8 +680,11 @@ class ElementWait extends ElementSelector {
     selectorList: K[],
     timeout: number
   ): Promise<NodeListOf<HTMLElementTagNameMap[K]> | null>;
-  waitAnyNodeList<T extends Element>(selectorList: string[], timeout: number): Promise<NodeListOf<T> | null>;
-  waitAnyNodeList<T extends Element>(...args: any[]): Promise<NodeListOf<T> | null> {
+  waitAnyNodeList<T extends Element = HTMLElement>(
+    selectorList: string[],
+    timeout: number
+  ): Promise<NodeListOf<T> | null>;
+  waitAnyNodeList<T extends Element = HTMLElement>(...args: any[]): Promise<NodeListOf<T> | null> {
     // 过滤掉undefined
     args = args.filter((arg) => arg !== void 0);
     const UtilsContext = this;