Latest web development tutorials
 

onmessage Event

< Event Object

Example

Create a new EventSource object, and specify the URL of the page sending the updates.
Each time an update is received, the onmessage event occurs. When an onmessage event occurs, put the received data into the <div> element with id="myDIV":

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

More "Try it Yourself" examples below.


Definition and Usage

The onmessage event occurs when a message is received through an event source.

The event object for the onmessage event supports the following properties:

  • data - Contains the actual message
  • origin - The URL of the document that invoked the event
  • lastEventId - the identifier of the last message seen in the event stream

Related events:

  • onopen - Occurs when a connection to the server is open
  • onerror - Occurs when a problem occurs

For more information about Server-Sent Events, read our HTML5 Server-Sent Events Tutorial.


Browser Support

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

Event
onmessage 9.0 Not supported 6.0 5.0 11.0

Syntax

object.onmessage=function(){myScript};
Try it Yourself »

Using the addEventListener() method:

object.addEventListener("message", myScript);
Try it Yourself »

Note: The addEventListener() method is not supported in Internet Explorer 8 and earlier versions.


Technical Details

Bubbles: No
Cancelable: No
Event type: Event

Examples

More Examples

Example

Get the URL of the document that invoked the onmessage event:

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

The result could be:

http://www.w3ii.com/
Try it Yourself »

< Event Object