Gathering detailed insights and metrics for image-type
Gathering detailed insights and metrics for image-type
Installations
npm install image-typeDeveloper Guide
BETA
Typescript
Yes
Module System
ESM
Min. Node Version
>=20
Node Version
20.19.1
NPM Version
10.9.2
Releases
6
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
Maintainers
1
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
Dev Dependencies
5
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 typesmime- 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
jpgpnggifwebpflifcr2tifbmpjxrpsdicobpgjp2- JPEG 2000jpm- JPEG 2000jpx- JPEG 2000heiccurdcm- DICOM Image File
SVG isn't included as it requires the whole file to be read, but you can get it here.
Related
- file-type - Detect the type of a file
- image-dimensions - Get the dimensions of an image
No vulnerabilities found.
Reason
security policy file detected
Details
- Info: security policy file detected: .github/security.md:1
- Info: Found linked content: .github/security.md:1
- Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/security.md:1
- Info: Found text in security policy: .github/security.md:1
Reason
no binaries found in the repo
Reason
no dangerous workflow patterns detected
Reason
0 existing vulnerabilities detected
Reason
license file detected
Details
- Info: project has a license file: license:0
- Info: FSF or OSI recognized license: MIT License: license:0
Reason
Found 6/30 approved changesets -- score normalized to 2
Reason
3 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 2
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/main.yml:1
- Info: no jobLevel write permissions found
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/sindresorhus/image-type/main.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/sindresorhus/image-type/main.yml/main?enable=pin
- Warn: npmCommand not pinned by hash: .github/workflows/main.yml:22
- Info: 0 out of 2 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 1 npmCommand dependencies pinned
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'main'
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 6 are checked with a SAST tool
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