基础篇：ArkTS基础语法介绍

前言：

        目前流行的编程语言TypeScript是在JavaScript基础上通过添加类型定义扩展而来的，而ArkTS则是TypeScript的进一步扩展。TypeScript深受开发者的喜爱，因为它提供了一种更结构化的JavaScript编码方法。ArkTS旨在保持TypeScript的大部分语法，为现有的TypeScript开发者实现无缝过渡，让移动开发者快速上手ArkTS。

        ArkTS比typeScipt更严格，它的一大特性是它专注于低运行时开销。ArkTS对TypeScript的动态类型特性施加了更严格的限制，以减少运行时开销，提高执行效率。通过取消动态类型特性，ArkTS代码能更有效地被运行前编译和优化，从而实现更快的应用启动和更低的功耗。

基本知识

声明

ArkTS通过声明引入变量、常量、函数和类型。

变量声明

以关键字let开头的声明引入变量，该变量在程序执行期间可以具有不同的值。

1. let hi: string = 'hello';
2. hi = 'hello, world';

常量声明

以关键字const开头的声明引入只读常量，该常量只能被赋值一次。

1. const hello: string = 'hello';

对常量重新赋值会造成编译时错误。

自动类型推断

由于ArkTS是一种静态类型语言，所有数据的类型都必须在编译时确定。

但是，如果一个变量或常量的声明包含了初始值，那么开发者就不需要显式指定其类型。ArkTS规范中列举了所有允许自动推断类型的场景。

以下示例中，两条声明语句都是有效的，两个变量都是string类型：

1. let hi1: string = 'hello';
2. let hi2 = 'hello, world';

类型

Number类型

ArkTS提供number和Number类型，任何整数和浮点数都可以被赋给此类型的变量。

数字字面量包括整数字面量和十进制浮点数字面量。

整数字面量包括以下类别：

• 由数字序列组成的十进制整数。例如：0、117、-345
• 以0x（或0X）开头的十六进制整数，可以包含数字（0-9）和字母a-f或A-F。例如：0x1123、0x00111、-0xF1A7
• 以0o（或0O）开头的八进制整数，只能包含数字（0-7）。例如：0o777
• 以0b（或0B）开头的二进制整数，只能包含数字0和1。例如：0b11、0b0011、-0b11

浮点字面量包括以下：

• 十进制整数，可为有符号数（即，前缀为“+”或“-”）；
• 小数点（“.”）
• 小数部分（由十进制数字字符串表示）
• 以“e”或“E”开头的指数部分，后跟有符号（即，前缀为“+”或“-”）或无符号整数。

示例：

1. let n1 = 3.14;
2. let n2 = 3.141592;
3. let n3 = .5;
4. let n4 = 1e10;
6. function factorial(n: number): number {
7. if (n <= 1) {
8. return 1;
9. }
10. return n * factorial(n - 1);
11. }

Boolean类型

boolean类型由true和false两个逻辑值组成。

通常在条件语句中使用boolean类型的变量：

1. let isDone: boolean = false;
3. // ...
5. if (isDone) {
6. console.log ('Done!');
7. }

String类型

string代表字符序列；可以使用转义字符来表示字符。

字符串字面量由单引号（'）或双引号（"）之间括起来的零个或多个字符组成。字符串字面量还有一特殊形式，是用反向单引号（`）括起来的模板字面量。

1. let s1 = 'Hello, world!\n';
2. let s2 = 'this is a string';
3. let a = 'Success';
4. let s3 = `The result is ${a}`;

Void类型

void类型用于指定函数没有返回值。

此类型只有一个值，同样是void。由于void是引用类型，因此它可以用于泛型类型参数。

1. class Class<T> {
2. //...
3. }
4. let instance: Class <void>

Object类型

Object类型是所有引用类型的基类型。任何值，包括基本类型的值（它们会被自动装箱），都可以直接被赋给Object类型的变量。

Array类型

array，即数组，是由可赋值给数组声明中指定的元素类型的数据组成的对象。

数组可由数组复合字面量（即用方括号括起来的零个或多个表达式的列表，其中每个表达式为数组中的一个元素）来赋值。数组的长度由数组中元素的个数来确定。数组中第一个元素的索引为0。

以下示例将创建包含三个元素的数组：

1. let names: string[] = ['Alice', 'Bob', 'Carol'];

Enum类型

enum类型，又称枚举类型，是预先定义的一组命名值的值类型，其中命名值又称为枚举常量。

使用枚举常量时必须以枚举类型名称为前缀。

1. enum ColorSet { Red, Green, Blue }
2. let c: ColorSet = ColorSet.Red;

常量表达式可以用于显式设置枚举常量的值。

1. enum ColorSet { White = 0xFF, Grey = 0x7F, Black = 0x00 }
2. let c: ColorSet = ColorSet.Black;

Union类型

union类型，即联合类型，是由多个类型组合成的引用类型。联合类型包含了变量可能的所有类型。

