pw-element-interactions 0.0.7 → 0.0.8

package/dist/interactions/Interaction.d.ts

@@ -83,4 +83,13 @@ export declare class Interactions {
        * @returns A promise that resolves to the matched Playwright Locator, or null if not found.
        */
     getByText(baseLocator: Locator, pageName: string, elementName: string, desiredText: string, strict?: boolean): Promise<ReturnType<Page['locator']> | null>;
+    /**
+     * Types into the target element character by character with a specified delay.
+     * Use this for OTP inputs, search-as-you-type fields, or when `fill()`
+     * doesn't trigger necessary keyboard events (like 'keyup' or 'keydown').
+     * @param locator - The Playwright Locator pointing to the input element.
+     * @param text - The string of text to type sequentially.
+     * @param delay - Time in milliseconds to wait between key presses. Defaults to 100ms.
+     */
+    typeSequentially(locator: Locator, text: string, delay?: number): Promise<void>;
 }

package/dist/interactions/Interaction.js

@@ -196,5 +196,21 @@ class Interactions {
         }
         return locator;
     }
+    /**
+     * Types into the target element character by character with a specified delay.
+     * Use this for OTP inputs, search-as-you-type fields, or when `fill()`
+     * doesn't trigger necessary keyboard events (like 'keyup' or 'keydown').
+     * @param locator - The Playwright Locator pointing to the input element.
+     * @param text - The string of text to type sequentially.
+     * @param delay - Time in milliseconds to wait between key presses. Defaults to 100ms.
+     */
+    async typeSequentially(locator, text, delay = 100) {
+        await this.utils.waitForState(locator, 'visible');
+        console.log(`[Action] -> Typing "${text}" sequentially with a ${delay}ms delay.`);
+        await locator.pressSequentially(text, {
+            delay,
+            timeout: this.ELEMENT_TIMEOUT
+        });
+    }
 }
 exports.Interactions = Interactions;

package/dist/steps/CommonSteps.d.ts

@@ -183,4 +183,13 @@ export declare class Steps {
      * @param state - The state to wait for: 'visible' | 'attached' | 'hidden' | 'detached'. Defaults to 'visible'.
      */
     waitForState(pageName: string, elementName: string, state?: 'visible' | 'attached' | 'hidden' | 'detached'): Promise<void>;
+    /**
+     * Types text into a specific element character by character with a delay.
+     * Ideal for OTP inputs, search bars, or fields with sensitive 'keyup' listeners.
+     * @param pageName - The page or component grouping name in your repository.
+     * @param elementName - The specific element name in your repository.
+     * @param text - The string to type sequentially.
+     * @param delay - Optional delay between key presses in milliseconds (defaults to 100).
+     */
+    typeSequentially(pageName: string, elementName: string, text: string, delay?: number): Promise<void>;
 }

package/dist/steps/CommonSteps.js

@@ -298,5 +298,18 @@ class Steps {
         const locator = await this.repo.get(this.page, pageName, elementName);
         await this.utils.waitForState(locator, state);
     }
+    /**
+     * Types text into a specific element character by character with a delay.
+     * Ideal for OTP inputs, search bars, or fields with sensitive 'keyup' listeners.
+     * @param pageName - The page or component grouping name in your repository.
+     * @param elementName - The specific element name in your repository.
+     * @param text - The string to type sequentially.
+     * @param delay - Optional delay between key presses in milliseconds (defaults to 100).
+     */
+    async typeSequentially(pageName, elementName, text, delay = 100) {
+        console.log(`[Step] -> Typing "${text}" sequentially into '${elementName}' in '${pageName}' (Delay: ${delay}ms)`);
+        const locator = await this.repo.get(this.page, pageName, elementName);
+        await this.interact.typeSequentially(locator, text, delay);
+    }
 }
 exports.Steps = Steps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pw-element-interactions",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "A robust, readable interaction and assertion Facade for Playwright. Abstract away boilerplate into semantic, English-like methods, making your test automation framework cleaner, easier to maintain, and accessible to non-developers.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",