第96章 使用noUncheckedIndexedAccess
案例96:危险索引读取——noUncheckedIndexedAccess 下的安全防护
题目:启用 TS 的 noUncheckedIndexedAccess 后,数组索引可能返回 undefined。请设计一个班级成绩统计函数,要求安全处理可能缺失的成绩项,并统计有效人数与平均分。
设计思路
开启 noUncheckedIndexedAccess 后,arr[i] 的类型变为 T | undefined,直接算术运算会报错。本案例通过类型守卫 + 可选链 + 空值合并运算符,实现健壮的成绩统计,既体现类型收窄,又避免运行时崩溃。
// 启用 noUncheckedIndexedAccess 编译
interface ClassScore {
students: (number | undefined)[];
}
function analyzeScore(cls: ClassScore) {
let sum = 0;
let validCount = 0;
for (let i = 0; i < cls.students.length; i++) {
const score = cls.students[i]; // 类型为 number | undefined
if (score !== undefined) {
sum += score; // 类型收窄为 number
validCount++;
}
}
return {
totalStudents: cls.students.length,
validCount,
sum,
average: validCount > 0 ? sum / validCount : 0
};
}
// 测试
const classA: ClassScore = {
students: [88, undefined, 92, 75, undefined, 100]
};
const result = analyzeScore(classA);
console.log(`有效人数: ${result.validCount}`);
console.log(`平均分: ${result.average.toFixed(2)}`);
console.log(`总人数: ${result.totalStudents}`);
运行方法:tsc --noUncheckedIndexedAccess 96.ts && node 96.js。若已配置 tsconfig.json,直接添加 "noUncheckedIndexedAccess": true 即可。
注意:不要使用非空断言(!)强制解除 undefined,否则违背开启该选项的初衷。应显式处理 undefined 分支。
成功要点:利用 undefined 判断实现类型收窄,使 sum += score 通过编译且运行安全。最终输出有效人数 4,平均分 88.75。
运行结果示例
有效人数: 4
平均分: 88.75
总人数: 6