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:

  • onopen - Inträffar när anslutningen till servern öppnas
  • onerror - Inträffar när det uppstår problem

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>";
};

Prova själv

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/

Prova själv

Syntax

object.onmessage = function(){myScript};

Prova själv

Använd addEventListener() metoden:

object.addEventListener("message", myScript);

Prova själv

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