npmpackage.info

Gathering detailed insights and metrics for mime-types

Other packages similar to mime-types

@types/mime

4.0.0

Stub TypeScript definitions entry for mime, which provides its own types definitions

mime-db

1.54.0

Media Type Database

@types/mime-types

3.0.1

TypeScript definitions for mime-types

@types/mime-db

1.43.6

TypeScript definitions for mime-db

Gathering detailed insights and metrics for mime-types

mime-types - 3.0.1 | npmpackage.info

mime-types

The ultimate javascript content-type utility.

3.0.1

1,395

MIT

JavaScript

23.57 kB

13,742,281,481 6.8

Installations

npm install mime-types

Developer Guide

BETA

Typescript

No

Module System

N/A

Min. Node Version

>= 0.6

Node Version

22.10.0

NPM Version

10.9.0 Score

99.4

Supply Chain

99.5

Quality

83.2

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

14

Total

58

Closed

29

Merged

15

Issues

Open

7

Total

47

Closed

40

Releases

v3.0.1

Updated on Mar 26, 2025

v3.0.0

Updated on Mar 23, 2025

2.1.35

Updated on Mar 12, 2022

2.1.34

Updated on Nov 09, 2021

2.1.33

Updated on Oct 01, 2021

2.1.32

Updated on Jul 27, 2021

View All 57 releases

Languages

JavaScript

JavaScript (100%)

Developer

jshttp

Download Statistics

Total Downloads

13,742,281,481

Last Day

5,038,401

Last Week

76,384,624

Last Month

331,134,142

Last Year

3,027,434,549

GitHub Statistics

MIT License

1,395 Stars

492 Commits

138 Forks

20 Watchers

12 Branches

28 Contributors

Updated on Jul 03, 2025

Bundle Size

158.59 kB

Minified

23.57 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 28 Contributors

Package Meta Information

Latest Version

3.0.1

Package Id

mime-types@3.0.1

Unpacked Size

21.82 kB

Size

6.99 kB

File Count

NPM Version

10.9.0

Node Version

22.10.0

Published on

Mar 26, 2025

Total Downloads

Cumulative downloads

Total Downloads

13,742,281,481

Dependencies

mime-db

Dev Dependencies

eslint eslint-config-standard eslint-plugin-import eslint-plugin-markdown eslint-plugin-node eslint-plugin-promise eslint-plugin-standard mocha nyc

mime-types

The ultimate javascript content-type utility.

Similar to the mime@1.x module, except:

No fallbacks. Instead of naively returning the first available type, mime-types simply returns false, so do var type = mime.lookup('unrecognized') || 'application/octet-stream'.
No new Mime() business, so you could do var lookup = require('mime-types').lookup.
No .define() functionality
Bug fixes for .lookup(path)

Otherwise, the API is compatible with mime 1.x.

Install

This is a Node.js module available through the npm registry. Installation is done using the npm install command:

1$ npm install mime-types

Note on MIME Type Data and Semver

This package considers the programmatic api as the semver compatibility. Additionally, the package which provides the MIME data for this package (mime-db) also considers it's programmatic api as the semver contract. This means the MIME type resolution is not considered in the semver bumps.

In the past the version of mime-db was pinned to give two decision points when adopting MIME data changes. This is no longer true. We still update the mime-db package here as a minor release when necessary, but will use a ^ range going forward. This means that if you want to pin your mime-db data you will need to do it in your application. While this expectation was not set in docs until now, it is how the pacakge operated, so we do not feel this is a breaking change.

If you wish to pin your mime-db version you can do that with overrides via your package manager of choice. See their documentation for how to correctly configure that.

Adding Types

All mime types are based on mime-db, so open a PR there if you'd like to add mime types.

API

1var mime = require('mime-types')

All functions return false if input is invalid or not found.

mime.lookup(path)

Lookup the content-type associated with a file.

1mime.lookup('json') // 'application/json'
2mime.lookup('.md') // 'text/markdown'
3mime.lookup('file.html') // 'text/html'
4mime.lookup('folder/file.js') // 'application/javascript'
5mime.lookup('folder/.htaccess') // false
6
7mime.lookup('cats') // false

mime.contentType(type)

Create a full content-type header given a content-type or extension. When given an extension, mime.lookup is used to get the matching content-type, otherwise the given content-type is used. Then if the content-type does not already have a charset parameter, mime.charset is used to get the default charset and add to the returned content-type.

1mime.contentType('markdown') // 'text/x-markdown; charset=utf-8'
2mime.contentType('file.json') // 'application/json; charset=utf-8'
3mime.contentType('text/html') // 'text/html; charset=utf-8'
4mime.contentType('text/html; charset=iso-8859-1') // 'text/html; charset=iso-8859-1'
5
6// from a full path
7mime.contentType(path.extname('/path/to/file.json')) // 'application/json; charset=utf-8'

mime.extension(type)

Get the default extension for a content-type.

1mime.extension('application/octet-stream') // 'bin'

mime.charset(type)

Lookup the implied default charset of a content-type.

1mime.charset('text/markdown') // 'UTF-8'

var type = mime.types[extension]

A map of content-types by extension.

[extensions...] = mime.extensions[type]

A map of extensions by content-type.

License

MIT

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Contributors

Determines if the project has a set of contributors from multiple organizations (e.g., companies).

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Dependency-Update-Tool

Determines if the project uses a dependency update tool.

10

License

Determines if the project has defined a license.

10

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

9

Security-Policy

Determines if the project has published a security policy.

7

CI-Tests

Determines if the project runs tests before pull requests are merged.

7

SAST

Determines if the project uses static code analysis.

6

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

4

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

3

Maintained

Determines if the project is "actively maintained".

0

Branch-Protection

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

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

Score

6.8

/10

Last Scanned on 2025-06-30T21:29:41Z

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

Other packages similar to mime-types

Other packages similar to mime-types

mime-types

Installations

Developer Guide

No

N/A

>= 0.6

22.10.0

10.9.0

Score

Pull Requests

14

58

29

15

Issues

7

47

40

Releases

Languages

Developer

jshttp

Download Statistics

GitHub Statistics

Bundle Size

158.59 kB

23.57 kB

Maintainers

Package Meta Information

Total Downloads

13,742,281,481

Dependencies

Dev Dependencies

mime-types

Install

Note on MIME Type Data and Semver

Adding Types

API

mime.lookup(path)

mime.contentType(type)

mime.extension(type)

mime.charset(type)

var type = mime.types[extension]

[extensions...] = mime.extensions[type]

License

10

10

10

10

10

10

10

9

7

7

6

4

3

0

0

0

6.8

/10

Weekly Downloads

Monthly Downloads

Yearly Downloads