Browser

Native webview using system browser.

Modulerequire("yue.gui")
TypeClass
InheritsView

Using Browser requires relatively new operating systems, for macOS the minimum version required is 10.10, for Linux it is required to install the webkit2gtk library with at least version 2.8.

On Linux due to poor support of hardware acceleration, the browser may fail to show anything, when that happens you can set WEBKIT_DISABLE_COMPOSITING_MODE environment variable to disable hardware acceleration.

Class methods

create(options)

Create a new browser view.

Parameters

Return

Browser

registerprotocol(scheme, handler)

Register a custom protocol with scheme and handler.

When the browser sends a request with scheme, the handler will be called with handler(url), and the handler must return an instance of class that inherits from ProtocolJob.

The handler is guaranteed to be called in the main thread.

Parameters

Return

boolean

unregisterprotocol(scheme)

Unregister the custom protocol with scheme.

Parameters

Methods

loadurl(url)

Load the URL.

Parameters

loadhtml(html, baseurl)

Set the webpage contents and base URL.

Parameters

geturl()

Return current URL.

Return

string

gettitle()

Return the title of document.

Return

string

setuseragent(useragent)

Change browser's user agent.

On Windows, due to Internet Explorer's limitations, calling SetUserAgent would change all web pages' user agents in current process.

Parameters

executejavascript(code, callback)

Evaluate code in browser and get the evaluated result.

The callback will be called with callback(success, result), the result argument is a generic value that created from the result of code.

Note that due to limitations of system toolkits, the execution may fail if the result of code can not be fully converted to JSON.

Parameters

goback()

Navigate to the back item in the back-forward list.

cangoback()

Return whether there is a back item in the back-forward list that can be navigated to.

Return

boolean

goforward()

Navigate to the forward item in the back-forward list.

cangoforward()

Return whether there is a forward item in the back-forward list that can be navigated to.

Return

boolean

reload()

Reload current page.

stop()

Stop loading all resources on the current page.

isloading()

Return whether current page is loading content.

Return

boolean

setbindingname(name)

Set the name of object which would have the native bindings.

By default native bindings are added to the window object, by calling this API, native bindings will be added to the window[name] object.

Parameters

addbinding(name, func)

Add a native binding to web page with name.

The func will be called with automatically converted arguments.

Parameters

addrawbinding(name, func)

Add a raw handler to web page with name.

The func will be called with a list of arguments passed from JavaScript.

Parameters

removebinding(name)

Remove the native binding with name.

Parameters

Events

onclose(self)

Emitted when the web page requests to close.

Parameters

Preventable

No.

onupdatecommand(self)

Emitted when the back-forward list has changed.

Parameters

Preventable

No.

onchangeloading(self)

Emitted when the browser starts or stops loading content.

Parameters

Preventable

No.

onupdatetitle(self, title)

Emitted when document's title is changed.

Parameters

Preventable

No.

onstartnavigation(self, url)

Emitted when the browser begins provisional navigation.

Parameters

Preventable

No.

oncommitnavigation(self, url)

Emitted when the browser begins to receive web content.

Parameters

Preventable

No.

onfinishnavigation(self, url)

Emitted when the navigation is complete.

Parameters

Preventable

No.

onfailnavigation(self, url, code)

Emitted when the navigation fails.

Parameters

Preventable

No.