node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Determines the size of an image without reading or downloading it entirely.

Implemented using an incremental parser, and can be fed multiple times with data chunks of any size.


var imagesize = require('imagesize');
imagesize(stream, function (err, result) {
  if (!err) {
    console.log(result); // {type, width, height}

The first argument should be a stream emitting data and end events.

Full example:

var http = require('http');
var imagesize = require('imagesize');
var request = http.get('', function (response) {
  imagesize(response, function (err, result) {
    // do something with result
    // we don't need more data

Advanced usage:

You can also use the incremental parser directly:

var Parser = require('imagesize').Parser;
var parser = Parser();
switch (parser.parse(buffer)) {
  case Parser.EOF:
    // needs moar data
  case Parser.INVALID:
    // invalid input, abort
  case Parser.DONE:
    var result = parser.getResult();