W3cubDocs

/DOM

EventSource.constructor

The EventSource() constructor returns a newly-created EventSource, which represents a remote resource.

Syntax

eventSource = new EventSource(url, configuration);

Parameters

url
A USVString that represents the location of the remote resource serving the events/messages.
configuration Optional
Provides options to configure the new connection. The possible entries are:
  • withCredentials, defaulting to false, indicating if CORS should be set to include credentials.

Examples

var evtSource = new EventSource('sse.php');
var eventList = document.querySelector('ul');

evtSource.onmessage = function(e) {
  var newElement = document.createElement("li");

  newElement.textContent = "message: " + e.data;
  eventList.appendChild(newElement);
}

Note: You can find a full example on GitHub — see Simple SSE demo using PHP.

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'EventSource()' in that specification.
Living Standard Initial definition

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 9 No 6 No 11 5
CORS support (withCredentials) 26 No 11 No 12 ?
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes 18 No 6 11 5 ?
CORS support (withCredentials) Yes 26 No 14 12 ? ?

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/EventSource/EventSource