guilmour 4d48d7b520 Version 0.1 | 6 年之前 | |
---|---|---|
.. | ||
HISTORY.md | 6 年之前 | |
LICENSE | 6 年之前 | |
README.md | 6 年之前 | |
db.json | 6 年之前 | |
index.js | 6 年之前 |
This is a database of all mime types. It consists of a single, public JSON file and does not include any logic, allowing it to remain as un-opinionated as possible with an API. It aggregates data from the following sources:
npm install mime-db
If you're crazy enough to use this in the browser, you can just grab the
JSON file using RawGit. It is recommended to replace
master
with a release tag as the
JSON format may change in the future.
https://cdn.rawgit.com/jshttp/mime-db/master/db.json
var db = require('mime-db');
// grab data on .js files
var data = db['application/javascript'];
The JSON file is a map lookup for lowercased mime types. Each mime type has the following properties:
.source
- where the mime type is defined.
If not set, it's probably a custom media type.
apache
- Apache common media typesiana
- IANA-defined media typesnginx
- nginx media types.extensions[]
- known extensions associated with this mime type..compressible
- whether a file of this type can be gzipped..charset
- the default charset associated with this type, if any.If unknown, every property could be undefined
.
To edit the database, only make PRs against src/custom.json
or
src/custom-suffix.json
.
The src/custom.json
file is a JSON object with the MIME type as the keys
and the values being an object with the following keys:
compressible
- leave out if you don't know, otherwise true
/false
for
if the data represented by the time is typically compressible.extensions
- include an array of file extensions that are associated with
the type.notes
- human-readable notes about the type, typically what the type is.sources
- include an array of URLs of where the MIME type and the associated
extensions are sourced from. This needs to be a primary source;
links to type aggregating sites and Wikipedia are not acceptible.To update the build, run npm run build
.
The best way to get new media types included in this library is to register them with the IANA. The community registration procedure is outlined in RFC 6838 section 5. Types registered with the IANA are automatically pulled into this library.