playwright-automation-core 1.0.0

package/dist/web/web.page.d.ts

@@ -0,0 +1,286 @@
+import { Page, Locator as PlaywrightLocator, FrameLocator } from "@playwright/test";
+import { Locator, ActionOptions, WaitOptions, BoundingBox, ElementState } from "../types";
+import { Logger } from "../utils";
+/**
+ * Type options for keyboard input
+ */
+export interface TypeOptions extends ActionOptions {
+    /** Clear existing text before typing */
+    clear?: boolean;
+    /** Delay between key presses */
+    typeDelay?: number;
+}
+/**
+ * Click options
+ */
+export interface ClickOptions extends ActionOptions {
+    /** Click button */
+    button?: "left" | "right" | "middle";
+    /** Number of clicks */
+    clickCount?: number;
+    /** Position relative to element */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /** Modifier keys */
+    modifiers?: ("Alt" | "Control" | "Meta" | "Shift")[];
+}
+/**
+ * Select option type
+ */
+export interface SelectOption {
+    value?: string;
+    label?: string;
+    index?: number;
+}
+/**
+ * Drag and drop options
+ */
+export interface DragDropOptions {
+    /** Source position */
+    sourcePosition?: {
+        x: number;
+        y: number;
+    };
+    /** Target position */
+    targetPosition?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * WebPage class providing high-level element interactions for Playwright.
+ */
+export declare class WebPage {
+    private page;
+    private logger;
+    private hooks;
+    private defaultTimeout;
+    private elementActions;
+    /**
+     * Create a new WebPage instance
+     */
+    constructor(page: Page, logger?: Logger, defaultTimeout?: number);
+    /**
+     * Resolve locator string to Playwright Locator
+     */
+    private resolveLocator;
+    /**
+     * Get underlying Playwright page
+     */
+    getPage(): Page;
+    /**
+     * Get Playwright locator from string or Locator object
+     */
+    getLocator(locator: Locator | string): Promise<PlaywrightLocator>;
+    /**
+     * Find element
+     */
+    findElement(locator: Locator | string, options?: WaitOptions): Promise<PlaywrightLocator>;
+    /**
+     * Find all elements matching locator
+     */
+    findElements(locator: Locator | string): Promise<PlaywrightLocator[]>;
+    /**
+     * Get element count
+     */
+    getElementCount(locator: Locator | string): Promise<number>;
+    /**
+     * Check if element exists
+     */
+    exists(locator: Locator | string, timeout?: number): Promise<boolean>;
+    /**
+     * Check if element is visible
+     */
+    isVisible(locator: Locator | string): Promise<boolean>;
+    /**
+     * Check if element is enabled
+     */
+    isEnabled(locator: Locator | string): Promise<boolean>;
+    /**
+     * Check if checkbox/radio is checked
+     */
+    isChecked(locator: Locator | string): Promise<boolean>;
+    /**
+     * Wait for element to be visible
+     */
+    waitForVisible(locator: Locator | string, options?: WaitOptions): Promise<PlaywrightLocator>;
+    /**
+     * Wait for element to be hidden
+     */
+    waitForHidden(locator: Locator | string, options?: WaitOptions): Promise<void>;
+    /**
+     * Wait for element to be enabled
+     */
+    waitForEnabled(locator: Locator | string, options?: WaitOptions): Promise<PlaywrightLocator>;
+    /**
+     * Wait for element to be clickable
+     */
+    waitForClickable(locator: Locator | string, options?: WaitOptions): Promise<PlaywrightLocator>;
+    /**
+     * Wait for text content
+     */
+    waitForText(locator: Locator | string, text: string, options?: WaitOptions): Promise<PlaywrightLocator>;
+    /**
+     * Wait for text to contain
+     */
+    waitForTextContains(locator: Locator | string, text: string, options?: WaitOptions): Promise<PlaywrightLocator>;
+    /**
+     * Click on element
+     */
+    click(locator: Locator | string, options?: ClickOptions): Promise<void>;
+    /**
+     * Double click on element
+     */
+    doubleClick(locator: Locator | string, options?: ClickOptions): Promise<void>;
+    /**
+     * Right click on element
+     */
+    rightClick(locator: Locator | string, options?: ClickOptions): Promise<void>;
+    /**
+     * Type text into element
+     */
+    type(locator: Locator | string, text: string, options?: TypeOptions): Promise<void>;
+    /**
+     * Fill element with text (faster than type, clears first)
+     */
+    fill(locator: Locator | string, text: string, options?: ActionOptions): Promise<void>;
+    /**
+     * Clear element text
+     */
+    clear(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Press keyboard key
+     */
+    pressKey(key: string, options?: {
+        delay?: number;
+    }): Promise<void>;
+    /**
+     * Press key on element
+     */
+    press(locator: Locator | string, key: string, options?: ActionOptions): Promise<void>;
+    /**
+     * Select option from dropdown
+     */
+    select(locator: Locator | string, option: SelectOption | SelectOption[], options?: ActionOptions): Promise<void>;
+    /**
+     * Check checkbox
+     */
+    check(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Uncheck checkbox
+     */
+    uncheck(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Set checkbox state
+     */
+    setChecked(locator: Locator | string, checked: boolean, options?: ActionOptions): Promise<void>;
+    /**
+     * Hover over element
+     */
+    hover(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Focus on element
+     */
+    focus(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Blur element (remove focus)
+     */
+    blur(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Scroll element into view
+     */
+    scrollIntoView(locator: Locator | string, options?: ActionOptions): Promise<void>;
+    /**
+     * Scroll page by amount
+     */
+    scrollBy(x: number, y: number): Promise<void>;
+    /**
+     * Scroll page to position
+     */
+    scrollTo(x: number, y: number): Promise<void>;
+    /**
+     * Drag element to target
+     */
+    dragAndDrop(source: Locator | string, target: Locator | string, options?: DragDropOptions): Promise<void>;
+    /**
+     * Upload file(s) to input
+     */
+    uploadFile(locator: Locator | string, files: string | string[], options?: ActionOptions): Promise<void>;
+    /**
+     * Handle file chooser dialog
+     */
+    handleFileChooser(files: string | string[]): Promise<void>;
+    /**
+     * Get element text
+     */
+    getText(locator: Locator | string, options?: ActionOptions): Promise<string>;
+    /**
+     * Get element inner text
+     */
+    getInnerText(locator: Locator | string): Promise<string>;
+    /**
+     * Get element inner HTML
+     */
+    getInnerHTML(locator: Locator | string): Promise<string>;
+    /**
+     * Get element attribute
+     */
+    getAttribute(locator: Locator | string, name: string): Promise<string | null>;
+    /**
+     * Get element input value
+     */
+    getValue(locator: Locator | string): Promise<string>;
+    /**
+     * Get element bounding box
+     */
+    getBoundingBox(locator: Locator | string): Promise<BoundingBox | null>;
+    /**
+     * Get element state
+     */
+    getElementState(locator: Locator | string): Promise<ElementState>;
+    /**
+     * Get all element attributes
+     */
+    getAllAttributes(locator: Locator | string): Promise<Record<string, string>>;
+    /**
+     * Get frame locator
+     */
+    getFrame(selector: string): FrameLocator;
+    /**
+     * Execute action within frame
+     */
+    inFrame<T>(selector: string, action: (frame: FrameLocator) => Promise<T>): Promise<T>;
+    /**
+     * Set up dialog handler
+     */
+    onDialog(handler: (dialog: {
+        type: string;
+        message: string;
+        accept: () => Promise<void>;
+        dismiss: () => Promise<void>;
+        defaultValue?: string;
+    }) => Promise<void>): void;
+    /**
+     * Accept next dialog
+     */
+    acceptDialog(promptText?: string): Promise<void>;
+    /**
+     * Dismiss next dialog
+     */
+    dismissDialog(): Promise<void>;
+    /**
+     * Set default timeout
+     */
+    setDefaultTimeout(timeout: number): void;
+    /**
+     * Take element screenshot
+     */
+    screenshotElement(locator: Locator | string): Promise<Buffer>;
+    /**
+     * Highlight element (for debugging)
+     */
+    highlight(locator: Locator | string, duration?: number): Promise<void>;
+}
+//# sourceMappingURL=web.page.d.ts.map

package/dist/web/web.page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.page.d.ts","sourceRoot":"","sources":["../../src/web/web.page.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,OAAO,IAAI,iBAAiB,EAC5B,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACb,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,oBAAoB;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,cAAc,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,sBAAsB;IACtB,cAAc,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAoC;IAE1D;;OAEG;gBACS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,cAAc,GAAE,MAAc;IAmCvE;;OAEG;YACW,cAAc;IA4B5B;;OAEG;IACI,OAAO,IAAI,IAAI;IAItB;;OAEG;IACU,UAAU,CACrB,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;OAEG;IACU,WAAW,CACtB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;OAEG;IACU,YAAY,CACvB,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAY/B;;OAEG;IACU,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxE;;OAEG;IACU,MAAM,CACjB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IAInB;;OAEG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE;;OAEG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE;;OAEG;IACU,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnE;;OAEG;IACU,cAAc,CACzB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;OAEG;IACU,aAAa,CACxB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACU,cAAc,CACzB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;OAEG;IACU,gBAAgB,CAC3B,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;OAEG;IACU,WAAW,CACtB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;OAEG;IACU,mBAAmB,CAC9B,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAU7B;;OAEG;IACU,KAAK,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IA6BhB;;OAEG;IACU,WAAW,CACtB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAahB;;OAEG;IACU,UAAU,CACrB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACU,IAAI,CACf,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IA8BhB;;OAEG;IACU,IAAI,CACf,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACU,KAAK,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACU,QAAQ,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACU,KAAK,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACU,MAAM,CACjB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE,EACrC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACU,KAAK,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACU,OAAO,CAClB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACU,UAAU,CACrB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACU,KAAK,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACU,KAAK,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACU,IAAI,CACf,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACU,cAAc,CACzB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACU,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1D;;OAEG;IACU,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D;;OAEG;IACU,WAAW,CACtB,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,MAAM,EAAE,OAAO,GAAG,MAAM,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACU,UAAU,CACrB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACU,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE;;OAEG;IACU,OAAO,CAClB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC;IAIlB;;OAEG;IACU,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrE;;OAEG;IACU,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrE;;OAEG;IACU,YAAY,CACvB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzB;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjE;;OAEG;IACU,cAAc,CACzB,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI9B;;OAEG;IACU,eAAe,CAC1B,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,OAAO,CAAC,YAAY,CAAC;IAIxB;;OAEG;IACU,gBAAgB,CAC3B,OAAO,EAAE,OAAO,GAAG,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAclC;;OAEG;IACI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAI/C;;OAEG;IACU,OAAO,CAAC,CAAC,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC;IAOb;;OAEG;IACI,QAAQ,CACb,OAAO,EAAE,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAK,OAAO,CAAC,IAAI,CAAC,GAClB,IAAI;IAYP;;OAEG;IACU,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3C;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM/C;;OAEG;IACU,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACU,SAAS,CACpB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,IAAI,CAAC;CAajB"}