CKTIS / JavaScript
PageTransitionEvent.persisted — preservar e restaurar documentos
PageTransitionEvent transporta informações sobre os eventos pageshow e pagehide. A propriedade persisted permite distinguir a restauração de um documento de um carregamento normal e indica se o navegador tenciona preservar o documento para uma possível reutilização.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.persisted
new PageTransitionEvent(type, { persisted: boolean })PageTransitionEvent herda de Event e é o tipo de objeto de evento para pageshow e pagehide, tratados em window. É uma interface da API Web do navegador definida em HTML, não uma funcionalidade de uma edição específica de ECMAScript. Não descreve animações de transição CSS.
PageTransitionEvent.persisted é uma propriedade booleana só de leitura. Para pageshow, true significa que foi restaurado um documento preservado, geralmente da cache de navegação anterior/seguinte (bfcache); false significa que não ocorreu essa restauração. Não testa se foi utilizada a cache HTTP. No carregamento inicial, pageshow ocorre depois de load.
Num evento pagehide desencadeado pelo navegador, true significa que o navegador tenciona preservar o documento para uma possível reutilização. Não garante que o documento seja guardado na bfcache nem que seja restaurado mais tarde. Numa aplicação, lê event.persisted em manipuladores registados através de window.addEventListener("pageshow", handler) ou window.addEventListener("pagehide", handler). O ramo de restauração pode ser usado para atualizar dados que entretanto se possam ter tornado obsoletos.
A MDN indica que a interface e a propriedade estão amplamente disponíveis desde julho de 2015, e o construtor desde janeiro de 2020. Verifica o suporte do construtor separadamente; o Node 24 não comprova a disponibilidade desta API do navegador. O exemplo cria dois eventos sintéticos e testa apenas a ramificação: não provoca navegação nem utilização de bfcache.
Exemplos
(() => {
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));
}
})();Resultado
not restored restored
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.