Miss any of our Open RFC calls?Watch the recordings here! »

react-native-udp-thinkout

3.0.1 • Public • Published

UDP in React Native

node's dgram API in React Native

This module is used by Tradle

Compatibility

React Native Version Use Version
<=0.59.10 <=2.7.0
>=0.60.0 >=3.0.0

Installion

npm install --save react-native-udp-thinkout

Link in the native dependency

For versions >= 3.0.0:

cd ios
pod install

For versions <=2.7.0:

react-native link react-native-udp
# OR, if you're using react-native older than 0.31:
rnpm link react-native-udp

Android (only for versions <=2.7.0)

  • Register and load the Native Module in your Main application (import, getPackages)
    • Note: prior to react-native 0.29.2, this should happen in your Main Activity
...
 
import com.tradle.react.UdpSocketsModule; // <--- import // 
 
public class MainApplication extends Application implements ReactApplication {
    ...
    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            new UdpSocketsModule() // <- add here // 
        );
    }
}

Buckle up, Dorothy

Usage

package.json

only if you want to write require('dgram') in your javascript

{
  "browser": {
    "dgram": "react-native-udp"
  }
}

JS

see/run index.js for a complete example, but basically it's just like dgram

var dgram = require('dgram')
// OR, if not shimming via package.json "browser" field:
// var dgram = require('react-native-udp')
var socket = dgram.createSocket('udp4')
socket.bind(12345)
socket.once('listening', function() {
  var buf = toByteArray('excellent!')
  socket.send(buf, 0, buf.length, remotePort, remoteHost, function(err) {
    if (err) throw err
 
    console.log('message was sent')
  })
})
 
socket.on('message', function(msg, rinfo) {
  console.log('message was received', msg)
})

Note

If you want to send and receive node Buffer objects, you'll have to "npm install buffer" and set it as a global for UdpSockets to pick it up:

global.Buffer = global.Buffer || require('buffer').Buffer

TODO

add select tests from node's tests for dgram

Contributors

Mark Vayngrib
Ellen Katsnelson
Tradle, Inc.

Andy Prock

PR's welcome!

Install

npm i react-native-udp-thinkout

DownloadsWeekly Downloads

1

Version

3.0.1

License

MIT

Unpacked Size

257 kB

Total Files

27

Last publish

Collaborators

  • avatar