- Notifications
You must be signed in to change notification settings - Fork196
socket.io-client-dart: Dartlang port of socket.io-clienthttps://github.com/socketio/socket.io-client
License
rikulo/socket.io-client-dart
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Port of awesome JavaScript Node.js library -Socket.io-client v2._ ~ v4._ - in Dart
| socket.io-client-dart | Socket.io Server |
|---|---|
v0.9.* ~v1.* | v2.* |
v2.* | v3.* ~v4.6.* |
v3.* | v4.7.* ~ v4.* |
import'package:socket_io/socket_io.dart';main() {// Dart servervar io=Server();var nsp= io.of('/some'); nsp.on('connection', (client) {print('connection /some'); client.on('msg', (data) {print('data from /some => $data'); client.emit('fromServer',"ok 2"); }); }); io.on('connection', (client) {print('connection default namespace'); client.on('msg', (data) {print('data from default => $data'); client.emit('fromServer',"ok"); }); }); io.listen(3000);}
import'package:socket_io_client/socket_io_client.dart'as IO;main() {// Dart clientIO.Socket socket=IO.io('http://localhost:3000'); socket.onConnect((_) {print('connect'); socket.emit('msg','test'); }); socket.on('event', (data)=>print(data)); socket.onDisconnect((_)=>print('disconnect')); socket.on('fromServer', (_)=>print(_));}
To connect the socket manually, set the optionautoConnect: false and call.connect().
For example,
Socket socket = io('http://localhost:3000', OptionBuilder() .setTransports(['websocket']) // for Flutter or Dart VM .disableAutoConnect() // disable auto-connection .setExtraHeaders({'foo': 'bar'}) // optional .build() );socket.connect();Note that.connect() should not be called ifautoConnect: true(by default, it's enabled to true), as this will cause all event handlers to get registered/fired twice. SeeIssue #33.
Socket socket= ...// Create socket.socket.io.options['extraHeaders']= {'foo':'bar'};// Update the extra headers.socket.io..disconnect()..connect();// Reconnect the socket manually.
Socket socket= ...// Create socket.socket.onConnect((_) {print('connect'); socket.emitWithAck('msg','init', ack: (data) {print('ack $data') ;if (data!=null) {print('from server $data'); }else {print("Null") ; } });});
These events can be listened on.
constListEVENTS= ['connect','connect_error','disconnect','error','reconnect','reconnect_attempt','reconnect_failed','reconnect_error','ping','pong'];// Replace 'onConnect' with any of the above events.socket.onConnect((_) {print('connect');});
socket.on('eventName', (data) {final dataList= dataasList;final ack= dataList.lastasFunction;ack(null);});
In Flutter env. not (Flutter Web env.) it only works withdart:io websocket,not withdart:html websocket or Ajax (XHR), so in this caseyou have to addsetTransports(['websocket']) when creates the socket instance.
For example,
IO.Socket socket=IO.io('http://localhost:3000',OptionBuilder() .setTransports(['websocket'])// for Flutter or Dart VM .setExtraHeaders({'foo':'bar'})// optional .build());
import'dart:async';// STEP1: Stream setupclassStreamSocket{final _socketResponse=StreamController<String>();voidFunction(String)get addResponse=> _socketResponse.sink.add;Stream<String>get getResponse=> _socketResponse.stream;voiddispose(){ _socketResponse.close(); }}StreamSocket streamSocket=StreamSocket();//STEP2: Add this function in main function in main.dart file and add incoming data to the streamvoidconnectAndListen(){IO.Socket socket=IO.io('http://localhost:3000',OptionBuilder() .setTransports(['websocket']).build()); socket.onConnect((_) {print('connect'); socket.emit('msg','test'); });//When an event received from server, data is added to the stream socket.on('event', (data)=> streamSocket.addResponse); socket.onDisconnect((_)=>print('disconnect'));}//Step3: Build widgets with StreamBuilderclassBuildWithSocketStreamextendsStatelessWidget {constBuildWithSocketStream({Key key}):super(key: key);@overrideWidgetbuild(BuildContext context) {returnContainer( child:StreamBuilder( stream: streamSocket.getResponse , builder: (BuildContext context,AsyncSnapshot<String> snapshot){returnContainer( child: snapshot.data, ); }, ), ); }}
There is a design decision in the baseline IO lookup command related to the caching of socket instances.
We reuse the existing instance based on same scheme/port/host.
It is important to make clear that bothdispose() anddestroy() do NOT remove a host from the cache of known connections. This can cause attemptedsubsequent connections to ignore certain parts of your configuration if not handled correctly. You must handle this by using the optionsavailable in the OptionBuilderduring the first creation of the instance.
In the following example, there is a userId and username set as extra headers for this connection.If you were to try and create the same connection with updated values, if the host is the same, the extra headers will not be updated and the oldconnection would be returned.
_socket= io.io( host, io.OptionBuilder() .setTransports(['websocket']) .setExtraHeaders({'id': userId,'name': username}) .disableAutoConnect() .enableReconnection() .build());
In order to prevent this, depending on your application's needs, you can either useenableForceNew() ordisableMultiplex() to theoption builder. These options would modify all connections using the same host, so be aware and plan accordingly.
An additional option, if it fits your use case, would be to follow the usage mentioned above inUpdate the extra headers.By updating the extra headers outside of the building of the options, you can guarantee that your connections will have the values you are expecting.
- Refer todart-lang/sdk#34284 issue.The workaround is to use the following code provided by@lehno on#84
classMyHttpOverridesextendsHttpOverrides {@overrideHttpClientcreateHttpClient(SecurityContext? context) {returnsuper.createHttpClient(context) ..badCertificateCallback= (X509Certificate cert,String host,int port)=>true; }}voidmain() {HttpOverrides.global=MyHttpOverrides();runApp(MyApp());}
- Refer to#108 issue.Please use
socket.dispose()instead ofsocket.close()orsocket.disconnect()to solve the memory leak issue on iOS.
- Refer toflutter/flutter#47606 (comment) issue.
By adding the following key into the to file*.entitlements under directorymacos/Runner/
<key>com.apple.security.network.client</key><true/>
For more details, please take a look athttps://flutter.dev/desktop#setting-up-entitlements
The HTTP connections are disabled by default on iOS and Android, so here is a workaround to this issue,which mentioned onstack overflow
If you'd like to contribute back to the core, you canfork this repository and send us a pull request, when it is ready.
If you are new to Git or GitHub, please readthis guide first.
Contribution of all kinds is welcome. Please readContributing.md in this repository.
About
socket.io-client-dart: Dartlang port of socket.io-clienthttps://github.com/socketio/socket.io-client
Topics
Resources
License
Contributing
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.