Interface GetValueOptions

Returns the value of a form element.

Example

const firstName = await getValue(ctx, 'input[name="firstName"]');

Param: ctx

Context object.

Param: selector

The element selector for which to return value.

Param: options

Options for waiting and querying. Supports root to specify a root element.

Returns

The value of the form element as a string.

interface GetValueOptions {
    hidden?: boolean;
    signal?: AbortSignal;
    timeout?: number;
    visible?: boolean;
}

Hierarchy (view full)

Properties

hidden? signal? timeout? visible?

Properties

Optionalhidden

hidden?: boolean

Wait for the selected element to not be found in the DOM or to be hidden. See ElementHandle.isHidden for the definition of element invisibility.

Default Value

false

Optionalsignal

signal?: AbortSignal

A signal object that allows you to cancel a waitForSelector call.

Optionaltimeout

timeout?: number

Maximum time to wait in milliseconds. Pass 0 to disable timeout.

The default value can be changed by using Page.setDefaultTimeout

Default Value

30_000 (30 seconds)

Optionalvisible

visible?: boolean

Wait for the selected element to be present in DOM and to be visible. See ElementHandle.isVisible for the definition of element visibility.

Default Value

false

Settings

On This Page

Properties