如何在JSDoc中指定参数为特定类的成员函数？

要同时满足「参数是函数」和「必须来自Mutation类」这两个要求，有几种实用的JSDoc写法，可根据你的场景选择：

1. 直接限定为指定方法的类型（精准匹配） #

如果mutationAlgorithm只接受Mutation.insert这类特定静态方法，用typeof引用该方法的类型即可，既明确是函数，又限定了来源：

/**
 * @param {typeof Mutation.insert} mutationAlgorithm - 来自Mutation类的突变算法函数，默认使用Mutation.insert
 */
constructor(mutationAlgorithm = Mutation.insert) {
    this.mutationAlgorithm = mutationAlgorithm;
}

这种写法会让编辑器识别出参数必须和Mutation.insert具有完全一致的函数签名，同时明确它来自Mutation类。

2. 定义统一类型别名（多方法复用） #

如果Mutation类有多个同签名的突变方法（比如insert、delete、replace），先定义通用类型别名，再用别名标注参数：

/**
 * @typedef {Function} MutationAlgorithm
 * @description Mutation类提供的突变算法函数，统一签名示例
 * @param {any} target - 要突变的目标对象
 * @param {any} options - 突变配置项
 * @returns {any} 突变后的结果
 */

/**
 * @param {MutationAlgorithm} mutationAlgorithm - 来自Mutation类的突变算法函数，默认使用Mutation.insert
 */
constructor(mutationAlgorithm = Mutation.insert) {
    this.mutationAlgorithm = mutationAlgorithm;
}

这种方式适合统一约束多个同类型方法的场景，可在类型别名描述里强调它来自Mutation类。

3. 联合类型限定允许的方法集合 #

如果只允许Mutation类中的某几个特定方法作为参数，用联合类型明确列出：

/**
 * @param {typeof Mutation.insert | typeof Mutation.delete} mutationAlgorithm - 来自Mutation类的指定突变算法函数，默认使用Mutation.insert
 */
constructor(mutationAlgorithm = Mutation.insert) {
    this.mutationAlgorithm = mutationAlgorithm;
}

这种写法会严格限制参数只能是列出的几个Mutation类静态方法，编辑器会给出精准的类型提示。

内容的提问来源于stack exchange，提问作者iso53