1. class Cat {
2. // ...
3. }
4. class Dog {
5. // ...
6. }
7. class Frog {
8. // ...
9. }
10. type Animal = Cat | Dog | Frog | number
11. // Cat、Dog、Frog是一些类型（类或接口）
13. let animal: Animal = new Cat();
14. animal = new Frog();
15. animal = 42;
16. // 可以将类型为联合类型的变量赋值为任何组成类型的有效值

可以用不同的机制获取联合类型中特定类型的值。

示例：

1. class Cat { sleep () {}; meow () {} }
2. class Dog { sleep () {}; bark () {} }
3. class Frog { sleep () {}; leap () {} }
5. type Animal = Cat | Dog | Frog | number
7. let animal: Animal = new Frog();
8. if (animal instanceof Frog) {
9. let frog: Frog = animal as Frog; // animal在这里是Frog类型
10. animal.leap();
11. frog.leap();
12. // 结果：青蛙跳了两次
13. }
15. animal.sleep (); // 任何动物都可以睡觉

Aliases类型

Aliases类型为匿名类型（数组、函数、对象字面量或联合类型）提供名称，或为已有类型提供替代名称。

1. type Matrix = number[][];
2. type Handler = (s: string, no: number) => string;
3. type Predicate <T> = (x: T) => Boolean;
4. type NullableObject = Object | null;

运算符

赋值运算符

赋值运算符=，使用方式如x=y。

复合赋值运算符将赋值与运算符组合在一起，其中x op = y等于x = x op y。

复合赋值运算符列举如下：+=、-=、*=、/=、%=、<<=、>>=、>>>=、&=、|=、^=。

比较运算符

算术运算符

一元运算符为-、+、--、++。

二元运算符列举如下：

位运算符

逻辑运算符

语句

If语句

if语句用于需要根据逻辑条件执行不同语句的场景。当逻辑条件为真时，执行对应的一组语句，否则执行另一组语句（如果有的话）。

else部分也可能包含if语句。

if语句如下所示：

1. if (condition1) {
2. // 语句1
3. } else if (condition2) {
4. // 语句2
5. } else {
6. // else语句
7. }

条件表达式可以是任何类型。但是对于boolean以外的类型，会进行隐式类型转换：

1. let s1 = 'Hello';
2. if (s1) {
3. console.log(s1); // 打印“Hello”
4. }
6. let s2 = 'World';
7. if (s2.length != 0) {
8. console.log(s2); // 打印“World”
9. }

Switch语句

使用switch语句来执行与switch表达式值匹配的代码块。

switch语句如下所示：

1. switch (expression) {
2. case label1: // 如果label1匹配，则执行
3. // ...
4. // 语句1
5. // ...
6. break; // 可省略
7. case label2:
8. case label3: // 如果label2或label3匹配，则执行
9. // ...
10. // 语句23
11. // ...
12. break; // 可省略
13. default:
14. // 默认语句
15. }

如果switch表达式的值等于某个label的值，则执行相应的语句。

如果没有任何一个label值与表达式值相匹配，并且switch具有default子句，那么程序会执行default子句对应的代码块。

break语句（可选的）允许跳出switch语句并继续执行switch语句之后的语句。

如果没有break语句，则执行switch中的下一个label对应的代码块。

条件表达式

条件表达式由第一个表达式的布尔值来决定返回其它两个表达式中的哪一个。

示例如下：

1. condition ? expression1 : expression2

如果condition的为真值（转换后为true的值），则使用expression1作为该表达式的结果；否则，使用expression2。

示例：

1. let isValid = Math.random() > 0.5 ? true : false;
2. let message = isValid ? 'Valid' : 'Failed';

For语句

for语句会被重复执行，直到循环退出语句值为false。

for语句如下所示：

1. for ([init]; [condition]; [update]) {
2. statements
3. }

for语句的执行流程如下：

1、 执行init表达式（如有）。此表达式通常初始化一个或多个循环计数器。

2、 计算condition。如果它为真值（转换后为true的值），则执行循环主体的语句。如果它为假值（转换后为false的值），则for循环终止。

3、 执行循环主体的语句。

4、 如果有update表达式，则执行该表达式。

5、 回到步骤2。

示例：

1. let sum = 0;
2. for (let i = 0; i < 10; i += 2) {
3. sum += i;
4. }

For-of语句

使用for-of语句可遍历数组或字符串。示例如下：

1. for (forVar of expression) {
2. statements
3. }

示例：

1. for (let ch of 'a string object') {
2. /* process ch */
3. }

While语句

只要condition为真值（转换后为true的值），while语句就会执行statements语句。示例如下：

1. while (condition) {
2. statements
3. }

示例：

1. let n = 0;
2. let x = 0;
3. while (n < 3) {
4. n++;
5. x += n;
6. }

Do-while语句

如果condition的值为真值（转换后为true的值），那么statements语句会重复执行。示例如下：

1. do {
2. statements
3. } while (condition)

示例：

1. let i = 0;
2. do {
3. i += 1;
4. } while (i < 10)

Break语句

使用break语句可以终止循环语句或switch。

示例：

1. let x = 0;
2. while (true) {
3. x++;
4. if (x > 5) {
5. break;
6. }
7. }

