// 定义类
class User {
  id: number = 0;
  name: string = "";
  age: number = 0;

    getInfo(): string {
    return `${this.name}，年龄${this.age}`;
  }
}

// 使用对象字面量创建实例
const user: User = {
  id: 1,
  name: "张三",
  age: 25,
  getInfo() {
    return `${this.name}，年龄${this.age}`;
  }
};

强制规范

ArkTS 严格禁止无类型对象字面量，代码 const obj = {id: 1, name: "test"} 会直接触发编译错误，必须显式指定类型或接口。

// 定义接口
interface IProduct {
  id: number;
  name: string;
  price: number;
  discount?: number; // 可选属性
  getPrice(): number;
}

// 直接通过对象字面量实现接口
const product: IProduct = {
  id: 1001,
  name: "华为Mate 60 Pro",
  price: 6999,
  getPrice() {
    return this.discount ? this.price * this.discount : this.price;
  }
};

// 基础键值对
const config: Record = { timeout: 3000, retryCount: 3, maxConnections: 10 }; // 嵌套Record实现多语言配置 type I18nConfig = Record>; const i18n: I18nConfig = { zh: { welcome: "欢迎使用", submit: "提交", cancel: "取消" }, en: { welcome: "Welcome", submit: "Submit", cancel: "Cancel" } };

// 定义API响应数据接口
interface ApiResponse { code: number; message: string; data: T; timestamp: number; } // 构造成功响应 function success(data: T): ApiResponse { return { code: 200, message: "操作成功", data: data, timestamp: Date.now() }; }

// 定义卡片组件属性接口
interface CardProps {
  title: string;
  subTitle?: string;
  showBorder: boolean;
  padding: number;
  onClick: () => void;
}

// 父组件传递属性
@Component
struct ParentComponent {
  build() {
    Column() {
      // 通过对象字面量传递属性
      CardComponent({
        title: "用户信息",
        showBorder: true,
        padding: 16,
        onClick: () => {
          console.log("卡片被点击");
        }
      })
    }
  }
}

class MenuItem {
  icon: string = "";
  title: string = "";
  route: string = "";
}

// 初始化菜单列表
const menuList: MenuItem[] = [
  { icon: "home", title: "首页", route: "pages/home" },
  { icon: "category", title: "分类", route: "pages/category" },
  { icon: "cart", title: "购物车", route: "pages/cart" },
  { icon: "user", title: "我的", route: "pages/user" }
];

interface PaginationParams {
  page: number;
  pageSize: number;
  keyword?: string;
  sortBy?: string;
  sortOrder?: "asc" | "desc";
}

// 查询用户列表
function queryUserList(params: PaginationParams): Promise { // 接口请求逻辑 return request.get("/api/user/list", params); } // 调用函数，通过对象字面量传递参数 queryUserList({ page: 1, pageSize: 10, keyword: "张三", sortOrder: "desc" });

// ❌ 错误：隐式类型，无返回值标注
const userList = data.map(item => ({
  id: item.id,
  name: item.name
}));

// ✅ 正确：显式声明返回类型
const userList = data.map((): User => ({
  id: item.id,
  name: item.name
}));

{
  "buildOption": {
    "arkOptions": {
      "strictMode": true,
      "strictPropertyInitialization": true,
      "noImplicitAny": true,
      "strictNullChecks": true
    }
  }
}

第三方库适配提示

引入JavaScript库时，若遇到对象字面量类型校验错误，可通过扩展第三方库类型定义、使用类型断言或在 oh-package.json5 中配置忽略规则解决，优先推荐扩展类型定义以保证类型安全。