Node Version 3.x Upgrade Guide

This is an upgrade guide for moving from 2.x to 3.x versions of the twilio-node helper library.

Import

In twilio-node 2.x, you would have to make a new instance of each client you used:

var Twilio = require('twilio');

var ipmClient = new Twilio.IpMessagingClient(USERNAME, PASSWORD);
var lookupsClient = new Twilio.LookupsClient(USERNAME, PASSWORD);

Now, in twilio-node 3.x, there is only 1 object to import and initialize:

var Twilio = require('twilio');
var twilio = new Twilio(USERNAME, PASSWORD);

Accessing Resources

Listing Resources

Paging

One of the biggest advantages of twilio-node 3.x is that it automatically handles paging for you! In both list and stream, you can specify the maximum number of instances to grab (limit), and the page size (pageSize). The library will take care of everything else.

twilio.messages.each(function(message) {
  console.log(message.sid);
});

var promise = twilio.messages.list();
promise.then(function(messages) {
  console.log(messages.length);
});
// 125

promise = twilio.messages.list({
  limit: 100
});
promise.then(function(messages) {
  console.log(messages.length);
});
// 100

Proper Types

Configurable HTTP Client

You can now plug your own HTTP client into the Twilio client! Just pass a client that conforms to the RequestClient interface and pass it in when you initialize Twilio.

var client = new CustomClient();
var twilio = new Twilio(USERNAME, PASSWORD, client);