此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

EventSource()

基线 广泛可用

自 2020年1月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

EventSource() 构造函数返回一个新建的EventSource,它代表了一个远程资源。

语法

pc = new EventSource(url, configuration);

参数

url

一个String ,它代表远程资源的位置

configuration 可选

为配置新连接提供选项。可选项是:

  • withCredentials,默认为 false,指示 CORS 是否应包含凭据 ( credentials )。

返回值

一个新建的 EventSource 对象,如果指定了configuration,则按其配置;否则,配置为合适的基本默认值。

示例

js
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);
};

备注:你可以在 GitHub 查看完整示例 — 请查看 Simple SSE demo using PHP.

规范

规范
HTML
# dom-eventsource-dev

浏览器兼容性

参见