# 接口

在 TypeScript 中,我们使用接口(Interfaces)来定义对象的类型。

# 什么是接口

在面向对象语言中,接口(Interfaces)是一个很重要的概念,它是对行为的抽象,而具体如何行动需要由类(classes)去实现(implement)。

TypeScript 中的接口是一个非常灵活的概念,除了可用于对类的一部分行为进行抽象以外,也常用于对「对象的形状(Shape)」进行描述。

TypeScript 接口定义如下:

interface interface_name { 
}

简单的例子:

interface Person {
    name: string;
    age: number;
}

let tom: Person = {
    name: 'Tom',
    age: 25
};

上面的例子中,我们定义了一个接口 Person,接着定义了一个变量 tom,它的类型是 Person。这样,我们就约束了 tom 的形状必须和接口 Person 一致

接口一般首字母大写

# 定义的变量比接口少了一些属性是不允许的:

interface Person {
    name: string;
    age: number;
}

let tom: Person = {
    name: 'Tom'
};

// index.ts(6,5): error TS2322: Type '{ name: string; }' is not assignable to type 'Person'.
//   Property 'age' is missing in type '{ name: string; }'.

# 多一些属性也是不允许的:

interface Person {
    name: string;
    age: number;
}

let tom: Person = {
    name: 'Tom',
    age: 25,
    gender: 'male'
};

/*
 index.ts(9,5): error TS2322: Type '{ name: string; age: number; gender: string; }' is not assignable to type 'Person'.
 Object literal may only specify known properties, and 'gender' does not exist in type 'Person'.
不能将类型“{ name: string; age: number; gender: string; }”分配给类型“Person”。
  对象文字可以只指定已知属性,并且“gender”不在类型“Person”中。ts(2322)
*/

可见,赋值的时候,变量的形状必须和接口的形状保持一致。

# 可选属性

有时我们希望不要完全匹配一个形状,那么可以用可选属性:

interface Person {
    name: string;
    age?: number;
}

let tom: Person = {
    name: 'Tom'
};

let gam: Person = {
    name: 'Gam',
    age: 18
};

# 任意属性

有时候我们希望一个接口允许有任意的属性,可以使用如下方式:

interface Person {
    name: string;
    age?: number;
    [propName: string]: any;
}

let tom: Person = {
    name: 'Tom',
    gender: 'male'
};

使用 [propName: string] 定义了任意属性取 string 类型的值。

需要注意的是,一旦定义了任意属性,那么确定属性和可选属性的类型都必须是它的类型的子集

interface Person {
    name: string;
    age?: number;
    [propName: string]: string;
}

let tom: Person = {
    name: 'Tom',
    age: 25,
    gender: 'male'
};

/**
 * 不能将类型“{ name: string; age: number; gender: string; }”分配给类型“Person”。
  属性“age”与索引签名不兼容。
    不能将类型“number”分配给类型“string”。ts(2322)
 */

上例中,任意属性的值允许是 string,但是可选属性 age 的值却是 number,number 不是 string 的子属性,所以报错了。

一个接口中只能定义一个任意属性。如果接口中有多个类型的属性,则可以在任意属性中使用联合类型:

interface Person {
    name: string;
    age?: number;
    [propName: string]: string | number;
}

let tom: Person = {
    name: 'Tom',
    age: 25,
    gender: 'male'
};

# 只读属性

有时候我们希望对象中的一些字段只能在创建的时候被赋值,那么可以用 readonly 定义只读属性:

interface Person {
    readonly id: number;
    name: string;
    age?: number;
    [propName: string]: any;
}

let tom: Person = {
    id: 89757,
    name: 'Tom',
    gender: 'male'
};

tom.id = 9527; // 无法分配到 "id" ,因为它是只读属性。ts(2540)

# 接口和数组

接口中我们可以将数组的索引值和元素设置为不同类型,索引值可以是数字或字符串。

interface namelist { 
   [index:number]:string 
} 
 
// 类型一致,正确
var list2:namelist = ["Google","aliwang","Taobao"]

// 错误元素 1 不是 string 类型
// var list2:namelist = ["aliwang",1,"Taobao"]
interface ages { 
   [index:string]:number 
} 
 
var agelist:ages; 
 // 类型正确 
agelist["aliwang"] = 15  
 
// 类型错误,输出  error TS2322: Type '"google"' is not assignable to type 'number'.
// agelist[2] = "google"

# 接口继承

接口继承就是说接口可以通过其他接口来扩展自己。

Typescript 允许接口继承多个接口

继承使用关键字 extends

单接口继承语法格式:Child_interface_name extends super_interface_name

多接口继承语法格式:Child_interface_name extends super_interface1_name, super_interface2_name,…,super_interfaceN_name

继承的各个接口使用逗号 , 分隔。

# 单继承实例

interface Person { 
   age:number 
} 
 
interface Musician extends Person { 
   instrument:string 
} 
 
var drummer = <Musician>{};  // <Musician>这是泛型写法,后面会专门讲泛型,这里你可以理解为,设置<Musician>之后,不会强制要求对象立马和接口保存一致,在使用的时候才和接口对比
drummer.age = 27 
drummer.instrument = "Drums" 
console.log("年龄:  "+drummer.age)
console.log("喜欢的乐器:  "+drummer.instrument)

drummer.name = "aliwang" //报错提示: 类型“Musician”上不存在属性“name”。ts(2339)

# 多继承实例

interface IParent1 { 
    v1: number 
} 
 
interface IParent2 { 
    v2: number 
} 
 
interface Child extends IParent1, IParent2 { } 
var Iobj: Child = { v1: 12, v2: 23} 
console.log("value 1: " + Iobj.v1 + " value 2: " + Iobj.v2)

参考文章

对象的类型——接口 (opens new window)

更新时间: 2022年7月26日星期二下午4点32分