js_worker_module

简介

worker能够让js拥有多线程的能力，通过postMessage完成worker线程与宿主线程通信。

接口说明

接口实现详见：js_worker_module/jsapi/worker

Worker对象描述

宿主线程用于与worker线程通信的Object对象。

接口

接口名

constructor(scriptURL:string, options? WorkerOptions)	构造函数

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");

接口名

postMessage(message:Object, options?:PostMessageOptions)	向worker线程发送消息
postMessage(message:Object, transfer:ArrayBuffer[])	向worker线程发送消息

使用示例

// 示例一
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.postMessage("hello world");
 
// 示例二
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
var buffer = new ArrayBuffer(8);
worker.postMessage(buffer, [buffer]);

接口名

on(type:string, listener:EventListener)	向worker添加一个事件监听

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.on("alert", (e)=>{
     console.log("worker on...");
})

接口名

once(type:string, listener:EventListener)	向worker添加一个事件监听, 事件监听只执行一次便自动删除

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.once("alert", (e)=>{
    console.log("worker on...");
})

接口名

off(type:string, listener?:EventListener)	删除worker的事件监听

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.off("alert");

接口名

terminate()	关闭worker线程，终止worker发送消息

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.terminate();

接口名

removeEventListener(type:string, listener?:EventListener)	删除worker的事件监听

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.removeEventListener("alert");

接口名

dispatchEvent(event: Event)	分发定义在worker的事件

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.dispatchEvent({type:"alert"});

接口名

removeAllListener()	删除worker的所有事件监听

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.removeAllListener();

属性

属性名

onexit?:(code:number)=>void	worker退出时被调用的事件处理程序，处理程序在宿主线程中执行

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.onexit = function(e) {
    console.log("onexit...");
}

属性名

onerror?:(ev:ErrorEvent)=>void	worker在执行过程中发生异常被调用的事件处理程序，处理程序在宿主线程中执行

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.onerror = function(e) {
    console.log("onerror...");
}

属性名

onmessage?:(ev:MessageEvent)=>void	宿主线程收到来自其创建的worker通过parentPort.postMessage接口发送的消息时被调用的事件处理程序，处理程序在宿主线程中执行

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.onmessage = function(e) {
    console.log("onmessage...");
}

属性名

onmessageerror?:(event:MessageEvent)=>void	worker对象接收到一条无法序列化的消息时被调用的事件处理程序，处理程序在宿主线程中执行

使用示例

import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.onmessageerror = function(e) {
    console.log("onmessageerror...");
}

parentPort对象描述

worker线程用于与宿主线程通信的Object对象。

接口

接口名

postMessage(message:Object, options?:PostMessageOptions)	向宿主线程发送消息
postMessage(message:Object, transfer:ArrayBuffer[])	向宿主线程发送消息

使用示例

// main.js
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.postMessage("hello world");

// worker.js
import worker from "@ohos.worker"
const parentPort = worker.parentPort;
parentPort.onmessage = function(e) {
    parentPort.postMessage("hello world from worker.js");
}

接口名

close()	关闭worker线程，终止worker接收消息

使用示例

// main.js
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.postMessage("hello world");

// worker.js
import worker from "@ohos.worker"
const parentPort = worker.parentPort;
parentPort.onmessage = function(e) {
    parentPort.close();
}

属性

属性名

onmessage?:(event:MessageEvent)=>void	宿主线程收到来自其创建的worker通过worker.postMessage接口发送的消息时被调用的事件处理程序，处理程序在worker线程中执行

使用示例

// main.js
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.postMessage("hello world");

// worker.js
import worker from "@ohos.worker"
const parentPort = worker.parentPort;
parentPort.onmessage = function(e) {
    console.log("receive main.js message");
}

属性名

onerror?:(ev: ErrorEvent)=>void	worker在执行过程中发生异常被调用的事件处理程序，处理程序在worker线程中执行

使用示例

// main.js
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.postMessage("hello world");

// worker.js
import worker from "@ohos.worker"
const parentPort = worker.parentPort;
parentPort.onerror = function(e) {
    console.log("onerror...");
}

属性名

onmessageerror?:(event: MessageEvent)=>void	worker对象接收到一条无法被反序列化的消息时被调用的事件处理程序，处理程序在worker线程中执行

使用示例

// main.js
import worker from "@ohos.worker"
const worker = new worker.Worker("workers/worker.js");
worker.postMessage("hello world");

// worker.js
import worker from "@ohos.worker"
const parentPort = worker.parentPort;
parentPort.onmessageerror = function(e) {
    console.log("onmessageerror...");
}

涉及仓

ace_ace_engine(foundation/arkui/ace_engine-readme_zh.md)
ace_napi(foundation/arkui/napi-readme_zh.md)

OpenHarmony / js_worker_module
关闭

js_worker_module

简介

接口说明

Worker对象描述

接口

属性

parentPort对象描述

接口

属性

涉及仓

相关仓

许可证

简介

发行版

贡献者

近期动态

OpenHarmony / js_worker_module关闭 .gitee-modal { width: 500px !important; }

js_worker_module

简介

接口说明

Worker对象描述

接口

属性

parentPort对象描述

接口

属性

涉及仓

相关仓

许可证

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

OpenHarmony / js_worker_module
关闭