如果break语句后带有标识符，则将控制流转移到该标识符所包含的语句块之外。

示例：

1. let x = 1
2. label: while (true) {
3. switch (x) {
4. case 1:
5. // statements
6. break label; // 中断while语句
7. }
8. }

Continue语句

continue语句会停止当前循环迭代的执行，并将控制传递给下一个迭代。

示例：

1. let sum = 0;
2. for (let x = 0; x < 100; x++) {
3. if (x % 2 == 0) {
4. continue
5. }
6. sum += x;
7. }

Throw和Try语句

throw语句用于抛出异常或错误：

1. throw new Error('this error')

try语句用于捕获和处理异常或错误：

1. try {
2. // 可能发生异常的语句块
3. } catch (e) {
4. // 异常处理
5. }

下面的示例中throw和try语句用于处理除数为0的错误：

1. class ZeroDivisor extends Error {}
3. function divide (a: number, b: number): number{
4. if (b == 0) throw new ZeroDivisor();
5. return a / b;
6. }
8. function process (a: number, b: number) {
9. try {
10. let res = divide(a, b);
11. console.log('result: ' + res);
12. } catch (x) {
13. console.log('some error');
14. }
15. }

支持finally语句：

1. function processData(s: string) {
2. let error: Error | null = null;
4. try {
5. console.log('Data processed: ' + s);
6. // ...
7. // 可能发生异常的语句
8. // ...
9. } catch (e) {
10. error = e as Error;
11. // ...
12. // 异常处理
13. // ...
14. } finally {
15. if (error != null) {
16. console.log(`Error caught: input='${s}', message='${error.message}'`);
17. }
18. }
19. }

函数

函数声明

函数声明引入一个函数，包含其名称、参数列表、返回类型和函数体。

以下示例是一个简单的函数，包含两个string类型的参数，返回类型为string：

1. function add(x: string, y: string): string {
2. let z: string = `${x} ${y}`;
3. return z;
4. }

在函数声明中，必须为每个参数标记类型。如果参数为可选参数，那么允许在调用函数时省略该参数。函数的最后一个参数可以是rest参数。

可选参数

可选参数的格式可为name?: Type。

1. function hello(name?: string) {
2. if (name == undefined) {
3. console.log('Hello!');
4. } else {
5. console.log(`Hello, ${name}!`);
6. }
7. }

可选参数的另一种形式为设置的参数默认值。如果在函数调用中这个参数被省略了，则会使用此参数的默认值作为实参。

1. function multiply(n: number, coeff: number = 2): number {
2. return n * coeff;
3. }
4. multiply(2); // 返回2*2
5. multiply(2, 3); // 返回2*3

Rest参数

函数的最后一个参数可以是rest参数。使用rest参数时，允许函数或方法接受任意数量的实参。

1. function sum(...numbers: number[]): number {
2. let res = 0;
3. for (let n of numbers)
4. res += n;
5. return res;
6. }
8. sum() // 返回0
9. sum(1, 2, 3) // 返回6

返回类型

如果可以从函数体内推断出函数返回类型，则可在函数声明中省略标注返回类型。

1. // 显式指定返回类型
2. function foo(): string { return 'foo'; }
4. // 推断返回类型为string
5. function goo() { return 'goo'; }

不需要返回值的函数的返回类型可以显式指定为void或省略标注。这类函数不需要返回语句。

以下示例中两种函数声明方式都是有效的：

1. function hi1() { console.log('hi'); }
2. function hi2(): void { console.log('hi'); }

函数的作用域

函数中定义的变量和其他实例仅可以在函数内部访问，不能从外部访问。

如果函数中定义的变量与外部作用域中已有实例同名，则函数内的局部变量定义将覆盖外部定义。

函数调用

调用函数以执行其函数体，实参值会赋值给函数的形参。

如果函数定义如下：

1. function join(x: string, y: string): string {
2. let z: string = `${x} ${y}`;
3. return z;
4. }

则此函数的调用需要包含两个string类型的参数：

1. let x = join('hello', 'world');
2. console.log(x);

函数类型

函数类型通常用于定义回调：

1. type trigFunc = (x: number) => number // 这是一个函数类型
3. function do_action(f: trigFunc) {
4. f(3.141592653589); // 调用函数
5. }
7. do_action(Math.sin); // 将函数作为参数传入

箭头函数或Lambda函数

函数可以定义为箭头函数，例如：

1. let sum = (x: number, y: number): number => {
2. return x + y;
3. }

箭头函数的返回类型可以省略；省略时，返回类型通过函数体推断。

表达式可以指定为箭头函数，使表达更简短，因此以下两种表达方式是等价的：

1. let sum1 = (x: number, y: number) => { return x + y; }
2. let sum2 = (x: number, y: number) => x + y

闭包

闭包是由函数及声明该函数的环境组合而成的。该环境包含了这个闭包创建时作用域内的任何局部变量。

在下例中，z是执行f时创建的g箭头函数实例的引用。g的实例维持了对它的环境的引用（变量count存在其中）。因此，当z被调用时，变量count仍可用。

