no-unused-modules

💼 This rule is enabled in the following configs: recommended, typescript.

Rule DetailsCopy Anchor Link

This rule enforces a convention: every module exports something. It reports a module that has no export at all.

An export is any way the module hands a value out: ESM export (named, default, export * from, a type), TypeScript export =, and CommonJS writes to the real module.exports or exports: module.exports =, module['exports'] =, exports.a =, module.exports.a =, and Object.defineProperty(exports, …) / Object.assign(module.exports, …). A write to a local or parameter that is merely named exports exports nothing. export {} exports nothing but is how TypeScript marks a file as a module on purpose, so it is not reported.

allowImportOnly exempts a module that imports something (ESM import, require(), or import x = require()) and exports nothing, such as an entry point that wires other modules together.

❌ IncorrectCopy Anchor Link

console.log('nothing leaves this file');

function fill(exports: Record<string, unknown>) {
  exports.a = 1;
}

✅ CorrectCopy Anchor Link

export const a = 1;

module.exports.handler = () => {};
Object.defineProperty(exports, 'version', { value: '1.0.0' });

OptionsCopy Anchor Link

[
  {
    "type": "object",
    "properties": {
      "allowImportOnly": {
        "type": "boolean",
        "default": false,
        "description": "Allow modules that only contain imports."
      }
    },
    "additionalProperties": false
  }
]

ImplementationCopy Anchor Link

• Source Code
• Test Cases

OWASP FoundationCopy Anchor Link

• Category: A00:2021 - General Security

Use this rule

npm install -D oxlint-plugin-import-next

{  "jsPlugins": ["oxlint-plugin-import-next"],  "rules": {    "import-next/no-unused-modules": "error"  }}

import { defineConfig } from 'vite-plus';export default defineConfig({  lint: {    jsPlugins: ['oxlint-plugin-import-next'],    rules: {      'import-next/no-unused-modules': 'error',    },  },});