no-unused-imports

Reports import specifiers that are never used.

Rule details Problem

This rule checks default imports, namespace imports, and named imports. When a binding is never referenced, it reports it and can remove the unused specifier with --fix.

By default, references inside JSDoc also count as usage. Bare side-effect imports like import "./init"; are ignored.

JSDoc references count by default

Tags like @see, @link, @type, @param, and @returns can keep an import alive when checkJSDoc is true.

Options

Option	Type	Default	What it does
checkJSDoc	boolean	true	Counts supported JSDoc references as usage

Configuration

eslint.config.js

import ceaseNonsense from "eslint-plugin-cease-nonsense";

export default [
  {
    plugins: {
      "cease-nonsense": ceaseNonsense,
    },
    rules: {
      "cease-nonsense/no-unused-imports": ["error", { checkJSDoc: true }],
    },
  },
];

Examples

Incorrect

import { unusedFunction, usedFunction } from "./utils";
import { AnotherUnused } from "./types";

usedFunction();

Correct

import { usedFunction } from "./utils";
import { anotherUsedFunction } from "./more-utils";

/**
 * @see {anotherUsedFunction}
 */
usedFunction();

Related rules

no-commented-code Removes dead code left in comments

ESLint: no-unused-vars Base rule for unused variables