JavaScript虽无原生interface,但可通过运行时检查函数、抽象基类抛错、JSDoc静态提示及单元测试四种方式模拟接口契约,兼顾灵活性与质量保障。

JavaScript 本身没有原生的 interface 关键字(像 TypeScript 或 Java 那样),但在纯 JS 中,我们可以通过约定、运行时检查或辅助函数来模拟接口行为,达到“声明契约、校验实现”的目的。
用函数模拟接口定义
可以写一个工具函数,在运行时检查某个对象是否具备指定的方法和属性:
- 定义“接口”为一个方法名数组,比如
['connect', 'disconnect', 'send'] - 创建
implementsInterface(obj, interfaceMethods)函数,遍历并检查obj是否有对应方法且为函数 - 在关键初始化或赋值处调用它,提前报错,避免后期调用时才出问题
用类和构造器约束实现
虽然不能强制继承,但可通过基类抛出未实现错误的方式引导开发者:
- 定义一个抽象基类,方法体里直接
throw new Error('must be implemented') - 子类继承后覆盖这些方法;若遗漏,运行时调用时立刻暴露问题
- 适合团队协作中统一行为规范,比完全无约束强得多
借助 JSDoc + 工具链(零运行时开销)
在注释中用 @interface 和 @implements 标记,配合 VS Code 或 ESLint 插件(如 eslint-plugin-jsdoc)做静态提示:
立即学习“Java免费学习笔记(深入)”;
- 不改变运行逻辑,但编辑器能高亮缺失方法、参数类型不符等问题
- 适合渐进式采用,尤其在迁移到 TypeScript 前的过渡阶段很实用
实际项目中更推荐:小而明确的契约 + 单元测试
比起花精力模拟接口语法,JS 社区更倾向用轻量方式保障一致性:
- 把“接口”写成文档片段(如 README 或内联注释),说明输入/输出/行为
- 为每个模块写单元测试,验证它是否满足该契约(例如调用
send()是否返回 Promise、是否触发回调等) - 测试即文档,也最贴近真实使用场景
基本上就这些。JS 的灵活让它不需要硬性接口语法,但通过约定+工具+测试,一样能守住代码质量底线。











