ectrol 0.0.2 → 0.0.4

package/dist/index.d.mts

@@ -88,9 +88,16 @@ declare class ElementHandle {
    * 填充输入框内容。
    * - 适用于 `<input>`、`<textarea>` 或 `contenteditable` 元素。
    * - 会触发 `input` 事件（冒泡）。
+   * - 支持自定义输入间隔, 'auto' 表示模拟自然输入节奏
+   * @example
+   * ```
+   * await element.fill('Hello, World!', { interval: 100 });
+   * ```
    */
   fill(value: string, options?: {
     timeout?: number;
+    interval?: number | 'auto';
+    append?: boolean;
   }): Promise<void>;
   /**
    * 在元素上发送按键事件。
@@ -119,6 +126,74 @@ declare class ElementHandle {
    * - 返回扩展的 DOMRect 信息并包含元素中心点坐标。
    */
   getBoundingClientRect(timeout?: number): Promise<IBoundingClientRect | null>;
+  /**
+   * 选择下拉框选项。
+   * @param value 选项的值
+   * @returns
+   */
+  selectOption(value: string): Promise<any>;
+  /**
+   * 获取元素的 HTML 内容。
+   */
+  innerHTML(): Promise<any>;
+  /**
+   * 获取元素的文本内容。
+   */
+  innerText(): Promise<any>;
+  /**
+   * 获取元素的文本内容。
+   * @returns 元素的文本内容
+   */
+  textContent(): Promise<any>;
+  /**
+   * 获取元素的输入值。
+   * @returns 元素的输入值
+   */
+  inputValue(): Promise<any>;
+  /**
+   * 获取元素的选中状态。
+   * @returns 元素的选中状态
+   */
+  isChecked(): Promise<any>;
+  /**
+   * 获取元素的禁用状态。
+   * @returns 元素的禁用状态
+   */
+  isDisabled(): Promise<any>;
+  /**
+   * 获取元素的可见状态。
+   * @returns 元素的可见状态
+   */
+  isVisible(): Promise<any>;
+  /**
+   * 获取元素的可用状态。
+   * @returns 元素的可用状态
+   */
+  isEnabled(): Promise<any>;
+  /**
+   * 获取元素的可编辑状态。
+   * @returns 元素的可编辑状态
+   */
+  isEditable(): Promise<any>;
+  /**
+   * 获取元素的隐藏状态。
+   * @returns 元素的隐藏状态
+   */
+  isHidden(): Promise<any>;
+  /**
+   * 选中元素的文本内容。
+   */
+  selectText(options: {
+    timeout?: number;
+  }): Promise<any>;
+  /**
+   * 取消选中复选框或单选框。
+   * @param options 选项
+   * @returns
+   */
+  uncheck(options?: {
+    timeout?: number;
+  }): Promise<any>;
 }
 //#endregion
 //#region src/localStorage.d.ts
@@ -169,6 +244,10 @@ declare class SessionStorage {
   removeItem(key: string): Promise<void>;
 }
 //#endregion
+//#region src/utils.d.ts
+declare function getHumanTypingDelay(index: number, text: string): number;
+declare function sleep(ms: number): Promise<unknown>;
+//#endregion
 //#region src/index.d.ts
 /**
  * Ectrol
@@ -193,4 +272,4 @@ declare class Ectrol {
   $(selector: string): ElementHandle;
 }
 //#endregion
-export { Ectrol, Ectrol as default, ElementHandle, IBoundingClientRect, ISize, IVector2D, LocalStorage, SessionStorage };
+export { Ectrol, Ectrol as default, ElementHandle, IBoundingClientRect, ISize, IVector2D, LocalStorage, SessionStorage, getHumanTypingDelay, sleep };

package/dist/index.mjs

@@ -1,3 +1,20 @@
+//#region src/utils.ts
+function getHumanTypingDelay(index, text) {
+	const char = text[index];
+	let delay = 90 + Math.random() * 60;
+	const progress = index / text.length;
+	if (progress < .15) delay *= 1.3;
+	else if (progress > .85) delay *= 1.25;
+	if (char === " ") delay += 40;
+	if (/[,.!?;:]/.test(char)) delay += 200 + Math.random() * 150;
+	if (Math.random() < .03) delay += 300 + Math.random() * 500;
+	return Math.max(40, Math.round(delay));
+}
+async function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+//#endregion
 //#region src/element.ts
 /**
 * ElementHandle
@@ -147,7 +164,7 @@ var ElementHandle = class {
 				button: options?.button || "left",
 				clickCount: 1
 			});
-			await new Promise((resolve) => setTimeout(resolve, options?.delay || 10));
+			await sleep(options?.delay || 10);
 			this.contents.sendInputEvent({
 				type: "mouseUp",
 				x: rect.centerX,
@@ -198,22 +215,32 @@ var ElementHandle = class {
 	* 填充输入框内容。
 	* - 适用于 `<input>`、`<textarea>` 或 `contenteditable` 元素。
 	* - 会触发 `input` 事件（冒泡）。
+	* - 支持自定义输入间隔, 'auto' 表示模拟自然输入节奏
+	* @example
+	* ```
+	* await element.fill('Hello, World!', { interval: 100 });
+	* ```
 	*/
 	async fill(value, options) {
-		await this.contents.executeJavaScript(`
+		await this.focus({ timeout: options?.timeout });
+		let interval;
+		if (typeof options?.interval === "number") interval = options?.interval;
+		if (!options?.append) await this.contents.executeJavaScript(`
       (function() {
         const target = ${this._getElement(options?.timeout)};
-        if (!target) return null;
-
-        // 验证输入框是否是文本类型
-        if (target.element.tagName !== 'INPUT' && target.element.tagName !== 'TEXTAREA' && !target.element.isContentEditable) return null;
-
-        target.element.focus();
-
-        target.element.value = ${JSON.stringify(value)};
-        target.element.dispatchEvent(new Event('input', { bubbles: true }));
+        if (target && target.element) {
+          if (target.element.tagName !== 'INPUT' && target.element.tagName !== 'TEXTAREA' && !target.element.isContentEditable) return null;
+          target.element.value = "";
+        }
       })()
     `);
+		for (let index = 0; index < value.length; index++) {
+			await sleep(interval || getHumanTypingDelay(index, value));
+			this.contents.sendInputEvent({
+				type: "char",
+				keyCode: value[index]
+			});
+		}
 	}
 	/**
 	* 在元素上发送按键事件。
@@ -230,7 +257,7 @@ var ElementHandle = class {
 			type: "keyDown",
 			keyCode: key$1
 		});
-		await new Promise((resolve) => setTimeout(resolve, options?.delay || 10));
+		await sleep(options?.delay || 10);
 		for (const key$1 of keys) this.contents.sendInputEvent({
 			type: "keyUp",
 			keyCode: key$1
@@ -286,6 +313,206 @@ var ElementHandle = class {
       })()
     `);
 	}
