Skip to content package
image-size v2.0.2 get dimensions of any image file
node >=16.x 0 deps esm cjs types open source
overview readme
license MIT
deps 0
unpacked 369.5 kB
files 116
node >=16.x $ npm install image-size@2.0.2n npmREADME GitHub-flavored package documentation.
downloads Across all versions.
Download trend unavailable.
compatibility Runtime metadata.
keywords Tagged topics.
image size dimensions resolution width height avif bmp cur gif heic heif
install size Estimated unpacked size across 1 packages.
96.4 kB
Includes dependencies.
versions Latest published Nov 6, 2026
maintainers Registry package owners.
contents image-size
Fast, lightweight NodeJS package to get dimensions of any image file or buffer.
Key Features
Zero dependencies
Supports all major image formats
Works with both files and buffers
Minimal memory footprint - reads only image headers
ESM and CommonJS support
TypeScript types included
BMP
CUR
DDS
GIF
HEIC (HEIF, AVCI, AVIF)
ICNS
ICO
J2C
JPEG-2000 (JP2)
JPEG
JPEG-XL
KTX (1 and 2)
PNG
PNM (PAM, PBM, PFM, PGM, PPM)
PSD
SVG
TGA
TIFF
WebP
Installation npm install image-size
# or
yarn add image-size
# or
pnpm add image-size copy
Usage
Passing in a Buffer/Uint8Array Best for streams, network requests, or when you already have the image data in memory.
import { imageSize } from 'image-size'
// or
const { imageSize } = require ( 'image-size' )
const dimensions = imageSize (buffer)
console. log (dimensions.width, dimensions.height) copy
Reading from a file Best for local files. Returns a promise.
import { imageSizeFromFile } from 'image-size/fromFile'
// or
const { imageSizeFromFile } = require ( 'image-size/fromFile' )
const dimensions = await imageSizeFromFile ( 'photos/image.jpg' )
console. log (dimensions.width, dimensions.height) copy Note: Reading from files has a default concurrency limit of 100
To change this limit, you can call the setConcurrency function like this:
import { setConcurrency } from 'image-size/fromFile'
// or
const { setConcurrency } = require ( 'image-size/fromFile' )
setConcurrency ( 123456 ) copy
Reading from a file Synchronously (not recommended) ⚠️ v1.x of this library had a sync API, that internally used sync file reads.
This isn't recommended because this blocks the node.js main thread, which reduces the performance, and prevents this library from being used concurrently.
However if you still need to use this package synchronously, you can read the file synchronously into a buffer, and then pass the buffer to this library.
import { readFileSync } from 'node:fs'
import { imageSize } from 'image-size'
const buffer = readFileSync ( 'photos/image.jpg' )
const dimensions = imageSize (buffer)
console. log (dimensions.width, dimensions.height) copy
3. Command Line npx image-size image1.jpg image2.png copy
Multi-size If the target file/buffer is an HEIF, an ICO, or a CUR file, the width and height will be the ones of the largest image in the set.
An additional images array is available and returns the dimensions of all the available images
import { imageSizeFromFile } from 'image-size/fromFile'
// or
const { imageSizeFromFile } = require ( 'image-size/fromFile' )
const { images } = await imageSizeFromFile ( 'images/multi-size.ico' )
for ( const dimensions of images) {
console. log (dimensions.width, dimensions.height)
} copy
Using a URL import url from 'node:url'
import http from 'node:http'
import { imageSize } from 'image-size'
const imgUrl = 'http://my-amazing-website.com/image.jpeg'
const options = url. parse (imgUrl)
http. get (options, function (response) {
const chunks = []
response
. on ( 'data' , function (chunk) {
chunks. push (chunk)
})
. on ( 'end' , function () {
const buffer = Buffer. concat (chunks)
console. log ( imageSize (buffer))
})
}) copy
Disabling certain image types import { disableTypes } from 'image-size'
// or
const { disableTypes } = require ( 'image-size' )
disableTypes ([ 'tiff' , 'ico' ]) copy
JPEG image orientation If the orientation is present in the JPEG EXIF metadata, it will be returned by the function. The orientation value is a number between 1 and 8 representing a type of orientation.
import { imageSizeFromFile } from 'image-size/fromFile'
// or
const { imageSizeFromFile } = require ( 'image-size/fromFile' )
const { width, height, orientation } = await imageSizeFromFile ( 'images/photo.jpeg' )
console. log (width, height, orientation) copy
Limitations
Partial File Reading
Only reads image headers, not full files
Some corrupted images might still report dimensions
SVG Limitations
Only supports pixel dimensions and viewBox
Percentage values not supported
File Access
Reading from files has a default concurrency limit of 100
Can be adjusted using setConcurrency()
Buffer Requirements
Some formats (like TIFF) require the full header in buffer
Streaming partial buffers may not work for all formats
License
Credits not a direct port, but an attempt to have something like
dabble's imagesize as a node module.