This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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

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