onmessage-händelse
Definition och användning
En onmessage-händelse inträffar när ett meddelande mottas via eventkälla.
Event-objektet för onmessage-händelsen stöder följande egenskaper:
- data - Innehåller det faktiska meddelandet
- origin - URL:en för dokumentet som anropar händelsen
- lastEventId - Identifikatorn för det sista meddelandet i händelselåten
Relaterade händelser:
För mer information om server-sända händelser (Server-Sent Events), lär dig vår HTML5 Server-Sent Events tutorial.
Exempel
Exempel 1
Skapa ett nytt EventSource-objekt och specificera URL:en för sidan som skickar uppdateringar.
Varje gång det sker en uppdatering, inträffar onmessage-händelsen. När onmessage-händelsen inträffar, placeras mottagna data i <div>-elementet med id="myDIV":
var source = new EventSource("demo_sse.php"); source.onmessage = function(event) { document.getElementById("myDIV").innerHTML += event.data + "<br>"; };
Exempel 2
Hämta URL:en för dokumentet som anropar onmessage-händelsen:
var source = new EventSource("demo_sse.php"); source.onmessage = function(event) { document.getElementById("myDIV").innerHTML = event.origin; };
Resultatet kommer att vara:
https://www.codew3c.com/
Syntax
object.onmessage = function(){myScript};
Använd addEventListener() metoden:
object.addEventListener("message", myScript);
Kommentar:Internet Explorer 8 eller tidigare versioner stöder inte addEventListener() metoden.
Tekniska detaljer
Bubbla: | Ej stödd |
---|---|
Kan avbrytas: | Ej stödd |
Händelsetyper: | Event |
Webbläsarstöd
Numreringen i tabellen anger den första webbläsarens version som fullständigt stöder denna händelse.
Händelser | Chrome | IE | Firefox | Safari | Opera |
---|---|---|---|---|---|
onmessage | 9.0 | Ej stödd | 6.0 | 5.0 | 11.0 |