tencent cloud

Worker
下载PDF
最后更新时间：2025-12-08 15:05:26
Worker
最后更新时间： 2025-12-08 15:05:26
下载PDF

wx.CreateWorker

wx.createWorker(string scriptPath)

功能描述：创建一个 Worker 线程。
参数：string scriptPath，Worker 入口文件的绝对路径。
返回值：Worker，Worker 对象。
注意事项：
接口使用前需要在 game.json 中配置 workers 字段，表示 Worker 代码根目录；
scriptPath 为入口文件的绝对路径，且不以 / 开头；
目前限制最多只能创建一个 Worker，创建下一个 Worker 前请先调用 Worker.terminate。
多线程 Worker 指南(小游戏)
示例代码：
// 创建普通worker
const worker = wx.createWorker('workers/index.js') // 文件名指定 worker 的入口文件路径，绝对路径

worker.onMessage(function (res) {
  console.log(res)
})



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



worker.terminate()

Worker

Worker 实例，主线程中可通过 wx.createWorker 接口获取，Worker 线程中可通过全局变量 Worker 获取。

属性

Object env，Worker 内的环境变量。
属性
类型
说明
USER_DATA_PATH
string
文件系统中的用户目录路径 (本地路径)

Worker.onMessage

Worker.onMessage(function listener)

功能描述：监听主线程/Worker 线程向当前线程发送的消息的事件。
参数：function listener，主线程/Worker 线程向当前线程发送的消息的事件的监听函数。
参数：Object res
属性
类型
说明
message
Object
主线程/Worker 线程向当前线程发送的消息

Worker.postMessage

Worker.postMessage(Object message)

功能描述：向主线程/Worker 线程发送的消息。
参数：Object message，需要发送的消息。
示例代码：
Worker 线程中
worker.postMessage({
  msg: 'hello from worker'
})
主线程中
const worker = wx.createWorker('workers/request/index.js')


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

Worker.terminate

Worker.terminate()

功能描述：结束当前 Worker 线程。仅限在主线程 Worker 对象上调用。

本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