noRestrictedDependencies (JavaScript)

Summary

Rule available since: v2.5.0
Diagnostic Category: lint/nursery/noRestrictedDependencies
This rule doesn’t have a fix.
The default severity of this rule is information.
Sources:
- Same as e18e/ban-dependencies

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "nursery": {
5
        "noRestrictedDependencies": "error"
6
      }
7
    }
8
  }
9
}

Description

Disallow dependencies that are known to have better alternatives.

This rule checks static imports, dynamic import(), and require() calls and suggests modern, native, or more maintainable alternatives based on e18e’s replacement data.

Examples

Invalid

1
import glob from "globby";

code-block.js:1:18 lint/nursery/noRestrictedDependencies ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Use of the restricted dependency globby detected.
  
  > 1 │ import glob from "globby";
      │                  ^^^^^^^^
    2 │ 
  
  ℹ The dependency might be old, not actively maintained, or there's a native alternative.
  
  ℹ The following replacement is suggested:
    - Replace with the alternative: tinyglobby.
  
  ℹ Read more: https://e18e.dev/docs/replacements/globby
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

1
const glob = require("globby");

code-block.js:1:22 lint/nursery/noRestrictedDependencies ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Use of the restricted dependency globby detected.
  
  > 1 │ const glob = require("globby");
      │                      ^^^^^^^^
    2 │ 
  
  ℹ The dependency might be old, not actively maintained, or there's a native alternative.
  
  ℹ The following replacement is suggested:
    - Replace with the alternative: tinyglobby.
  
  ℹ Read more: https://e18e.dev/docs/replacements/globby
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

1
const glob = await import("globby");

code-block.js:1:27 lint/nursery/noRestrictedDependencies ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Use of the restricted dependency globby detected.
  
  > 1 │ const glob = await import("globby");
      │                           ^^^^^^^^
    2 │ 
  
  ℹ The dependency might be old, not actively maintained, or there's a native alternative.
  
  ℹ The following replacement is suggested:
    - Replace with the alternative: tinyglobby.
  
  ℹ Read more: https://e18e.dev/docs/replacements/globby
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

Valid

1
import glob from "tinyglobby";

1
const glob = require("tinyglobby");

1
const glob = await import("tinyglobby");

See the e18e docs for the full list of replacements.