JavaScript / TypeScript / 系统课时
声明数组与只读数组
声明数组与只读数组
本课解决 TypeScript 中“集合里能放什么、是否允许修改”两个问题。你将掌握普通数组、泛型数组和只读数组的声明方式,并能根据函数职责选择可变或只读参数。
学习目标
- 使用
T[]与Array<T>限制数组元素类型 - 使用
readonly T[]与ReadonlyArray<T>阻止修改集合 - 理解只读数组的赋值方向和浅只读边界
声明普通数组
数组类型写在元素类型之后。string[] 表示只能保存字符串,Array<string> 是等价的泛型写法。项目中通常优先使用简洁的 T[];遇到嵌套泛型或需要统一泛型风格时,可使用 Array<T>。
元素类型可以是联合类型,例如 (string | number)[] 允许字符串和数字共存。不要为了省事使用 any[],否则读写时都会失去类型检查。
声明只读数组
只读数组写作 readonly string[] 或 ReadonlyArray<string>。它允许读取、遍历、查找和创建新数组,但禁止 push、pop、索引赋值等原地修改。
当函数只负责读取集合时,应把参数声明为只读数组。这样既能接收普通数组,也能接收只读数组,并明确函数不会修改调用方数据。
完整示例
下面的示例同时演示普通数组、泛型数组、只读参数和通过复制生成新数组。保存为 array-demo.ts 后运行。
const names: string[] = ["Ada", "Linus"];
const scores: Array<number> = [95, 88, 100];
names.push("Grace");
scores[0] = 98;
function formatItems(items: readonly string[]): string {
// 只读取参数,不改变调用方的原数组
return items.join(", ");
}
const readonlyNames: ReadonlyArray<string> = names;
const extendedNames = [...readonlyNames, "Margaret"];
console.log(formatItems(readonlyNames));
console.log(scores.reduce((sum, value) => sum + value, 0));
console.log(extendedNames.length);运行命令:
npx tsx array-demo.ts预期输出:
Ada, Linus, Grace
286
4实际文件路径和工具版本可能不同,但三行结果应与示例一致。
赋值方向与浅只读
普通数组可以赋给只读数组,因为这是减少修改权限;只读数组不能直接赋给普通数组,因为后者可能通过引用修改内容。将 readonlyNames 赋给 string[] 会产生类型错误。
只读数组只保护容器本身。如果元素是对象,仍可能修改对象属性。需要连属性一起保护时,可把元素声明为 Readonly<User>,例如 readonly Readonly<User>[]。
常见错误
const 不等于只读数组。const names = ["Ada"] 只禁止变量重新指向另一个数组,仍允许执行 names.push("Grace")。真正限制集合修改行为的是 readonly T[] 或 ReadonlyArray<T>。
本课总结
T[]与Array<T>都能限制数组中的元素类型- 只读数组适合只读取、不修改集合的函数和共享数据
- 数组只读是浅层约束,元素对象是否可变取决于元素类型
下一课预告
下一课将使用元组描述长度和位置都有含义的数据,并处理可选元素、剩余元素和只读元组。