TypeScript中索引签名的实现示例

 更新时间:2026年01月15日 10:51:22   作者:新节  
索引签名在TypeScript中用于定义具有动态属性名的对象,它允许使用字符串或数字作为键,并可以限制键和值的类型,下面就来详细的介绍一下TypeScript中索引签名,感兴趣的可以了解一下

1. 基本语法

索引签名的基本语法如下:

interface SomeObject {
  [key: string]: string;
}

在上面的例子中,[key: string] 表示这个对象可以有任意数量的字符串类型的键,而每个键对应的值都是 string 类型。

在使用apiFox对接接口时,经常会自动生成类型:如图

项目中的一些场景:

2. 使用索引签名

2.1 定义一个对象类型,允许使用字符串键名

interface Dictionary {
  [key: string]: number;
}

const dict: Dictionary = {
  age: 30,
  height: 175
};

console.log(dict["age"]); // 输出: 30
console.log(dict["height"]); // 输出: 175

在这个例子中,Dictionary 类型允许我们使用任意的字符串作为键,并且每个键对应的值都是 number 类型。

2.2 字符串或数字作为索引类型

你可以指定索引的键可以是 字符串数字,但你不能同时指定这两种类型。如果你同时使用字符串和数字,TypeScript 会做一定的类型推导。

interface MixedDictionary {
  [key: string]: number;
  [index: number]: number; // 字符串索引与数字索引共享相同的值类型
}

const dict: MixedDictionary = {
  age: 25,
  100: 500,
  height: 175
};

console.log(dict["age"]); // 输出: 25
console.log(dict[100]); // 输出: 500

3. 限制键的类型

你可以使用 字面量类型 限制对象的索引签名的键类型。例如,限制对象的键为 'a''b''c'

interface MyObject {
  [key: "a" | "b" | "c"]: number;
}

const obj: MyObject = {
  a: 1,
  b: 2,
  c: 3
};

console.log(obj.a); // 输出: 1

在这个例子中,MyObject 只允许 abc 作为键。键名之外的任何值都会导致编译错误。

4. 只读索引签名

有时你可能希望对象的键是不可变的,可以使用 readonly 来限制对象的属性是只读的。这对确保数据的不可变性非常有用。

interface ReadOnlyDict {
  readonly [key: string]: number;
}

const readOnlyDict: ReadOnlyDict = {
  age: 30,
  height: 175
};

console.log(readOnlyDict["age"]); // 输出: 30
// readOnlyDict["age"] = 35;  // Error: Cannot assign to 'age' because it is a read-only property.

在这个例子中,readOnlyDict 的属性值是只读的,意味着你不能更改这些值。

5. 使用类与索引签名

索引签名不仅适用于接口,还可以应用于类。当类具有索引签名时,类的实例可以使用任意的字符串作为键。

class MyClass {
  [key: string]: string;

  constructor() {
    this["name"] = "John";
  }
}

const obj = new MyClass();
obj["age"] = "30"; // 可以动态添加新的属性
console.log(obj.name); // 输出: John
console.log(obj.age); // 输出: 30

在这个例子中,MyClass 类允许通过字符串键访问和修改属性。

6. 限制索引签名值的类型

你可以使用联合类型来限制索引签名的值类型。例如:

interface EventDetails {
  [key: string]: "start" | "end"; // 值只能是 "start" 或 "end"
}

const event: EventDetails = {
  event1: "start",
  event2: "end"
};

console.log(event["event1"]); // 输出: start

在这个例子中,EventDetails 类型的所有值只能是 "start""end"

7. 结合其他类型使用索引签名

索引签名也可以与其他类型结合使用,提供更加灵活的类型设计。例如,在组合不同接口时,你可能会同时使用索引签名和其他属性。

interface Car {
  make: string;
  model: string;
  [key: string]: string | number; // 支持字符串或数字类型的任意额外属性
}

const car: Car = {
  make: "Toyota",
  model: "Corolla",
  year: 2020, // 额外的属性
  color: "Red"
};

console.log(car);

在这个例子中,Car 类型具有 makemodel 两个具体属性,并且可以通过索引签名动态添加其他的字符串或数字类型的属性。

8. 动态属性和字面量类型

通过使用索引签名,你可以让对象的键动态地决定类型,并在开发中提高灵活性。

type DynamicProperties = {
  [key: string]: string;
};

