tencent cloud

文档反馈

多进程 Worker

最后更新时间:2024-07-12 18:29:16
    一些异步处理的任务,可以放置于 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 目录外。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持