whatwg-mimetype 2.0.1 → 2.1.0

package/README.md

@@ -30,6 +30,10 @@ This package's algorithms conform to those of the WHATWG [MIME Sniffing Standard
 
 This package's main module's default export is a class, `MIMEType`. Its constructor takes a string which it will attempt to parse into a MIME type; if parsing fails, an `Error` will be thrown.
 
+### The `parse()` static factory method
+
+As an alternative to the constructor, you can use `MIMEType.parse(string)`. The only difference is that `parse()` will return `null` on failed parsing, whereas the constructor will throw. It thus makes the most sense to use the constructor in cases where unparseable MIME types would be exceptional, and use `parse()` when dealing with input from some unconstrained source.
+
 ### Properties
 
 - `type`: the MIME type's [type](https://mimesniff.spec.whatwg.org/#mime-type-type), e.g. `"text"`
@@ -48,8 +52,9 @@ This package's main module's default export is a class, `MIMEType`. Its construc
 - `toString()` serializes the MIME type to a string
 - `isHTML()`: returns true if this instance represents [a HTML MIME type](https://mimesniff.spec.whatwg.org/#html-mime-type)
 - `isXML()`: returns true if this instance represents [an XML MIME type](https://mimesniff.spec.whatwg.org/#xml-mime-type)
+- `isJavaScript({ allowParameters })`: returns true if this instance represents [a JavaScript MIME type](https://html.spec.whatwg.org/multipage/scripting.html#javascript-mime-type); `allowParameters` can be set to true to allow arbitrary parameters, instead of their presence causing the method to return `false`
 
-_Note: the `isHTML()` and `isXML()` methods are speculative, and may be removed or changed in future major versions. See [whatwg/mimesniff#48](https://github.com/whatwg/mimesniff/issues/48) for brainstorming in this area. Currently we implement these mainly because they are useful in jsdom._
+_Note: the `isHTML()`, `isXML()`, and `isJavaScript()` methods are speculative, and may be removed or changed in future major versions. See [whatwg/mimesniff#48](https://github.com/whatwg/mimesniff/issues/48) for brainstorming in this area. Currently we implement these mainly because they are useful in jsdom._
 
 ## `MIMETypeParameters` API
 

package/lib/mime-type.js

@@ -20,6 +20,14 @@ module.exports = class MIMEType {
     this._parameters = new MIMETypeParameters(result.parameters);
   }
 
+  static parse(string) {
+    try {
+      return new this(string);
+    } catch (e) {
+      return null;
+    }
+  }
+
   get essence() {
     return `${this.type}/${this.subtype}`;
   }
@@ -68,6 +76,47 @@ module.exports = class MIMEType {
     return serialize(this);
   }
 
+  isJavaScript({ allowParameters = false } = {}) {
+    switch (this._type) {
+      case "text": {
+        switch (this._subtype) {
+          case "ecmascript":
+          case "javascript":
+          case "javascript1.0":
+          case "javascript1.1":
+          case "javascript1.2":
+          case "javascript1.3":
+          case "javascript1.4":
+          case "javascript1.5":
+          case "jscript":
+          case "livescript":
+          case "x-ecmascript":
+          case "x-javascript": {
+            return allowParameters || this._parameters.size === 0;
+          }
+          default: {
+            return false;
+          }
+        }
+      }
+      case "application": {
+        switch (this._subtype) {
+          case "ecmascript":
+          case "javascript":
+          case "x-ecmascript":
+          case "x-javascript": {
+            return allowParameters || this._parameters.size === 0;
+          }
+          default: {
+            return false;
+          }
+        }
+      }
+      default: {
+        return false;
+      }
+    }
+  }
   isXML() {
     return (this._subtype === "xml" && (this._type === "text" || this._type === "application")) ||
            this._subtype.endsWith("+xml");

package/package.json

@@ -8,7 +8,7 @@
     "http",
     "whatwg"
   ],
-  "version": "2.0.1",
+  "version": "2.1.0",
   "author": "Domenic Denicola <d@domenic.me> (https://domenic.me/)",
   "license": "MIT",
   "repository": "jsdom/whatwg-mimetype",