Skip to main content

tsdoc-require-2/require-class

Require the @class tag in TSDoc blocks for supported TypeScript declarations.

Rule details​

This rule reports declarations that already have TSDoc but do not contain @class.

It does not create a TSDoc block. Pair it with tsdoc-require-2/require when you also want to require comments.

Why use it​

@class can help teams and doc generators that expect explicit declaration-kind tags.

Options​

This rule accepts the same options as tsdoc-require-2/require:

  • enforceFor: limit which declaration kinds are checked.
  • exportMode: choose whether to check exported declarations, non-exported top-level declarations, or both.
  • includeNonExported: legacy alias for exportMode: "all".

Flat config example (class-only scope):

import tsdocRequire from "eslint-plugin-tsdoc-require-2";

export default [
 {
  plugins: {
   "tsdoc-require-2": tsdocRequire,
  },
  rules: {
   "tsdoc-require-2/require-class": ["error", { enforceFor: ["class"] }],
  },
 },
];

❌ Incorrect​

/**
 * Represents a cache entry.
 */
export class CacheEntry {
 public constructor(public readonly key: string) {}
}

✅ Correct​

/**
 * Represents a cache entry.
 *
 * @class
 */
export class CacheEntry {
 public constructor(public readonly key: string) {}
}

When not to use it​

Disable this rule if your documentation convention does not require @class on the declarations targeted by your configuration.

Further reading​