KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

PageTransitionEvent.persisted — documenten behouden en herstellen

PageTransitionEvent bevat informatie over pageshow- en pagehide-gebeurtenissen. De eigenschap persisted maakt onderscheid tussen het herstellen van een document en een gewone laadbeurt, en geeft aan of de browser van plan is het document te bewaren voor mogelijk hergebruik.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

PageTransitionEvent erft van Event en is het gebeurtenisobjecttype voor pageshow en pagehide, die op window worden afgehandeld. Het is een browser-Web-API-interface die is gedefinieerd in HTML, geen functie van een bepaalde ECMAScript-editie. Het beschrijft geen CSS-overgangsanimaties.

PageTransitionEvent.persisted is een alleen-lezen booleaanse eigenschap. Bij pageshow betekent true dat een bewaard document is hersteld, meestal uit de terug/vooruit-cache (bfcache); false betekent dat dit niet is gebeurd. De eigenschap controleert niet of de HTTP-cache is gebruikt. Bij de eerste laadbeurt vindt pageshow plaats na load.

Bij een pagehide-gebeurtenis die door de browser wordt geactiveerd, betekent true dat de browser van plan is het document te bewaren voor mogelijk hergebruik. Dat garandeert niet dat het document in de bfcache terechtkomt of later wordt hersteld. Lees in een toepassing event.persisted in handlers die zijn geregistreerd met window.addEventListener("pageshow", handler) of window.addEventListener("pagehide", handler). De herstelvertakking kan worden gebruikt om gegevens bij te werken die mogelijk verouderd zijn geraakt.

MDN vermeldt dat de interface en eigenschap sinds juli 2015 breed beschikbaar zijn, en de constructor sinds januari 2020. Controleer ondersteuning voor de constructor afzonderlijk; Node 24 bewijst niet dat deze browser-API beschikbaar is. Het voorbeeld maakt twee synthetische gebeurtenissen en test alleen de vertakking: het start geen navigatie en gebruikt geen bfcache.

Voorbeelden

(() => {
  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));
  }
})();

Resultaat

not restored
restored

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen