forbidden-code

The forbidden-code rule type enables you to disallow code and code patterns through string and regular expression matches.

• Disallowing comments
  • You want to disallow // TODO comments
  • You want to disallow usage of @ts-ignore
• Disallowing specific strings
  • You want to enforce a certain casing for one or more strings
  • You want to disallow specific strings from being used within code

If you want to disallow specific operations on a property, you should instead use the forbidden-properties rule type.

To create a custom forbidden-code rule, you'll need to configure the below required properties:

The example below configures a rule named NO_DISALLOWED_USAGE that disallows:

• Any usage of "and" at the start of a line (case-sensitive).
• Any usage of "but" in any case.
• Any usage of "TODO" (case-sensitive).

{
  "customRules": [
    {
      "ruleType": "forbidden-imports",
      "ruleName": "NO_DISALLOWED_USAGE",
      "categories": ["code-health"],
      "errorMessage": "References to \"and\" at the start of a line are not allowed.",
      "description": "Disallows using \"and\" at the start of a line.",
      "severity": "major",
      "patterns": ["^and", { "pattern": "but", "flags": "i" }],
      "strings": ["TODO"],
    },
  ],
}

This custom rule type always sets the "g" (or global) flag for regular expressions. This ensures that all regular expression matches are reported, opposed to only reporting on the first match.

When providing flags through an object in patterns, you can omit the "g" as this will automatically be set.

To learn more about regular expression flags, see the MDN guide on advanced searching with flags.

If you're not familiar with regular expressions, you can use tools like regex101 and/or RegExr to help you understand and write regular expressions.

Regular expressions can vary in complexity, depending on what you're trying to achieve. We've added some examples below to help you get started.

To enable this rule type, you can set the rule to true, or provide the following configuration.

The example below enables the NO_DISALLOWED_USAGE custom rule for all files in the src/ directory, excluding files in src/legacy/. In this example, the custom rule is also restricted to the dashboard and marketing-site workspaces, which is optional.

{
  "overrides": [
    {
      "restrictTo": {
        "workspaces": ["dashboard", "marketing-site"],
      },
      "rules": {
        "CUSTOM.NO_DISALLOWED_USAGE": {
          "paths": ["src", "!src/legacy"],
        },
      },
    },
  ],
  "customRules": [
    // ...
  ],
}

This next example enables the NO_DISALLOWED_USAGE custom rule for all files, and without workspace restrictions.

{
  "overrides": [
    {
      "rules": {
        "CUSTOM.NO_DISALLOWED_USAGE": true,
      },
    },
  ],
  "customRules": [
    // ...
  ],
}

;