Symbol.hasInstance 是 JavaScript 内置的一个 Symbol 值，用于自定义 instanceof 运算符的行为。简而言之，执行 a instanceof b 时，引擎会调用 b[Symbol.hasInstance](a) 来判断实例关系。这一机制的最大优势在于，你可以完全掌控实例判定逻辑，而不再依赖默认的原型链查找过程。
必须定义在构造函数对象自身
这一点容易踩坑——Symbol.hasInstance 必须作为静态方法直接定义在构造函数（或 class）上，而不能挂载在原型链或实例上。只有构造函数自身拥有该方法时，instanceof 才会触发它。具体而言：
- ✅ 正确：直接挂载到类或函数对象本身
- ❌ 错误：挂在
MyClass.prototype或某个实例上 - ❌ 错误：用
Object.defineProperty但目标对象不是构造函数本身
方法签名与返回值
该方法接收一个参数——即 instanceof 左侧的操作数（待检测对象），并必须返回布尔值。返回 true 表示该对象是其实例，false 则相反。如果返回非布尔值（如 undefined、null 或数字），引擎会强制转换，但容易引发 bug，因此建议始终显式返回 true 或 false。
实际代码示例
首先展示函数构造器的写法：
function MyClass() {}
MyClass[Symbol.hasInstance] = function(obj) {
return obj != null && typeof obj === 'object' && 'customFlag' in obj;
};
console.log({ customFlag: true } instanceof MyClass); // true
console.log({}) instanceof MyClass; // false
采用 class 语法更为简洁，推荐使用：
class MyClass {}
MyClass[Symbol.hasInstance] = function(obj) {
return obj?.constructor === MyClass || obj instanceof MyClass;
// 注意：这里避免无限递归，不要直接用 `obj instanceof MyClass`
};
// 更灵活的自定义逻辑示例：
class FlexibleArray {}
FlexibleArray[Symbol.hasInstance] = function(obj) {
return Array.isArray(obj) || (obj && typeof obj === 'object' && 'length' in obj && typeof obj.length === 'number');
};
console.log([1,2] instanceof FlexibleArray); // true
console.log({length: 5} instanceof FlexibleArray); // true
注意事项与常见陷阱
- 默认的
instanceof行为基于原型链查找，但一旦构造函数定义了Symbol.hasInstance，引擎会完全跳过默认逻辑，仅执行自定义函数。因此，一旦定义，你就完全接管了实例判定。 - 避免在
[Symbol.hasInstance]内部再次使用instanceof检测同一个构造函数，否则容易导致无限递归（如前文示例注释所述）。 - 箭头函数无法正确绑定
this，因此可以使用箭头函数，但要确保内部不依赖this；如果需要访问类的静态属性，建议改用普通函数。 - 该方法默认不可枚举（
propertyIsEnumerable(Symbol.hasInstance) === false），因此不会出现在for...in等遍历中，无需额外处理。
