第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