NotRestoredReasonDetails: свойство reason

Чтение-только свойство reason интерфейса NotRestoredReasonDetails возвращает строку, описывающую причину блокирования страницы от использования кэша вперёд/назад (bfcache).

Строка.

Существует множество причин блокировки, и браузеры могут выбирать свои собственные причины блокировки, основанные на их работе. Разработчики должны избегать зависимости от конкретной формулировки причин и быть готовыми к добавлению и удалению новых причин.

Начальные значения, указанные в спецификации, это:

"fetch"

Во время выгрузки был отменён запрос fetch, инициированный текущим документом (например, с помощью fetch()), пока он выполнялся. В результате страница не находилась в стабильном состоянии, которое можно было бы сохранить в bfcache.

"lock"

Во время выгрузки были завершены удерживаемые блокировки и запросы блокировок, поэтому страница не находилась в стабильном состоянии, которое можно было бы сохранить в bfcache.

"masked"

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

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

"navigation-failure"

Исходная навигация, создавшая текущий документ, завершилась ошибкой, и сохранение получившегося документа с ошибкой в bfcache было предотвращено.

"parser-aborted"

Текущий документ не завершил начальную парсерную обработку HTML, и сохранение незавершенного документа в bfcache было предотвращено.

"websocket"

Во время выгрузки закрылось открытое подключение WebSocket, поэтому страница не находилась в стабильном состоянии, которое можно было бы сохранить в bfcache.

Некоторые браузеры могут использовать дополнительные причины блокировки, например:

"unload-listener"

Страница регистрирует обработчик unload, что предотвращает использование bfcache. Это служит полезным предупреждением, так как unload устарело. См. примечания к использованию для получения дополнительной информации.

"response-cache-control-no-store"

На странице используется no-store в качестве значения заголовка Cache-Control.

"related-active-contents"

Страница была открыта из другой страницы, которая всё ещё имеет ссылку на эту страницу, например, при использовании функции "дублирования вкладки".

См. Отслеживание причин блокировки bfcache для примеров.

• Отслеживание причин блокировки bfcache
• PerformanceNavigationTiming.notRestoredReasons