База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

PageTransitionEvent.persisted — запазване и възстановяване на документи

PageTransitionEvent предава информация за събитията pageshow и pagehide. Свойството persisted позволява да се различи възстановяването на документ от обикновено зареждане и показва дали браузърът възнамерява да запази документа за евентуална повторна употреба.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

event.persisted
new PageTransitionEvent(type, { persisted: boolean })

PageTransitionEvent наследява Event и е типът обект на събитие за pageshow и pagehide, обработвани върху window. Това е интерфейс на браузърния Web API, дефиниран в HTML, а не функция на конкретно издание на ECMAScript. Не описва CSS анимации на преходи.

PageTransitionEvent.persisted е булево свойство само за четене. При pageshow стойност true означава, че запазен документ е възстановен, обикновено от кеша за връщане/напред (bfcache); false означава, че такова възстановяване не е настъпило. Свойството не проверява дали е използван HTTP кешът. При първоначално зареждане pageshow настъпва след load.

При събитие pagehide, задействано от браузъра, стойност true означава, че браузърът възнамерява да запази документа за евентуална повторна употреба. Това не гарантира, че документът ще бъде добавен в bfcache или че ще бъде възстановен по-късно. В приложение чети event.persisted в обработчици, регистрирани чрез window.addEventListener("pageshow", handler) или window.addEventListener("pagehide", handler). Клонът за възстановяване може да се използва за обновяване на данни, които може да са остарели.

MDN посочва, че интерфейсът и свойството са широко достъпни от юли 2015 г., а конструкторът — от януари 2020 г. Проверявай поддръжката на конструктора отделно; Node 24 не доказва наличността на този браузърен API. Примерът създава две синтетични събития и проверява само разклонението: не задейства навигация или bfcache.

Примери

(() => {
  function describePageShow(event) {
    return event.persisted ? "restored" : "not restored";
  }

  for (const persisted of [false, true]) {
    const event = new PageTransitionEvent("pageshow", { persisted });
    console.log(describePageShow(event));
  }
})();

Резултат

not restored
restored

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници