Class ZCircusDriver

constructor

• new ZCircusDriver(element: HTMLElement): ZCircusDriver

• Initializes a new instance of this object.

  Parameters

  • element: HTMLElement

    The element to wrap.

  Returns ZCircusDriver

Readonlyelement

attribute

• attribute<T extends string>(
      attribute: string,
      fallback?: null | T,
  ): Promise<null | T>

• Returns an attribute of the driver.

  Type Parameters

  • T extends string

  Parameters

  • attribute: string

    The attribute to retrieve.
  • fallback: null | T = null

  Returns Promise<null | T>

  The attribute value, or null if no such value exists.

body

• body(): Promise<IZCircusDriver>

• Jumps to the body element.

  This is useful if you are opening modals and popups that don't exist from withing the driver context.

  Returns Promise<IZCircusDriver>

  A new driver that contains the document body as the context.

classes

• classes(filter?: string[]): Promise<string[]>

• Returns a list of classes on the driver context that match a given filter.

  Parameters

  • Optionalfilter: string[]

    The filter of classes you want to check for. If you just want to get all classes, then just use undefined here.

  Returns Promise<string[]>

  The list of classes that match the filter.

disabled

• disabled(): Promise<boolean>

• Gets whether the context described by this driver is disabled.

  Returns Promise<boolean>

  True if the driver context is disabled. False if enabled.

focused

• focused(): Promise<null | IZCircusDriver>

• Jumps to the focused element.

  Returns Promise<null | IZCircusDriver>

  A new driver that contains the focused element, or null if there is no element focused.

peek

• peek(selector: string): Promise<boolean>

• Looks at the app structure to see if a css selector will produce any results.

  Parameters

  • selector: string

    The selector to check.

  Returns Promise<boolean>

  True if the selector will result in one or more results. False otherwise.

perform

• perform(act: IZCircusAct): Promise<void>

• Performs an action against the driver context.

  Parameters

  • act: IZCircusAct

    The act to perform.

  Returns Promise<void>

query

• query(selector: string): Promise<IZCircusDriver[]>

• Selects all items under this driver that matches the css selector.

  Parameters

  • selector: string

    The selector to query.

  Returns Promise<IZCircusDriver[]>

  A promise that resolves with all items found from the selector. If no items are found, then an empty array is returned.

select

• select(selector: string): Promise<IZCircusDriver>

• Selects a single item under the driver that matches the css selector.

  Parameters

  • selector: string

    The selector to query.

  Returns Promise<IZCircusDriver>

  A resolved promise with the first item found if the selector produces one or more results. Returns a rejected promise if the selector returns no items.

selected

• selected(): Promise<boolean>

• Gets whether the value of the driver context is selected.

  Returns Promise<boolean>

  True if the context is in a selected state. False otherwise.

tag

• tag(): Promise<string>

• Gets the tag (node name) of the driver context.

  Returns Promise<string>

  The tag of the driver context.

text

• text(): Promise<string>

• Gets the underlying text of the driver context.

  Returns Promise<string>

  The underlying text of the driver context. Returns the empty string if no text exists.

value

• value(fallback: string): Promise<string>

• Gets the underlying value of the driver context.

  Parameters

  • fallback: string

    The fallback value in the case that the driver does not support a value.

  Returns Promise<string>

  The underlying value of the driver context, or fallback if the driver does not support a value.
• value(): Promise<null | string>

• Gets the underlying value of the driver context if there is one.

  Returns Promise<null | string>

  The underlying value of the driver context if there is one. Returns null if the driver does not support a value.

wait

• wait(
      predicate: () => boolean | Promise<boolean>,
      options?: IZCircusWaitOptions,
  ): Promise<void>

• Waits for a certain condition to be met before continuing.

  Parameters

  • predicate: () => boolean | Promise<boolean>

    The predicate to wait for.
  • Optionaloptions: IZCircusWaitOptions

    The options for the wait.

  Returns Promise<void>