externalBrowseTheWebWithWebdriverIO

This implementation of the ability to BrowseTheWeb enables the Actor to interact with web front-ends using WebdriverIO.

Using WebdriverIO to BrowseTheWeb

import { actorCalled } from '@serenity-js/core'
import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio'
import { By, Navigate, PageElement, Text } from '@serenity-js/web'
import { Ensure, equals } from '@serenity-js/assertions'
import { browser } from '@wdio/globals'

const HomePage = {
  title: () =>
    PageElement.located(By.css('h1')).describedAs('title')
}

await actorCalled('Wendy')
  .whoCan(BrowseTheWebWithWebdriverIO.using(browser))  // `browser` is global in WebdriverIO tests
  .attemptsTo(
    Navigate.to(`https://serenity-js.org`),
    Ensure.that(Text.of(HomePage.title()), equals('Serenity/JS')),
  );

Learn more

• WebdriverIO website
• BrowseTheWeb
• Ability
• Actor

Hierarchy

• BrowseTheWeb<WebdriverIO.Element>
  • BrowseTheWebWithWebdriverIO

Index

Constructors

• constructor

Methods

• using
• currentPage
• allPages
• browserCapabilities

Constructors

externalconstructor

• new BrowseTheWebWithWebdriverIO(session: BrowsingSession<Page<Element>>): BrowseTheWebWithWebdriverIO

• Inherited from BrowseTheWeb<WebdriverIO.Element>.constructor

  Parameters

  • externalsession: BrowsingSession<Page<Element>>

  Returns BrowseTheWebWithWebdriverIO

Methods

staticexternalusing

• using(browserInstance: Browser): BrowseTheWebWithWebdriverIO

• Parameters

  • externalbrowserInstance: Browser

  Returns BrowseTheWebWithWebdriverIO

externalcurrentPage

• currentPage(): Promise<Page<Element>>

• Inherited from BrowseTheWeb.currentPage

  Returns a Page representing the currently active browser tab.

  ---

  Returns Promise<Page<Element>>

externalallPages

• allPages(): Promise<Page<Element>[]>

• Inherited from BrowseTheWeb.allPages

  Returns an array of pages representing all the browser tabs available in the current BrowsingSession.

  ---

  Returns Promise<Page<Element>[]>

externalbrowserCapabilities

• browserCapabilities(): Promise<BrowserCapabilities>

• Inherited from BrowseTheWeb.browserCapabilities

  Returns basic meta-data about the browser associated with this ability.

  ---

  Returns Promise<BrowserCapabilities>