Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes