abstractBrowserController <Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

The BrowserController serves two purposes. First, it is the base class that specialized controllers like PuppeteerController or PlaywrightController extend. Second, it defines the public interface of the specialized classes which provide only private methods. Therefore, we do not keep documentation for the specialized classes, because it's the same for all of them.

@hideconstructor

Hierarchy

• TypedEmitter<BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>>
  • BrowserController
    • PuppeteerController
    • PlaywrightController

Index

Constructors

• constructor

Properties

• activePages
• browser
• browserPlugin
• id
• isActive
• lastPageOpenedAt
• launchContext
• totalPages
• defaultMaxListeners

Methods

• addListener
• close
• emit
• eventNames
• getCookies
• getMaxListeners
• kill
• listenerCount
• listeners
• off
• on
• once
• prependListener
• prependOnceListener
• rawListeners
• removeAllListeners
• removeListener
• setCookies
• setMaxListeners

Constructors

constructor

• new BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>(browserPlugin: BrowserPlugin<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Overrides TypedEmitter<BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>>.constructor

  Type parameters

  • Library: CommonLibrary = CommonLibrary
  • LibraryOptions: undefined | Dictionary<any> = Parameters<Library[launch]>[0]
  • LaunchResult: CommonBrowser = UnwrapPromise<ReturnType<Library[launch]>>
  • NewPageOptions = Parameters<LaunchResult[newPage]>[0]
  • NewPageResult = UnwrapPromise<ReturnType<LaunchResult[newPage]>>

  Parameters

  • browserPlugin: BrowserPlugin<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

Properties

activePages

activePages: number = 0

browser

browser: LaunchResult = ...

Browser representation of the underlying automation library.

browserPlugin

browserPlugin: BrowserPlugin<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

The BrowserPlugin instance used to launch the browser.

id

id: string = ...

isActive

isActive: boolean = false

lastPageOpenedAt

lastPageOpenedAt: number = ...

launchContext

launchContext: LaunchContext<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult> = ...

The configuration the browser was launched with.

totalPages

totalPages: number = 0

staticexternaldefaultMaxListeners

defaultMaxListeners: number

Inherited from TypedEmitter.defaultMaxListeners

Methods

externaladdListener

• addListener<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.addListener

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

close

• close(): Promise<void>

• Gracefully closes the browser and makes sure there will be no lingering browser processes.

  Emits 'browserClosed' event.

  ---

  Returns Promise<void>

externalemit

• emit<U>(event: U, ...args: Parameters<BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]>): boolean

• Inherited from TypedEmitter.emit

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externalrest...args: Parameters<BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]>

  Returns boolean

externaleventNames

• eventNames<U>(): U[]

• Inherited from TypedEmitter.eventNames

  Type parameters

  • U: BROWSER_CLOSED

  Returns U[]

getCookies

• getCookies(page: NewPageResult): Promise<Cookie[]>

• Parameters

  • page: NewPageResult

  Returns Promise<Cookie[]>

externalgetMaxListeners

• getMaxListeners(): number

• Inherited from TypedEmitter.getMaxListeners

  Returns number

kill

• kill(): Promise<void>

• Immediately kills the browser process.

  Emits 'browserClosed' event.

  ---

  Returns Promise<void>

externallistenerCount

• listenerCount(type: BROWSER_CLOSED): number

• Inherited from TypedEmitter.listenerCount

  Parameters

  • externaltype: BROWSER_CLOSED

  Returns number

externallisteners

• listeners<U>(type: U): BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U][]

• Inherited from TypedEmitter.listeners

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externaltype: U

  Returns BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U][]

externaloff

• off<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.off

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

externalon

• on<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.on

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

externalonce

• once<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.once

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

externalprependListener

• prependListener<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.prependListener

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

externalprependOnceListener

• prependOnceListener<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.prependOnceListener

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

externalrawListeners

• rawListeners<U>(type: U): BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U][]

• Inherited from TypedEmitter.rawListeners

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externaltype: U

  Returns BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U][]

externalremoveAllListeners

• removeAllListeners(event?: BROWSER_CLOSED): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.removeAllListeners

  Parameters

  • externaloptionalevent: BROWSER_CLOSED

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

externalremoveListener

• removeListener<U>(event: U, listener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.removeListener

  Type parameters

  • U: BROWSER_CLOSED

  Parameters

  • externalevent: U

  • externallistener: BrowserControllerEvents<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>[U]

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

setCookies

• setCookies(page: NewPageResult, cookies: Cookie[]): Promise<void>

• Parameters

  • page: NewPageResult

  • cookies: Cookie[]

  Returns Promise<void>

externalsetMaxListeners

• setMaxListeners(n: number): BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>

• Inherited from TypedEmitter.setMaxListeners

  Parameters

  • externaln: number

  Returns BrowserController<Library, LibraryOptions, LaunchResult, NewPageOptions, NewPageResult>