$.eventsource({
  
  // Assign a label to this event source
  
  label:    'event-source-label', 

  //  Set the file to receive data from the server

  url:      'event-sources/server-event-source.php',
  
  //  Set the type of data you expect to be returned
  //  text, json supported
  
  dataType: 'json', 
  
  //  Set a callback to fire when the event source is opened
  //  `onopen`
  open:  function (data) {


    console.log(data);

  },

  //  Set a callback to fire when a message is received
  //  `onmessage`
  message:  function (data) {


    console.log(data);

  }
});


//  Close event sources by label name

$.eventsource('close', 'event-source-label');

// PLAIN TEXT EXAMPLE - NO CONTENT TYPE GIVEN
$.eventsource({
  label:    'text-event-source',
  url:      'test-event-sources/text-event-source.php',
  open:  function () {

    console.log( 'opened' );

  },
  message:  function (data) {

    console.log(data);


    $.eventsource('close', 'text-event-source');
  }
});

// PLAIN TEXT EXAMPLE - HAS CONTENT TYPE
$.eventsource({
  label:    'text-event-source-ct',
  url:      'test-event-sources/text-event-source-ct.php',
  dataType: 'text',

  message:  function (data) {

    console.log(data);

    $.eventsource('close', 'text-event-source-ct');
  }
});


// JSON EXAMPLE - HAS CONTENT TYPE
$.eventsource({
  label:    'json-event-source',
  url:      'test-event-sources/json-event-source.php',
  dataType: 'json',
  open:  function () {

    console.log( 'opened' );

  },
  message:  function (data) {

    console.log(data);

    $.eventsource('close', 'json-event-source');
  }
});     

//  Returns an object containing all the currently active eventsource streams
$.eventsource('streams')

//  Server response MUST be Content-Type: text/event-stream
//  Server response MUST be prepended with 'data: '
//  UPDATE: Recent testing shows that the "data: " prefix is
//  no longer required, at least in nightly Chromium builds


// Examples:

//  PHP
header("Content-Type: text/event-stream\n\n");
echo 'data: this is a valid response';


//  Python
print "Content-Type: text/event-stream"
print "data: this is a valid response"