JavaScript 中 class 语法怎么做属性类型校验-js教程-PHP中文网

javascript class 本身不支持属性类型校验，需借助 typescript 编译时检查、运行时手动 setter 校验或 zod 等第三方库实现；jsdoc 仅提供弱提示，不可靠。

javascript 中 class 语法怎么做属性类型校验

JavaScript 的 class 语法本身不支持属性类型校验，它只是语法糖，运行时没有类型系统。要实现属性类型校验，需借助外部机制——常见方式是手动检查、使用 TypeScript 编译时校验，或在运行时用工具库/自定义逻辑拦截赋值。

用 TypeScript 实现编译期类型校验

TypeScript 是最主流、最可靠的方案。它在开发阶段就检查类型，编译后生成纯 JavaScript，不改变运行时行为。

示例：

class Person {
  name: string;
  age: number;
  isStudent?: boolean;
<p>constructor(name: string, age: number) {
this.name = name;
this.age = age;
}
}</p><p>const p = new Person("Alice", 25);
p.age = "30"; // ❌ TypeScript 报错：Type 'string' is not assignable to type 'number'</p>

关键点：

必须用 .ts 后缀文件，并配置 TypeScript 编译器（tsconfig.json）
类型声明只在开发/编译阶段起作用，不会生成运行时校验代码
可配合 strict 模式开启更严格的检查（如 strictPropertyInitialization 防止未初始化属性）

运行时手动校验（纯 JavaScript）

若只能用原生 JS，可在 setter 或构造函数中做判断，抛出错误或自动转换。

示例（使用 set 访问器）：

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

class Person {
  #_age;
<p>constructor(name, age) {
this.name = typeof name === 'string' ? name : '';
this.age = age; // 触发 setter
}</p><p>get age() {
return this.#_age;
}</p><p>set age(value) {
if (typeof value !== 'number' || isNaN(value) || value age must be a non-negative finite number, got ${value});
}
this.#_age = value;
}
}</p>

优点：真正运行时生效；缺点：需手动写、易遗漏、影响性能（尤其高频赋值）。

用第三方库辅助运行时校验

例如 io-ts、zod 或 class-validator，可结合 class 使用：

Zod 示例（推荐，轻量且直观）：

import { z } from 'zod';
<p>const PersonSchema = z.object({
name: z.string().min(1),
age: z.number().int().nonnegative()
});</p><p>class Person {
constructor(data) {
const result = PersonSchema.safeParse(data);
if (!result.success) {
throw new Error(<code>Invalid Person: ${result.error}</code>);
}
Object.assign(this, result.data);
}
}</p>

这种方式把校验逻辑和 class 分离，更清晰，也支持序列化/反序列化校验。