From 31b6b7646086352957de7ef80f13c258fbcf8498 Mon Sep 17 00:00:00 2001 From: yqhan Date: Wed, 30 Nov 2022 11:01:13 +0800 Subject: [PATCH] Modify the problems of inconsistency for worker issue: https://gitee.com/openharmony/docs/issues/I63U4T Signed-off-by: yqhan --- .../reference/apis/js-apis-worker.md | 259 +++++++++--------- 1 file changed, 134 insertions(+), 125 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-worker.md b/zh-cn/application-dev/reference/apis/js-apis-worker.md index c26b6a78be..d04883cc41 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-worker.md +++ b/zh-cn/application-dev/reference/apis/js-apis-worker.md @@ -1,9 +1,8 @@ # 启动一个Worker -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
-> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - Worker是与主线程并行的独立线程。创建Worker的线程称之为宿主线程，Worker自身的线程称之为Worker线程。创建Worker传入的url文件在Worker线程中执行，可以处理耗时操作但不可以直接操作UI。 +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> 本模块首批接口从API version 7 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 @@ -16,10 +15,10 @@ import worker from '@ohos.worker'; **系统能力：** SystemCapability.Utils.Lang -| 名称 | 类型 | 可读 | 可写 | 说明 | +| 名称 | 类型 | 可读 | 可写 | 说明 | | --------------------------------- | --------------------------------------------------------- | ---- | ---- | ------------------------------------------------------------ | | workerPort9+ | [ThreadWorkerGlobalScope](#threadworkerglobalscope9) | 是 | 是 | worker线程用于与宿主线程通信的对象。 | -| parentPort(deprecated) | [DedicatedWorkerGlobalScope](#dedicatedworkerglobalscope) | 是 | 是 | worker线程用于与宿主线程通信的对象。
此属性从api9开始被废弃，建议使用workerPort9+。 | +| parentPort(deprecated) | [DedicatedWorkerGlobalScope](#dedicatedworkerglobalscope) | 是 | 是 | worker线程用于与宿主线程通信的对象。
此属性从API version 7开始支持,从API version 9 开始被废弃。
建议使用workerPort9+替代。 | ## WorkerOptions @@ -30,7 +29,7 @@ Worker构造函数的选项信息，用于为Worker添加其他信息。 | 名称 | 类型 | 可读 | 可写 | 说明 | | ---- | -------- | ---- | ---- | -------------- | -| type | classic \| module | 是 | 是 | Worker执行脚本的模式类型，默认为classic类型，暂不支持module类型。 | +| type | "classic" \| "module" | 是 | 是 | Worker执行脚本的模式类型，默认为classic类型，暂不支持module类型。 | | name | string | 是 | 是 | Worker的名称。 | | shared | boolean | 是 | 是 | 暂不支持共享Worker功能。 | @@ -264,7 +263,7 @@ Worker对象的onexit属性表示Worker销毁时被调用的事件处理程序 | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------ | -| code | number | 否 | Worker退出的code。 | +| code | number | 是 | Worker退出的code。 | **示例：** @@ -288,7 +287,7 @@ Worker对象的onerror属性表示Worker在执行过程中发生异常被调用 | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------- | ---- | ---------- | -| err | [ErrorEvent](#errorevent) | 否 | 异常数据。 | +| err | [ErrorEvent](#errorevent) | 是 | 异常数据。 | **示例：** @@ -302,7 +301,7 @@ workerInstance.onerror = function(e) { ### onmessage9+ -onmessage?: (event: MessageEvent\) => void +onmessage?: (event: MessageEvents) => void Worker对象的onmessage属性表示宿主线程接收到来自其创建的Worker通过parentPort.postMessage接口发送的消息时被调用的事件处理程序，处理程序在宿主线程中执行。 @@ -310,9 +309,9 @@ Worker对象的onmessage属性表示宿主线程接收到来自其创建的Worke **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ---------------------- | -| event | [MessageEvent](#messageevent) | 否 | 收到的Worker消息数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | -------------------------------- | ---- | ---------------------- | +| event | [MessageEvents](#messageevents9) | 是 | 收到的Worker消息数据。 | **示例：** @@ -328,7 +327,7 @@ workerInstance.onmessage = function(e) { ### onmessageerror9+ -onmessageerror?: (event: MessageEvent\) => void +onmessageerror?: (event: MessageEvents) => void Worker对象的onmessageerror属性表示当Worker对象接收到一条无法被序列化的消息时被调用的事件处理程序，处理程序在宿主线程中执行。 @@ -336,9 +335,9 @@ Worker对象的onmessageerror属性表示当Worker对象接收到一条无法被 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ---------- | -| event | [MessageEvent](#messageevent) | 否 | 异常数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | -------------------------------- | ---- | ---------- | +| event | [MessageEvents](#messageevents9) | 是 | 异常数据。 | **示例：** @@ -516,7 +515,7 @@ parentPort.onmessage = function(e) { ### onmessage9+ -onmessage?: (event: MessageEvent\) => void +onmessage?: (event: MessageEvents) => void DedicatedWorkerGlobalScope的onmessage属性表示Worker线程收到来自其宿主线程通过postMessage接口发送的消息时被调用的事件处理程序，处理程序在Worker线程中执行。 @@ -524,9 +523,9 @@ DedicatedWorkerGlobalScope的onmessage属性表示Worker线程收到来自其宿 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ------------------------ | -| event | [MessageEvent](#messageevent) | 否 | 收到宿主线程发送的数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | -------------------------------- | ---- | ------------------------ | +| event | [MessageEvents](#messageevents9) | 是 | 收到宿主线程发送的数据。 | **示例：** @@ -549,7 +548,7 @@ parentPort.onmessage = function(e) { ### onmessageerror9+ -onmessageerror?: (event: MessageEvent\) => void +onmessageerror?: (event: MessageEvents) => void DedicatedWorkerGlobalScope的onmessageerror属性表示当Worker对象接收到一条无法被反序列化的消息时被调用的事件处理程序，处理程序在Worker线程中执行。 @@ -557,9 +556,9 @@ DedicatedWorkerGlobalScope的onmessageerror属性表示当Worker对象接收到 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ---------- | -| event | [MessageEvent](#messageevent) | 否 | 异常数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | -------------------------------- | ---- | ---------- | +| event | [MessageEvents](#messageevents9) | 是 | 异常数据。 | **示例：** @@ -617,7 +616,7 @@ Worker线程自身的运行环境，GlobalScope类继承[WorkerEventTarget](#wor **系统能力：** SystemCapability.Utils.Lang -| 名称 | 类型 | 可读 | 可写 | 说明 | +| 名称 | 类型 | 可读 | 可写 | 说明 | | ---- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------- | | name | string | 是 | 否 | Worker的名字，new Worker时指定。 | | self | [GlobalScope](#globalscope9) & typeof globalThis | 是 | 否 | GlobalScope本身。 | @@ -635,7 +634,7 @@ GlobalScope的onerror属性表示Worker在执行过程中发生异常被调用 | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------- | ---- | ---------- | -| ev | [ErrorEvent](#errorevent) | 否 | 异常数据。 | +| ev | [ErrorEvent](#errorevent) | 是 | 异常数据。 | **示例：** @@ -654,22 +653,33 @@ parentPort.onerror = function(e){ } ``` +## MessageEvents9+ + +消息类，持有Worker线程间传递的数据。 + +**系统能力：** SystemCapability.Utils.Lang + +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ---- | ---- | ---- | ---- | ------------------ | +| data | any | 是 | 否 | 线程间传递的数据。 | ## Worker(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker9+](#threadworker9)替代。 使用以下方法前，均需先构造Worker实例，Worker类继承[EventTarget](#eventtarget)。 -### constructor(deprecated) > **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.constructor9+](#constructor9)替代。 +> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker9+](#threadworker9)替代。 + +### constructor(deprecated) constructor(scriptURL: string, options?: WorkerOptions) Worker构造函数。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.constructor9+](#constructor9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -754,13 +764,13 @@ Stage模型: ``` ### postMessage(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.postMessage9+](#postmessage9)替代。 - postMessage(message: Object, options?: PostMessageOptions): void 向Worker线程发送数据，数据类型必须是序列化所支持的类型。序列化支持类型见其他说明。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.postMessage9+](#postmessage9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -784,13 +794,13 @@ workerInstance.postMessage(buffer, [buffer]); ### on(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.on9+](#on9)替代。 - on(type: string, listener: EventListener): void 向Worker添加一个事件监听。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.on9+](#on9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -812,13 +822,13 @@ workerInstance.on("alert", (e)=>{ ### once(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.once9+](#once9)替代。 - once(type: string, listener: EventListener): void 向Worker添加一个事件监听，事件监听只执行一次便自动删除。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.once9+](#once9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -840,13 +850,13 @@ workerInstance.once("alert", (e)=>{ ### off(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.off9+](#off9)替代。 - off(type: string, listener?: EventListener): void 删除类型为type的事件监听。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.off9+](#off9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -866,13 +876,13 @@ workerInstance.off("alert"); ### terminate(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.terminate9+](#terminate9)替代。 - terminate(): void 销毁Worker线程，终止Worker接收消息。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.terminate9+](#terminate9)替代。 + **系统能力：** SystemCapability.Utils.Lang **示例：** @@ -885,20 +895,20 @@ workerInstance.terminate(); ### onexit(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.onexit9+](#onexit9)替代。 - onexit?: (code: number) => void Worker对象的onexit属性表示Worker销毁时被调用的事件处理程序，处理程序在宿主线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.onexit9+](#onexit9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------ | -| code | number | 否 | Worker退出的code。 | +| code | number | 是 | Worker退出的code。 | **示例：** @@ -912,20 +922,20 @@ workerInstance.onexit = function(e) { ### onerror(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.onerror9+](#onerror9)替代。 - onerror?: (err: ErrorEvent) => void Worker对象的onerror属性表示Worker在执行过程中发生异常被调用的事件处理程序，处理程序在宿主线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.onerror9+](#onerror9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------- | ---- | ---------- | -| err | [ErrorEvent](#errorevent) | 否 | 异常数据。 | +| err | [ErrorEvent](#errorevent) | 是 | 异常数据。 | **示例：** @@ -939,20 +949,20 @@ workerInstance.onerror = function(e) { ### onmessage(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.onmessage9+](#onmessage9)替代。 - onmessage?: (event: MessageEvent\) => void Worker对象的onmessage属性表示宿主线程接收到来自其创建的Worker通过parentPort.postMessage接口发送的消息时被调用的事件处理程序，处理程序在宿主线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.onmessage9+](#onmessage9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ---------------------- | -| event | [MessageEvent](#messageevent) | 否 | 收到的Worker消息数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | --------------------------------------- | ---- | ---------------------- | +| event | [MessageEvent<T>](#messageeventt) | 是 | 收到的Worker消息数据。 | **示例：** @@ -968,20 +978,20 @@ workerInstance.onmessage = function(e) { ### onmessageerror(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorker.onmessageerror9+](#onmessageerror9)替代。 - onmessageerror?: (event: MessageEvent\) => void Worker对象的onmessageerror属性表示当Worker对象接收到一条无法被序列化的消息时被调用的事件处理程序，处理程序在宿主线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorker.onmessageerror9+](#onmessageerror9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ---------- | -| event | [MessageEvent](#messageevent) | 否 | 异常数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | --------------------------------------- | ---- | ---------- | +| event | [MessageEvent<T>](#messageeventt) | 是 | 异常数据。 | **示例：** @@ -995,17 +1005,17 @@ workerInstance.onmessageerror= function(e) { ## EventTarget(deprecated) > **说明：**
-> 从API version 9开始废弃，建议使用[WorkerEventTarget9+](#workereventtarget9)替代。 +> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[WorkerEventTarget9+](#workereventtarget9)替代。 ### addEventListener(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[addEventListener9+](#addeventlistener9)替代。 - addEventListener(type: string, listener: EventListener): void 向Worker添加一个事件监听。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[addEventListener9+](#addeventlistener9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -1027,13 +1037,13 @@ workerInstance.addEventListener("alert", (e)=>{ ### removeEventListener(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[removeEventListener9+](#removeeventlistener9)替代。 - removeEventListener(type: string, callback?: EventListener): void 删除Worker的事件监听。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[removeEventListener9+](#removeeventlistener9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -1053,13 +1063,13 @@ workerInstance.removeEventListener("alert"); ### dispatchEvent(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[dispatchEvent9+](#dispatchevent9)替代。 - dispatchEvent(event: Event): boolean 分发定义在Worker的事件。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[dispatchEvent9+](#dispatchevent9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -1084,13 +1094,13 @@ workerInstance.dispatchEvent({type:"alert"}); ### removeAllListener(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[removeAllListener9+](#removealllistener9)替代。 - removeAllListener(): void 删除Worker所有的事件监听。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[removeAllListener9+](#removealllistener9)替代。 + **系统能力：** SystemCapability.Utils.Lang **示例：** @@ -1103,21 +1113,20 @@ workerInstance.removeAllListener(); ## DedicatedWorkerGlobalScope(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9)替代。 - Worker线程用于与宿主线程通信的类，通过postMessage接口发送消息给宿主线程、close接口销毁Worker线程。DedicatedWorkerGlobalScope类继承[WorkerGlobalScope](#workerglobalscope)。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9)替代。 ### postMessage(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).postMessage9+替代。 - postMessage(messageObject: Object, options?: PostMessageOptions): void Worker线程向宿主线程发送消息。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).postMessage9+替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -1152,13 +1161,13 @@ parentPort.onmessage = function(e){ ### close(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).close9+替代。 - close(): void 销毁Worker线程，终止Worker接收消息。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).close9+替代。 + **系统能力：** SystemCapability.Utils.Lang **示例：** @@ -1180,20 +1189,20 @@ parentPort.onmessage = function(e) { ### onmessage(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).onmessage9+替代。 - onmessage?: (event: MessageEvent\) => void DedicatedWorkerGlobalScope的onmessage属性表示Worker线程收到来自其宿主线程通过postMessage接口发送的消息时被调用的事件处理程序，处理程序在Worker线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).onmessage9+替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ------------------------ | -| event | [MessageEvent](#messageevent) | 否 | 收到宿主线程发送的数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | --------------------------------------- | ---- | ------------------------ | +| event | [MessageEvent<T>](#messageeventt) | 是 | 收到宿主线程发送的数据。 | **示例：** @@ -1215,20 +1224,20 @@ parentPort.onmessage = function(e) { ### onmessageerror(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).onmessageerror9+替代。 - onmessageerror?: (event: MessageEvent\) => void DedicatedWorkerGlobalScope的onmessageerror属性表示当Worker对象接收到一条无法被反序列化的消息时被调用的事件处理程序，处理程序在Worker线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[ThreadWorkerGlobalScope9+](#threadworkerglobalscope9).onmessageerror9+替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ----------------------------- | ---- | ---------- | -| event | [MessageEvent](#messageevent) | 否 | 异常数据。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | --------------------------------- | ---- | ---------- | +| event | [MessageEvent<T>](#messageeventt) | 是 | 异常数据。 | **示例：** @@ -1253,7 +1262,7 @@ parentPort.onmessageerror= function(e) { **系统能力：** SystemCapability.Utils.Lang -| 名称 | 类型 | 可读 | 可写 | 说明 | +| 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | ---- | ---- | --------------------------------- | | transfer | Object[] | 是 | 是 | ArrayBuffer数组，用于传递所有权。 | @@ -1264,21 +1273,21 @@ parentPort.onmessageerror= function(e) { **系统能力：** SystemCapability.Utils.Lang -| 名称 | 类型 | 可读 | 可写 | 说明 | -| --------- | -------- | ---- | ---- | ---------------------------------- | -| type | string | 是 | 否 | 指定事件的类型。 | -| timeStamp | number | 是 | 否 | 事件创建时的时间戳（精度为毫秒）。 | +| 名称 | 类型 | 可读 | 可写 | 说明 | +| --------- | ------ | ---- | ---- | ---------------------------------- | +| type | string | 是 | 否 | 指定事件的类型。 | +| timeStamp | number | 是 | 否 | 事件创建时的时间戳（精度为毫秒）。 | ## EventListener(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[WorkerEventListener9+](#workereventlistener9)替代。 - (evt: Event): void | Promise<void> 事件监听类。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[WorkerEventListener9+](#workereventlistener9)替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** @@ -1309,38 +1318,38 @@ workerInstance.addEventListener("alert", (e)=>{ **系统能力：** SystemCapability.Utils.Lang -| 名称 | 类型 | 可读 | 可写 | 说明 | -| -------- | -------- | ---- | ---- | -------------------- | -| message | string | 是 | 否 | 异常发生的错误信息。 | -| filename | string | 是 | 否 | 出现异常所在的文件。 | -| lineno | number | 是 | 否 | 异常所在的行数。 | -| colno | number | 是 | 否 | 异常所在的列数。 | -| error | Object | 是 | 否 | 异常类型。 | +| 名称 | 类型 | 可读 | 可写 | 说明 | +| -------- | ------ | ---- | ---- | -------------------- | +| message | string | 是 | 否 | 异常发生的错误信息。 | +| filename | string | 是 | 否 | 出现异常所在的文件。 | +| lineno | number | 是 | 否 | 异常所在的行数。 | +| colno | number | 是 | 否 | 异常所在的列数。 | +| error | Object | 是 | 否 | 异常类型。 | -## MessageEvent +## MessageEvent\ 消息类，持有Worker线程间传递的数据。 **系统能力：** SystemCapability.Utils.Lang | 名称 | 类型 | 可读 | 可写 | 说明 | -| ---- | -------- | ---- | ---- | ------------------ | -| data | T | 是 | 否 | 线程间传递的数据。 | +| ---- | ---- | ---- | ---- | ------------------ | +| data | T | 是 | 否 | 线程间传递的数据。 | ## WorkerGlobalScope(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[GlobalScope9+](#globalscope9)替代。 - Worker线程自身的运行环境，WorkerGlobalScope类继承[EventTarget](#eventtarget)。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[GlobalScope9+](#globalscope9)替代。 + ### 属性 **系统能力：** SystemCapability.Utils.Lang -| 名称 | 类型 | 可读 | 可写 | 说明 | +| 名称 | 类型 | 可读 | 可写 | 说明 | | ---- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------- | | name | string | 是 | 否 | Worker的名字，new Worker时指定。 | | self | [WorkerGlobalScope](#workerglobalscope) & typeof globalThis | 是 | 否 | WorkerGlobalScope本身。 | @@ -1348,20 +1357,20 @@ Worker线程自身的运行环境，WorkerGlobalScope类继承[EventTarget](#eve ### onerror(deprecated) -> **说明：**
-> 从API version 9开始废弃，建议使用[GlobalScope9+](#globalscope9).onerror替代。 - onerror?: (ev: ErrorEvent) => void WorkerGlobalScope的onerror属性表示Worker在执行过程中发生异常被调用的事件处理程序，处理程序在Worker线程中执行。 +> **说明：**
+> 从API version 7 开始支持，从API version 9 开始废弃，建议使用[GlobalScope9+](#globalscope9).onerror替代。 + **系统能力：** SystemCapability.Utils.Lang **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | ------------------------- | ---- | ---------- | -| ev | [ErrorEvent](#errorevent) | 否 | 异常数据。 | +| ev | [ErrorEvent](#errorevent) | 是 | 异常数据。 | **示例：** -- GitLab