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/TS轻松搞定Excel与XML互转

    深入浅出使用JS/TS轻松搞定Excel与XML互转

    在一些场景下,程序化的Excel与XML转换能力就显得尤为重要,这篇文章主要为大家详细介绍了如何使用JS/TS轻松搞定Excel与XML互转,感兴趣的小伙伴可以了解下
    2025-07-07
  • 详解js的六大数据类型

    详解js的六大数据类型

    js中有六种数据类型,包括五种基本数据类型(Number,String,Boolean,Null,Undefined),和一种混合数据类型(Object)。下面就跟着小编一起来看下吧
    2016-12-12
  • js实现从右往左匀速显示图片(无缝轮播)

    js实现从右往左匀速显示图片(无缝轮播)

    这篇文章主要为大家详细介绍了js实现从右往左匀速显示图片,无缝轮播,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-06-06
  • js中apply和Math.max()函数的问题及区别介绍

    js中apply和Math.max()函数的问题及区别介绍

    这篇文章主要介绍了js中apply和Math.max()函数的问题,本文给大家带来两种答案,每一种答案给大家介绍的非常详细,在文章底部给大家提到了js中Math.max.apply和Math.max的区别,感兴趣的朋友一起看看吧
    2018-03-03
  • 用原生JS对AJAX做简单封装的实例代码

    用原生JS对AJAX做简单封装的实例代码

    下面小编就为大家带来一篇用原生JS对AJAX做简单封装的实例代码。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-07-07
  • 浅析document.createDocumentFragment()与js效率

    浅析document.createDocumentFragment()与js效率

    对于循环批量操作页面的DOM有很大帮助!利用文档碎片处理,然后一次性append,并且使用原生的javascript语句操作
    2013-07-07
  • js实现简易计算器功能

    js实现简易计算器功能

    这篇文章主要为大家详细介绍了js实现简易计算器功能,制作能进行加减乘除的计算器,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-10-10
  • JS动态计算移动端rem的解决方案

    JS动态计算移动端rem的解决方案

    移动设备分辨率五花八门虽然我们可以通过CSS3的media query来实现适配,但是这种做法并不能适配所有设备,这篇文章主要介绍了js动态计算移动端rem的解决方案,非常不错,感兴趣的朋友一起看看吧
    2016-10-10
  • 详解用Webpack与Babel配置ES6开发环境

    详解用Webpack与Babel配置ES6开发环境

    这篇文章主要介绍了详解用Webpack与Babel配置ES6开发环境,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • 前端实现pdf文件预览的操作步骤方法

    前端实现pdf文件预览的操作步骤方法

    这篇文章主要介绍了前端实现pdf文件预览的操作步骤方法,前端实现PDF文件流预览可以使用多种方法,其中一种常用的方法是使用PDF.js库,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-07-07

最新评论