Skip to main content

no-duplicate-type-constituents

Disallow duplicate constituents of union or intersection types.

✅

Extending "plugin:@typescript-eslint/recommended-type-checked" in an ESLint configuration enables this rule.

🔧

Some problems reported by this rule are automatically fixable by the --fix ESLint command line option.

💭

This rule requires type information to run.

TypeScript supports types ("constituents") within union and intersection types being duplicates of each other. However, developers typically expect each constituent to be unique within its intersection or union. Duplicate values make the code overly verbose and generally reduce readability.

This rule disallows duplicate union or intersection constituents. We consider types to be duplicate if they evaluate to the same result in the type system. For example, given type A = string and type T = string | A, this rule would flag that A is the same type as string.

type T1 = 'A' | 'A';

type T2 = A | A | B;

type T3 = { a: string } & { a: string };

type T4 = [1, 2, 3] | [1, 2, 3];

type StringA = string;
type StringB = string;
type T5 = StringA | StringB;
Open in Playground
.eslintrc.cjs
module.exports = {
  "rules": {
    "@typescript-eslint/no-duplicate-type-constituents": "error"
  }
};

Try this rule in the playground ↗

Options​

This rule accepts the following options:

type Options = [
  {
    ignoreIntersections?: boolean;
    ignoreUnions?: boolean;
  },
];

const defaultOptions: Options = [
  { ignoreIntersections: false, ignoreUnions: false },
];

ignoreIntersections​

When set to true, duplicate checks on intersection type constituents are ignored.

ignoreUnions​

When set to true, duplicate checks on union type constituents are ignored.

When Not To Use It​

It can sometimes be useful for the sake of documentation to include aliases for the same type. You might consider using ESLint disable comments for those specific situations instead of completely disabling this rule.

In some of those cases, branded types might be a type-safe way to represent the underlying data types.

Type checked lint rules are more powerful than traditional lint rules, but also require configuring type checked linting. See Performance Troubleshooting if you experience performance degredations after enabling type checked rules.

Resources​