---
title: EventSource
slug: Web/API/EventSource
tags:
  - API
  - Interface
  - Referenz
  - Server-sent events
translation_of: Web/API/EventSource
---
<p>{{APIRef("Websockets API")}}</p>

<p>Das <strong>EventSource</strong>-Interface erlaubt das Empfangen von Server-Sent Events. Es erlaubt den Zugriff auf Events im <code>text/event-stream</code> Format über eine persistente HTTP-Verbindung.</p>

<dl>
</dl>

<h2 id="Properties">Properties</h2>

<p><em>Diese Interface erbt weitere Properties von seinem Parent-Object {{domxref("EventTarget")}}.</em></p>

<dl>
 <dt>{{domxref("EventSource.onerror")}}</dt>
 <dd>Ist eine {{event("Event_handlers", "event handler")}}-Instanz. Diese wird aufgerufen, wenn ein Fehler auftritt und das {{event("error")}}-Event auf diesem Object ausgelöst wird.</dd>
 <dt>{{domxref("EventSource.onmessage")}}</dt>
 <dd>Ist eine {{event("Event_handlers", "event handler")}}-Instanz. Diese wir aufgerufen, wenn ein {{event("message")}}-event empfangen wird. Dies ist immer dann der Fall, wenn die Event-Quelle eine neue Nachricht erzeugt hat.</dd>
 <dt>{{domxref("EventSource.onopen")}}</dt>
 <dd>Ist eine {{event("Event_handlers", "event handler")}}-Instanz. Diese wird immer dann aufgerufen, wenn die Verbindung geöffnet wurde, also ein {{event("open")}}-Event empfangen wurde.</dd>
 <dt>{{domxref("EventSource.readyState")}} {{readonlyinline}}</dt>
 <dd>Ein <code>unsigned short</code>, welcher den aktuellen Status der Verbindung repräsentiert. Gültige werte sind <code>CONNECTING</code> (<code>0</code>), <code>OPEN</code> (<code>1</code>), or <code>CLOSED</code> (<code>2</code>).</dd>
 <dt>{{domxref("EventSource.url")}} {{readonlyinline}}</dt>
 <dd>Ein {{domxref("DOMString")}}, welcher die URL der Event-Quelle beinhaltet.</dd>
</dl>

<h2 id="Methods">Methods</h2>

<p><em>Diese Interface erbt weitere Methoden von seinem Parent-Object {{domxref("EventTarget")}}.</em></p>

<dl>
 <dt>{{domxref("EventSource.close()")}}</dt>
 <dd>Schließt die Verbindung, soweit geöffnet, und setzt den Status (<code>readyState</code>) auf CLOSED. Auf bereits geschlossenen Verbindungen hat diese Methode keinen Effekt.</dd>
</dl>

<h2 id="Spezifikationen">Spezifikationen</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spezifikation</th>
   <th scope="col">Status</th>
   <th scope="col">Kommentar</th>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "comms.html#the-eventsource-interface", "EventSource")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<ul>
</ul>

<h2 id="Browser_Kompatiblität">Browser Kompatiblität</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basis-Support</td>
   <td>9</td>
   <td>{{ CompatGeckoDesktop("6.0") }}</td>
   <td>{{CompatUnknown}}</td>
   <td>11</td>
   <td>5</td>
  </tr>
  <tr>
   <td>CORS-Support</td>
   <td>26</td>
   <td>{{ CompatGeckoDesktop("11.0") }}</td>
   <td>{{CompatUnknown}}</td>
   <td>12</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basis-Support</td>
   <td>{{ CompatAndroid("4.4") }}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Siehe_auch">Siehe auch</h2>

<ul>
 <li><a href="/en/Server-sent_events/Using_server-sent_events" title="en/Server-sent events/Using server-sent events">Using server-sent events</a></li>
</ul>