Skip to content
JavaScript library for parsing, stringifying and manipulating media types. Useful for content negotiation. Follows RFC2045, supports quoted parameters, all allowed characters etc.
JavaScript Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
test
.gitignore
.npmignore
.travis.yml
CHANGELOG.md
LICENSE
Makefile
README.md
index.js
package.json

README.md

MediumType.js

![NPM version][npm-badge] ![Build status][travis-badge] [npm-badge]: https://badge.fury.io/js/medium-type.png [travis-badge]: https://travis-ci.org/moll/js-medium-type.png?branch=master

MediumType.js is a JavaScript library to parse and stringify media types.

Tour

  • Implements parsing based on RFC 2045 with added support for suffixes (RFC 3023, RFC 6839).
    RFC 2045 is a little more permissive than later RFCs when it comes to allowed tokens. MediumType.js thereby adheres to Postel's law of liberal acceptance.

    Examples of supported media types:

    • application/json.
    • application/vnd.app.model+json; charset=utf-8.
    • application/xml; dtd="http://www.w3.org/TR/html4/strict.dtd".
    • */*+json; q=0.3.
    • */*.
  • Split comma separated media types (like in HTTP's Accept header).
    Note that it properly supports quoted parameters when splitting. It's the only library that I know of that does this.

    MediumType.split("text/html; levels=\"1, 2, 3\", text/plain")
  • Sort an array of MediumTypes according to sorting rules of the HTTP Accept header listed in RFC 2616 and RFC 7231.
    That is, first by the q parameter, then by type and subtype specificity and then by parameter count (excluding the q parameter).

    MediumType.sort([
      new MediumType("text/html; level=3; q=0.7"),
      new MediumType("text/html; q=0.7"),
      new MediumType("text/plain; q=0.5"),
      new MediumType("text/*; q=0.1"),
      new MediumType("*/*; q=0.1"),
    ])
  • Stringify media types to a canonical type/subtype+suffix; param=value format.

    MediumType.stringify({type: "application", subtype: "json"})
    new MediumType({type: "application", subtype: "json"}).toString()
  • No dependencies on Node.js modules or the whole MIME database. Pretty lightweight and easily usable in the browser with Browserify.

Installing

From v1.0.0 MediumType.js will follow semantic versioning, but until then, breaking changes may appear between minor versions (the middle number).

Installing on Node.js

npm install medium-type

Installing for the browser

MediumType.js doesn't yet have a build ready for the browser, but you will be able to use Browserify to have it run there till then.

Using

var MediumType = require("medium-type")

var type = new MediumType("application/vnd.app.model+json; charset=utf-8")
type.type == "application"
type.subtype == "vnd.app.model"
type.suffix == "json"
type.parameters.charset == "utf-8"

API

For extended documentation on all functions, please see the MediumType.js API Documentation.

MediumType

License

MediumType.js is released under a Lesser GNU Affero General Public License, which in summary means:

  • You can use this program for no cost.
  • You can use this program for both personal and commercial reasons.
  • You do not have to share your own program's code which uses this program.
  • You have to share modifications (e.g. bug-fixes) you've made to this program.

For more convoluted language, see the LICENSE file.

About

Andri Möll typed this and the code.
Monday Calendar supported the engineering work.

If you find MediumType.js needs improving, please don't hesitate to type to me now at andri@dot.ee or create an issue online.

You can’t perform that action at this time.