Symbol.hasInstance 是一个内置 symbol，用于自定义 instanceof 的判断逻辑：当执行 a instanceof B 时，引擎调用 B[Symbol.hasInstance](a)，返回布尔值决定结果；它仅影响 instanceof 行为，不改变构造、原型链或其他检测方式。
JavaScript 中可以通过在类的静态方法上定义 Symbol.hasInstance 来自定义 instanceof 的判断逻辑，它会覆盖默认的原型链检查行为。
Symbol.hasInstance 是什么
Symbol.hasInstance 是一个内置 symbol，用于确定一个构造器是否认为某个对象是其实例。当使用 a instanceof B 时，JavaScript 引擎会调用 B[Symbol.hasInstance](a)（如果存在），而不是直接查原型链。
它的签名是：static [Symbol.hasInstance](value: any): boolean
在 class 中定义 Symbol.hasInstance
只需在 class 内部添加一个静态 getter 或静态方法，返回布尔值即可：
- 必须是静态的（
static） - 键名必须是
Symbol.hasInstance（不能写成字符串） - 参数是被检测的对象（
value），返回true表示“是实例”
示例：
class Animal {
constructor(name) {
this.name = name;
}
static [Symbol.hasInstance](obj) {
return obj != null &&
typeof obj === 'object' &&
'name' in obj &&
typeof obj.name === 'string';
}
}
console.log({ name: 'dog' } instanceof Animal); // true
console.log({ age: 5 } instanceof Animal); // false
console.log(new Animal('cat') instanceof Animal); // true（仍走原逻辑，但也可覆盖）
注意：它不改变 new 或原型链本身
Symbol.hasInstance 只影响 instanceof 运算符的行为，不影响：
- 构造函数调用（
new Animal()） - 原型继承（
Animal.prototype是否被继承） - 其他检测方式，如
obj.constructor === Animal或Object.getPrototypeOf(obj) === Animal.prototype
也就是说，它只是“说谎”的接口——你可以让任意对象通过 instanceof 检查，哪怕它根本没调用过这个类的构造函数。
实用场景举例
常见用途包括：
-
鸭子类型校验：只要对象有某些属性/方法，就当作某类实例（如把 plain object 当作
ArrayLike） -
跨 Realm 兼容：不同 iframe 或上下文中的 Array 构造器不同，可用
Symbol.hasInstance统一识别数组特征 -
Mock 或 Proxy 类型伪装：测试中让 mock 对象通过
instanceof Promise等检查
例如模拟数组行为：
class ArrayLike {
static [Symbol.hasInstance](obj) {
return obj != null &&
typeof obj.length === 'number' &&
Number.isInteger(obj.length) &&
obj.length >= 0 &&
// 支持索引访问（可选增强）
(obj.length === 0 || obj[0] !== undefined || obj.hasOwnProperty(0));
}
}
console.log([1,2,3] instanceof ArrayLike); // true
console.log({ length: 2, 0: 'a', 1: 'b' } instanceof ArrayLike); // true
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
