Optional aInstancePtr: objectA run time mechanism for interface discovery.
NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.
aInstancePtr must not be null.
[in] A requested interface IID
[out] A pointer to an interface pointer to receive the result.
Initializes the transfer with certain properties. This function must be called prior to accessing any properties on this interface.
The source URI of the transfer. Must not be null.
The original URI of the transfer in case aSource is a blob URL. Can be null.
The target URI of the transfer. Must not be null.
The user-readable description of the transfer. Can be empty.
The MIME info associated with the target, including MIME type and helper app when appropriate. This parameter is optional.
Time when the download started (ie, when the first response from the server was received) XXX presumably wbp and exthandler do this differently
The location of a temporary file; i.e. a file in which the received data will be stored, but which is not equal to the target file. (will be moved to the real target by the caller, when the download is finished) May be null.
An object that can be used to abort the download. Must not be null. Implementations are expected to hold a strong reference to this object until the download is finished, at which point they should release the reference.
Used to determine the privacy status of the new transfer. If true, indicates that the transfer was initiated from a source that desires privacy.
Indicates wheter the download is unwanted, should be considered dangerous or insecure.
The Referrer this download is started with
true (default) - Open downloads panel. false - Only show an icon indicator. This parameter is optional.
Same as init, but allows for passing the browsingContext which will allow for opening the download with the same userContextId and auth header.
BrowsingContext of the initiating document.
Set to true if the download should be opened within the browser.
Channel of the initiating document.
Notification called for content blocking events. This method will be called when content gets allowed/blocked for various reasons per the Content Blocking rules.
The nsIWebProgress instance that fired the notification.
The nsIRequest that has new security state.
A value composed of the Content Blocking Event Flags listed above. Any undefined bits are reserved for future use.
Called when the location of the window being watched changes. This is not when a load is requested, but rather once it is verified that the load is going to occur in the given window. For instance, a load that starts in a window might send progress and status messages for the new site, but it will not send the onLocationChange until we are sure that we are loading this new page here.
The nsIWebProgress instance that fired the notification.
The associated nsIRequest. This may be null in some cases.
The URI of the location that is being loaded.
This is a value which explains the situation or the reason why the location has changed.
Notification that the progress has changed for one of the requests associated with aWebProgress. Progress totals are reset to zero when all requests in aWebProgress complete (corresponding to onStateChange being called with aStateFlags including the STATE_STOP and STATE_IS_WINDOW flags).
The nsIWebProgress instance that fired the notification.
The nsIRequest that has new progress.
The current progress for aRequest.
The maximum progress for aRequest.
The current progress for all requests associated with aWebProgress.
The total progress for all requests associated with aWebProgress.
NOTE: If any progress value is unknown, or if its value would exceed the maximum value of type long, then its value is replaced with -1.
NOTE: If the object also implements nsIWebProgressListener2 and the caller knows about that interface, this function will not be called. Instead, nsIWebProgressListener2::onProgressChange64 will be called.
Notification that the progress has changed for one of the requests associated with aWebProgress. Progress totals are reset to zero when all requests in aWebProgress complete (corresponding to onStateChange being called with aStateFlags including the STATE_STOP and STATE_IS_WINDOW flags).
This function is identical to nsIWebProgressListener::onProgressChange, except that this function supports 64-bit values.
nsIWebProgressListener2::onProgressChange64
The nsIWebProgress instance that fired the notification.
The nsIRequest that has new progress.
The current progress for aRequest.
The maximum progress for aRequest.
The current progress for all requests associated with aWebProgress.
The total progress for all requests associated with aWebProgress.
NOTE: If any progress value is unknown, then its value is replaced with -1.
Notification that a refresh or redirect has been requested in aWebProgress For example, via a or an HTTP Refresh: header
True if the refresh may proceed. False if the refresh should be aborted.
The nsIWebProgress instance that fired the notification.
The new URI that aWebProgress has requested redirecting to.
The delay (in milliseconds) before refresh.
True if aWebProgress is requesting a refresh of the current URI. False if aWebProgress is requesting a redirection to a different URI.
Notification called for security progress. This method will be called on security transitions (eg HTTP -> HTTPS, HTTPS -> HTTP, FOO -> HTTPS) and after document load completion. It might also be called if an error occurs during network loading.
The nsIWebProgress instance that fired the notification.
The nsIRequest that has new security state.
A value composed of the Security State Flags and the Security Strength Flags listed above. Any undefined bits are reserved for future use.
NOTE: These notifications will only occur if a security package is installed.
Notification indicating the state has changed for one of the requests associated with aWebProgress.
The nsIWebProgress instance that fired the notification
The nsIRequest that has changed state.
Flags indicating the new state. This value is a combination of one of the State Transition Flags and one or more of the State Type Flags defined above. Any undefined bits are reserved for future use.
Error status code associated with the state change. This parameter should be ignored unless aStateFlags includes the STATE_STOP bit. The status code indicates success or failure of the request associated with the state change. NOTE: aStatus may be a success code even for server generated errors, such as the HTTP 404 error. In such cases, the request itself should be queried for extended error information (e.g., for HTTP requests see nsIHttpChannel).
Notification that the status of a request has changed. The status message is intended to be displayed to the user (e.g., in the status bar of the browser).
The nsIWebProgress instance that fired the notification.
The nsIRequest that has new status.
This value is not an error code. Instead, it is a numeric value that indicates the current status of the request. This interface does not define the set of possible status codes. NOTE: Some status values are defined by nsITransport and nsISocketTransport.
Localized text corresponding to aStatus.
Used to notify the transfer object of the redirects associated with the channel that terminated in the downloaded file. Must be called on the main thread, only after the download has finished successfully.
The nsIArray of nsIPrincipal of redirected URIs associated with the downloaded file.
Used to notify the transfer object of the signature of the downloaded file. Must be called on the main thread, only after the download has finished successfully.
The Array of Array of Array of bytes certificates of the downloaded file.
Generated using TypeDoc
Increases the reference count for this interface. The associated instance will not be deleted unless the reference count is returned to zero.
Returns
The resulting reference count.