The web_socket_channel package provides StreamChannel wrappers for WebSocket connections. It provides a cross-platform WebSocketChannel API, a cross-platform implementation of that API that communicates over an underlying StreamChannel, an implementation that wraps dart:io's WebSocket class, and a similar implementation that wraps dart:html's.
It also provides constants for the WebSocket protocol's pre-defined status codes in the status.dart library. It's strongly recommended that users import this library with the prefix status.
import 'package:web_socket_channel/io.dart';
import 'package:web_socket_channel/status.dart' as status;
main() async {
var channel = IOWebSocketChannel.connect(Uri.parse('ws://localhost:1234'));
channel.stream.listen((message) {
channel.sink.add('received!');
channel.sink.close(status.goingAway);
});
}
WebSocketChannel
The WebSocketChannel class's most important role is as the interface for WebSocket stream channels across all implementations and all platforms. In addition to the base StreamChannel interface, it adds a protocol getter that returns the negotiated protocol for the socket, as well as closeCode and closeReason getters that provide information about why the socket closed.
The channel's sink property is also special. It returns a WebSocketSink, which is just like a StreamSink except that its close() method supports optional closeCode and closeReason parameters. These parameters allow the caller to signal to the other socket exactly why they're closing the connection.
WebSocketChannel also works as a cross-platform implementation of the WebSocket protocol. The WebSocketChannel.connect constructor connects to a listening server using the appropriate implementation for the platform. The WebSocketChannel() constructor takes an underlying StreamChannel over which it communicates using the WebSocket protocol. It also provides the static signKey() method to make it easier to implement the initial WebSocket handshake. These are used in the shelf_web_socket package to support WebSockets in a cross-platform way.
![[Ping Interval] Allow control over websocket ping interval](https://avatars.githubusercontent.com/u/13107481?v=4)
![[Web] Unsupported operation: Platform._version](https://avatars.githubusercontent.com/u/37765346?v=4)
![[ERROR:flutter/lib/ui/ui_dart_state.cc(148)] Unhandled Exception: Invalid argument(s)](https://avatars.githubusercontent.com/u/1247062?v=4)
3 Jun 30, 2022
0 Sep 2, 2022
7 Dec 23, 2022
122 Sep 20, 2022
14 Nov 30, 2022
4 May 11, 2021
4 Dec 21, 2021
2 Oct 13, 2021
415 Jan 8, 2023
2 Nov 16, 2021
1 Nov 7, 2021
1.7k Dec 30, 2022
1 Jan 5, 2022
21 Dec 21, 2022
1 Jan 23, 2022
10 Dec 5, 2022
6 Apr 3, 2022
31 Oct 21, 2022
4 Feb 2, 2022