输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API
开发与测试开放能力API应用框架ArkTS（方舟编程语言）ArkTS并发并发线程间通信线程间通信对象普通对象

普通对象

更新时间: 2026-08-29 09:41
本文导读

普通对象跨线程时通过拷贝（序列化）形式传递，两个线程的对象内容一致，但指向各自线程的隔离内存区间，被分配在各自线程的虚拟机本地堆（LocalHeap）。序列化支持类型包括：除Symbol之外的基础类型、Date、String、RegExp、Array、Map、Set、Object（仅限简单对象，比如通过"{}"或者"new Object"创建，普通对象仅支持传递属性，不支持传递其原型及方法）、ArrayBuffer、TypedArray。通信过程如图所示：

说明

普通类实例对象跨线程通过拷贝形式传递，只能传递数据，类方法会丢失。使用@Sendable装饰器标识为Sendable类后，类实例对象跨线程传递后，可携带类方法。

使用示例

此处提供了一个传递普通对象的示例，具体实现如下：

收起
自动换行
深色代码主题
复制
  1. // 自定义class TestA
  2. export class TestA {
  3.   constructor(name: string) {
  4.     this.name = name;
  5.   }
  6.   name: string = 'ClassA';
  7. }
Test.ets
收起
自动换行
深色代码主题
复制
  1. import { taskpool } from '@kit.ArkTS';
  2. import { BusinessError } from '@kit.BasicServicesKit';
  3. import { TestA } from './Test';
  4. 

  5. @Concurrent
  6. async function test1(arg: TestA) {
  7.   console.info(`TestA name is: ${arg.name}`);
  8. }
  9. 

  10. @Entry
  11. @Component
  12. struct Index {
  13.   @State message: string = 'Hello World';
  14. 

  15.   build() {
  16.     RelativeContainer() {
  17.       Text(this.message)
  18.         .id('HelloWorld')
  19.         .fontSize(50)
  20.         .fontWeight(FontWeight.Bold)
  21.         .alignRules({
  22.           center: { anchor: '__container__', align: VerticalAlign.Center },
  23.           middle: { anchor: '__container__', align: HorizontalAlign.Center }
  24.         })
  25.         .onClick(() => {
  26.           // 1. 创建TestA实例objA
  27.           let objA = new TestA('TestA');
  28.           // 2. 创建任务task，将objA传递给该任务，objA非sendable对象，通过序列化传递给子线程
  29.           let task = new taskpool.Task(test1, objA);
  30.           // 3. 执行任务
  31.           taskpool.execute(task).then(() => {
  32.             this.message = 'success';
  33.             console.info('taskpool: execute task success!');
  34.           }).catch((e: BusinessError) => {
  35.             this.message = 'fail';
  36.             console.error(`taskpool: execute task: Code: ${e.code}, message: ${e.message}`);
  37.           })
  38.         })
  39.     }
  40.     .height('100%')
  41.     .width('100%')
  42.   }
  43. }
NormalObject.ets
线程间通信对象概述
容器类对象
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词