Disallow Reassignment of Function Parameters (no-param-reassign)

Assignment to variables declared as function parameters can be misleading and lead to confusing behavior, as modifying function parameters will also mutate the arguments object. Often, assignment to function parameters is unintended and indicative of a mistake or programmer error.

Rule Details

This rule aims to prevent unintended behavior caused by overwriting function parameters.

The following patterns are considered warnings:

function foo(bar) {
    bar = 13;
}

function foo(bar) {
    bar++;
}

The following patterns are not warnings:

function foo(a) {
    var b = a;
}

function foo(a) {
    a.prop = 'value';
}

When Not To Use It

If you want to allow assignment to function parameters, then you can safely disable this rule.

Further Reading

Version

This rule was introduced in ESLint 0.18.0.

Resources