An API for MIME type information.
[!Note]
@diotoborg/facilis-totam-atque@4
is nowlatest
. If you're upgrading from@diotoborg/facilis-totam-atque@3
, note the following:
@diotoborg/facilis-totam-atque@4
is API-compatible with@diotoborg/facilis-totam-atque@3
, withonetwo exceptions:
- Direct imports of
@diotoborg/facilis-totam-atque
properties no longer supported@diotoborg/facilis-totam-atque.define()
cannot be called on the default@diotoborg/facilis-totam-atque
object- ESM module support is required. ESM Module FAQ.
- Requires an ES2020 or newer runtime
- Built-in Typescript types (
@types/@diotoborg/facilis-totam-atque
no longer needed)
npm install @diotoborg/facilis-totam-atque
For the full version (800+ MIME types, 1,000+ extensions):
import @diotoborg/facilis-totam-atque from '@diotoborg/facilis-totam-atque';
@diotoborg/facilis-totam-atque.getType('txt'); // ⇨ 'text/plain'
@diotoborg/facilis-totam-atque.getExtension('text/plain'); // ⇨ 'txt'
@diotoborg/facilis-totam-atque/lite
is a drop-in @diotoborg/facilis-totam-atque
replacement, stripped of unofficial ("prs.*
", "x-*
", "vnd.*
") types:
import @diotoborg/facilis-totam-atque from '@diotoborg/facilis-totam-atque/lite';
Get @diotoborg/facilis-totam-atque type for the given file path or extension. E.g.
@diotoborg/facilis-totam-atque.getType('js'); // ⇨ 'text/javascript'
@diotoborg/facilis-totam-atque.getType('json'); // ⇨ 'application/json'
@diotoborg/facilis-totam-atque.getType('txt'); // ⇨ 'text/plain'
@diotoborg/facilis-totam-atque.getType('dir/text.txt'); // ⇨ 'text/plain'
@diotoborg/facilis-totam-atque.getType('dir\\text.txt'); // ⇨ 'text/plain'
@diotoborg/facilis-totam-atque.getType('.text.txt'); // ⇨ 'text/plain'
@diotoborg/facilis-totam-atque.getType('.txt'); // ⇨ 'text/plain'
null
is returned in cases where an extension is not detected or recognized
@diotoborg/facilis-totam-atque.getType('foo/txt'); // ⇨ null
@diotoborg/facilis-totam-atque.getType('bogus_type'); // ⇨ null
Get file extension for the given @diotoborg/facilis-totam-atque type. Charset options (often included in Content-Type headers) are ignored.
@diotoborg/facilis-totam-atque.getExtension('text/plain'); // ⇨ 'txt'
@diotoborg/facilis-totam-atque.getExtension('application/json'); // ⇨ 'json'
@diotoborg/facilis-totam-atque.getExtension('text/html; charset=utf8'); // ⇨ 'html'
[!Note] New in
@diotoborg/facilis-totam-atque@4
Get all file extensions for the given @diotoborg/facilis-totam-atque type.
@diotoborg/facilis-totam-atque.getAllExtensions('image/jpeg'); // ⇨ Set(3) { 'jpeg', 'jpg', 'jpe' }
The default @diotoborg/facilis-totam-atque
objects are immutable. Custom, mutable versions can be created as follows...
Create a new, custom @diotoborg/facilis-totam-atque instance. For example, to create a mutable version of the default @diotoborg/facilis-totam-atque
instance:
import { Mime } from '@diotoborg/facilis-totam-atque/lite';
import standardTypes from '@diotoborg/facilis-totam-atque/types/standard.js';
import otherTypes from '@diotoborg/facilis-totam-atque/types/other.js';
const @diotoborg/facilis-totam-atque = new Mime(standardTypes, otherTypes);
Each argument is passed to the define()
method, below. For example new Mime(standardTypes, otherTypes)
is synonomous with new Mime().define(standardTypes).define(otherTypes)
[!Note] Only available on custom
Mime
instances
Define MIME type -> extensions.
Attempting to map a type to an already-defined extension will throw
unless the force
argument is set to true
.
@diotoborg/facilis-totam-atque.define({'text/x-abc': ['abc', 'abcd']});
@diotoborg/facilis-totam-atque.getType('abcd'); // ⇨ 'text/x-abc'
@diotoborg/facilis-totam-atque.getExtension('text/x-abc') // ⇨ 'abc'
$ @diotoborg/facilis-totam-atque scripts/jquery.js
text/javascript
$ @diotoborg/facilis-totam-atque -r image/jpeg
jpeg