dart:html

Класс WebSocket

Используйте интерфейс WebSocket для подключения к WebSocket и для отправки и получения данных по этому WebSocket.

Для использования WebSocket в вашем веб-приложении сначала создайте объект WebSocket, передав URL WebSocket в качестве аргумента конструктору.

var webSocket = new WebSocket('ws://127.0.0.1:1337/ws');

Для отправки данных по WebSocket используйте метод send.

if (webSocket != null && webSocket.readyState == WebSocket.OPEN) {
  webSocket.send(data);
} else {
  print('WebSocket not connected, message $data not sent');
}

Для получения данных по WebSocket зарегистрируйте обработчик событий сообщения.

webSocket.onMessage.listen((MessageEvent e) {
  receivedData(e.data);
});

Обработчик события сообщения получает объект MessageEvent в качестве единственного аргумента. Вы также можете определить обработчики событий открытия, закрытия и ошибки, как указано в Event.

Для получения дополнительной информации см. раздел WebSockets в туре по библиотеке и Введение в WebSockets, учебник HTML5Rocks.com.

Наследование

• Object
• EventTarget
• WebSocket

Аннотации

• @SupportedBrowser(SupportedBrowser.CHROME)
• @SupportedBrowser(SupportedBrowser.FIREFOX)
• @SupportedBrowser(SupportedBrowser.IE, '10')
• @SupportedBrowser(SupportedBrowser.SAFARI)
• @Unstable()
• @Native("WebSocket")

Конструкторы

WebSocket(String url, [Object? protocols])

factory

Свойства

binaryType ↔ String?

чтение/запись

bufferedAmount → int?

только для чтения

extensions → String?

только для чтения

hashCode → int

только для чтения, унаследованное

Хэш-код этого объекта.

on → Events

только для чтения, унаследованное

Это вспомогательный аксессор для потоков событий, который следует использовать только в том случае, если явный аксессор недоступен.

onClose → Stream<CloseEvent>

только для чтения

Поток событий close обрабатываемых этим WebSocket.

onError → Stream<Event>

только для чтения

Поток событий error обрабатываемых этим WebSocket.

onMessage → Stream<MessageEvent>

только для чтения

Поток событий message обрабатываемых этим WebSocket.

onOpen → Stream<Event>

только для чтения

Поток событий open обрабатываемых этим WebSocket.

protocol → String?

только для чтения

readyState → int

только для чтения

runtimeType → Type

только для чтения, унаследованное

Представление типа объекта в момент выполнения.

url → String?

только для чтения

Методы

addEventListener(String type, EventListener? listener, [bool? useCapture]) → void

унаследованное

close([int? code, String? reason]) → void

dispatchEvent(Event event) → bool

унаследованное

noSuchMethod(Invocation invocation) → dynamic

унаследованное

Вызывается при обращении к несуществующему методу или свойству.

removeEventListener(String type, EventListener? listener, [bool? useCapture]) → void

унаследованное

send(dynamic data) → void

Передаёт данные на сервер по этому соединению.

sendBlob(Blob data) → void

@JSName('send')

Передаёт данные на сервер по этому соединению.

sendByteBuffer(ByteBuffer data) → void

@JSName('send')

Передаёт данные на сервер по этому соединению.

sendString(String data) → void

@JSName('send')

Передаёт данные на сервер по этому соединению.

sendTypedData(TypedData data) → void

@JSName('send')

Передаёт данные на сервер по этому соединению.

toString() → String

унаследованное

Строковое представление этого объекта.

Операторы

operator ==(Object other) → bool

унаследованное

Оператор равенства.

Статические свойства

supported → bool

только для чтения

Проверяет, поддерживается ли этот тип на текущей платформе.

Константы

CLOSED → const int

3

closeEvent → const EventStreamProvider<CloseEvent>

Статический фабричный метод, предназначенный для экспонирования событий close обработчикам событий, которые не обязательно являются экземплярами WebSocket.

const EventStreamProvider<CloseEvent>('close')

CLOSING → const int

2

CONNECTING → const int

0

errorEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий error обработчикам событий, которые не обязательно являются экземплярами WebSocket.

const EventStreamProvider<Event>('error')

messageEvent → const EventStreamProvider<MessageEvent>

Статический фабричный метод, предназначенный для экспонирования событий message обработчикам событий, которые не обязательно являются экземплярами WebSocket.

const EventStreamProvider<MessageEvent>('message')

OPEN → const int

1

openEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий open обработчикам событий, которые не обязательно являются экземплярами WebSocket.

const EventStreamProvider<Event>('open')