# @trickfilm400/rollup-plugin-off-main-thread

> Use Rollup with workers and ES6 modules today.

Latest version **3.0.0-pre1** (published 2025-12-02) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @trickfilm400/rollup-plugin-off-main-thread
pnpm add @trickfilm400/rollup-plugin-off-main-thread
yarn add @trickfilm400/rollup-plugin-off-main-thread
bun add @trickfilm400/rollup-plugin-off-main-thread
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.0-pre1 |
| Published | 2025-12-02 |
| First published | 2024-05-22 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=12 |
| Dependencies | 4 |
| Unpacked size | 242.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Surma |
| Maintainers | trickfilm400 |

## Links

- npm: https://www.npmjs.com/package/@trickfilm400/rollup-plugin-off-main-thread
- Repository: https://github.com/Trickfilm400/rollup-plugin-off-main-thread
- Homepage: https://github.com/Trickfilm400/rollup-plugin-off-main-thread#readme
- Issues: https://github.com/Trickfilm400/rollup-plugin-off-main-thread/issues
- npm.io page: https://npm.io/package/@trickfilm400/rollup-plugin-off-main-thread

## Dependencies (4)

- [ejs](https://npm.io/package/ejs.md) ^3.1.10
- [json5](https://npm.io/package/json5.md) ^2.2.3
- [magic-string](https://npm.io/package/magic-string.md) ^0.30.21
- [string.prototype.matchall](https://npm.io/package/string.prototype.matchall.md) ^4.0.12

## Recent versions

- 3.0.0-pre1 (latest) — 2025-12-02
- 4.0.0-pre2 (beta) — 2026-07-15
- 4.0.0-pre1 — 2026-05-26
- 3.1.0-pre2 — 2025-12-03
- 2.5.0 — 2025-12-02
- 2.4.3 — 2024-06-20
- 2.4.0 — 2024-05-22
- 2.3.0 — 2024-05-22
- 2.2.3-fix — 2024-05-22

## README

# rollup-plugin-off-main-thread

Use Rollup with workers and ES6 modules _today_.

```
$ npm install --save @trickfilm400/rollup-plugin-off-main-thread
```

Workers are JavaScript’s version of threads. [Workers are important to use][when workers] as the main thread is already overloaded, especially on slower or older devices.

This plugin takes care of shimming module support in workers and allows you to use `new Worker()`.

OMT is the result of merging loadz0r and workz0r.

## Usage

I set up [a gist] to show a full setup with OMT.

### Config

```js
// rollup.config.js
import OMT from "@trickfilm400/rollup-plugin-off-main-thread";

export default {
  input: ["src/main.js"],
  output: {
    dir: "dist",
    // You _must_ use either “amd” or “esm” as your format.
    // But note that only very few browsers have native support for
    // modules in workers.
    format: "amd"
  },
  plugins: [OMT()]
};
```

### Auto bundling

In your project's code use a module-relative path via `new URL` to include a Worker:

```js
const worker = new Worker(new URL("worker.js", import.meta.url), {
  type: "module"
});
```

This will just work.

If required, the plugin also supports plain literal paths:

```js
const worker = new Worker("./worker.js", { type: "module" });
```

However, those are less portable: in Rollup they would result in module-relative
path, but if used directly in the browser, they'll be relative to the document
URL instead.

Hence, they're deprecated and `new URL` pattern is encouraged instead for portability.

### Importing workers as URLs

If your worker constructor doesn't match `workerRegexp` (see options below), you might find it easier to import the worker as a URL. In your project's code:

```js
import workerURL from "omt:./worker.js";
import paintWorkletURL from "omt:./paint-worklet.js";

const worker = new Worker(workerURL, { name: "main-worker" });
CSS.paintWorklet.addModule(paintWorkletURL);
```

`./worker.js` and `./paint-worklet.js` will be added to the output as chunks.

## Options

```js
{
  // ...
  plugins: [OMT(options)];
}
```

- `loader`: A string containing the EJS template for the amd loader. If `undefined`, OMT will use `loader.ejs`.
- `useEval`: Use `fetch()` + `eval()` to load dependencies instead of `<script>` tags and `importScripts()`. _This is not CSP compliant, but is required if you want to use dynamic imports in ServiceWorker_.
- `workerRegexp`: A RegExp to find `new Workers()` calls. The second capture group _must_ capture the provided file name without the quotes.
- `amdFunctionName`: Function name to use instead of AMD’s `define`.
- `prependLoader`: A function that determines whether the loader code should be prepended to a certain chunk. Should return true if the load is suppsoed to be prepended.
- `urlLoaderScheme`: Scheme to use when importing workers as URLs. If `undefined`, OMT will use `"omt"`.

[when workers]: https://dassur.ma/things/when-workers
[a gist]: https://gist.github.com/surma/a02db7b53eb3e7870bf539b906ff6ff6

---

License Apache-2.0

---
_Source: https://npm.io/package/@trickfilm400/rollup-plugin-off-main-thread · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._