1. function f(): () => number {
2. let count = 0;
3. let g = (): number => { count++; return count; };
4. return g;
5. }
7. let z = f();
8. z(); // 返回：1
9. z(); // 返回：2

函数重载

我们可以通过编写重载，指定函数的不同调用方式。具体方法为，为同一个函数写入多个同名但签名不同的函数头，函数实现紧随其后。

1. function foo(x: number): void; /* 第一个函数定义 */
2. function foo(x: string): void; /* 第二个函数定义 */
3. function foo(x: number | string): void { /* 函数实现 */
4. }
6. foo(123); // OK，使用第一个定义
7. foo('aa'); // OK，使用第二个定义

不允许重载函数有相同的名字以及参数列表，否则将会编译报错。

类

类声明引入一个新类型，并定义其字段、方法和构造函数。

在以下示例中，定义了Person类，该类具有字段name和surname、构造函数和方法fullName：

1. class Person {
2. name: string = ''
3. surname: string = ''
4. constructor (n: string, sn: string) {
5. this.name = n;
6. this.surname = sn;
7. }
8. fullName(): string {
9. return this.name + ' ' + this.surname;
10. }
11. }

定义类后，可以使用关键字new创建实例：

1. let p = new Person('John', 'Smith');
2. console.log(p.fullName());

或者，可以使用对象字面量创建实例：

1. class Point {
2. x: number = 0
3. y: number = 0
4. }
5. let p: Point = {x: 42, y: 42};

字段

字段是直接在类中声明的某种类型的变量。

类可以具有实例字段或者静态字段。

实例字段

实例字段存在于类的每个实例上。每个实例都有自己的实例字段集合。

要访问实例字段，需要使用类的实例。

1. class Person {
2. name: string = ''
3. age: number = 0
4. constructor(n: string, a: number) {
5. this.name = n;
6. this.age = a;
7. }
9. getName(): string {
10. return this.name;
11. }
12. }
14. let p1 = new Person('Alice', 25);
15. p1.name;
16. let p2 = new Person('Bob', 28);
17. p2.getName();

静态字段

使用关键字static将字段声明为静态。静态字段属于类本身，类的所有实例共享一个静态字段。

要访问静态字段，需要使用类名：

1. class Person {
2. static numberOfPersons = 0
3. constructor() {
4. // ...
5. Person.numberOfPersons++;
6. // ...
7. }
8. }
10. Person.numberOfPersons;

字段初始化

为了减少运行时的错误和获得更好的执行性能，

ArkTS要求所有字段在声明时或者构造函数中显式初始化。这和标准TS中的strictPropertyInitialization模式一样。

以下代码是在ArkTS中不合法的代码。

1. class Person {
2. name: string // undefined
4. setName(n:string): void {
5. this.name = n;
6. }
8. getName(): string {
9. // 开发者使用"string"作为返回类型，这隐藏了name可能为"undefined"的事实。
10. // 更合适的做法是将返回类型标注为"string | undefined"，以告诉开发者这个API所有可能的返回值。
11. return this.name;
12. }
13. }
15. let jack = new Person();
16. // 假设代码中没有对name赋值，例如调用"jack.setName('Jack')"
17. jack.getName().length; // 运行时异常：name is undefined

在ArkTS中，应该这样写代码。

1. class Person {
2. name: string = ''
4. setName(n:string): void {
5. this.name = n;
6. }
8. // 类型为'string'，不可能为"null"或者"undefined"
9. getName(): string {
10. return this.name;
11. }
12. }
15. let jack = new Person();
16. // 假设代码中没有对name赋值，例如调用"jack.setName('Jack')"
17. jack.getName().length; // 0, 没有运行时异常

接下来的代码展示了如果name的值可以是undefined，那么应该如何写代码。

1. class Person {
2. name?: string // 可能为`undefined`
4. setName(n:string): void {
5. this.name = n;
6. }
8. // 编译时错误：name可以是"undefined"，所以将这个API的返回值类型标记为string
9. getNameWrong(): string {
10. return this.name;
11. }
13. getName(): string | undefined { // 返回类型匹配name的类型
14. return this.name;
15. }
16. }
18. let jack = new Person();
19. // 假设代码中没有对name赋值，例如调用"jack.setName('Jack')"
21. // 编译时错误：编译器认为下一行代码有可能会访问undefined的属性，报错
22. jack.getName().length; // 编译失败
24. jack.getName()?.length; // 编译成功，没有运行时错误

getter和setter

setter和getter可用于提供对对象属性的受控访问。

在以下示例中，setter用于禁止将age属性设置为无效值：

1. class Person {
2. name: string = ''
3. private _age: number = 0
4. get age(): number { return this._age; }
5. set age(x: number) {
6. if (x < 0) {
7. throw Error('Invalid age argument');
8. }
9. this._age = x;
10. }
11. }
13. let p = new Person();
14. p.age; // 输出0
15. p.age = -42; // 设置无效age值会抛出错误

在类中可以定义getter或者setter。

方法

