如何拦截 JavaScript Symbol.hasInstance

Symbol.hasInstance 是 JavaScript 内置的一个 Symbol 值，专门用来改写 instanceof 运算符的行为。简单说，当你写 a instanceof b 时，引擎实际上会去调用 b[Symbol.hasInstance](a) 来判断。这个机制最大的好处就是：你可以完全接管“实例判定”的逻辑，而不必依赖默认的原型链查找。

必须定义在构造函数对象本身上

这一点很容易踩坑——Symbol.hasInstance 必须作为静态方法直接挂在构造函数（或 class）上，不能写在原型链上，也不能放在实例上。只有构造函数自身拥有这个 Symbol 方法，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，所以 MyClass[Symbol.hasInstance] = (obj) => { ... } 可以用，但要注意内部不依赖 this；如果确实需要访问类的静态属性，建议用普通函数。
• 这个方法默认是不可枚举的（propertyIsEnumerable(Symbol.hasInstance) === false），所以不会出现在 for...in 等遍历中，不用额外操心。