+	/**
+	* 选择下拉框选项。
+	* @param value 选项的值
+	* @returns
+	*/
+	async selectOption(value) {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        // 验证元素是否为选择框
+        if (target.element.tagName !== 'SELECT') return null;
+
+        target.element.value = ${JSON.stringify(value)};
+        target.element.dispatchEvent(new Event('change', { bubbles: true }));
+      })()
+    `);
+	}
+	/**
+	* 获取元素的 HTML 内容。
+	*/
+	async innerHTML() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.innerHTML;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的文本内容。
+	*/
+	async innerText() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.innerText;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的文本内容。
+	* @returns 元素的文本内容
+	*/
+	async textContent() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.textContent;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的输入值。
+	* @returns 元素的输入值
+	*/
+	async inputValue() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        // 验证输入框是否是文本类型
+        if (target.element.tagName !== 'INPUT' && target.element.tagName !== 'TEXTAREA' && !target.element.isContentEditable) return null;
+
+        return target.element.value;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的选中状态。
+	* @returns 元素的选中状态
+	*/
+	async isChecked() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        // 验证输入框是否是复选框或单选框
+        if (target.element.tagName !== 'INPUT' || target.element.type !== 'checkbox' && target.element.type !== 'radio') return null;
+
+        return target.element.checked;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的禁用状态。
+	* @returns 元素的禁用状态
+	*/
+	async isDisabled() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.disabled;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的可见状态。
+	* @returns 元素的可见状态
+	*/
+	async isVisible() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.offsetParent !== null;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的可用状态。
+	* @returns 元素的可用状态
+	*/
+	async isEnabled() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return !target.element.disabled;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的可编辑状态。
+	* @returns 元素的可编辑状态
+	*/
+	async isEditable() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.isContentEditable;
+      })()
+    `);
+	}
+	/**
+	* 获取元素的隐藏状态。
+	* @returns 元素的隐藏状态
+	*/
+	async isHidden() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        return target.element.offsetParent === null;
+      })()
+    `);
+	}
+	/**
+	* 选中元素的文本内容。
+	*/
+	async selectText(options) {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement(options.timeout)};
+        if (!target) return null;
+
+        // 选中元素的文本内容
+        const selection = window.getSelection();
+        const range = document.createRange();
+        range.selectNodeContents(target.element);
+        selection.removeAllRanges();
+        selection.addRange(range);
+      })()
+    `);
+	}
+	/**
+	* 取消选中复选框或单选框。
+	* @param options 选项
+	* @returns
+	*/
+	async uncheck(options) {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement(options?.timeout)};
+        if (!target) return null;
+
+        // 验证输入框是否是复选框或单选框
+        if (target.element.tagName !== 'INPUT' || target.element.type !== 'checkbox' && target.element.type !== 'radio') return null;
+
+        target.element.checked = false;
+        target.element.dispatchEvent(new Event('change', { bubbles: true }));
+      })()
+    `);
+	}
 };
 var element_default = ElementHandle;
 
@@ -387,4 +614,4 @@ var Ectrol = class {
 var src_default = Ectrol;
 
 //#endregion
-export { Ectrol, ElementHandle, LocalStorage, SessionStorage, src_default as default };
+export { Ectrol, ElementHandle, LocalStorage, SessionStorage, src_default as default, getHumanTypingDelay, sleep };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ectrol",
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "一个基于 Electron WebContents 的轻量级自动化助手，用于在你的应用内对网页内容进行交互（点击、输入、聚焦、键盘事件等）。",
   "author": "Cee Vee X <ceeveex@hotmail.com>",
   "license": "MIT",