W3cubDocs

/Web Extensions

downloads.InterruptReason

The InterruptReason 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

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
InterruptReason
Yes
79
47
?
Yes
No
?
?
48-79
?
?
?

Note: 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.

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason