Lift Default into Parameter

Replace default value assignment expressions with default parameter values.

refactoring
ES2015 modernization
can impact code execution

Default parameters allow providing default values for function parameters. These default values are used if nothing or undefined is passed into the function. For example, function f(p = 42) { ... } sets p to 42 if no value is passed in.

Previous ways of setting default values, for example p = p || 42 can be converted to default parameters. This refactoring supports converting the following expressions and variants of them:

  • or assignment, e.g. p = p || 42 or p ||= 42
  • nullish coalescing operator, e.g. p = p ?? 42
  • ternary with falsy check on parameter, e.g. p = p ? p : 42
  • ternary with null check, e.g. p = p == null ? 42 : p or p = p != null ? p : 42
  • ternary with undefined check, e.g. p = p === undefined ? 42 : p
  • ternary with typeof check, e.g. p = typeof p === "undefined" ? 42 : p

Code Action Safety

Default values are only used in place of undefined. The code that is replaced by this refactoring may have provided defaults for falsy or null values as well. This may lead to undesired behavior, for example:

function example(x) {
    x = x == null ? "default" : x;
    console.log(x);
}

example(null); // prints "default"

becomes

function example(x = "default") {
    console.log(x);
}

example(null); // prints "null"