onmessage-gebeurtenis

DOM events Event object

Definitie en gebruik

Een onmessage-gebeurtenis vindt plaats wanneer een bericht via de eventbron wordt ontvangen.

Het event-object van de onmessage-gebeurtenis ondersteunt de volgende eigenschappen:

  • data - Bevat het daadwerkelijke bericht
  • origin - URL van het document dat de gebeurtenis aanroept
  • lastEventId - Identificatie van het laatste bericht in de gebeurtenisstroom

Gerelateerde gebeurtenissen:

  • onopen wordt aangeroepen wanneer de verbinding met de server geopend wordt
  • onerror wordt aangeroepen bij problemen

Voor meer informatie over Server-Sent Events (SSE), leer onze HTML5 Server-Sent Events handleiding.

Voorbeeld

Voorbeeld 1

Maak een nieuwe EventSource-object aan en specificeer de URL van de pagina die de updates verzendt.

Elke keer dat er een update binnenkomt, vindt er een onmessage-gebeurtenis plaats. Wanneer een onmessage-gebeurtenis optreedt, wordt de ontvangen gegevens in het <div>-element met id="myDIV" geplaatst:

var source = new EventSource("demo_sse.php");
source.onmessage = function(event) {
  document.getElementById("myDIV").innerHTML += event.data + "<br>";
};

Probeer het zelf uit

Voorbeeld 2

Haal de URL op van het document dat de onmessage-gebeurtenis aanroept:

var source = new EventSource("demo_sse.php");
source.onmessage = function(event) {
  document.getElementById("myDIV").innerHTML = event.origin;
};

Het resultaat zal zijn:

https://www.codew3c.com/

Probeer het zelf uit

Syntax

object.onmessage = function(){myScript};

Probeer het zelf uit

Gebruik de addEventListener() methode:

object.addEventListener("message", myScript);

Probeer het zelf uit

Opmerking:Internet Explorer 8 of eerder ondersteunt dit niet addEventListener() methode.

Technische details

Bubbel: Not supported
Kan annuleren: Not supported
Event type: Event

Browser support

The numbers in the table indicate the first browser version that fully supports the event.

Events Chrome IE Firefox Safari Opera
onmessage 9.0 Not supported 6.0 5.0 11.0
DOM events Event object