close
Rslint

    no-missing-import

    Unreleased

    Configuration

    rslint.config.ts
    import { defineConfig } from '@rslint/core';

export default defineConfig([
  {
    plugins: ['node'],
    rules: {
      'node/no-missing-import': 'error',
    },
  },
]);

    Disallow imports and re-exports whose modules cannot be found.

    The rule checks static import, export ... from, and dynamic import() with literal arguments. It checks installed packages and their exports maps as well as local files. Declaring a dependency in package.json does not make an uninstalled package available.

    Examples

    Incorrect:

    import missing from './missing.js';
export { value } from 'missing-package';
const module = import('./missing.js');

    Correct, when existing.js and installed-package exist:

    import existing from './existing.js';
export { value } from 'installed-package';
import fs from 'node:fs';

    Relative directory imports such as import './directory' are reported even when the directory contains index.js or a package entry point. Import that file explicitly. Bare package imports can use package entry points.

    Runtime imports of Node builtins, data: URLs, and HTTP or HTTPS URLs are accepted. Expressions such as import(variable) and template literals are outside this rule's checks. The rule provides no fixes or suggestions.

    Options

    import { defineConfig } from '@rslint/core';

export default defineConfig([
  {
    plugins: ['node'],
    rules: {
      'node/no-missing-import': [
        'error',
        {
          allowModules: ['electron'],
          resolvePaths: [],
          ignoreTypeImport: false,
        },
      ],
    },
  },
]);
    • allowModules: package roots to accept without resolving them, including scoped packages and virtual: modules. Allowing a package also allows its internal paths, such as electron/main. The default is an empty list.
    • resolvePaths: additional base directories, searched before the importing file's directory. Relative entries use the working directory, or settings.cwd when configured. The default is an empty list.
    • tryExtensions: extensions to try for extensionless imports. The default is ['.js', '.json', '.node', '.mjs', '.cjs']. An empty list disables extension guessing; explicit filenames can still resolve.
    • resolverConfig.modules: a module directory string or array, such as 'node_modules' or ['custom_modules', 'node_modules']. The default is ['node_modules']. Relative names are searched up the directory tree; absolute directories are also accepted. An empty array disables package lookup without disabling relative file imports.
    • ignoreTypeImport: skips whole import type declarations when true. The default is false. Type re-exports and individual type specifiers in a value import are still checked, matching upstream.
    • typescriptExtensionMap: overrides TypeScript extension substitution. Accepts [sourceExtension, emittedExtension] pairs, or preserve, react, react-jsx, react-jsxdev, and react-native. An empty array disables substitution.
    • tsconfigPath: selects a TypeScript config for extension substitution. The nearest tsconfig.json supplies the default mapping and path aliases. Relative values use the working directory, independently of settings.cwd. An explicit extension map takes precedence over tsconfigPath.

    Except for ignoreTypeImport, these options can also be supplied through settings.node. Rule options take precedence over shared settings. Legacy settings.n is accepted with the same precedence as upstream. Explicit empty lists override shared lists.

    In TypeScript files, the default mapping substitutes .ts for .js, .mts for .mjs, .cts for .cjs, and .tsx for .jsx in preserve mode or .js in React modes. With allowImportingTsExtensions, the default extension list also includes .ts, .mts, and .cts, and emitted extensions are not substituted. Type-only imports also activate the types export condition.

    Differences from upstream

    Only resolverConfig.modules is supported. If you map virtual to ./local.js with resolverConfig.alias, rslint may report import 'virtual' as missing even when the target file exists. For local aliases in TypeScript files, use compilerOptions.paths instead.

    Some invalid package.json#imports mappings, such as "#entry": [null, "./entry.js"], produce different error messages. Both linters report an error; rslint reports that the import cannot be resolved.

    An unpaired Unicode surrogate in a module name, such as import('\uD800'), may appear as replacement characters in the reported name. File lookup still matches Node.js: import './\uD800.js' resolves an existing file named �.js.

    References