W3cubDocs

/Web APIs

Navigator: mimeTypes property

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Returns a MimeTypeArray object, which contains a list of MimeType objects representing the MIME types recognized and supported by the browser. The array can be queried for information about the enabled plugin that is used to handle a file of the specified type. Named properties of the returned object are not enumerable (except in very old browser versions).

Recent versions of the specification hard-code the returned set of MIME types. If PDF files can be displayed inline then application/pdf and text/pdf are listed. Otherwise an empty list is returned.

Note: Use Navigator.pdfViewerEnabled to determine if inline viewing of PDF files is supported. Do not infer it from this property.

Legacy browser versions do not hard-code the list returned by the property, and might return other MIME types.

Value

A MimeTypeArray object which has a length property as well as item(index) and namedItem(name) methods.

If PDF inline viewing is supported this has entries for MIME types application/pdf and text/pdf. Otherwise an empty MimeTypeArray is returned. The description and file suffixes supported by enabled plugins are hard coded to 'pdf' and 'Portable Document Format', respectively.

Examples

The code below tests whether PDF files can be viewed inline, and then prints the description of the plugin and the file suffixes it supports.

js

if ("application/pdf" in navigator.mimeTypes) {
  // browser supports inline viewing of PDF files.

  const { description, suffixes } = navigator.mimeTypes["application/pdf"];
  console.log(`Description: ${description}, Suffix: ${suffixes}`);
  // expected output: Description: Portable Document Format, Suffix: pdf
}

Note that while the above code tests for application/pdf you could equally well check text/pdf. (Either both or neither MIME type will be true.) In addition, on current browsers you don't actually need to get the plugin description and suffixes, because this information is also hard-coded.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
mimeTypes 1 12 1 4 ≤12.1 1 4.4 18 4 ≤12.1 1 1.0
returns_plugin_type 1–94 12–94 1–99 4 ≤12.1–80 1 4.4–94 18–94 4–99 ≤12.1–66 1 1.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/mimeTypes