方法属于类。类可以定义实例方法或者静态方法。静态方法属于类本身，只能访问静态字段。而实例方法既可以访问静态字段，也可以访问实例字段，包括类的私有字段。

实例方法

以下示例说明了实例方法的工作原理。

calculateArea方法通过将高度乘以宽度来计算矩形的面积：

1. class RectangleSize {
2. private height: number = 0
3. private width: number = 0
4. constructor(height: number, width: number) {
5. // ...
6. }
7. calculateArea(): number {
8. return this.height * this.width;
9. }
10. }

必须通过类的实例调用实例方法：

1. let square = new RectangleSize(10, 10);
2. square.calculateArea(); // 输出：100

静态方法

使用关键字static将方法声明为静态。静态方法属于类本身，只能访问静态字段。

静态方法定义了类作为一个整体的公共行为。

必须通过类名调用静态方法：

1. class Cl {
2. static staticMethod(): string {
3. return 'this is a static method.';
4. }
5. }
6. console.log(Cl.staticMethod());

继承

一个类可以继承另一个类（称为基类），并使用以下语法实现多个接口：

1. class [extends BaseClassName] [implements listOfInterfaces] {
2. // ...
3. }

继承类继承基类的字段和方法，但不继承构造函数。继承类可以新增定义字段和方法，也可以覆盖其基类定义的方法。

基类也称为“父类”或“超类”。继承类也称为“派生类”或“子类”。

示例：

1. class Person {
2. name: string = ''
3. private _age = 0
4. get age(): number {
5. return this._age;
6. }
7. }
8. class Employee extends Person {
9. salary: number = 0
10. calculateTaxes(): number {
11. return this.salary * 0.42;
12. }
13. }

包含implements子句的类必须实现列出的接口中定义的所有方法，但使用默认实现定义的方法除外。

1. interface DateInterface {
2. now(): string;
3. }
4. class MyDate implements DateInterface {
5. now(): string {
6. // 在此实现
7. return 'now is now';
8. }
9. }

父类访问

关键字super可用于访问父类的实例字段、实例方法和构造函数。在实现子类功能时，可以通过该关键字从父类中获取所需接口：

1. class RectangleSize {
2. protected height: number = 0
3. protected width: number = 0
5. constructor (h: number, w: number) {
6. this.height = h;
7. this.width = w;
8. }
10. draw() {
11. /* 绘制边界 */
12. }
13. }
14. class FilledRectangle extends RectangleSize {
15. color = ''
16. constructor (h: number, w: number, c: string) {
17. super(h, w); // 父类构造函数的调用
18. this.color = c;
19. }
21. draw() {
22. super.draw(); // 父类方法的调用
23. // super.height -可在此处使用
24. /* 填充矩形 */
25. }
26. }

方法重写

子类可以重写其父类中定义的方法的实现。重写的方法必须具有与原始方法相同的参数类型和相同或派生的返回类型。

1. class RectangleSize {
2. // ...
3. area(): number {
4. // 实现
5. return 0;
6. }
7. }
8. class Square extends RectangleSize {
9. private side: number = 0
10. area(): number {
11. return this.side * this.side;
12. }
13. }

方法重载签名

通过重载签名，指定方法的不同调用。具体方法为，为同一个方法写入多个同名但签名不同的方法头，方法实现紧随其后。

1. class C {
2. foo(x: number): void; /* 第一个签名 */
3. foo(x: string): void; /* 第二个签名 */
4. foo(x: number | string): void { /* 实现签名 */
5. }
6. }
7. let c = new C();
8. c.foo(123); // OK，使用第一个签名
9. c.foo('aa'); // OK，使用第二个签名

如果两个重载签名的名称和参数列表均相同，则为错误。

构造函数

类声明可以包含用于初始化对象状态的构造函数。

构造函数定义如下：

1. constructor ([parameters]) {
2. // ...
3. }

如果未定义构造函数，则会自动创建具有空参数列表的默认构造函数，例如：

1. class Point {
2. x: number = 0
3. y: number = 0
4. }
5. let p = new Point();

在这种情况下，默认构造函数使用字段类型的默认值来初始化实例中的字段。

派生类的构造函数

构造函数函数体的第一条语句可以使用关键字super来显式调用直接父类的构造函数。

1. class RectangleSize {
2. constructor(width: number, height: number) {
3. // ...
4. }
5. }
6. class Square extends RectangleSize {
7. constructor(side: number) {
8. super(side, side);
9. }
10. }

构造函数重载签名

我们可以通过编写重载签名，指定构造函数的不同调用方式。具体方法为，为同一个构造函数写入多个同名但签名不同的构造函数头，构造函数实现紧随其后。

1. class C {
2. constructor(x: number) /* 第一个签名 */
3. constructor(x: string) /* 第二个签名 */
4. constructor(x: number | string) { /* 实现签名 */
5. }
6. }
7. let c1 = new C(123); // OK，使用第一个签名
8. let c2 = new C('abc'); // OK，使用第二个签名

如果两个重载签名的名称和参数列表均相同，则为错误。

