Twilio Client JavaScript SDK Changelog

The latest version of twilio.js can be found on Twilio's CDN at https://media.twiliocdn.com/sdk/js/client/releases/1.6.1/twilio.js https://media.twiliocdn.com/sdk/js/client/releases/1.6.1/twilio.min.js

Or on NPM at https://www.npmjs.com/package/twilio-client

1.6.2 (Nov 8, 2018)

Addition

Updated default RTCConfiguration object to ensure forward compatibility when plan-b is deprecated.
Added an rtcConfiguration field to IDeviceOptions, which takes an RTCConfiguration object that gets passed to any created RTCPeerConnections. Example:

Device.setup(token, {
  rtcConfiguration: { iceTransportPolicy: 'relay' },
});

1.6.1 (Oct 3, 2018)

Bug Fixes

Re-assigning the master output device mid-call, particularly when calling device.disconnectAll(), will no longer throw an exception or pause script execution.
Fixed closeProtection feature
Added EventEmitter interface (on, addListener, removeListener, etc...) to Device singleton.

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>
      <Parameter name="foo" value="bar"/>
      <Parameter 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.

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.

Thanks for rating this page!

Need some help?