iana-media-type


What is it for?

With iana-media-type, you can use IANA media types as JSON in your projects. It works in modern JavaScript runtimes.

We've provided a simple API for you. You can obtain iana-media-type from NPM. Please see the section "How to Obtain".

How to Obtain

- iana-media-type provides an NPM package. You can install it with your favorite package managers, and then bundle it into your project.

| Package Manager | Command | Shorthand |
| ----------------------------- | ------------------------------ | -------------------------- |
| bun | bun install iana-media-type | bun i iana-media-type |
| npm | npm install iana-media-type | npm i iana-media-type |
| pnpm | pnpm install iana-media-type | pnpm i iana-media-type |
| yarn | yarn add iana-media-type | yarn add iana-media-type |

- iana-media-type provides a JSON file on the GitHub. You can download it and use it in your project.

``bash
curl -fsSL -o iana-media-type.json https://raw.githubusercontent.com/AsherJingkongChen/iana-media-type/main/index.json
`

Let's Learn How to Use It

1. Import the .js file:

`javascript
import mediaTypes from 'iana-media-type/index.js';
console.log({ mediaTypes, length: mediaTypes.length });
`

2. Import the json file (Obtained from NPM) on node v19:

`javascript
import mediaTypes from 'iana-media-type' assert { type: 'json' };
console.log({ mediaTypes, length: mediaTypes.length });
`

3. Import the json file (Obtained from NPM) on node 20+:

`javascript
import mediaTypes from 'iana-media-type' with { type: 'json' };
console.log({ mediaTypes, length: mediaTypes.length });
`

4. Import the json file (Obtained from GitHub) in the browser or deno:

`javascript
import mediaTypes from 'https://raw.githubusercontent.com/AsherJingkongChen/iana-media-type/main/index.json' with { type: 'json' };
console.log({ mediaTypes, length: mediaTypes.length });
`

Resources

- IANA Media Types

Let's Setup the Project

> Note: THIS section is for contributors and developers only

$3

- IDEs:
- VSCode
- Extensions:
- Prettier for VSCode

$3

- Environments
- Node.js v20
- Linters
- Prettier

$3

| Package Manager | Command | Script | Description |
| ---------------------- | --------- | -------- | --------------------------- |
| bun / npm / pnpm | install | | Install dependencies |
| bun / npm / pnpm | run | build | Build the JSON manifest |
| bun / npm / pnpm | run | format` | Format files using Prettier |

$3

You may encounter some problems during development and deployment.

Please read the following notes carefully.

1. We provide the JSON file for backward compatibility and for situations where you don't want to evaluate code.
2. We are NOT IANA or IETF official. We are just a group of open-source developers.