Worker

Deno 支持 Web Worker API.

Worker 能够用来在多个线程中运行代码,Worker 的每个实例都会在一个单独的线程中运行,这个线程专属于它。

目前,Deno 只支持 module 类型的 worker,因此在创建新的 worker 时必须传递 type: "module" 选项。

目前,相对模块说明符 (Relative module specifiers) 尚不支持。作为代替,您可以用 URL 构造函数和 import.meta.url 来为附近的脚本创建说明符。

  1. // Good
  2. new Worker(new URL("worker.js", import.meta.url).href, { type: "module" });
  3. // Bad
  4. new Worker(new URL("worker.js", import.meta.url).href);
  5. new Worker(new URL("worker.js", import.meta.url).href, { type: "classic" });
  6. new Worker("./worker.js", { type: "module" });

权限

创建一个新的 Worker 实例的行为与动态导入类似,因此 Deno 需要适当的权限来做这个操作。

对于使用本地模块的 worker,Deno 需要读取 (--allow-read) 权限:

main.ts

  1. new Worker(new URL("worker.ts", import.meta.url).href, { type: "module" });

worker.ts

  1. console.log("hello world");
  2. self.close();
  1. $ deno run main.ts
  2. error: Uncaught PermissionDenied: read access to "./worker.ts", run again with the --allow-read flag
  3. $ deno run --allow-read main.ts
  4. hello world

对于使用远程模块的 worker,Deno 需要网络 (--allow-net) 权限:

main.ts

  1. new Worker("https://example.com/worker.ts", { type: "module" });

worker.ts

  1. console.log("hello world");
  2. self.close();
  1. $ deno run main.ts
  2. error: Uncaught PermissionDenied: net access to "https://example.com/worker.ts", run again with the --allow-net flag
  3. $ deno run --allow-net main.ts
  4. hello world

在 Worker 中使用 Deno

这是一个不稳定的 Deno 特性。 更多信息请查阅 稳定性

默认情况下,Deno 命名空间在 worker 作用域中不可用。

要想启用 Deno 命名空间,在创建新的 worker 时传递 deno: true 选项:

main.js

  1. const worker = new Worker(new URL("worker.js", import.meta.url).href, {
  2. type: "module",
  3. deno: true,
  4. });
  5. worker.postMessage({ filename: "./log.txt" });

worker.js

  1. self.onmessage = async (e) => {
  2. const { filename } = e.data;
  3. const text = await Deno.readTextFile(filename);
  4. console.log(text);
  5. self.close();
  6. };

log.txt

  1. hello world
  1. $ deno run --allow-read --unstable main.js
  2. hello world

Deno 命名空间在 worker 作用域中启用时,此 worker 继承创建者的权限(使用类似 --allow-* 的选项指定的权限)。

我们计划提供 worker 权限的配置方法。