可见性修饰符

类的方法和属性都可以使用可见性修饰符。

可见性修饰符包括：private、protected和public。默认可见性为public。

Public（公有）

public修饰的类成员（字段、方法、构造函数）在程序的任何可访问该类的地方都是可见的。

Private（私有）

private修饰的成员不能在声明该成员的类之外访问，例如：

1. class C {
2. public x: string = ''
3. private y: string = ''
4. set_y (new_y: string) {
5. this.y = new_y; // OK，因为y在类本身中可以访问
6. }
7. }
8. let c = new C();
9. c.x = 'a'; // OK，该字段是公有的
10. c.y = 'b'; // 编译时错误：'y'不可见

Protected（受保护）

protected修饰符的作用与private修饰符非常相似，不同点是protected修饰的成员允许在派生类中访问，例如：

1. class Base {
2. protected x: string = ''
3. private y: string = ''
4. }
5. class Derived extends Base {
6. foo() {
7. this.x = 'a'; // OK，访问受保护成员
8. this.y = 'b'; // 编译时错误，'y'不可见，因为它是私有的
9. }
10. }

对象字面量

对象字面量是一个表达式，可用于创建类实例并提供一些初始值。它在某些情况下更方便，可以用来代替new表达式。

对象字面量的表示方式是：封闭在花括号对({})中的'属性名：值'的列表。

1. class C {
2. n: number = 0
3. s: string = ''
4. }
6. let c: C = {n: 42, s: 'foo'};

ArkTS是静态类型语言，如上述示例所示，对象字面量只能在可以推导出该字面量类型的上下文中使用。其他正确的例子：

1. class C {
2. n: number = 0
3. s: string = ''
4. }
6. function foo(c: C) {}
8. let c: C
10. c = {n: 42, s: 'foo'}; // 使用变量的类型
11. foo({n: 42, s: 'foo'}); // 使用参数的类型
13. function bar(): C {
14. return {n: 42, s: 'foo'}; // 使用返回类型
15. }

也可以在数组元素类型或类字段类型中使用：

1. class C {
2. n: number = 0
3. s: string = ''
4. }
5. let cc: C[] = [{n: 1, s: 'a'}, {n: 2, s: 'b'}];

Record类型的对象字面量

泛型Record<K, V>用于将类型（键类型）的属性映射到另一个类型（值类型）。常用对象字面量来初始化该类型的值：

1. let map: Record<string, number> = {
2. 'John': 25,
3. 'Mary': 21,
4. }
6. map['John']; // 25

类型K可以是字符串类型或数值类型，而V可以是任何类型。

1. interface PersonInfo {
2. age: number
3. salary: number
4. }
5. let map: Record<string, PersonInfo> = {
6. 'John': { age: 25, salary: 10},
7. 'Mary': { age: 21, salary: 20}
8. }

接口

接口声明引入新类型。接口是定义代码协定的常见方式。

任何一个类的实例只要实现了特定接口，就可以通过该接口实现多态。

接口通常包含属性和方法的声明

示例：

1. interface Style {
2. color: string // 属性
3. }
4. interface AreaSize {
5. calculateAreaSize(): number // 方法的声明
6. someMethod(): void; // 方法的声明
7. }

实现接口的类示例：

1. // 接口：
2. interface AreaSize {
3. calculateAreaSize(): number // 方法的声明
4. someMethod(): void; // 方法的声明
5. }
7. // 实现：
8. class RectangleSize implements AreaSize {
9. private width: number = 0
10. private height: number = 0
11. someMethod(): void {
12. console.log('someMethod called');
13. }
14. calculateAreaSize(): number {
15. this.someMethod(); // 调用另一个方法并返回结果
16. return this.width * this.height;
17. }
18. }

接口属性

接口属性可以是字段、getter、setter或getter和setter组合的形式。

属性字段只是getter/setter对的便捷写法。以下表达方式是等价的：

1. interface Style {
2. color: string
3. }

1. interface Style {
2. get color(): string
3. set color(x: string)
4. }

实现接口的类也可以使用以下两种方式：

1. interface Style {
2. color: string
3. }
5. class StyledRectangle implements Style {
6. color: string = ''
7. }

1. interface Style {
2. color: string
3. }
5. class StyledRectangle implements Style {
6. private _color: string = ''
7. get color(): string { return this._color; }
8. set color(x: string) { this._color = x; }
9. }

接口继承

接口可以继承其他接口，如下面的示例所示：

1. interface Style {
2. color: string
3. }
5. interface ExtendedStyle extends Style {
6. width: number
7. }

继承接口包含被继承接口的所有属性和方法，还可以添加自己的属性和方法。

泛型类型和函数

泛型类型和函数允许创建的代码在各种类型上运行，而不仅支持单一类型。

泛型类和接口

类和接口可以定义为泛型，将参数添加到类型定义中，如以下示例中的类型参数Element：

1. class CustomStack<Element> {
2. public push(e: Element):void {
3. // ...
4. }
5. }

要使用类型CustomStack，必须为每个类型参数指定类型实参：

