Installations

npm install image-type

Developer Guide

BETA

Typescript

Yes

Module System

ESM

Min. Node Version

>=20

Node Version

20.19.1

NPM Version

10.9.2 Pull Requests

Open

0

Total

12

Closed

2

Merged

10

Issues

Open

0

Total

12

Closed

12

Releases

6

v6.0.0

Updated on May 20, 2025

v5.2.0

Updated on Jan 15, 2023

v5.1.0

Updated on Sep 24, 2022

v5.0.0

Updated on Jul 29, 2022

v4.1.0

Updated on Apr 06, 2019

v4.0.0

Updated on Mar 06, 2019

View All 6 releases

Languages

2

JavaScript

TypeScript

JavaScript (64.75%)

TypeScript (35.25%)

Developer

sindresorhus

Download Statistics

Total Downloads

0

Last Day

0

Last Week

0

Last Month

0

Last Year

0

GitHub Statistics

MIT License

408 Stars

55 Commits

16 Forks

9 Watchers

1 Branches

7 Contributors

Updated on Jul 05, 2025

Sponsor this package

https://github.com/sponsors/sindresorhus

Maintainers

1

View All 7 Contributors

Package Meta Information

Latest Version

6.0.0

Package Id

image-type@6.0.0

Unpacked Size

7.13 kB

Size

2.87 kB

File Count

5

NPM Version

10.9.2

Node Version

20.19.1

Published on

May 20, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

0%

NaN

Compared to previous day

Last Week

0%

NaN

Compared to previous week

Last Month

0%

NaN

Compared to previous month

Last Year

0%

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

1

file-type

Dev Dependencies

5

@types/node ava read-chunk tsd xo

image-type

Detect the image type of an ArrayBuffer/Uint8Array

See the file-type module for more file types and a CLI.

Install

1npm install image-type

Usage

Node.js

1import {readChunk} from 'read-chunk';
2import imageType, {minimumBytes} from 'image-type';
3
4const buffer = await readChunk('unicorn.png', {length: minimumBytes});
5
6await imageType(buffer);
7//=> {ext: 'png', mime: 'image/png'}

Or from a remote location:

1import https from 'node:https';
2import imageType, {minimumBytes} from 'image-type';
3
4const url = 'https://upload.wikimedia.org/wikipedia/en/a/a9/Example.jpg';
5
6https.get(url, response => {
7	response.on('readable', () => {
8		(async () => {
9			const chunk = response.read(minimumBytes);
10			response.destroy();
11			console.log(await imageType(chunk));
12			//=> {ext: 'jpg', mime: 'image/jpeg'}
13		})();
14	});
15});

Browser

1const xhr = new XMLHttpRequest();
2xhr.open('GET', 'unicorn.png');
3xhr.responseType = 'arraybuffer';
4
5xhr.onload = () => {
6	(async () => {
7		await imageType(new Uint8Array(this.response));
8		//=> {ext: 'png', mime: 'image/png'}
9	})();
10};
11
12xhr.send();

API

imageType(input)

Returns an Promise<object> with:

ext - One of the supported file types
mime - The MIME type

Or undefined when there is no match.

input

Type: ArrayBuffer | Uint8Array

It only needs the first minimumBytes amount of bytes.

minimumBytes

Type: number

The minimum amount of bytes needed to detect a file type. Currently, it's 4100 bytes, but it can change, so don't hardcode it.

Supported file types

jpg
png
gif
webp
flif
cr2
tif
bmp
jxr
psd
ico
bpg
jp2 - JPEG 2000
jpm - JPEG 2000
jpx - JPEG 2000
heic
cur
dcm - DICOM Image File

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

4.4

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

image-type

Installations

Developer Guide

Yes

ESM

>=20

20.19.1

10.9.2

Pull Requests

0

12

2

10

Issues

0

12

12

Releases

Languages

Developer

sindresorhus

Download Statistics

GitHub Statistics

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

image-type

Install

Usage

Node.js

Browser

API

imageType(input)

input

minimumBytes

Supported file types

Related

10

10

10

10

10

2

2

0

0

0

0

0

0

4.4

/10