Class FileUploadField

A model for a FileUploadField component.

Hierarchy

Constructors

constructor

Properties

error input label root xpath

Accessors

fieldTypeValidator

Methods

getChildOfType getGlobalLocator getLocator setValue verifyFieldType

Constructors

constructor

  • A model for a FormField component.

    Parameters

    • parent: ComponentModel | Page | FrameLocator

      The parent playwright page, frame or component model.

    • Optional xpath: string

      A relative xpath selector to this element from the parent.

    • Optional nth: number

      Position among matching elements. Position is 1 indexed. Negative numbers count from the end.

    Returns FileUploadField

Properties

Readonly error

error: Locator

A locator to the field error message.

Protected Readonly input

input: Locator

A locator to the file input element.

Readonly label

label: Locator

A locator to the field label.

Protected root

root: Page | FrameLocator

The root playwright entity from which to resolve this component model's xpath.

Readonly xpath

xpath: string

An absolute xpath to the DOM element that this component model represents.

Accessors

Protected fieldTypeValidator

  • get fieldTypeValidator(): string

  • A selector which will match the field if the element type is correct.

    Returns string

Methods

getChildOfType

  • This method gets a child component model with a provided type. This is useful for modelling a page where the UI is composed in a custom manner.

    Type Parameters

    Parameters

    • model: ComponentModelType<TModel>

      A ComponentModel type. e.g. ToggleButton / Modal

    • Optional xpath: string

      An optional xpath relative to this component. If not provided, the model's default xpath will be used.

    • Optional nth: number

      Optional position among matches. Position is 1 indexed. Negative numbers count from the end.

    Returns TModel

Protected getGlobalLocator

  • A helper method to create global locators - This helps with locating globally across the entire DOM, rather than being scoped to the form

    Parameters

    • selector: string

    Returns Locator

getLocator

  • This method gets a locator to the DOM element represented by this component model.

    Returns Locator

  • This method gets a locator to a DOM element relative to the element represented by this component model.

    Parameters

    • xpath: string

      An xpath relative to this component.

    • Optional nth: number

      Optional position among matches. Position is 1 indexed. Negative numbers count from the end.

    Returns Locator

setValue

  • This method verifies the field type and enters a path or paths to local files.

    Parameters

    • value: string | string[]

    Returns Promise<void>

verifyFieldType

  • This method verifies that the field is visible, and that the actual element matches the model being used.

    Returns Promise<void>

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc