Mozilla.org

nsIRequestObserver

---

This interface defines an observer of the request cycle. It is scriptable.

Methods

onStartRequest

Called to signify the beginning of an asynchronous request.

Syntax:

void nsIRequestObserver::onStartRequest(
	in nsIRequest aRequest,in nsISupports aContext)  

Parameters:

aRequest: The request being observed.

aContext: A user defined context.

nsresult:

NS_OK if successful.

Note: An exception thrown from onStartRequest has the side-effect of causing the request to be canceled.

onStopRequest

Called to signify the end of an asynchronous request.This call is always preceded by a call to onStartRequest.

Syntax:

void nsIRequestObserver::onStopRequest(
	in nsIRequest aRequest, in nsISupports aContext,
	in nsresult aStatusCode)  

Parameters:

aRequest: The request being observed.

aContext: A user defined context.

aStatusCode: The reason for stopping (NS_OK if completed successfully.

nsresult:

NS_OK if successful.

Note: An exception thrown from onStopRequest is generally ignored.