用途
该技能用于在 TypeScript 项目中启用并应用 noUncheckedIndexedAccess 编译选项,以捕获数组越界访问引发的潜在缺陷。它适用于审计 tsconfig.json 中缺失的安全标志、审查数据处理流程中按索引访问数组的代码,以及排查运行时因未定义值导致的崩溃。
主要能力
- 检查项目 tsconfig.json 是否已启用 noUncheckedIndexedAccess。
- 扫描代码中可能因数组长度不足而失败的索引访问(如 arr[0]、arr[i])。
- 在启用该标志后,更新被 TypeScript 标记的索引访问,加入显式的 undefined 检查或使用可选链。
- 解释 noUncheckedIndexedAccess 的作用、TypeScript 默认行为在数组索引访问上的不健全性,以及可选链和 Array.at() 与该标志的交互方式。
- 在代码审查中,标记所有未先进行 undefined 检查就使用索引访问值的位置,即使项目尚未启用该标志。
使用方式
该技能提供四种模式:
- Check:检查 tsconfig.json 是否启用 noUncheckedIndexedAccess;若未启用,则扫描可能失败的数组索引访问。
- Fix:在 tsconfig.json 中启用 noUncheckedIndexedAccess,然后更新 TypeScript 标记的索引访问,加入显式 undefined 检查或使用可选链。
- Explain:解释该标志的作用、默认行为的不健全性,以及可选链和 Array.at() 的交互。
- Code Review:审查文件中所有数组索引访问(arr[0]、arr[i]、object[key]),标记未先进行 undefined 检查就使用的位置。
完整实现细节、代码示例和框架特定指南见 references/rule.md。规则页面:https://frontendchecklist.io/rules/javascript/no-unchecked-indexed-access
适用场景
- 审计 TypeScript 项目配置,确保启用 noUncheckedIndexedAccess。
- 审查数据处理管道中按索引访问数组的代码。
- 调查因数组越界或空数组导致的运行时崩溃。
- 在代码审查中主动发现未检查的索引访问。
限制
该技能的具体实现细节、代码示例和框架特定指南需参考 references/rule.md,当前资料未提供这些内容。其他未提及的功能、收费、价格、平台或效果暂未提供。