1. let s = new CustomStack<string>();
2. s.push('hello');

编译器在使用泛型类型和函数时会确保类型安全。参见以下示例：

1. let s = new CustomStack<string>();
2. s.push(55); // 将会产生编译时错误

泛型约束

泛型类型的类型参数可以被限制只能取某些特定的值。例如，MyHashMap<Key, Value>这个类中的Key类型参数必须具有hash方法。

1. interface Hashable {
2. hash(): number
3. }
4. class MyHashMap<Key extends Hashable, Value> {
5. public set(k: Key, v: Value) {
6. let h = k.hash();
7. // ...其他代码...
8. }
9. }

在上面的例子中，Key类型扩展了Hashable，Hashable接口的所有方法都可以为key调用。

泛型函数

使用泛型函数可编写更通用的代码。比如返回数组最后一个元素的函数：

1. function last(x: number[]): number {
2. return x[x.length - 1];
3. }
4. last([1, 2, 3]); // 3

如果需要为任何数组定义相同的函数，使用类型参数将该函数定义为泛型：

1. function last<T>(x: T[]): T {
2. return x[x.length - 1];
3. }

现在，该函数可以与任何数组一起使用。

在函数调用中，类型实参可以显式或隐式设置：

1. // 显式设置的类型实参
2. last<string>(['aa', 'bb']);
3. last<number>([1, 2, 3]);
5. // 隐式设置的类型实参
6. // 编译器根据调用参数的类型来确定类型实参
7. last([1, 2, 3]);

泛型默认值

泛型类型的类型参数可以设置默认值。这样可以不指定实际的类型实参，而只使用泛型类型名称。下面的示例展示了类和函数的这一点。

1. class SomeType {}
2. interface Interface <T1 = SomeType> { }
3. class Base <T2 = SomeType> { }
4. class Derived1 extends Base implements Interface { }
5. // Derived1在语义上等价于Derived2
6. class Derived2 extends Base<SomeType> implements Interface<SomeType> { }
8. function foo<T = number>(): T {
9. // ...
10. }
11. foo();
12. // 此函数在语义上等价于下面的调用
13. foo<number>();

空安全

默认情况下，ArkTS中的所有类型都是不可为空的，因此类型的值不能为空。这类似于TypeScript的严格空值检查模式（strictNullChecks），但规则更严格。

在下面的示例中，所有行都会导致编译时错误：

1. let x: number = null; // 编译时错误
2. let y: string = null; // 编译时错误
3. let z: number[] = null; // 编译时错误

可以为空值的变量定义为联合类型T | null。

1. let x: number | null = null;
2. x = 1; // ok
3. x = null; // ok
4. if (x != null) { /* do something */ }

非空断言运算符

后缀运算符!可用于断言其操作数为非空。

应用于空值时，运算符将抛出错误。否则，值的类型将从T | null更改为T：

1. class C {
2. value: number | null = 1;
3. }
5. let c = new C();
6. let y: number;
7. y = c.value + 1; // 编译时错误：无法对可空值作做加法
8. y = c.value! + 1; // ok，值为2

空值合并运算符

空值合并二元运算符??用于检查左侧表达式的求值是否等于null或者undefined。如果是，则表达式的结果为右侧表达式；否则，结果为左侧表达式。

换句话说，a ?? b等价于三元运算符(a != null && a != undefined) ? a : b。

在以下示例中，getNick方法如果设置了昵称，则返回昵称；否则，返回空字符串：

1. class Person {
2. // ...
3. nick: string | null = null
4. getNick(): string {
5. return this.nick ?? '';
6. }
7. }

可选链

在访问对象属性时，如果该属性是undefined或者null，可选链运算符会返回undefined。

1. class Person {
2. nick: string | null = null
3. spouse?: Person
5. setSpouse(spouse: Person): void {
6. this.spouse = spouse;
7. }
9. getSpouseNick(): string | null | undefined {
10. return this.spouse?.nick;
11. }
13. constructor(nick: string) {
14. this.nick = nick;
15. this.spouse = undefined;
16. }
17. }

说明：getSpouseNick的返回类型必须为string | null | undefined，因为该方法可能返回null或者undefined。

可选链可以任意长，可以包含任意数量的?.运算符。

在以下示例中，如果一个Person的实例有不为空的spouse属性，且spouse有不为空的nick属性，则输出spouse.nick。否则，输出undefined：

1. class Person {
2. nick: string | null = null
3. spouse?: Person
5. constructor(nick: string) {
6. this.nick = nick;
7. this.spouse = undefined;
8. }
9. }
11. let p: Person = new Person('Alice');
12. p.spouse?.nick; // undefined

模块

程序可划分为多组编译单元或模块。

每个模块都有其自己的作用域，即，在模块中创建的任何声明（变量、函数、类等）在该模块之外都不可见，除非它们被显式导出。

与此相对，从另一个模块导出的变量、函数、类、接口等必须首先导入到模块中。

导出

可以使用关键字export导出顶层的声明。

未导出的声明名称被视为私有名称，只能在声明该名称的模块中使用。

