CHANGELOG.md

2.1.0 (2017-10-05)

• Minor change: Better error handling by returning an error of type HttpError if the response status code is 4xx/5xx, instead of the generic TypeError: unsupported file type: undefined (file: undefined) passed by image-size. Fixes #8, thanks to @Arturszott and @dustingraves for their contribution.

2.0.0 (2017-08-10)

• Breaking change: request-image-size now returns an ES6 native promise instead of using a callback. Please read about the new API in the README. Requires Node.js v4+.
• Updated image-size to 0.6.1, adds support for ICO/CUR.

1.3.0 (2017-04-20)

This is the last version using a callback instead of returning a promise.

Basic usage

var requestImageSize = require('request-image-size');

requestImageSize('http://nodejs.org/images/logo.png', function(err, size, downloaded) {

  if (err) {
    return console.error('An error has ocurred:', error);
  }

  if (!size) {
    return console.error('Could not get image size');
  }

  console.log('Image is %dpx x %dpx, downloaded %d bytes', size.width, size.height, downloaded);

});

Advanced usage

Specifying a request options object (docs):

var requestImageSize = require('request-image-size');

var options = {
  url: 'http://nodejs.org/images/logo.png',
  headers: {
    'User-Agent': 'request-image-size'
  }
};

requestImageSize(options, function(err, size, length) {
  console.log(err, size, length);
});

The callback receives three arguments: err, size, downloaded:

• err returns an Error object if anything goes wrong.
• size is in the form { width: 245, height: 66, type: 'png' }.
• downloaded is the number of bytes downloaded before being able to extract the image size.