← Cloudflare Workers / workers / runtime-apis

EventSource

EventSource ↗ интерфейс представляет собой API для server-sent событий, который позволяет серверу отправлять события клиенту. EventSource объект используется для получения server-sent events. Он подключается к серверу по HTTP и получает события в текстовом формате.

let eventSource = new EventSource(url, options);

• url USVString: URL, к которому выполняется подключение.
• options EventSourceInit: необязательный словарь с любыми дополнительными настройками.

По умолчанию EventSource будет использовать глобальный fetch() функцию под капотом для выполнения запросов. Если вам нужна другая реализация fetch, предоставленная через привязку Cloudflare Workers, вы можете передать fetcher параметр:

export default {
  async fetch(req, env) {
    let eventSource = new EventSource(url, { fetcher: env.MYFETCHER });
    // ...
  }
};

Обратите внимание на fetcher параметр представляет собой специфичное расширение Cloudflare Workers.

• eventSource.url USVString, только для чтения
  • URL источника события.
• eventSource.readyState USVString, только для чтения
  • Состояние соединения.
• eventSource.withCredentials Boolean только для чтения
  • Логическое значение, указывающее, что EventSource объект был создан с установленными межсайтовыми (CORS) учётными данными (true), или нет (false).

• eventSource.close()
  • Закрывает соединение.
• eventSource.onopen
  • Обработчик события, вызываемый при открытии соединения.
• eventSource.onmessage
  • Обработчик события, вызываемый при получении сообщения.
• eventSource.onerror
  • Обработчик события, вызываемый при возникновении ошибки.

• message
  • Возникает при получении сообщения.
• open
  • Возникает при открытии соединения.
• error
  • Возникает при ошибке.

• EventSource.from(readableStreamReadableStream) : EventSource
  • Это специфичное для Cloudflare Workers расширение, которое создает новый EventSource объект из существующего ReadableStream. Такой экземпляр не инициирует новое соединение, а вместо этого подключается к предоставленному потоку.