{"_id":"@eshaz/web-worker","_rev":"4215964","name":"@eshaz/web-worker","description":"Consistent Web Workers in browser and Node.","dist-tags":{"latest":"1.2.2"},"maintainers":[{"name":"eshaz","email":""}],"time":{"modified":"2026-03-04T17:10:46.000Z","created":"2022-12-11T21:21:55.853Z","1.2.2":"2023-11-26T16:53:21.189Z","1.2.1":"2023-06-02T02:33:17.456Z","1.2.0":"2022-12-11T21:21:55.853Z"},"users":{},"repository":{"type":"git","url":"git+https://github.com/eshaz/web-worker.git"},"versions":{"1.2.2":{"name":"@eshaz/web-worker","version":"1.2.2","description":"Consistent Web Workers in browser and Node.","main":"./cjs/node.js","browser":"./cjs/browser.js","types":"index.d.ts","scripts":{"prepare":"babel node.js browser.js -d cjs","test":"eslint '*.js' test && node --experimental-modules ./node_modules/.bin/ava"},"babel":{"plugins":["@babel/plugin-syntax-dynamic-import","babel-plugin-commonjs-lite"]},"repository":{"type":"git","url":"git+https://github.com/eshaz/web-worker.git"},"keywords":["worker","worker_threads","webworker","web worker","web-worker","threads"],"authors":[],"license":"Apache-2.0","homepage":"https://github.com/eshaz/web-worker","eslintConfig":{"extends":"developit","rules":{"no-console":0}},"devDependencies":{"@babel/cli":"^7.7.7","@babel/core":"^7.7.7","@babel/plugin-syntax-dynamic-import":"^7.7.4","@babel/plugin-transform-modules-commonjs":"^7.7.5","@babel/preset-env":"^7.7.7","ava":"^2.4.0","babel-plugin-commonjs-lite":"gist:3e38560d5bed35da1fd708d635e4acb3","eslint":"^6.8.0","eslint-config-developit":"^1.1.1","eslint-plugin-compat":"^4.1.4"},"gitHead":"8d1e4bbf49f283fe59fdda20f633286148770696","bugs":{"url":"https://github.com/eshaz/web-worker/issues"},"_id":"@eshaz/web-worker@1.2.2","_nodeVersion":"18.17.1","_npmVersion":"9.6.7","dist":{"shasum":"506ec07ab811c15a12799725a0d8b82289e3d937","size":9172,"noattachment":false,"key":"/@eshaz/web-worker/-/@eshaz/web-worker-1.2.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/@eshaz/web-worker/download/@eshaz/web-worker-1.2.2.tgz"},"_npmUser":{"name":"eshaz","email":"ethanshalsall@gmail.com"},"directories":{},"maintainers":[{"name":"eshaz","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/web-worker_1.2.2_1701017600992_0.1000840114228172"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2023-11-26T16:53:21.189Z","publish_time":1701017601189,"_source_registry_name":"default","_cnpm_publish_time":1701017601189},"1.2.1":{"name":"@eshaz/web-worker","version":"1.2.1","description":"Consistent Web Workers in browser and Node.","main":"./cjs/node.js","browser":"./cjs/browser.js","types":"index.d.ts","scripts":{"prepare":"babel node.js browser.js -d cjs","test":"eslint '*.js' test && node --experimental-modules ./node_modules/.bin/ava"},"babel":{"plugins":["@babel/plugin-syntax-dynamic-import","babel-plugin-commonjs-lite"]},"repository":{"type":"git","url":"git+https://github.com/eshaz/web-worker.git"},"keywords":["worker","worker_threads","webworker","web worker","web-worker","threads"],"authors":[],"license":"Apache-2.0","homepage":"https://github.com/eshaz/web-worker","eslintConfig":{"extends":"developit","rules":{"no-console":0}},"devDependencies":{"@babel/cli":"^7.7.7","@babel/core":"^7.7.7","@babel/plugin-syntax-dynamic-import":"^7.7.4","@babel/plugin-transform-modules-commonjs":"^7.7.5","@babel/preset-env":"^7.7.7","ava":"^2.4.0","babel-plugin-commonjs-lite":"gist:3e38560d5bed35da1fd708d635e4acb3","eslint":"^6.8.0","eslint-config-developit":"^1.1.1","eslint-plugin-compat":"^4.1.4"},"gitHead":"5ec99ac04b1c12b4fcc4348be5623fc4ebd9f54c","bugs":{"url":"https://github.com/eshaz/web-worker/issues"},"_id":"@eshaz/web-worker@1.2.1","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"shasum":"834385830529582589e9790350beb24bf3ac8018","size":9170,"noattachment":false,"key":"/@eshaz/web-worker/-/@eshaz/web-worker-1.2.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/@eshaz/web-worker/download/@eshaz/web-worker-1.2.1.tgz"},"_npmUser":{"name":"eshaz","email":"ethanshalsall@gmail.com"},"directories":{},"maintainers":[{"name":"eshaz","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/web-worker_1.2.1_1685673197278_0.9621531422277432"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2023-06-02T02:33:17.456Z","publish_time":1685673197456,"_source_registry_name":"default","_cnpm_publish_time":1685673197456},"1.2.0":{"name":"@eshaz/web-worker","version":"1.2.0","description":"Consistent Web Workers in browser and Node.","main":"./cjs/node.js","browser":"./cjs/browser.js","types":"index.d.ts","scripts":{"prepare":"babel node.js browser.js -d cjs","test":"eslint '*.js' test && node --experimental-modules ./node_modules/.bin/ava"},"babel":{"plugins":["@babel/plugin-syntax-dynamic-import","babel-plugin-commonjs-lite"]},"repository":{"type":"git","url":"git+https://github.com/eshaz/web-worker.git"},"keywords":["worker","worker_threads","webworker","web worker","web-worker","threads"],"authors":[],"license":"Apache-2.0","homepage":"https://github.com/eshaz/web-worker","eslintConfig":{"extends":"developit","rules":{"no-console":0}},"devDependencies":{"@babel/cli":"^7.7.7","@babel/core":"^7.7.7","@babel/plugin-syntax-dynamic-import":"^7.7.4","@babel/plugin-transform-modules-commonjs":"^7.7.5","@babel/preset-env":"^7.7.7","ava":"^2.4.0","babel-plugin-commonjs-lite":"gist:3e38560d5bed35da1fd708d635e4acb3","eslint":"^6.8.0","eslint-config-developit":"^1.1.1"},"gitHead":"61b31eb1c1b981282b32bcf6606705ad63309a2f","bugs":{"url":"https://github.com/eshaz/web-worker/issues"},"_id":"@eshaz/web-worker@1.2.0","_nodeVersion":"18.12.1","_npmVersion":"8.19.2","dist":{"shasum":"a71c47e63c3325c227c619c217e3982578bde951","size":9151,"noattachment":false,"key":"/@eshaz/web-worker/-/@eshaz/web-worker-1.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/@eshaz/web-worker/download/@eshaz/web-worker-1.2.0.tgz"},"_npmUser":{"name":"eshaz","email":"ethanshalsall@gmail.com"},"directories":{},"maintainers":[{"name":"eshaz","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/web-worker_1.2.0_1670793715701_0.12060995281034437"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2022-12-11T21:22:02.030Z","publish_time":1670793715853,"_cnpm_publish_time":1670793715853}},"readme":"<h1 align=\"center\">\n  web-worker\n  <a href=\"https://www.npmjs.org/package/web-worker\"><img src=\"https://img.shields.io/npm/v/web-worker.svg?style=flat-square\" alt=\"npm\"></a>\n</h1>\n<p align=\"center\">\n  Native cross-platform Web Workers. Works in published npm modules.\n</p>\n<p align=\"center\">\n  <img src=\"https://user-images.githubusercontent.com/105127/79602228-1998bf00-80b8-11ea-91e4-26b212aabaa2.png\" width=\"1000\" alt=\"\">\n</p>\n\n**In Node**, it's a web-compatible Worker implementation atop Node's [worker_threads](https://nodejs.org/api/worker_threads.html).\n\n**In the browser** (and when bundled for the browser), it's simply an alias of `Worker`.\n\n### Features\n\n_Here's how this is different from worker_threads:_\n\n- makes Worker code compatible across browser and Node\n- supports Module Workers (`{type:'module'}`) natively in Node 12.8+\n- uses DOM-style events (`Event.data`, `Event.type`, etc)\n- supports event handler properties (`worker.onmessage=..`)\n- `Worker()` accepts a module URL, Blob URL or Data URL\n- emulates browser-style [WorkerGlobalScope] within the worker\n\n### Usage Example\n\nIn its simplest form:\n\n```js\nimport Worker from 'web-worker';\n\nconst worker = new Worker('data:,postMessage(\"hello\")');\nworker.onmessage = e => console.log(e.data);  // \"hello\"\n```\n\n<table>\n<thead><tr><th><strong>main.js</strong></th><th><strong>worker.js</strong></th></tr></thead>\n<tbody><tr><td>\n\n```js\nimport Worker from 'web-worker';\n\nconst url = new URL('./worker.js', import.meta.url);\nconst worker = new Worker(url);\n\nworker.addEventListener('message', e => {\n  console.log(e.data)  // \"hiya!\"\n});\n\nworker.postMessage('hello');\n```\n\n</td><td valign=\"top\">\n\n```js\naddEventListener('message', e => {\n  if (e.data === 'hello') {\n    postMessage('hiya!');\n  }\n});\n```\n\n</td></tr></tbody>\n</table>\n\n???? Notice how `new URL('./worker.js', import.meta.url)` is used above to load the worker relative to the current module instead of the application base URL. Without this, Worker URLs are relative to a document's URL, which in Node.js is interpreted to be `process.cwd()`.\n\n> _Support for this pattern in build tools and test frameworks is still limited. We are [working on growing this](https://github.com/developit/web-worker/issues/4)._\n\n### Module Workers\n\nModule Workers are supported in Node 12.8+ using this plugin, leveraging Node's native ES Modules support.\nIn the browser, they can be used natively in Chrome 80+, or in all browsers via [worker-plugin] or [rollup-plugin-off-main-thread]. As with classic workers, there is no difference in usage between Node and the browser:\n\n<table>\n<thead><tr><th><strong>main.mjs</strong></th><th><strong>worker.mjs</strong></th></tr></thead>\n<tbody><tr><td>\n\n```js\nimport Worker from 'web-worker';\n\nconst worker = new Worker(\n  new URL('./worker.mjs', import.meta.url),\n  { type: 'module' }\n);\nworker.addEventListener('message', e => {\n  console.log(e.data)  // \"200 OK\"\n});\nworker.postMessage('https://httpstat.us/200');\n```\n\n</td><td valign=\"top\">\n\n```js\nimport fetch from 'isomorphic-fetch';\n\naddEventListener('message', async e => {\n  const url = e.data;\n  const res = await fetch(url)\n  const text = await res.text();\n  postMessage(text);\n});\n```\n\n</td></tr></tbody>\n</table>\n\n\n### Data URLs\n\nInstantiating Worker using a Data URL is supported in both module and classic workers:\n\n```js\nimport Worker from 'web-worker';\n\nconst worker = new Worker(`data:application/javascript,postMessage(42)`);\nworker.addEventListener('message', e => {\n  console.log(e.data)  // 42\n});\n```\n\n### Special Thanks\n\nThis module aims to provide a simple and forgettable piece of infrastructure,\nand as such it needed an obvious and descriptive name.\n[@calvinmetcalf](https://github.com/calvinmetcalf), who you may recognize as the author of [Lie](https://github.com/calvinmetcalf/lie) and other fine modules, gratiously offered up the name from his `web-worker` package.\nThanks Calvin!\n\n\n[worker-plugin]: https://github.com/googlechromelabs/worker-plugin\n[rollup-plugin-off-main-thread]: https://github.com/surma/rollup-plugin-off-main-thread\n[WorkerGlobalScope]: https://developer.mozilla.org/en-US/docs/Web/API/WorkerGlobalScope\n","_attachments":{},"homepage":"https://github.com/eshaz/web-worker","bugs":{"url":"https://github.com/eshaz/web-worker/issues"},"license":"Apache-2.0"}