Skip to content
← Back to rules

jsdoc/require-param-type Pedantic

🛠️ An auto-fix is available for this rule.

作用

要求每个 @param 标签都有类型值(用花括号括起来)。

为什么这不好?

参数的类型应该被文档化。

示例

此规则的错误代码示例:

javascript
/** @param foo */
function quux(foo) {}

此规则的正确代码示例:

javascript
/** @param {SomeType} foo */
function quux(foo) {}

配置

此规则接受一个配置对象,包含以下属性:

defaultDestructuredRootType

type: string

default: "object"

用于为解构根对象默认设置的类型字符串。默认为 "object"

setDefaultDestructuredRootType

type: boolean

default: false

是否设置默认的解构根类型。例如,你可能希望避免手动为对应于解构根对象的 @param 设置类型,因为它始终会是一个对象。使用 defaultDestructuredRootType 作为类型字符串。默认为 false

如何使用

To enable this rule using the config file or in the CLI, you can use:

json
{
  "plugins": ["jsdoc"],
  "rules": {
    "jsdoc/require-param-type": "error"
  }
}
ts
import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: ["jsdoc"],
  rules: {
    "jsdoc/require-param-type": "error",
  },
});
bash
oxlint --deny jsdoc/require-param-type --jsdoc-plugin

版本

此规则于 v0.4.4 中添加。

参考