CKTIS / HTML
onbeforeunload — gestire un evento prima di lasciare una pagina
L’attributo onbeforeunload su body imposta un gestore per l’evento beforeunload dell’oggetto Window. Può richiedere un avviso prima di lasciare la pagina, ma non garantisce né la visualizzazione di una finestra di dialogo né l’annullamento della navigazione.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<body onbeforeunload="event.preventDefault()">onbeforeunload è un attributo gestore di eventi su body. Il suo valore è codice JavaScript, non un nome di evento né un valore booleano. Gestisce l’evento beforeunload dell’oggetto Window, non un evento diretto a body stesso. La proprietà JavaScript corrispondente è window.onbeforeunload.
Quando si lascia davvero una pagina, il gestore può chiamare event.preventDefault() per richiedere una conferma. Un meccanismo storico consiste nell’impostare event.returnValue su una stringa non vuota. Una regola speciale per onbeforeunload consente anche di restituire un valore diverso da null e undefined per annullare l’evento; non applicare qui il consueto schema return false. Il valore restituito da una funzione passata a addEventListener() non funziona in questo modo.
L’annullamento dell’evento non garantisce che la navigazione si interrompa: il browser decide se mostrare una conferma e l’utente può scegliere di uscire. La finestra di dialogo richiede una precedente attivazione dell’utente e può essere soppressa dalle restrizioni del browser. Non è possibile impostare un testo di avviso personalizzato. Attiva il gestore solo in presenza di modifiche non salvate e rimuovilo dopo il salvataggio; non considerarlo un meccanismo garantito per salvare i dati.
L’esempio invia a window un evento sintetico e annullabile e controlla event.defaultPrevented. Il risultato previsto è true. Non verifica una navigazione reale né una finestra di dialogo; poi rimuove l’attributo affinché non rimanga alcun gestore attivo.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onbeforeunload wiring test</title>
</head>
<body onbeforeunload="event.preventDefault()">
<p>See the browser console.</p>
<script>
const event = new Event('beforeunload', { cancelable: true });
window.dispatchEvent(event);
console.log(event.defaultPrevented);
document.body.removeAttribute('onbeforeunload');
</script>
</body>
</html>Risultato
true
Il 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.