Twilio Client JavaScript SDK Changelog

twilio.js 1.6

1.6.0 (Aug 29, 2018)

New Features

Added the ability to receive and handle incoming calls while on an active call behind a new flag, allowIncomingWhileBusy. When set to true, Device's default behavior of silently ignoring the incoming call is removed, and the incoming call will instead cause Device to emit an "incoming" event. If accepted, the prior active call will be immediately disconnected, and the incoming call will be accepted, replacing the prior active call.

Twilio.Device.setup(token, { allowIncomingWhileBusy: true });

Added support for custom incoming parameters from TwiML as Map<string, string> Connection.customParameters. When a TwiML application sends custom parameters using the <Parameter> noun, these parameters will be added to Connection.customParameters. For example:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>
    <Client>
      <Identity>alice</Identity>
      <Param name="foo" value="bar"/>
      <Param name="baz" value="123"/>
    </Client>
  </Dial>
</Response>

device.on('incoming', connection => {
  assert.equal(connection.customParameters.get('foo'), 'bar');
  assert.equal(connection.customParameters.get('baz'), '123');
});

Note that the following restrictions apply to the Parameter noun:

Parameter name must be a string, up to 32 bytes.
Parameter value must be a string, up to 128 bytes.
Up to 8 parameters can be sent per dial.

twilio.js 1.5

1.5.1 (Aug 15, 2018)

Bug Fixes

Updated Insights logic to point to new endpoint, fully supporting Insights when using Access Tokens

1.5.0 (Aug 08, 2018)

New Features

Twilio.Device may now be instantiated multiple times via

const device = new Twilio.Device(token, options);

Twilio.Device.setup() may now be called with Access Tokens, in addition to Capability Tokens.
Twilio.Device.destroy() will now completely clear out the Device, allowing Device.setup() to be called with a new set of options

Bug Fixes

We now ensure all Audio resources are cleaned up after closing a Connection

Deprecations

Twilio Client is moving toward the standard EventEmitter interface, meaning events should be managed with .on(eventName, handler) and .removeListener(eventName, handler), replacing our legacy handlers (such as .accept(handler), .error(handler), etc...). The following methods are deprecated:

Device.cancel(handler)
Device.connect(handler)
Device.disconnect(handler)
Device.error(handler)
Device.incoming(handler)
Device.offline(handler)
Device.ready(handler)
Connection.accept(handler)
Connection.cancel(handler)
Connection.disconnect(handler)
Connection.error(handler)
Connection.ignore(handler)
Connection.mute(handler)
Connection.reject(handler)
Connection.volume(handler)

These have been replaced with the following EventEmitter events:

Device.on('cancel', handler)
Device.on('connect', handler)
Device.on('disconnect', handler)
Device.on('error', handler)
Device.on('incoming', handler)
Device.on('offline', handler)
Device.on('ready', handler)
Connection.on('accept', handler)
Connection.on('cancel', handler)
Connection.on('disconnect', handler)
Connection.on('error', handler)
Connection.on('mute', handler)
Connection.on('reject', handler)
Connection.on('volume', handler)

Note that there is no Connection#ignore event. The Connection.ignore(handler) method is actually a backward-compatible listener for the Connection.on('cancel', handler) event.

Twilio Client JavaScript SDK Changelog

Thank you for your feedback!

Need some help?