本文介绍在 TypeScript 中使用字符串索引签名（如 interface Students { [key: string]: Exam[] }）时，如何在运行时校验每个 Exam 对象的 testName 和 testScore 字段均被完整赋值，避免因缺失字段导致的运行时错误。

本文介绍在 typescript 中使用字符串索引签名（如 `interface students { [key: string]: exam[] }`）时，如何在运行时校验每个 `exam` 对象的 `testname` 和 `testscore` 字段均被完整赋值，避免因缺失字段导致的运行时错误。

TypeScript 的接口仅提供编译时类型检查，无法阻止运行时非法数据（如 testScore 缺失）被赋值给符合索引签名的对象。因此，需在运行时主动遍历所有学生及其考试记录，逐项验证字段完整性。

以下是一个健壮、可复用的校验函数：

interface Exam {
  testName: string;
  testScore: number;
}

export interface Students {
  [studentName: string]: Exam[];
}

function isValidStudents(data: unknown): data is Students {
  if (typeof data !== 'object' || data === null) return false;

  // 确保是普通对象（非数组、Date、RegExp 等）
  if (!data || Array.isArray(data) || data instanceof Date || data instanceof RegExp) {
    return false;
  }

  for (const [studentName, exams] of Object.entries(data)) {
    // 检查 studentName 对应值是否为 Exam[] 数组
    if (!Array.isArray(exams)) {
      console.warn(`Student "${studentName}" is not an array of exams`);
      return false;
    }

    for (let i = 0; i < exams.length; i++) {
      const exam = exams[i];
      if (
        typeof exam !== 'object' ||
        exam === null ||
        typeof exam.testName !== 'string' ||
        typeof exam.testScore !== 'number' ||
        isNaN(exam.testScore)
      ) {
        console.warn(
          `Invalid exam at student "${studentName}", index ${i}:`,
          exam
        );
        return false;
      }
    }
  }

  return true;
}

✅ 使用示例：

Galileo TypeScript sdk

完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。

下载

const studentsExample: unknown = {
  john: [
    { testName: "Biology", testScore: 92 },
    { testName: "Math", testScore: 76 },
  ],
  sarah: [
    { testName: "English", testScore: 87 },
    { testName: "Economics", testScore: 95 }
  ]
};

const studentsExample2: unknown = {
  john: [
    { testName: "Biology", testScore: 92 },
    { testName: "Math", testScore: 76 },
  ],
  sarah: [
    { testName: "English", testScore: 87 },
    { testName: "Economics" } // ❌ missing testScore
  ]
};

console.log(isValidStudents(studentsExample)); // true
console.log(isValidStudents(studentsExample2)); // false（并输出警告）

⚠️ 注意事项：

• 不要依赖 instanceof 或 constructor.name 判断对象类型，Object.entries() + 类型守卫更安全；
• testScore 需额外校验 isNaN()，防止传入 null、undefined 或字符串 "abc" 被 typeof 误判为 number；
• 若需深度不可变校验（如禁止 null/undefined 值），建议结合 Zod 或 io-ts 等运行时 Schema 库实现声明式验证；
• 开发阶段可配合 ESLint 规则（如 @typescript-eslint/no-explicit-any）和严格 tsconfig.json（"strict": true, "noImplicitAny": true, "strictNullChecks": true）从源头降低风险。

通过上述校验逻辑，你不仅能确保 Students 对象结构合规，还能准确定位问题字段位置，显著提升数据可靠性与调试效率。