啟動一個Worker

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[复制gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

Worker是與主線程并行的獨(dú)立線程。創(chuàng)建Worker的線程稱之為宿主線程，Worker自身的線程稱之為Worker線程。創(chuàng)建Worker傳入的url文件在Worker線程中執(zhí)行，可以處理耗時操作但不可以直接操作UI。

導(dǎo)入模塊

复制import worker from '@ohos.worker';

屬性

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

WorkerOptions

Worker構(gòu)造函數(shù)的選項(xiàng)信息，用于為Worker添加其他信息。

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

Worker

使用以下方法前，均需先構(gòu)造Worker實(shí)例，Worker類繼承[EventTarget]。

constructor

constructor(scriptURL: string, options?: WorkerOptions)

Worker構(gòu)造函數(shù)。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js", {name:"first worker"});

postMessage

postMessage(message: Object, options?: PostMessageOptions): void

向Worker線程發(fā)送消息，數(shù)據(jù)的傳輸采用結(jié)構(gòu)化克隆算法。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js");
workerInstance.postMessage("hello world");

复制const workerInstance= new worker.Worker("workers/worker.js");
var buffer = new ArrayBuffer(8);
workerInstance.postMessage(buffer, [buffer]);

on

on(type: string, listener: EventListener): void

向Worker添加一個事件監(jiān)聽。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.on("alert", (e)= >{
    console.log("alert listener callback");
})

once

once(type: string, listener: EventListener): void

向Worker添加一個事件監(jiān)聽，事件監(jiān)聽只執(zhí)行一次便自動刪除。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js");
workerInstance.once("alert", (e)= >{
    console.log("alert listener callback");
})

off

off(type: string, listener?: EventListener): void

刪除Worker的事件監(jiān)聽。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js");
workerInstance.off("alert");

terminate

terminate(): void

關(guān)閉Worker線程，終止Worker接收消息。

系統(tǒng)能力： SystemCapability.Utils.Lang

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.terminate()

onexit

onexit?: (code: number) => void

Worker對象的onexit屬性表示W(wǎng)orker退出時被調(diào)用的事件處理程序，處理程序在宿主線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.onexit = function(e) {
    console.log("onexit")
}

onerror

onerror?: (err: ErrorEvent) => void

Worker對象的onerror屬性表示W(wǎng)orker在執(zhí)行過程中發(fā)生異常被調(diào)用的事件處理程序，處理程序在宿主線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.onerror = function(e) {
    console.log("onerror")
}

onmessage

onmessage?: (event: MessageEvent) => void

Worker對象的onmessage屬性表示宿主線程接收到來自其創(chuàng)建的Worker通過parentPort.postMessage接口發(fā)送的消息時被調(diào)用的事件處理程序，處理程序在宿主線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.onmessage = function(e) {
    console.log("onerror")
}

onmessageerror

onmessageerror?: (event: MessageEvent) => void

Worker對象的onmessageerror屬性表示當(dāng)Worker對象接收到一條無法被序列化的消息時被調(diào)用的事件處理程序，處理程序在宿主線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.onmessageerror= function(e) {
    console.log("onmessageerror")
}

EventTarget

addEventListener

addEventListener(type: string, listener: EventListener): void

向Worker添加一個事件監(jiān)聽。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.addEventListener("alert", (e)= >{
    console.log("alert listener callback");
})

removeEventListener

removeEventListener(type: string, callback?: EventListener): void

刪除Worker的事件監(jiān)聽。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.removeEventListener("alert")

dispatchEvent

dispatchEvent(event: Event): boolean

分發(fā)定義在Worker的事件。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.dispatchEvent({type:"alert"})

removeAllListener

removeAllListener(): void

刪除Worker的所有事件監(jiān)聽。

系統(tǒng)能力： SystemCapability.Utils.Lang

示例：

复制const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.removeAllListener({type:"alert"})

DedicatedWorkerGlobalScope

Worker線程用于與宿主線程通信的類，通過postMessage接口發(fā)送消息給宿主線程、close接口關(guān)閉Worker線程，DedicatedWorkerGlobalScope類繼承[WorkerGlobalScope]。

postMessage

postMessage(message: Object, options?: PostMessageOptions): void

Worker向宿主線程發(fā)送消息。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制// main.js
import worker from '@ohos.worker';
const workerInstance = new worker.Worker("workers/worker.js")
workerInstance.postMessage("hello world")
workerInstance.onmessage = function(e) {
    console.log("receive data from worker.js")
}

复制// worker.js
import worker from '@ohos.worker';
const parentPort = worker.parentPort;
parentPort.onmessage = function(e){
    parentPort.postMessage("receive data from main.js")
}

close

close(): void

關(guān)閉Worker線程，終止Worker接收消息。

系統(tǒng)能力： SystemCapability.Utils.Lang

示例：

复制// main.js
import worker from '@ohos.worker';
const workerInstance = new worker.Worker("workers/worker.js")

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

onmessage

onmessage?: (event: MessageEvent) => void

DedicatedWorkerGlobalScope的onmessage屬性表示W(wǎng)orker線程收到來自其宿主線程通過worker.postMessage接口發(fā)送的消息時被調(diào)用的事件處理程序，處理程序在Worker線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

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

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

onmessageerror

onmessageerror?: (event: MessageEvent) => void

DedicatedWorkerGlobalScope的onmessageerror屬性表示當(dāng)Worker對象接收到一條無法被反序列化的消息時被調(diào)用的事件處理程序，處理程序在Worker線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制// main.js
import worker from '@ohos.worker';
const workerInstance = new worker.Worker("workers/worker.js")

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

PostMessageOptions

明確數(shù)據(jù)傳遞過程中需要轉(zhuǎn)移所有權(quán)對象的類，傳遞所有權(quán)的對象必須是ArrayBuffer。

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

Event

事件類。

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

EventListener

事件監(jiān)聽類。

(evt: Event): void | Promise

執(zhí)行的回調(diào)函數(shù)。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

返回值：

示例：

复制const workerInstance = new worker.Worker("workers/worker.js");
workerInstance.addEventListener("alert", (e)= >{
    console.log("alert listener callback");
})

ErrorEvent

錯誤事件類，用于表示W(wǎng)orker執(zhí)行過程中出現(xiàn)異常的詳細(xì)信息，ErrorEvent類繼承[Event]。

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

MessageEvent

消息類，持有Worker線程間傳遞的數(shù)據(jù)。

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

WorkerGlobalScope

Worker線程自身的運(yùn)行環(huán)境，WorkerGlobalScope類繼承[EventTarget]。

屬性

系統(tǒng)能力： 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Utils.Lang。

onerror

onerror?: (ev: ErrorEvent) => void

WorkerGlobalScope的onerror屬性表示W(wǎng)orker在執(zhí)行過程中發(fā)生異常被調(diào)用的事件處理程序，處理程序在Worker線程中執(zhí)行。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

示例：

复制// main.js
import worker from '@ohos.worker';
const workerInstance = new worker.Worker("workers/worker.js")

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

審核編輯 黃宇