MIMEType class
An implementation of the MIMEType class.
In accordance with browser conventions, all properties of MIMEType
objects
are implemented as getters and setters on the class prototype, rather than as
data properties on the object itself.
A MIME string is a structured string containing multiple meaningful
components. When parsed, a MIMEType
object is returned containing
properties for each of these components.
Constructors
MIMEType(string | { to |
Creates a new MIMEType object by parsing the input. A |
Properties
essence | Gets the essence of the MIME. This property is read only.
Use
|
params | Gets the |
subtype | Gets and sets the subtype portion of the MIME.
|
type | Gets and sets the type portion of the MIME.
|
Methods
to |
The Because of the need for standard compliance, this method does not allow users to customize the serialization process of the MIME. |
Constructor Details
MIMEType(string | { toString: () => string })
Creates a new MIMEType object by parsing the input.
A TypeError
will be thrown if the input
is not a valid MIME.
Note that an effort will be made to coerce the given values into strings.
new MIMEType(input: string | { toString: () => string })
Parameters
- input
-
string | { toString: () => string }
The input MIME to parse.
Property Details
essence
Gets the essence of the MIME. This property is read only.
Use mime.type
or mime.subtype
to alter the MIME.
import { MIMEType } from 'node:util';
const myMIME = new MIMEType('text/javascript;key=value');
console.log(myMIME.essence);
// Prints: text/javascript
myMIME.type = 'application';
console.log(myMIME.essence);
// Prints: application/javascript
console.log(String(myMIME));
// Prints: application/javascript;key=value
essence: string
Property Value
string
params
Gets the MIMEParams
object representing the
parameters of the MIME. This property is read-only. See MIMEParams
documentation for details.
params: MIMEParams
Property Value
subtype
Gets and sets the subtype portion of the MIME.
import { MIMEType } from 'node:util';
const myMIME = new MIMEType('text/ecmascript');
console.log(myMIME.subtype);
// Prints: ecmascript
myMIME.subtype = 'javascript';
console.log(myMIME.subtype);
// Prints: javascript
console.log(String(myMIME));
// Prints: text/javascript
subtype: string
Property Value
string
type
Gets and sets the type portion of the MIME.
import { MIMEType } from 'node:util';
const myMIME = new MIMEType('text/javascript');
console.log(myMIME.type);
// Prints: text
myMIME.type = 'application';
console.log(myMIME.type);
// Prints: application
console.log(String(myMIME));
// Prints: application/javascript
type: string
Property Value
string
Method Details
toString()
The toString()
method on the MIMEType
object returns the serialized MIME.
Because of the need for standard compliance, this method does not allow users to customize the serialization process of the MIME.
function toString(): string
Returns
string