> For the complete documentation index, see [llms.txt](https://osl.mistium.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://osl.mistium.com/packages/data/mime.md).

# mime

> MIME-type lookup and parsing

Use `mime` to inspect MIME types, file extensions, media categories, charsets, and content disposition headers.

```javascript
import "std:mime"
```

## API reference

### `mime`

| Method                                    | Returns   | Description                                                                     |
| ----------------------------------------- | --------- | ------------------------------------------------------------------------------- |
| `mime.typeByExt(ext: any)`                | `string`  | Runs the type by ext operation.                                                 |
| `mime.byFilename(name: any)`              | `string`  | Resolves the filename's final extension through `typeByExt`.                    |
| `mime.extByType(mtype: any)`              | `string`  | Runs the ext by type operation.                                                 |
| `mime.parse(contentType: any)`            | `object`  | Parses input data.                                                              |
| `mime.format(mtype: any, params: object)` | `string`  | Formats a value for display.                                                    |
| `mime.resolve(input: any)`                | `string`  | Normalizes a MIME type, extension, or filename using final-extension semantics. |
| `mime.isText(input: any)`                 | `boolean` | Reports whether text.                                                           |
| `mime.isImage(input: any)`                | `boolean` | Reports whether image.                                                          |
| `mime.isAudio(input: any)`                | `boolean` | Reports whether audio.                                                          |
| `mime.isVideo(input: any)`                | `boolean` | Reports whether video.                                                          |

## Notes

* Prefer `import "std:mime"`; the older `import "osl/mime"` spelling remains supported.
* Return values such as `array` and `object` are regular OSL values unless a returned object section says otherwise.

## Edge-case behavior

MIME parsing handles parameters, quoted values, case variants, unknown extensions, and malformed media types without panicking.