LoadEvent QML Type

LoadEvent represents a load event More...

Import Statement: import com.canonical.Oxide 1.15
Instantiates: OxideQLoadEvent

Properties

Detailed Description

LoadEvent represents a load event.

Load events are associated with a url, and have a type.

For load events where the type is TypeFailed, the event will provide details of the error via errorDomain, errorString and errorCode.

For load events where the type is TypeCommitted, TypeSucceeded or TypeRedirected, and url is a http: or https: URL, httpStatusCode will indicate the HTTP status code returned from the server. Load events where type is TypeFailed may also provide the HTTP status code if the failure is post-commit.

Load events where type is TypeRedirected will provide the original URL via originalUrl.

Property Documentation

errorCode : int

An error code for this load event. The error code matches the internal code provided by the Chromium networking stack.

Applications shouldn't make any assumption about the meaning of these error codes, and shouldn't assume that specific errors will produce the same error code in future releases of Oxide.

See also errorDomain and errorString.


errorDomain : enumeration

The error domain for this load event. If type is not TypeFailed, this will be ErrorDomainNone.

Possible values are:

ConstantDescription
LoadEvent.ErrorDomainNoneNo error.
LoadEvent.ErrorDomainInternalAn internal error occurred.
LoadEvent.ErrorDomainConnectionA connection error occurred, such as a SSL error, TCP protocol error or name resolution failure
LoadEvent.ErrorDomainCertificateA certificate error occurred, such as the server responding with a certificate whose common name is invalid, is expired or signed by an authority that isn't trusted. This error won't be seen for main frame loads.
LoadEvent.ErrorDomainHTTPA HTTP error occurred, such as a redirect loop or other invalid HTTP response.
LoadEvent.ErrorDomainCacheA cache error occurred
LoadEvent.ErrorDomainFTPA FTP error occurred
LoadEvent.ErrorDomainDNSAn error occurred during name resolution, such as a timeout or invalid response

See also errorString and errorCode.


errorString : string

A description of the error for this load event, suitable for display in an application UI. If type is not TypeFailed, this will be an empty string.

See also errorDomain and errorCode.


httpStatusCode : int

The HTTP status code returned from the remote server for this load. This will be 0 for load events where type is TypeStarted or TypeStopped, or url is not a http: or https: URL. Itwill also be 0 for load events where type is TypeFailed and the load hasn't committed yet.

This QML property was introduced in OxideQt 1.8.


isError : bool

Is true if the load event is associated with an error page. If a load fails, Chromium will proceed to load a (currently empty) error page.

This QML property was introduced in OxideQt 1.5.


originalUrl : url

The original URL for load events where type is TypeRedirected. For all other load events, this is an empty URL.

This QML property was introduced in OxideQt 1.3.


type : enumeration

The type of this load event.

Possible values are:

ConstantDescription
LoadEvent.TypeStartedA started event is the first event in a load event sequence. It occurs before any request is sent over the network. At this point, the previous document still exists.
LoadEvent.TypeStoppedA stopped event occurs when the load is stopped by the application, a non-overridable certificate error occurs in the main frame, a certificate error is denied by the application, or the load is cancelled by some other mechanism.
LoadEvent.TypeSucceededA succeeded event occurs when a load completes successfully.
LoadEvent.TypeFailedA failed event occurs when a load fails.
LoadEvent.TypeCommittedA committed event occurs when a response is received from the remote server. At this point, the new document has replaced the previous document. This value was added in OxideQt 1.3.
LoadEvent.TypeRedirectedA redirected event occurs when the server responds with a 3xx response. This value was added in OxideQt 1.3.

url : url

The url associated with this load event.