Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

downloads.InterruptReason

The InteruptReason type of the downloads API defines a set of possible reasons why a download was interrupted.

A downloads.DownloadItem's error property will contain a string taken from the values defined in this type.

Type

Values of this type are strings. Possible values are split into categories, with each set having the same substring at the beginning:

File-related errors:

  • "FILE_FAILED"
  • "FILE_ACCESS_DENIED"
  • "FILE_NO_SPACE"
  • "FILE_NAME_TOO_LONG"
  • "FILE_TOO_LARGE"
  • "FILE_VIRUS_INFECTED"
  • "FILE_TRANSIENT_ERROR"
  • "FILE_BLOCKED"
  • "FILE_SECURITY_CHECK_FAILED"
  • "FILE_TOO_SHORT"

Network-related errors:

  • "NETWORK_FAILED"
  • "NETWORK_TIMEOUT"
  • "NETWORK_DISCONNECTED"
  • "NETWORK_SERVER_DOWN"
  • "NETWORK_INVALID_REQUEST"

Server-related errors:

  • "SERVER_FAILED"
  • "SERVER_NO_RANGE"
  • "SERVER_BAD_CONTENT"
  • "SERVER_UNAUTHORIZED"
  • "SERVER_CERT_PROBLEM"
  • "SERVER_FORBIDDEN"

User-related errors:

  • "USER_CANCELED"
  • "USER_SHUTDOWN"

Miscellaneous:

  • "CRASH"

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic Support Yes No 47.0 48.0 33

Acknowledgements

This API is based on Chromium's chrome.downloads API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, wbamberg
 Last updated by: chrisdavidmills,