Broadcast transmission support

README.md

@@ -76,6 +76,20 @@ oscServer.on('bundle', function (bundle) {
 });
 ```
 
+### Enabling Broadcast on Client
+
+**WARNING**: Broadcast support is Experimental and subject to change at any point. 
+
+```js
+import { Client } from 'node-osc';
+
+const client = new Client('127.0.0.1', 3333);
+client.setBroadcast(true);
+client.send('/oscAddress', 200, () => {
+  client.close();
+});
+```
+
 ### CJS API
 
 This just works due to conditional exports, isn't that cool!

lib/Client.mjs

@@ -12,7 +12,24 @@ class Client {
       type: 'udp4',
       reuseAddr: true
     });
+    this._bound = false;
   }
+  setBroadcast(flag, cb) {
+    if (!cb) cb = () => {};
+    if (typeof flag !== 'boolean') {
+      throw new TypeError('flag must be a boolean');
+    }
+    if (this._bound) {
+      this._sock.setBroadcast(flag);
+      cb();
+      return;
+    }
+    this._sock.bind(this.port, () => {
+      this._bound = true;
+      this._sock.setBroadcast(flag);
+      cb();
+     })
+   }
   close(cb) {
     this._sock.close(cb);
   }

test/test-client.mjs

@@ -91,6 +91,38 @@ test('client: with Bundle object', (t) => {
   });
 });
 
+test('client: setBroadcast', (t) => {
+  const oscServer = new Server(t.context.port, '127.0.0.1');
+  const client = new Client('127.0.0.1', t.context.port);
+
+  t.plan(2);
+
+  client.setBroadcast(true);
+
+  oscServer.on('message', (msg) => {
+    oscServer.close();
+    t.same(msg, ['/test', 0, 1, 'testing', true], 'We should receive expected payload');
+  });
+
+  client.send(['/test', 0, 1, 'testing', true], (err) => {
+    client.setBroadcast(false);
+    t.error(err, 'there should be no error');
+    client.close();
+  });
+});
+
+test('client: setBroadcast typeError', (t) => {
+  const client = new Client('127.0.0.1', t.context.port);
+
+  t.plan(1);
+
+  t.throws(() => {
+    client.setBroadcast('Oops');;
+  });
+
+  client.close();
+});
+
 test('client: failure', (t) => {
   const client = new Client('127.0.0.1', t.context.port);