typescript/no-array-delete Correctness

✅ This rule is turned on by default.

🚧 An auto-fix is still under development.

What it does

This rule disallows using the delete operator on array values.

Why is this bad?

When using the delete operator on an array, the element is not actually removed, but instead the array slot is turned into undefined. This is usually not the intended behavior. Instead, you should use methods like Array.prototype.splice() to properly remove elements from an array.

Examples

Examples of incorrect code for this rule:

declare const arr: number[];
delete arr[0];

Examples of correct code for this rule:

declare const arr: number[];
arr.splice(0, 1);

// or with a filter
const filteredArr = arr.filter((_, index) => index !== 0);

// delete on object is allowed
declare const obj: { a?: number };
delete obj.a;

How to use

To enable this rule in the CLI or using the config file, you can use:

CLI

oxlint --deny typescript/no-array-delete

Config (.oxlintrc.json)

{
  "rules": {
    "typescript/no-array-delete": "error"
  }
}

References

• Rule Source