abstractPlaywrightBrowsingSession
Hierarchy
- BrowsingSession<PlaywrightPage>
- PlaywrightBrowsingSession
Index
Methods
publicabstractbrowserCapabilities
Returns basic meta-data about the browser associated with this ability.
Please note that since Playwright does not expose information about the operating system the tests are running on, Serenity/JS assumes that the tests are running locally and therefore returns the value of Node.js
process.platform
forplatformName
.Returns Promise<BrowserCapabilities>
cookie
Parameters
name: string
Returns Promise<Cookie>
setCookie
Parameters
cookie: CookieData
Returns Promise<void>
deleteAllCookies
Returns Promise<void>
closePagesOtherThan
Parameters
pageOfInterest: PlaywrightPage
Returns Promise<void>
currentPage
Returns a Page representing the currently active top-level browsing context.
Returns Promise<PlaywrightPage>
register
Registers specified pages to be managed by this BrowsingSession.
Parameters
rest...pages: PlaywrightPage[]
Returns void
deregister
Informs this BrowsingSession that it should no longer manage pages identified by the given
pageIds
.Parameters
rest...pageIds: CorrelationId[]
Returns void
allPages
Returns a pages representing all the available top-level browsing context, e.g. all the open browser tabs.
Returns Promise<PlaywrightPage[]>
registeredPageIds
Returns the ids of any pages this BrowsingSession is aware of.
Returns CorrelationId[]
changeCurrentPageTo
Informs the BrowsingSession that the ācurrent pageā has changed to
page
.Please note that different Web integration tools have a different definition of what a ācurrent pageā is. For example, Selenium or WebdriverIO use a single āfocusedā window that a developer needs to explicitly āswitch toā in their tests in order to interact with it. This is similar to how a regular user would interact with Web pages; switching from one tab to another, but not interacting with more than one window/tab simultaneously.
Playwright and Puppeteer, on the other hand, donāt have a concept of the ācurrentā page at all, since they allow the developer to interact with multiple open tabs/windows at the same time.
Web integration-specific implementations of this class should override this method to define how the concept of the ācurrent pageā should be interpreted by Serenity/JS.
Parameters
page: PlaywrightPage
Returns Promise<void>
closeAllPages
Closes all the pages available in this browsing context
Returns Promise<void>
Playwright-specific implementation of BrowsingSession.