const dynamicObject: DynamicProperties = {
  name: "Alice",
  age: "25",
  occupation: "Engineer"
};

console.log(dynamicObject);

9. 类型推导与索引签名

TypeScript 会根据你为索引签名指定的类型自动推导出对象的属性类型。例如:

interface DynamicObject {
  [key: string]: string | number;
}

const obj: DynamicObject = {
  name: "Alice",
  age: 30
};

console.log(obj["name"]); // 输出: Alice
console.log(obj["age"]); // 输出: 30

10. 使用索引签名进行合并

索引签名也可以与其他对象类型合并,通过 & 进行交叉组合。比如:

interface Name {
  name: string;
}

interface Address {
  address: string;
}

type Person = Name &
  Address & {
    [key: string]: string; // 任意的额外属性
  };

const person: Person = {
  name: "John",
  address: "123 Main St",
  phone: "123-456-7890"
};

console.log(person);

11. 小结

  • 索引签名(Index Signatures) 用于定义允许具有动态属性名的对象。
  • 使用 key: stringkey: number 作为键类型来表示对象的属性键。
  • 可以结合其他类型使用索引签名,灵活地定义对象结构。
  • 通过 readonly 限制对象的键为只读。
  • 索引签名与类:类的实例也可以使用索引签名来动态访问和修改属性。
  • 索引签名与联合类型:可以为索引签名指定值的类型限制。

到此这篇关于TypeScript中索引签名的实现示例的文章就介绍到这了,更多相关TypeScript 索引签名内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • JS利用循环解决的一些常见问题总结

    JS利用循环解决的一些常见问题总结

    循环输出问题是面试中经典的题目,一般会给出代码,让我们解释原因,并给出若干解决方案,下面这篇文章主要给大家介绍了关于JS利用循环解决的一些常见问题,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-08-08
  • 微信小程序合法域名配置方法

    微信小程序合法域名配置方法

    这篇文章主要介绍了微信小程序合法域名配置,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-05-05
  • 学习javascript面向对象 javascript实现继承的方式

    学习javascript面向对象 javascript实现继承的方式

    这篇文章主要为大家介绍了javascript实现继承的方式,学习javascript面向对象,感兴趣的小伙伴们可以参考一下
    2016-01-01
  • EditPlus 正则表达式 实战(3)

    EditPlus 正则表达式 实战(3)

    这篇文章主要介绍了EditPlus 正则表达式 实战(3)的相关资料,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2016-12-12
  • JS组件Bootstrap按钮组与下拉按钮详解

    JS组件Bootstrap按钮组与下拉按钮详解

    这篇文章主要为大家介绍了JS组件Bootstrap按钮组与下拉按钮的相关资料,感兴趣的小伙伴们可以参考一下
    2016-05-05
  • echarts学习笔记之图表自适应问题详解

    echarts学习笔记之图表自适应问题详解

    最近发现一个问题,echarts图初始化后不能自适应浏览器的缩放,所以下面这篇文章就来给大家介绍了关于echarts图表自适应问题的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考借鉴,下面随着小编来一起学习学习吧。
    2017-11-11
  • 当达到输入长度时表单自动切换焦点

    当达到输入长度时表单自动切换焦点

    给每个字段限制输入长度,当达到输入长度时自动切换焦点,以增强表单的易用性,需要的朋友可以参考下
    2014-04-04
  • js轮播图代码分享

    js轮播图代码分享

    这篇文章主要为大家详细介绍了js轮播图代码,代码简洁,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-07-07
  • 微信小程序实现action-sheet弹出底部菜单功能【附源码下载】

    微信小程序实现action-sheet弹出底部菜单功能【附源码下载】

    这篇文章主要介绍了微信小程序实现action-sheet弹出底部菜单功能,结合实例形式分析了action-sheet组件弹出菜单的使用技巧,包括元素遍历、事件响应及属性设置等操作方法,并附带源码供读者下载参考,需要的朋友可以参考下
    2017-12-12
  • JavaScript深入理解系列之call与apply

    JavaScript深入理解系列之call与apply

    Function.prototype.call和Function.prototype.apply都是非常常用的方法,它们的作用一模一样,区别仅在于传入参数形式的不同,下面这篇文章主要介绍了JavaScript深入理解系列之call与apply的相关资料,需要的朋友可以参考下
    2022-04-04

最新评论