WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIDownloader

IID:fafe41a9-a531-4d6d-89bc-588a6522fb4e
Inherits From:nsIStreamListener

A downloader is a special implementation of a nsIStreamListener that will make the contents of the stream available as a file. This may utilize the disk cache as an optimization to avoid an extra copy of the data on disk. The resulting file is valid from the time the downloader completes until the last reference to the downloader is released.

This interface is implemented by the following components:

Methods

void init ( nsIDownloadObserver observer , nsIFile downloadLocation )

void init ( nsIDownloadObserver observer , nsIFile downloadLocation )

Initialize this downloader

Arguments:
observer: the observer to be notified when the download completes.
downloadLocation: the location where the stream contents should be written. if null, the downloader will select a location and the resulting file will be deleted (or otherwise made invalid) when the downloader object is destroyed. if an explicit download location is specified then the resulting file will not be deleted, and it will be the callers responsibility to keep track of the file, etc.

References

This interface is passed as an argument to the following methods:

nsIDownloadObserver.onDownloadComplete

Reference documentation is generated from Mozilla's source.