Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Download Item object

Updated on October 19, 2022

Access the Download Item object by using a proxy for certain properties, methods, and events of the component, such as the Download Manager events and the Items property.

Note: : If you manually erase a download from the chrome://downloads or edge://downloads pages, the download remains in the file list for the Download Manager component. The system does not clear the downloads until this page closes.

Use the following properties, methods, and events when downloading files from the Google Chrome or Microsoft Edge browsers using the Download API.


PropertyDescriptionReturn type
BytesReceivedThe current number of bytes downloaded.Integer
CurrentStatusThe current status of the download; for example, started, interrupted, paused, or completed.Enum
DownloadIDThe download ID that is assigned by the browser to this Download Item object.Integer
EstimatedEndTimeThe time when the download is expected to complete.DateTime
FilePathThe path to the folder where the file exists.String
FinalURLThe web site from where the file came, after all redirects.String
InterruptReasonThe reason that file download was interrupted.String
PercentCompleteThe percentage that shows the download progress or if the download completed.Integer
StatusDateTimeWhen the current state started. This property only shows the Started and Completed states. For all other states, this property is blank.Datetime
TotalFileSizeThe size of the file download.Integer
URLThe web site from where the download was referenced, excluding all redirects.String


MethodDescriptionParametersReturn type
PauseDownloadUse this method to pause the downloading of the object.NoneVoid
ResumeDownloadUse this method to resume the downloading of the object.NoneVoid
TerminateDownloadUse this method to stop the downloading of the object.NoneVoid

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us