WebRequestClient.md

API categories | API index

WebRequestClient (interface)

See WebRequest.CreateWebRequest().

You have to keep a strong reference to the WebRequest object during the request, otherwise it gets destroyed and the WebRequestClient callbacks won't get called.

Table of contents:

• Notes
• Callbacks
  • OnUploadProgress
  • OnDownloadProgress
  • OnDownloadData
  • OnRequestComplete

Notes

Callbacks available in upstream CEF, but not yet exposed in CEF Python:

• GetAuthCredentials

Callbacks

The methods of this class will be called on the same thread that created the request unless otherwise documented.

OnUploadProgress

Parameter	Type
web_request	WebRequest
current	long
total	long
Return	void

Notifies the client of upload progress. |current| denotes the number of bytes sent so far and |total| is the total size of uploading data (or -1 if chunked upload is enabled). This method will only be called if the ReportUploadProgress flag is set on the request (see Request.GetFlags() and SetFlags())

OnDownloadProgress

Parameter	Type
web_request	WebRequest
current	long
total	long
Return	void

Notifies the client of download progress. |current| denotes the number of bytes received up to the call and |total| is the expected total size of the response (or -1 if not determined).

OnDownloadData

Parameter	Type
web_request	WebRequest
data	bytes
Return	void

Called when some part of the response is read. |data| contains the current bytes received since the last call. This method will not be called if the NoDownloadData flag is set on the request (see Request.GetFlags() and SetFlags()).

OnRequestComplete

Parameter	Type
web_request	WebRequest
Return	void

Notifies the client that the request has completed. Use the WebRequest.GetRequestStatus() method to determine if the request was successful or not.