ectrol 0.0.3 → 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>;
   /**
    * 在元素上发送按键事件。
@@ -237,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
@@ -261,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
@@ -587,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.3",
+  "version": "0.0.4",
   "description": "一个基于 Electron WebContents 的轻量级自动化助手，用于在你的应用内对网页内容进行交互（点击、输入、聚焦、键盘事件等）。",
   "author": "Cee Vee X <ceeveex@hotmail.com>",
   "license": "MIT",