pw-element-interactions 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export { DateUtilities } from './utils/DateUtilities';
 export { Utils } from './utils/ElementUtilities';
 export { ElementInteractions } from './interactions/facade/ElementInteractions';
 export { Steps } from './steps/CommonSteps';
+export { baseFixture } from './fixture/BaseFixture';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Steps = exports.ElementInteractions = exports.Utils = exports.DateUtilities = exports.Extractions = exports.Interactions = exports.Verifications = exports.Navigation = void 0;
+exports.baseFixture = exports.Steps = exports.ElementInteractions = exports.Utils = exports.DateUtilities = exports.Extractions = exports.Interactions = exports.Verifications = exports.Navigation = void 0;
 // Enums
 __exportStar(require("./enum/Options"), exports);
 // Supporting Action Classes
@@ -37,3 +37,6 @@ Object.defineProperty(exports, "ElementInteractions", { enumerable: true, get: f
 // Test Steps Facade
 var CommonSteps_1 = require("./steps/CommonSteps");
 Object.defineProperty(exports, "Steps", { enumerable: true, get: function () { return CommonSteps_1.Steps; } });
+// Test Fixture
+var BaseFixture_1 = require("./fixture/BaseFixture");
+Object.defineProperty(exports, "baseFixture", { enumerable: true, get: function () { return BaseFixture_1.baseFixture; } });

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.6",
+  "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",
@@ -45,4 +45,4 @@
   },
   "author": "Umut Ay Bora",
   "license": "MIT"
-}
+}