setMime

Set or update MIME type mapping.

API

setMime

Return

Parameters

Example

Basic Usage

import { setMime, getMime } from 'ranuts';

// Set custom MIME type
setMime('.myext', 'application/x-my-custom-type');

// Get MIME type
const mime = getMime('.myext');
console.log(mime); // 'application/x-my-custom-type'

Update Existing Type

import { setMime, getMime } from 'ranuts';

// Update .js MIME type
setMime('.js', 'application/javascript-custom');

const mime = getMime('script.js');
console.log(mime); // 'application/javascript-custom'

Add New Type

import { setMime } from 'ranuts';

// Add new file type mapping
setMime('.xyz', 'application/x-xyz-format');

Notes

1. Global impact: After setting, affects global MIME type mapping, all places using getMime will be affected.
2. Override behavior: If extension already exists, will override original MIME type.
3. Return value: Returns entire MIME type Map, can continue operations.
4. Use case: Commonly used to add custom file type MIME type mappings.

MimeType

The underlying Map<string, string> that getMime, setMime and getExtensions all read and write. Import it directly if you want to enumerate every known extension/type pair rather than look one up.

import { MimeType } from 'ranuts/utils';

MimeType.get('.pdf'); // 'application/pdf'
MimeType.size; // total number of known extensions
[...MimeType.entries()].filter(([, type]) => type.startsWith('image/'));

It's the same Map instance setMime mutates, so changes made through setMime are visible here immediately, and vice versa. Mutating it directly works too; setMime is just a named entry point for the common case.