tencent cloud

腾讯云超级应用服务

文档腾讯云超级应用服务小程序开发指南指南基础能力多进程 Worker

多进程 Worker

PDF
聚焦模式
字号
最后更新时间： 2025-11-28 09:49:10
一些异步处理的任务，可以放置于 Worker 中运行，待运行结束后，再把结果返回到小程序主线程。Worker 运行于一个单独的全局上下文与线程中，不能直接调用主线程的方法。
Worker 与主线程之间的数据传输，双方使用 Worker.postMessage() 来发送数据，Worker.onMessage() 来接收数据，传输的数据并不是直接共享，而是被复制的。

使用流程

配置 Worker 信息

在 app.json 中可配置 Worker 代码放置的目录，目录下的所有 JS 代码最终将被打包成一个 JS 文件：
配置示例：
{
  "workers": "workers"
}
通过以上方式配置，workers 目录下的所有 JS 文件会被打包为一个 JS 文件，并作为小程序首包的一部分。

添加 Worker 代码文件

根据步骤1中的配置，在代码目录下新建以下两个入口文件：
workers/request/index.js
workers/request/utils.js
workers/response/index.js
添加后，目录结构如下：
├── app.js
├── app.json
├── project.config.json
└── workers
    ├── request
    │   ├── index.js
    │   └── utils.js
    └── response
        └── index.js

编写 Worker 代码

在 workers/request/index.js 编写 Worker 响应代码
const utils = require('./utils')


// 在 Worker 线程执行上下文会全局暴露一个 worker 对象，直接调用 worker.onMessage/postMessage 即可
worker.onMessage(function (res) {
  console.log(res)
})

在主线程中初始化 Worker

在主线程的代码 app.js 中初始化 Worker
const worker = wx.createWorker('workers/request/index.js') // 文件名指定 worker 的入口文件路径，绝对路径

主线程向 Worker 发送消息

worker.postMessage({
  msg: 'hello worker'
})

注意事项

Worker 最大并发数量限制为 1 个，创建下一个前请用 Worker.terminate() 结束当前 Worker；
Worker 内代码只能 require 指定 Worker 路径内的文件，无法引用其它路径；
Worker 的入口文件由 wx.createWorker() 时指定，开发者可动态指定 Worker 入口文件；
Worker 内不支持 wx 系列的 API；
Workers 之间不支持发送消息；
Worker 目录内只支持放置 JS 文件，其他类型的静态文件需要放在 Worker 目录外。
上一篇: 自定义 tabBar下一篇: DarkMode 适配指南

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