Class for parsing, stringifying and manipulating media types. Useful for content negotiation. Follows RFC2045, supports quoted parameters, all allowed characters etc.
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.
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"
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.
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.