fix(language-service): prune duplicate returned definitions (#34995)

Sometimes, a request for definitions will return multiple of the same
definition. This can happen in at least the cases of

- two-way bindings (one of the same definition for the property and
  event binding)
- multiple template binding expressions in the same attribute
  - something like "*ngFor="let i of items; trackBy: test" has two
    template bindings, resulting in two template binding ASTs at the
    same location (the attribute span). The language service then parses
    both of these bindings individually, resulting in two independent
    but identical definitions. For more context, see https://github.com/angular/angular/pull/34847#discussion_r371006680.

This commit prunes duplicate definitions by signing definitions with
their location, and checking if that location signature has been seen in
a previous definition returned to the client.

PR Close #34995
This commit is contained in:
ayazhafiz 2020-01-27 08:13:37 -08:00 committed by Andrew Kushnir
parent 3822455928
commit b64ead5cb8
2 changed files with 28 additions and 18 deletions

View File

@ -39,6 +39,7 @@ export function getDefinitionAndBoundSpan(
return; return;
} }
const seen = new Set<string>();
const definitions: ts.DefinitionInfo[] = []; const definitions: ts.DefinitionInfo[] = [];
for (const symbolInfo of symbols) { for (const symbolInfo of symbols) {
const {symbol} = symbolInfo; const {symbol} = symbolInfo;
@ -53,16 +54,28 @@ export function getDefinitionAndBoundSpan(
const containerKind = const containerKind =
container ? container.kind as ts.ScriptElementKind : ts.ScriptElementKind.unknown; container ? container.kind as ts.ScriptElementKind : ts.ScriptElementKind.unknown;
const containerName = container ? container.name : ''; const containerName = container ? container.name : '';
definitions.push(...locations.map((location) => {
return { for (const {fileName, span} of locations) {
const textSpan = ngSpanToTsTextSpan(span);
// In cases like two-way bindings, a request for the definitions of an expression may return
// two of the same definition:
// [(ngModel)]="prop"
// ^^^^ -- one definition for the property binding, one for the event binding
// To prune duplicate definitions, tag definitions with unique location signatures and ignore
// definitions whose locations have already been seen.
const signature = `${textSpan.start}:${textSpan.length}@${fileName}`;
if (seen.has(signature)) continue;
definitions.push({
kind: kind as ts.ScriptElementKind, kind: kind as ts.ScriptElementKind,
name, name,
containerKind, containerKind,
containerName, containerName,
textSpan: ngSpanToTsTextSpan(location.span), textSpan: ngSpanToTsTextSpan(span),
fileName: location.fileName, fileName: fileName,
}; });
})); seen.add(signature);
}
} }
return { return {

View File

@ -60,11 +60,9 @@ describe('definitions', () => {
expect(textSpan).toEqual(marker); expect(textSpan).toEqual(marker);
expect(definitions).toBeDefined(); expect(definitions).toBeDefined();
// There are exactly two, indentical definitions here, corresponding to the "name" on the expect(definitions !.length).toBe(1);
// property and event bindings of the two-way binding. The two-way binding is effectively const def = definitions ![0];
// syntactic sugar for `[ngModel]="name" (ngModel)="name=$event"`.
expect(definitions !.length).toBe(2);
for (const def of definitions !) {
expect(def.fileName).toBe(PARSING_CASES); expect(def.fileName).toBe(PARSING_CASES);
expect(def.name).toBe('title'); expect(def.name).toBe('title');
expect(def.kind).toBe('property'); expect(def.kind).toBe('property');
@ -72,7 +70,6 @@ describe('definitions', () => {
const fileContent = mockHost.readFile(def.fileName); const fileContent = mockHost.readFile(def.fileName);
expect(fileContent !.substring(def.textSpan.start, def.textSpan.start + def.textSpan.length)) expect(fileContent !.substring(def.textSpan.start, def.textSpan.start + def.textSpan.length))
.toEqual(`title = 'Some title';`); .toEqual(`title = 'Some title';`);
}
}); });
it('should be able to find a method from a call', () => { it('should be able to find a method from a call', () => {