Skip to main content

Installation

Bundler

Install mediainfo.js using a package manager of your choice.

$ npm install mediainfo.js

WASM file loading

When calling mediaInfoFactory(), the WASM file is automatically loaded. By default, it is searched for in the parent directory relative to the script file, aligning with the package distribution structure. This setup works out-of-the-box for the CDN version.

When using a bundler:

  • Ensure the file node_modules/mediainfo.js/dist/MediaInfoModule.wasm is accessible by the web server. The steps to achieve this depend on your framework and project setup. The simplest method is to copy the file to your static files folder.

  • The locateFile option allows you to adjust the location from which the WASM file is loaded.

tip

Refer to the examples page for instructions on using different frameworks.

CDN

For simple projects you might want to use the CDN version of mediainfo.js. Just add the script tag to your website.

<script type="text/javascript" src="https://unpkg.com/mediainfo.js"></script>
note

Users of the CDN version do not need to manage WASM file loading, as it is preconfigured to load from the CDN server.

Content Security Policy (CSP)

mediainfo.js is compiled with Emscripten DYNAMIC_EXECUTION=0, so it does not require script-src 'unsafe-eval'.

In strict CSP setups, WebAssembly compilation may still require script-src 'wasm-unsafe-eval':

Content-Security-Policy: script-src 'self' 'wasm-unsafe-eval'

Also ensure the URL used to load MediaInfoModule.wasm is permitted by your CSP (for example via connect-src or default-src).