Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Control flow for constructor initialized properties #37920

Merged
merged 10 commits into from
Apr 28, 2020

Conversation

ahejlsberg
Copy link
Member

@ahejlsberg ahejlsberg commented Apr 12, 2020

With this PR we use control flow analysis of this.xxx assignments in constructors to determine the types of properties that have no type annotations or initializers.

  • In .ts files we perform control flow analysis for properties declared with no type annotation or initializer when in noImplicitAny mode.
  • In .js files we perform control flow analysis for properties declared with no JSDoc type annotation or initializer, and properties with no explicit declaration but at least one this.xxx assignment in the constructor.

In the following example, control flow analysis determines the type of x to be string | number based on the this.x assignments in the constructor:

// Compile with --noImplicitAny
class C {
    x;  // string | number
    constructor(b: boolean) {
        if (b) {
            this.x = 'hello';
        }
        else {
            this.x = 42;
        }
    }
}

In .js files we would previously determine the type of a property with no explicit declaration from local analysis of all this.xxx assignments seen in the constructor and methods of the class. This analysis is less precise than control flow analysis, but we still use it as a fallback. With the increased precision of control flow analysis we now correctly discover properties that are conditionally (as opposed to definitely) initialized in constructors. We're also able to handle assignments of values that depend on previous assignment to the same property, as well as other scenarios that previously were deemed circular.

The baseline changes are mostly because constructor declared properties are now considered to have type any when they are assignment targets in the constructor body. This an effect of how CFA auto-typing works.

Fixes #37900.

@weswigham
Copy link
Member

weswigham commented Apr 13, 2020

@ahejlsberg do we have a test for the declaration emit of a property like this? afaik none of the cases in tests/cases/conformance/jsdoc/declarations/jsDeclarationsClasses.ts are that complex.

@ahejlsberg
Copy link
Member Author

@weswigham Best I can tell there are several classes in that test that now have property types computed by CFA with no changes in baselines. I wouldn't expect any either since declaration emit just uses getTypeOfSymbol.

@ahejlsberg
Copy link
Member Author

@typescript-bot user test this

@typescript-bot
Copy link
Collaborator

typescript-bot commented Apr 14, 2020

Heya @ahejlsberg, I've started to run the parallelized community code test suite on this PR at df98d9c. You can monitor the build here.

@typescript-bot
Copy link
Collaborator

The user suite test run you requested has finished and failed. I've opened a PR with the baseline diff from master.

@ahejlsberg
Copy link
Member Author

ahejlsberg commented Apr 14, 2020

@sandersn I'm looking at the user test suite baseline changes, and so far things seem reasonable. The increased precision of CFA causes more errors in places as expected, for example when CFA discovers that a property is conditionally (instead of definitely) initialized in the constructor or that a property has an auto-type array type.

The chrome-devtools errors are insanely hard to verify because there's no indentation in the code, but best I can tell they're to be expected.

@sandersn
Copy link
Member

I ran a before/after perf comparison of 10 runs of chrome-devtools-frontend, since it's a nice big code base with lots of functions.

Here's the average of 10 runs:

Before, time: 15.94 s
After, time: 16.21 s
1.66% slower.

Before, memory: 751.06 MB
After, memory: 757.27 MB
0.82% more memory.

Not that much difference actually.

(@ahejlsberg only one file in chrome-devtools-frontend is indentation-free, and it's a checked-in dependency. I always just skip that one.)

@ahejlsberg
Copy link
Member Author

@typescript-bot user test this

@typescript-bot
Copy link
Collaborator

typescript-bot commented Apr 16, 2020

Heya @ahejlsberg, I've started to run the parallelized community code test suite on this PR at 728d9cb. You can monitor the build here.

@ahejlsberg
Copy link
Member Author

@sandersn Fixed some over eager widening in auto-typed assignments. User test baselines now look good. More errors because we figure out more types, but the errors are to be expected and some of them actually reveal questionable logic.

I tried to get some perf numbers by running tsc on chrome-devtools-frontend but there is so much variability in the numbers that I can't really see any appreciable difference.

@ahejlsberg ahejlsberg changed the title Control flow for constructor properties Apr 21, 2020
@ahejlsberg
Copy link
Member Author

@typescript-bot test this
@typescript-bot user test this
@typescript-bot run dt

@typescript-bot
Copy link
Collaborator

typescript-bot commented Apr 21, 2020

Heya @ahejlsberg, I've started to run the extended test suite on this PR at ab993c2. You can monitor the build here.

@typescript-bot
Copy link
Collaborator

typescript-bot commented Apr 21, 2020

Heya @ahejlsberg, I've started to run the parallelized Definitely Typed test suite on this PR at ab993c2. You can monitor the build here.

@typescript-bot
Copy link
Collaborator

typescript-bot commented Apr 21, 2020

Heya @ahejlsberg, I've started to run the parallelized community code test suite on this PR at ab993c2. You can monitor the build here.

@sandersn sandersn added this to Not started in PR Backlog Apr 21, 2020
@sandersn sandersn moved this from Not started to Needs review in PR Backlog Apr 21, 2020
// Return the inherited type of the given property or undefined if property doesn't exist in a base class.
function getTypeOfPropertyInBaseClass(property: Symbol) {
const classType = getDeclaringClass(property);
const baseClassType = classType && getBaseTypes(classType)[0];
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thinking of mixins, shouldn't we iterate through the base types list and get the property from the first base type which has it, rather than only checking the first base type?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, classes never have more than one base class, mixins or not.

PR Backlog automation moved this from Needs review to Needs merge Apr 28, 2020
@ahejlsberg ahejlsberg merged commit 3919042 into master Apr 28, 2020
PR Backlog automation moved this from Needs merge to Done Apr 28, 2020
@ahejlsberg ahejlsberg deleted the controlFlowConstructorProperties branch April 28, 2020 23:59
@ahejlsberg ahejlsberg added this to the TypeScript 4.0 milestone Apr 29, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
4 participants