On let vs const
December 22, 2019
My previous post included this paragraph:
let
vsconst
vsvar
: Usually you wantlet
. If you want to forbid assignment to this variable, you can useconst
. (Some codebases and coworkers are pedantic and force you to useconst
when there is only one assignment.)
This turned out to be very controversial, sparking conversations on Twitter and Reddit. It seems that the majority view (or at least, the most vocally expressed view) is that one should use const
wherever possible, only falling back to let
where necessary, as can be enforced with the prefer-const
ESLint rule.
In this post, I will briefly summarize some of the arguments and counter-arguments I’ve encountered, as well as my personal conclusion on this topic.
Why prefer-const
- One Way to Do It: It is mental overhead to have to choose between
let
andconst
every time. A rule like “always useconst
where it works” lets you stop thinking about it and can be enforced by a linter. - Reassignments May Cause Bugs: In a longer function, it can be easy to miss when a variable is reassigned. This may cause bugs. Particularly in closures,
const
gives you confidence you’ll always “see” the same value. - Learning About Mutation: Folks new to JavaScript often get confused thinking
const
implies immutability. However, one could argue that it’s important to learn the difference between variable mutation and assignment anyway, and preferringconst
forces you to confront this distinction early on. - Meaningless Assignments: Sometimes, an assignment doesn’t make sense at all. For example, with React Hooks, the values you get from a Hook like
useState
are more like parameters. They flow in one direction. Seeing an error on their assignment helps you learn earlier about the React data flow. - Performance Benefits: There are occasional claims that JavaScript engines could make code using
const
run faster due to the knowledge the variable won’t be reassigned.
Why Not prefer-const
- Loss of Intent: If we force
const
everywhere it can work, we lose the ability to communicate whether it was important for something to not be reassigned. - Confusion with Immutability: In every discussion about why you should prefer
const
, someone always confuses with immutability. This is unsurprising, as both assignment and mutation use the same=
operator. In response, people are usually told that they should “just learn the language”. However, the counter-argument is that if a feature that prevents mostly beginner mistakes is confusing to beginners, it isn’t very helpful. And unfortunately, it doesn’t help prevent mutation mistakes which span across modules and affect everyone. - Pressure to Avoid Redeclaring: A
const
-first codebase creates a pressure to not uselet
for conditionally assigned variables. For example, you might writeconst a = cond ? b : c
instead of anif
condition, even if bothb
andc
branches are convoluted and giving them explicit names is awkward. - Reassignments May Not Cause Bugs: There are three common cases when reassignments cause bugs: when the scope is very large (such as module scope or huge functions), when the value is a parameter (so it’s unexpected that it would be equal to something other than what was passed), and when a variable is used in a nested function. However, in many codebases most variables won’t satisfy either of those cases, and parameters can’t be marked as constant at all.
- No Performance Benefits: It is my understanding that the engines are already aware of which variables are only assigned once — even if you use
var
orlet
. If we insist on speculating, we could just as well speculate that extra checks can create performance cost rather than reduce it. But really, engines are smart.
My Conclusion
I don’t care.
I would use whatever convention already exists in the codebase.
If you care, use a linter that automates checking and fixing this so that changing let
to const
doesn’t become a delay in code review.
Finally, remember that linters exist to serve you. If a linter rule annoys you and your team, delete it. It may not be worth it. Learn from your own mistakes.