CKTIS / JavaScript
PopStateEvent.state — stato della voce della cronologia
PopStateEvent.state consente di leggere lo stato associato alla voce della cronologia attivata durante un evento popstate. Scopri cosa significa null e perché salvare uno stato è diverso dal navigare nella cronologia.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.statePopStateEvent.state è una proprietà di sola lettura, accessibile come event.state. In un evento di navigazione contiene una copia dei dati salvati con history.pushState() o history.replaceState() nella voce appena attivata, non in quella che viene lasciata. Se non è stato salvato alcuno stato, il valore è null; verificalo prima di leggere i campi.
La sola chiamata a history.pushState() o history.replaceState() non attiva popstate. L’evento è associato allo spostamento nella cronologia, per esempio quando si usa il pulsante Indietro. Il browser può richiedere una precedente interazione con la pagina. In un’applicazione, ricevi l’evento con window.addEventListener("popstate", handler) e ripristina la vista usando event.state.
L’esempio crea intenzionalmente due oggetti PopStateEvent e li passa direttamente a una funzione. Non invia eventi e non modifica la cronologia. L’opzione state fornisce i dati del primo oggetto; se viene omessa, il valore è null. Le righe attese sono {"page":2} e null.
Questa è una Web API del browser definita dallo standard HTML, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che la proprietà è ampiamente disponibile da luglio 2015 e che il costruttore usato nell’esempio lo è da agosto 2016. La presenza di Node 24 in un repository non dimostra il supporto di queste interfacce.
Esempi
(() => {
function describeState(event) {
console.log(JSON.stringify(event.state));
}
describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
describeState(new PopStateEvent("popstate"));
})();Risultato
{"page":2}
nullIl codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.