BackgroundFetchRegistration.failureReason

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Доступное только для чтения свойство failureReason интерфейса BackgroundFetchRegistration возвращает строку, значение которой указывает на причину неудачного выполнения фонового запроса.

Когда значение свойства меняется, то у связанного объекта BackgroundFetchRegistration срабатывает событие progress.

Значение

Может принимать одну из следующих строк:

""

Фоновый запрос не завершён, либо завершён успешно.

"aborted"

Операция была прервана пользователем, либо был вызван abort().

"bad-status"

Статус ответа не-ok (статус находится за пределами диапазона 200-299).

"fetch-error"

Запрос провалился по другим причинам, например CORS, или ошибки сети.

"quota-exceeded"

Во время операции была достигнута квота хранения.

"download-total-exceeded"

Было превышено указанное значение downloadTotal. Это значение было установлено при регистрациии фонового запроса.

Примеры

Логирование этого свойства в консоль печатает причину завершения запроса с ошибкой, или пустую строку, если запрос был завершён успешно, либо ещё не завершён.

js
console.log(bgFetch.failureReason);

Спецификации

Specification
Background Fetch
# dom-backgroundfetchregistration-failurereason

Совместимость с браузерами

BCD tables only load in the browser