TypeScript: Uninitialized variables work around strictNullChecks (follow-up to #13884)
This is a follow-up to #13884, where @RyanCavanaugh asked me to open a new issue.
tl;dr: Now that there is strictPropertyInitialization
, it seems that there should also be an analogous strictLocalInitialization
.
TypeScript Version: 2.8
Search Terms: uninitialized local variables, strict local variables, strictLocalInitialization, strictPropertyInitialization, strictNullChecks
Code
let x: number[]; // No definite assignment assertion.
// x.toString(); // Compile-time error. Yay!
function foo() {
x.toString(); // No compile-time error, but throws an exception. :(
}
foo();
Slightly more interesting:
function fooFactory() {
let x: number; // Inaccessible from anywhere but `foo()` below.
return {
foo() {
// Guaranteed to throw an exception since `x` can't change.
return x.toString();
}
};
}
Expected behavior:
If an imaginary --strictLocalInitialization
flag is enabled, these snippets should each result in a compile-time error.
To resolve such an error, one would need to:
A) Initialize the variable in a way that the TypeScript compiler understands (e.g. immediately, or before referencing it in a closure).
-OR-
B) Use a definite assignment assertion. It seems that this issue would come up naturally when discussing definite assignment assertions for local variables. Instead, the example provided in the blog feels contrived and wouldn’t be a problem if it weren’t for control flow analysis limitations.
-OR-
C) Explicitly mark the variable as potentially undefined
, forcing callers to acknowledge that it may not be set.
Actual behavior:
No compile-time errors, but obvious run-time errors.
Playground Link:
Link (enable strictNullChecks
)
Related Issues:
Understandably, this may not be as simple as strictPropertyInitialization
, but I feel it needs a discussion none the less. The fooFactory()
example above is analogous to this Foo
class, which correctly emits a compile-time error under strictPropertyInitialization
:
class Foo {
private x: number; // Compile-time error!
foo() {
// `x` isn't initialized! But it's OK, compile-time error above.
return this.x.toString();
}
}
About this issue
- Original URL
- State: open
- Created 6 years ago
- Reactions: 24
- Comments: 21 (7 by maintainers)
Accepting PRs. The rule here is that any variable that is read but never written to is an error if the variable doesn’t have
undefined
in its type.Implementation note - this needs to be done not as a separate pass. Re-use the existing logic that finds unused locals and refactor it to provide read/write information instead of just read.
No new flag since this should only ever catch true errors – this will be the default behavior for all
strictNullChecks
compilations.I would actually rather have the simpler
--strictLocalInitialization
option that flags any uninitialized declaration which does not have undefined as an allowable type, than a control-flow based feature that allows a subset of such constructs where assignment before use can be proven. And even more so if the control-flow based feature is going to permit some constructs where there is an assignment but it can’t be proven to occur before use – I think the majority of bugs people hope to catch with strictness like this would fall in this category.It seems a bit weird to ask users to use separate program (tslint) to avoid shortcoming in compiler. I believe there should be an option which forces
let
to be initialized to a proper type in typescript compiler.So instead of
let x: Foo;
you would have to writelet x: Foo | undefined;
orlet x: Foo = undefined as Foo;
I’m not following why this continuously was shot down. It seems clear that this should be handled by a compiler, not by a lint rule. The language sets uninitialized
let
s toundefined
yet the compiler does not recognize it as such. Why?@agopshi sure in my example, I don’t really care about the error; it was a trivial example.
It’s just that previous attempts have been shot down because the generic problem is undecidable, and I recognize that fact. It’d be nice to have a surefire way to express that
let foo: Foo;
is indeed a lie. At the moment that statement compiles just fine, I’ve declared thatfoo
is of typeFoo
yet it isundefined
. I’d like a mode that prevents this contradiction from happening ever rather than silently allowing in the cases where flow analysis fails.While I appreciate the MS Paint work, I find it tough to have followed 3 different conversation on this topic and even just within this thread seen it flip to suggesting this is better as a lint rule. If there is not fundamental agreement that an uninitialized
let
isundefined
per the language, any work to enforce that via the compiler would be wasted. The path forward needs to be clear for this to be worked on no?@RyanCavanaugh the TSLint rule is actually the opposite 😃 it seems I will lose this debate yet again and perhaps I’d be better off adding a PR for a rule option to tslint instead, but I still hold that this seems like a fundamental responsibility of a type system.
If I understood his suggestion and call for PRs correctly, the following code would compile fine
But with
strictLocalInitialization
, it should fail on line 1 withType 'undefined' is not assignable to type 'Foo'
. It’s a much stricter and simpler assertion. Never allow a typedef oflet myVar: T
if the variable is not immediately initialized@RyanCavanaugh Right - in your example, since it cannot be proven that
assign()
is called beforeuse()
, I would expectx
to be widened tonumber|undefined
inuse()
. (Or the declaration itself would have to be rewritten asnumber|undefined
or with the definite assignment assertion).Totally understood that this is impossible with the current control flow analysis architecture. Just discussing ideals. In the meantime, what you proposed would certainly be a welcome addition.
Really excited about the progress here and openness from the team about addressing this thank you! ❤️
As we’ve established, the usage before initialization is an undecidable problem and doing any sort of flow analysis will have its limits. Is there opposition from the typescript team to also adding the proposed
strictLocalInitialization
option as one step of type safety further? It’s a simple rule (No uninitialized declarations that do not haveundefined
as an allowable type) and is a surefire way to ensure these issues are handled.Inlining the effects and requirements of every function call is out of scope in terms of our current flow control analysis architecture.
Nothing we can do will get us 100%, e.g.
The addition of
strictPropertyInitialization
really makes this quite in line with the otherstrict*
flags and is sorely needed. There aren’t other well-established, automated ways of catching this; ironically, the only lint rule that TSLint offers is the exact opposite of what we want hereno-unnecessary-initializer
.