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.

Hierarchy

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

Index

Properties

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

Methods

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

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.

optionalproxyTier

proxyTier?: number

The proxy tier tied to this browser controller. undefined if no tiered proxy is used.

optionalproxyUrl

proxyUrl?: string

The proxy URL used by the browser controller. This is set every time the browser controller uses proxy (even the tiered one). undefined if no proxy is used

totalPages

totalPages: number = 0

staticexternalinheriteddefaultMaxListeners

defaultMaxListeners: number

Inherited from TypedEmitter.defaultMaxListeners

Methods

externalinheritedaddListener

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

• Inherited from TypedEmitter.addListener

  Parameters

  • externalevent: U

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

  Returns this

close

• close(): Promise<void>

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

  Emits 'browserClosed' event.

  ---

  Returns Promise<void>

externalinheritedemit

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

• Inherited from TypedEmitter.emit

  Parameters

  • externalevent: U

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

  Returns boolean

externalinheritedeventNames

• eventNames(): U[]

• Inherited from TypedEmitter.eventNames

  Returns U[]

getCookies

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

• Parameters

  • page: NewPageResult

  Returns Promise<Cookie[]>

externalinheritedgetMaxListeners

• getMaxListeners(): number

• Inherited from TypedEmitter.getMaxListeners

  Returns number

kill

• kill(): Promise<void>

• Immediately kills the browser process.

  Emits 'browserClosed' event.

  ---

  Returns Promise<void>

externalinheritedlistenerCount

• listenerCount(type: BROWSER_CLOSED): number

• Inherited from TypedEmitter.listenerCount

  Parameters

  • externaltype: BROWSER_CLOSED

  Returns number

externalinheritedlisteners

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

• Inherited from TypedEmitter.listeners

  Parameters

  • externaltype: U

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

externalinheritedoff

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

• Inherited from TypedEmitter.off

  Parameters

  • externalevent: U

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

  Returns this

externalinheritedon

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

• Inherited from TypedEmitter.on

  Parameters

  • externalevent: U

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

  Returns this

externalinheritedonce

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

• Inherited from TypedEmitter.once

  Parameters

  • externalevent: U

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

  Returns this

externalinheritedprependListener

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

• Inherited from TypedEmitter.prependListener

  Parameters

  • externalevent: U

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

  Returns this

externalinheritedprependOnceListener

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

• Inherited from TypedEmitter.prependOnceListener

  Parameters

  • externalevent: U

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

  Returns this

externalinheritedrawListeners

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

• Inherited from TypedEmitter.rawListeners

  Parameters

  • externaltype: U

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

externalinheritedremoveAllListeners

• removeAllListeners(event?: BROWSER_CLOSED): this

• Inherited from TypedEmitter.removeAllListeners

  Parameters

  • externaloptionalevent: BROWSER_CLOSED

  Returns this

externalinheritedremoveListener

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

• Inherited from TypedEmitter.removeListener

  Parameters

  • externalevent: U

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

  Returns this

setCookies

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

• Parameters

  • page: NewPageResult

  • cookies: Cookie[]

  Returns Promise<void>

externalinheritedsetMaxListeners

• setMaxListeners(n: number): this

• Inherited from TypedEmitter.setMaxListeners

  Parameters

  • externaln: number

  Returns this