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
Opera
Safari
Firefox for Android
Safari on iOS
InterruptReason
Chrome – Full support
Chrome 30 (Release date: 2013-10-01)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 47 (Release date: 2016-06-07)
footnote
footnote Only returns these errors: NETWORK_FAILED, FILE_FAILED, CRASH, USER_CANCELED, SERVER_BAD_CONTENT, SERVER_FORBIDDEN, SERVER_UNAUTHORIZED, and SERVER_FAILED.
Opera – Full support
Opera 17 (Release date: 2013-10-08)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – No support
Firefox for Android 48 – 68 (Release date: 2016-08-02)
footnote Removed in 79 and later
Safari on iOS – No support
Safari on iOS
footnote No support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

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