注意：通过export方式导出，在导入时要加{}。

1. export class Point {
2. x: number = 0
3. y: number = 0
4. constructor(x: number, y: number) {
5. this.x = x;
6. this.y = y;
7. }
8. }
9. export let Origin = new Point(0, 0);
10. export function Distance(p1: Point, p2: Point): number {
11. return Math.sqrt((p2.x - p1.x) * (p2.x - p1.x) + (p2.y - p1.y) * (p2.y - p1.y));
12. }

导入

静态导入

导入声明用于导入从其他模块导出的实体，并在当前模块中提供其绑定。导入声明由两部分组成：

• 导入路径，用于指定导入的模块；
• 导入绑定，用于定义导入的模块中的可用实体集和使用形式（限定或不限定使用）。

导入绑定可以有几种形式。

假设模块具有路径“./utils”和导出实体“X”和“Y”。

导入绑定* as A表示绑定名称“A”，通过A.name可访问从导入路径指定的模块导出的所有实体：

1. import * as Utils from './utils'
2. Utils.X // 表示来自Utils的X
3. Utils.Y // 表示来自Utils的Y

导入绑定{ ident1, ..., identN }表示将导出的实体与指定名称绑定，该名称可以用作简单名称：

1. import { X, Y } from './utils'
2. X // 表示来自utils的X
3. Y // 表示来自utils的Y

如果标识符列表定义了ident as alias，则实体ident将绑定在名称alias下：

1. import { X as Z, Y } from './utils'
2. Z // 表示来自Utils的X
3. Y // 表示来自Utils的Y
4. X // 编译时错误：'X'不可见

动态导入

应用开发的有些场景中，如果希望根据条件导入模块或者按需导入模块，可以使用动态导入代替静态导入。

import()语法通常称为动态导入dynamic import，是一种类似函数的表达式，用来动态导入模块。以这种方式调用，将返回一个promise。

如下例所示，import(modulePath)可以加载模块并返回一个promise，该promise resolve为一个包含其所有导出的模块对象。该表达式可以在代码中的任意位置调用。

1. let modulePath = prompt("Which module to load?");
2. import(modulePath)
3. .then(obj => <module object>)
4. .catch(err => <loading error, e.g. if no such module>)

如果在异步函数中，可以使用let module = await import(modulePath)。

1. // say.ts
2. export function hi() {
3. console.log('Hello');
4. }
5. export function bye() {
6. console.log('Bye');
7. }

那么，可以像下面这样进行动态导入：

1. async function test() {
2. let ns = await import('./say');
3. let hi = ns.hi;
4. let bye = ns.bye;
5. hi();
6. bye();
7. }

更多的使用动态import的业务场景和使用实例见动态import。

导入HarmonyOS SDK的开放能力

HarmonyOS SDK提供的开放能力（接口）也需要在导入声明后使用。可直接导入接口模块来使用该模块内的所有接口能力，例如：

1. import UIAbility from '@ohos.app.ability.UIAbility';

从HarmonyOS NEXT Developer Preview 1版本开始引入Kit概念。SDK对同一个Kit下的接口模块进行了封装，开发者在示例代码中可通过导入Kit的方式来使用Kit所包含的接口能力。其中，Kit封装的接口模块可查看SDK目录下Kit子目录中各Kit的定义。

通过导入Kit方式使用开放能力有三种方式：

• 方式一：导入Kit下单个模块的接口能力。例如：

  1. import { UIAbility } from '@kit.AbilityKit';

• 方式二：导入Kit下多个模块的接口能力。例如：

  1. import { UIAbility, Ability, Context } from '@kit.AbilityKit';

• 方式三：导入Kit包含的所有模块的接口能力。例如：

  1. import * as module from '@kit.AbilityKit';

  其中，“module”为别名，可自定义，然后通过该名称调用模块的接口。

  说明

  方式三可能会导入过多无需使用的模块，导致编译后的HAP包太大，占用过多资源，请谨慎使用。

顶层语句

模块可以包含除return语句外的任何模块级语句。

如果模块包含主函数（程序入口），则模块的顶层语句将在此函数函数体之前执行。否则，这些语句将在执行模块的其他功能之前执行。

程序入口

程序（应用）的入口是顶层主函数。主函数应具有空参数列表或只有string[]类型的参数。

1. function main() {
2. console.log('this is the program entry');
3. }

关键字

this

关键字this只能在类的实例方法中使用。

示例

1. class A {
2. count: string = 'a'
3. m(i: string): void {
4. this.count = i;
5. }
6. }

使用限制：

• 不支持this类型
• 不支持在函数和类的静态方法中使用this

示例

1. class A {
2. n: number = 0
3. f1(arg1: this) {} // 编译时错误，不支持this类型
4. static f2(arg1: number) {
5. this.n = arg1; // 编译时错误，不支持在类的静态方法中使用this
6. }
7. }
9. function foo(arg1: number) {
10. this.n = i; // 编译时错误，不支持在函数中使用this
11. }

关键字this的指向:

• 调用实例方法的对象
• 正在构造的对象