no-absolute-path

💼 This rule is enabled in the following configs: recommended, typescript. 🔧 This rule is automatically fixable by the --fix CLI option.

Rule DetailsCopy Anchor Link

A module specifier that is an absolute file-system path (/home/me/app/lib/util) only resolves on the machine it was written on. This rule reports one, in every spelling of the module system its option turns on, and the fix rewrites it relative to the file.

• esmodule (default on): import ... from, side-effect import, export ... from, export * from, and import().
• commonjs (default on): require('m') with one argument, and TS import x = require('m').
• amd (default off): the elements of the dependency array of define([...], factory) and require([...], callback). A named module id (define('id', [...], f)) is a name, not a path, and is not checked.

A static template literal (require(`/abs/x`)) is the same string as a quoted one. A specifier the file cannot know (a variable, a template with a substitution) is not checked. Relative and package specifiers are fine.

❌ IncorrectCopy Anchor Link

import util from '/srv/app/lib/util';
export * from '/srv/app/lib/util';
const util2 = require(`/srv/app/lib/util`);

✅ CorrectCopy Anchor Link

import util from './lib/util';
import lodash from 'lodash';
const load = (name: string) => import(name);

OptionsCopy Anchor Link

[
  {
    "type": "object",
    "properties": {
      "esmodule": {
        "type": "boolean",
        "default": true
      },
      "commonjs": {
        "type": "boolean",
        "default": true
      },
      "amd": {
        "type": "boolean",
        "default": false
      }
    },
    "additionalProperties": false
  }
]

• esmodule (default true): check ES module syntax.
• commonjs (default true): check require() and import x = require().
• amd (default false): check AMD dependency arrays.

When Not To Use ItCopy Anchor Link

When absolute specifiers are mapped by your bundler or resolver to something other than the file system (e.g. a / alias for the project root).

Use this rule

npm install -D oxlint-plugin-import-next

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

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