ProtractorPage
Hierarchy
- Page<ElementFinder>
- ProtractorPage
Index
Constructors
Properties
Methods
- createPageElement
- locate
- locateAll
- enableAngularSynchronisation
- navigateTo
- navigateBack
- navigateForward
- reload
- sendKeys
- executeScript
- executeAsyncScript
- lastScriptExecutionResult
- takeScreenshot
- cookie
- setCookie
- deleteAllCookies
- title
- name
- url
- viewportSize
- setViewportSize
- close
- closeOthers
- isPresent
- switchTo
- modalDialog
- toString
Constructors
constructor
Parameters
session: ProtractorBrowsingSession
browser: ProtractorBrowser
modalDialogHandler: ModalDialogHandler
errorHandler: ProtractorErrorHandler
pageId: CorrelationId
Returns ProtractorPage
Properties
readonlyid
Methods
createPageElement
Parameters
nativeElement: ElementFinder
Returns PageElement<ElementFinder>
locate
Parameters
selector: Selector
Returns PageElement<ElementFinder>
locateAll
Parameters
selector: Selector
Returns PageElements<ElementFinder>
enableAngularSynchronisation
If set to
false
, Protractor will not wait for Angular 1.x$http
and$timeout
tasks to complete before interacting with the browser.This can be useful when:
- you need to switch to a non-Angular app during your tests, e.g. to sign in using an SSO gateway
- your app continuously polls an API with
$timeout
If youโre not testing an Angular app, itโs better to disable Angular synchronisation completely in protractor configuration:
// protractor.conf.js
exports.config = {
onPrepare: function () {
return browser.waitForAngularEnabled(false)
},
// ... other config
}Parameters
enable: boolean
Returns Promise<boolean>
navigateTo
Parameters
destination: string
Returns Promise<void>
navigateBack
Returns Promise<void>
navigateForward
Returns Promise<void>
reload
Returns Promise<void>
sendKeys
Parameters
keys: (string | Key)[]
Returns Promise<void>
executeScript
Type parameters
- Result
- InnerArguments: any[]
Parameters
script: string | (...parameters: InnerArguments) => Result
rest...args: InnerArguments
Returns Promise<Result>
executeAsyncScript
Type parameters
- Result
- Parameters: any[]
Parameters
script: string | (...args: [...parameters: Parameters[], callback: (result: Result) => void]) => void
rest...args: Parameters
Returns Promise<Result>
lastScriptExecutionResult
Returns any
takeScreenshot
Returns Promise<string>
cookie
Parameters
name: string
Returns Promise<Cookie>
setCookie
Parameters
cookieData: CookieData
Returns Promise<void>
deleteAllCookies
Returns Promise<void>
title
Returns Promise<string>
name
Returns Promise<string>
url
Returns Promise<URL>
viewportSize
Returns Promise<{ width: number; height: number }>
setViewportSize
Parameters
size: { width: number; height: number }
Returns Promise<void>
close
Returns Promise<void>
closeOthers
Returns Promise<void>
isPresent
Returns Promise<boolean>
switchTo
Switches the current browsing context to the given page and returns an object that allows the caller to switch back to the previous context when needed.
Learn more
Returns Promise<SwitchableOrigin>
modalDialog
Returns the ModalDialogHandler for the current Page.
Returns ModalDialogHandler
toString
Returns a description of this Page and its ID.
Returns string
Protractor-specific implementation of Page.