https://github.com/angular/angular
Tip revision: 1a8aa9ddfa899ef95a8b3445b76d27406c7f26e7 authored by Andrew Kushnir on 23 August 2023, 17:39:47 UTC
release: cut the v17.0.0-next.1 release
release: cut the v17.0.0-next.1 release
Tip revision: 1a8aa9d
r3_template_transform_spec.ts
/**
* @license
* Copyright Google LLC All Rights Reserved.
*
* Use of this source code is governed by an MIT-style license that can be
* found in the LICENSE file at https://angular.io/license
*/
import {BindingType} from '../../src/expression_parser/ast';
import * as t from '../../src/render3/r3_ast';
import {unparse} from '../expression_parser/utils/unparser';
import {parseR3 as parse} from './view/util';
// Transform an IVY AST to a flat list of nodes to ease testing
class R3AstHumanizer implements t.Visitor<void> {
result: any[] = [];
visitElement(element: t.Element) {
this.result.push(['Element', element.name]);
this.visitAll([
element.attributes,
element.inputs,
element.outputs,
element.references,
element.children,
]);
}
visitTemplate(template: t.Template) {
this.result.push(['Template']);
this.visitAll([
template.attributes,
template.inputs,
template.outputs,
template.templateAttrs,
template.references,
template.variables,
template.children,
]);
}
visitContent(content: t.Content) {
this.result.push(['Content', content.selector]);
t.visitAll(this, content.attributes);
}
visitVariable(variable: t.Variable) {
this.result.push(['Variable', variable.name, variable.value]);
}
visitReference(reference: t.Reference) {
this.result.push(['Reference', reference.name, reference.value]);
}
visitTextAttribute(attribute: t.TextAttribute) {
this.result.push(['TextAttribute', attribute.name, attribute.value]);
}
visitBoundAttribute(attribute: t.BoundAttribute) {
this.result.push([
'BoundAttribute',
attribute.type,
attribute.name,
unparse(attribute.value),
]);
}
visitBoundEvent(event: t.BoundEvent) {
this.result.push([
'BoundEvent',
event.name,
event.target,
unparse(event.handler),
]);
}
visitText(text: t.Text) {
this.result.push(['Text', text.value]);
}
visitBoundText(text: t.BoundText) {
this.result.push(['BoundText', unparse(text.value)]);
}
visitIcu(icu: t.Icu) {
return null;
}
visitDeferredBlock(deferred: t.DeferredBlock): void {
this.result.push(['DeferredBlock']);
deferred.visitAll(this);
}
visitSwitchBlock(block: t.SwitchBlock): void {
this.result.push(['SwitchBlock', unparse(block.expression)]);
this.visitAll([block.cases]);
}
visitSwitchBlockCase(block: t.SwitchBlockCase): void {
this.result.push(
['SwitchBlockCase', block.expression === null ? null : unparse(block.expression)]);
this.visitAll([block.children]);
}
visitForLoopBlock(block: t.ForLoopBlock): void {
const result: any[] = ['ForLoopBlock', unparse(block.expression), unparse(block.trackBy)];
block.contextVariables !== null && result.push(block.contextVariables);
this.result.push(result);
this.visitAll([block.children]);
block.empty?.visit(this);
}
visitForLoopBlockEmpty(block: t.ForLoopBlockEmpty): void {
this.result.push(['ForLoopBlockEmpty']);
this.visitAll([block.children]);
}
visitIfBlock(block: t.IfBlock): void {
this.result.push(['IfBlock']);
this.visitAll([block.branches]);
}
visitIfBlockBranch(block: t.IfBlockBranch): void {
const result = ['IfBlockBranch', block.expression === null ? null : unparse(block.expression)];
block.expressionAlias !== null && result.push(block.expressionAlias);
this.result.push(result);
this.visitAll([block.children]);
}
visitDeferredTrigger(trigger: t.DeferredTrigger): void {
if (trigger instanceof t.BoundDeferredTrigger) {
this.result.push(['BoundDeferredTrigger', unparse(trigger.value)]);
} else if (trigger instanceof t.ImmediateDeferredTrigger) {
this.result.push(['ImmediateDeferredTrigger']);
} else if (trigger instanceof t.HoverDeferredTrigger) {
this.result.push(['HoverDeferredTrigger']);
} else if (trigger instanceof t.IdleDeferredTrigger) {
this.result.push(['IdleDeferredTrigger']);
} else if (trigger instanceof t.TimerDeferredTrigger) {
this.result.push(['TimerDeferredTrigger', trigger.delay]);
} else if (trigger instanceof t.InteractionDeferredTrigger) {
this.result.push(['InteractionDeferredTrigger', trigger.reference]);
} else if (trigger instanceof t.ViewportDeferredTrigger) {
this.result.push(['ViewportDeferredTrigger', trigger.reference]);
} else {
throw new Error('Unknown trigger');
}
}
visitDeferredBlockPlaceholder(block: t.DeferredBlockPlaceholder): void {
const result = ['DeferredBlockPlaceholder'];
block.minimumTime !== null && result.push(`minimum ${block.minimumTime}ms`);
this.result.push(result);
this.visitAll([block.children]);
}
visitDeferredBlockLoading(block: t.DeferredBlockLoading): void {
const result = ['DeferredBlockLoading'];
block.afterTime !== null && result.push(`after ${block.afterTime}ms`);
block.minimumTime !== null && result.push(`minimum ${block.minimumTime}ms`);
this.result.push(result);
this.visitAll([block.children]);
}
visitDeferredBlockError(block: t.DeferredBlockError): void {
this.result.push(['DeferredBlockError']);
this.visitAll([block.children]);
}
private visitAll(nodes: t.Node[][]) {
nodes.forEach(node => t.visitAll(this, node));
}
}
function expectFromHtml(html: string, ignoreError = false, enabledBlockTypes?: string[]) {
const res = parse(html, {ignoreError, enabledBlockTypes});
return expectFromR3Nodes(res.nodes);
}
function expectFromR3Nodes(nodes: t.Node[]) {
const humanizer = new R3AstHumanizer();
t.visitAll(humanizer, nodes);
return expect(humanizer.result);
}
function expectSpanFromHtml(html: string) {
const {nodes} = parse(html);
return expect(nodes[0]!.sourceSpan.toString());
}
describe('R3 template transform', () => {
describe('ParseSpan on nodes toString', () => {
it('should create valid text span on Element with adjacent start and end tags', () => {
expectSpanFromHtml('<div></div>').toBe('<div></div>');
});
});
describe('Nodes without binding', () => {
it('should parse incomplete tags terminated by EOF', () => {
expectFromHtml('<a', true /* ignoreError */).toEqual([
['Element', 'a'],
]);
});
it('should parse incomplete tags terminated by another tag', () => {
expectFromHtml('<a <span></span>', true /* ignoreError */).toEqual([
['Element', 'a'],
['Element', 'span'],
]);
});
it('should parse text nodes', () => {
expectFromHtml('a').toEqual([
['Text', 'a'],
]);
});
it('should parse elements with attributes', () => {
expectFromHtml('<div a=b></div>').toEqual([
['Element', 'div'],
['TextAttribute', 'a', 'b'],
]);
});
it('should parse ngContent', () => {
const res = parse('<ng-content select="a"></ng-content>');
expectFromR3Nodes(res.nodes).toEqual([
['Content', 'a'],
['TextAttribute', 'select', 'a'],
]);
});
it('should parse ngContent when it contains WS only', () => {
expectFromHtml('<ng-content select="a"> \n </ng-content>').toEqual([
['Content', 'a'],
['TextAttribute', 'select', 'a'],
]);
});
it('should parse ngContent regardless the namespace', () => {
expectFromHtml('<svg><ng-content select="a"></ng-content></svg>').toEqual([
['Element', ':svg:svg'],
['Content', 'a'],
['TextAttribute', 'select', 'a'],
]);
});
});
describe('Bound text nodes', () => {
it('should parse bound text nodes', () => {
expectFromHtml('{{a}}').toEqual([
['BoundText', '{{ a }}'],
]);
});
});
describe('Bound attributes', () => {
it('should parse mixed case bound properties', () => {
expectFromHtml('<div [someProp]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'someProp', 'v'],
]);
});
it('should parse bound properties via bind- ', () => {
expectFromHtml('<div bind-prop="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'prop', 'v'],
]);
});
it('should report missing property names in bind- syntax', () => {
expect(() => parse('<div bind-></div>')).toThrowError(/Property name is missing in binding/);
});
it('should parse bound properties via {{...}}', () => {
expectFromHtml('<div prop="{{v}}"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'prop', '{{ v }}'],
]);
});
it('should parse dash case bound properties', () => {
expectFromHtml('<div [some-prop]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'some-prop', 'v'],
]);
});
it('should parse dotted name bound properties', () => {
expectFromHtml('<div [d.ot]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'd.ot', 'v'],
]);
});
it('should not normalize property names via the element schema', () => {
expectFromHtml('<div [mappedAttr]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'mappedAttr', 'v'],
]);
});
it('should parse mixed case bound attributes', () => {
expectFromHtml('<div [attr.someAttr]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Attribute, 'someAttr', 'v'],
]);
});
it('should parse and dash case bound classes', () => {
expectFromHtml('<div [class.some-class]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Class, 'some-class', 'v'],
]);
});
it('should parse mixed case bound classes', () => {
expectFromHtml('<div [class.someClass]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Class, 'someClass', 'v'],
]);
});
it('should parse mixed case bound styles', () => {
expectFromHtml('<div [style.someStyle]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Style, 'someStyle', 'v'],
]);
});
});
describe('templates', () => {
it('should support * directives', () => {
expectFromHtml('<div *ngIf></div>').toEqual([
['Template'],
['TextAttribute', 'ngIf', ''],
['Element', 'div'],
]);
});
it('should support <ng-template>', () => {
expectFromHtml('<ng-template></ng-template>').toEqual([
['Template'],
]);
});
it('should support <ng-template> regardless the namespace', () => {
expectFromHtml('<svg><ng-template></ng-template></svg>').toEqual([
['Element', ':svg:svg'],
['Template'],
]);
});
it('should support <ng-template> with structural directive', () => {
expectFromHtml('<ng-template *ngIf="true"></ng-template>').toEqual([
['Template'],
['BoundAttribute', 0, 'ngIf', 'true'],
['Template'],
]);
const res = parse('<ng-template *ngIf="true"></ng-template>', {ignoreError: false});
expect((res.nodes[0] as t.Template).tagName).toEqual(null);
expect(((res.nodes[0] as t.Template).children[0] as t.Template).tagName)
.toEqual('ng-template');
});
it('should support reference via #...', () => {
expectFromHtml('<ng-template #a></ng-template>').toEqual([
['Template'],
['Reference', 'a', ''],
]);
});
it('should support reference via ref-...', () => {
expectFromHtml('<ng-template ref-a></ng-template>').toEqual([
['Template'],
['Reference', 'a', ''],
]);
});
it('should report an error if a reference is used multiple times on the same template', () => {
expect(() => parse('<ng-template #a #a></ng-template>'))
.toThrowError(/Reference "#a" is defined more than once/);
});
it('should parse variables via let-...', () => {
expectFromHtml('<ng-template let-a="b"></ng-template>').toEqual([
['Template'],
['Variable', 'a', 'b'],
]);
});
it('should parse attributes', () => {
expectFromHtml('<ng-template k1="v1" k2="v2"></ng-template>').toEqual([
['Template'],
['TextAttribute', 'k1', 'v1'],
['TextAttribute', 'k2', 'v2'],
]);
});
it('should parse bound attributes', () => {
expectFromHtml('<ng-template [k1]="v1" [k2]="v2"></ng-template>').toEqual([
['Template'],
['BoundAttribute', BindingType.Property, 'k1', 'v1'],
['BoundAttribute', BindingType.Property, 'k2', 'v2'],
]);
});
});
describe('inline templates', () => {
it('should support attribute and bound attributes', () => {
// Desugared form is
// <ng-template ngFor [ngForOf]="items" let-item>
// <div></div>
// </ng-template>
expectFromHtml('<div *ngFor="let item of items"></div>').toEqual([
['Template'],
['TextAttribute', 'ngFor', ''],
['BoundAttribute', BindingType.Property, 'ngForOf', 'items'],
['Variable', 'item', '$implicit'],
['Element', 'div'],
]);
// Note that this test exercises an *incorrect* usage of the ngFor
// directive. There is a missing 'let' in the beginning of the expression
// which causes the template to be desugared into
// <ng-template [ngFor]="item" [ngForOf]="items">
// <div></div>
// </ng-template>
expectFromHtml('<div *ngFor="item of items"></div>').toEqual([
['Template'],
['BoundAttribute', BindingType.Property, 'ngFor', 'item'],
['BoundAttribute', BindingType.Property, 'ngForOf', 'items'],
['Element', 'div'],
]);
});
it('should parse variables via let ...', () => {
expectFromHtml('<div *ngIf="let a=b"></div>').toEqual([
['Template'],
['TextAttribute', 'ngIf', ''],
['Variable', 'a', 'b'],
['Element', 'div'],
]);
});
it('should parse variables via as ...', () => {
expectFromHtml('<div *ngIf="expr as local"></div>').toEqual([
['Template'],
['BoundAttribute', BindingType.Property, 'ngIf', 'expr'],
['Variable', 'local', 'ngIf'],
['Element', 'div'],
]);
});
});
describe('events', () => {
it('should parse bound events with a target', () => {
expectFromHtml('<div (window:event)="v"></div>').toEqual([
['Element', 'div'],
['BoundEvent', 'event', 'window', 'v'],
]);
});
it('should parse event names case sensitive', () => {
expectFromHtml('<div (some-event)="v"></div>').toEqual([
['Element', 'div'],
['BoundEvent', 'some-event', null, 'v'],
]);
expectFromHtml('<div (someEvent)="v"></div>').toEqual([
['Element', 'div'],
['BoundEvent', 'someEvent', null, 'v'],
]);
});
it('should parse bound events via on-', () => {
expectFromHtml('<div on-event="v"></div>').toEqual([
['Element', 'div'],
['BoundEvent', 'event', null, 'v'],
]);
});
it('should report missing event names in on- syntax', () => {
expect(() => parse('<div on-></div>')).toThrowError(/Event name is missing in binding/);
});
it('should parse bound events and properties via [(...)]', () => {
expectFromHtml('<div [(prop)]="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'prop', 'v'],
['BoundEvent', 'propChange', null, 'v = $event'],
]);
});
it('should parse bound events and properties via bindon-', () => {
expectFromHtml('<div bindon-prop="v"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'prop', 'v'],
['BoundEvent', 'propChange', null, 'v = $event'],
]);
});
it('should parse bound events and properties via [(...)] with non-null operator', () => {
expectFromHtml('<div [(prop)]="v!"></div>').toEqual([
['Element', 'div'],
['BoundAttribute', BindingType.Property, 'prop', 'v!'],
['BoundEvent', 'propChange', null, 'v = $event'],
]);
});
it('should report an error for assignments into non-null asserted expressions', () => {
// TODO(joost): this syntax is allowed in TypeScript. Consider changing the grammar to
// allow this syntax, or improve the error message.
// See https://github.com/angular/angular/pull/37809
expect(() => parse('<div (prop)="v! = $event"></div>'))
.toThrowError(/Unexpected token '=' at column 4/);
});
it('should report missing property names in bindon- syntax', () => {
expect(() => parse('<div bindon-></div>'))
.toThrowError(/Property name is missing in binding/);
});
it('should report an error on empty expression', () => {
expect(() => parse('<div (event)="">')).toThrowError(/Empty expressions are not allowed/);
expect(() => parse('<div (event)=" ">')).toThrowError(/Empty expressions are not allowed/);
});
it('should parse bound animation events when event name is empty', () => {
expectFromHtml('<div (@)="onAnimationEvent($event)"></div>', true).toEqual([
['Element', 'div'],
['BoundEvent', '', null, 'onAnimationEvent($event)'],
]);
expect(() => parse('<div (@)></div>'))
.toThrowError(/Animation event name is missing in binding/);
});
it('should report invalid phase value of animation event', () => {
expect(() => parse('<div (@event.invalidPhase)></div>'))
.toThrowError(
/The provided animation output phase value "invalidphase" for "@event" is not supported \(use start or done\)/);
expect(() => parse('<div (@event.)></div>'))
.toThrowError(
/The animation trigger output event \(@event\) is missing its phase value name \(start or done are currently supported\)/);
expect(() => parse('<div (@event)></div>'))
.toThrowError(
/The animation trigger output event \(@event\) is missing its phase value name \(start or done are currently supported\)/);
});
});
describe('variables', () => {
it('should report variables not on template elements', () => {
expect(() => parse('<div let-a-name="b"></div>'))
.toThrowError(/"let-" is only supported on ng-template elements./);
});
it('should report missing variable names', () => {
expect(() => parse('<ng-template let-><ng-template>'))
.toThrowError(/Variable does not have a name/);
});
});
describe('references', () => {
it('should parse references via #...', () => {
expectFromHtml('<div #a></div>').toEqual([
['Element', 'div'],
['Reference', 'a', ''],
]);
});
it('should parse references via ref-', () => {
expectFromHtml('<div ref-a></div>').toEqual([
['Element', 'div'],
['Reference', 'a', ''],
]);
});
it('should parse camel case references', () => {
expectFromHtml('<div #someA></div>').toEqual([
['Element', 'div'],
['Reference', 'someA', ''],
]);
});
it('should report invalid reference names', () => {
expect(() => parse('<div #a-b></div>')).toThrowError(/"-" is not allowed in reference names/);
});
it('should report missing reference names', () => {
expect(() => parse('<div #></div>')).toThrowError(/Reference does not have a name/);
});
it('should report an error if a reference is used multiple times on the same element', () => {
expect(() => parse('<div #a #a></div>'))
.toThrowError(/Reference "#a" is defined more than once/);
});
});
describe('literal attribute', () => {
it('should report missing animation trigger in @ syntax', () => {
expect(() => parse('<div @></div>')).toThrowError(/Animation trigger is missing/);
});
});
describe('ng-content', () => {
it('should parse ngContent without selector', () => {
const res = parse('<ng-content></ng-content>');
expectFromR3Nodes(res.nodes).toEqual([
['Content', '*'],
]);
});
it('should parse ngContent with a specific selector', () => {
const res = parse('<ng-content select="tag[attribute]"></ng-content>');
const selectors = ['', 'tag[attribute]'];
expectFromR3Nodes(res.nodes).toEqual([
['Content', selectors[1]],
['TextAttribute', 'select', selectors[1]],
]);
});
it('should parse ngContent with a selector', () => {
const res = parse(
'<ng-content select="a"></ng-content><ng-content></ng-content><ng-content select="b"></ng-content>');
const selectors = ['*', 'a', 'b'];
expectFromR3Nodes(res.nodes).toEqual([
['Content', selectors[1]],
['TextAttribute', 'select', selectors[1]],
['Content', selectors[0]],
['Content', selectors[2]],
['TextAttribute', 'select', selectors[2]],
]);
});
it('should parse ngProjectAs as an attribute', () => {
const res = parse('<ng-content ngProjectAs="a"></ng-content>');
expectFromR3Nodes(res.nodes).toEqual([
['Content', '*'],
['TextAttribute', 'ngProjectAs', 'a'],
]);
});
});
describe('Ignored elements', () => {
it('should ignore <script> elements', () => {
expectFromHtml('<script></script>a').toEqual([
['Text', 'a'],
]);
});
it('should ignore <style> elements', () => {
expectFromHtml('<style></style>a').toEqual([
['Text', 'a'],
]);
});
});
describe('<link rel="stylesheet">', () => {
it('should keep <link rel="stylesheet"> elements if they have an absolute url', () => {
expectFromHtml('<link rel="stylesheet" href="http://someurl">').toEqual([
['Element', 'link'],
['TextAttribute', 'rel', 'stylesheet'],
['TextAttribute', 'href', 'http://someurl'],
]);
expectFromHtml('<link REL="stylesheet" href="http://someurl">').toEqual([
['Element', 'link'],
['TextAttribute', 'REL', 'stylesheet'],
['TextAttribute', 'href', 'http://someurl'],
]);
});
it('should keep <link rel="stylesheet"> elements if they have no uri', () => {
expectFromHtml('<link rel="stylesheet">').toEqual([
['Element', 'link'],
['TextAttribute', 'rel', 'stylesheet'],
]);
expectFromHtml('<link REL="stylesheet">').toEqual([
['Element', 'link'],
['TextAttribute', 'REL', 'stylesheet'],
]);
});
it('should ignore <link rel="stylesheet"> elements if they have a relative uri', () => {
expectFromHtml('<link rel="stylesheet" href="./other.css">').toEqual([]);
expectFromHtml('<link REL="stylesheet" HREF="./other.css">').toEqual([]);
});
});
describe('ngNonBindable', () => {
it('should ignore bindings on children of elements with ngNonBindable', () => {
expectFromHtml('<div ngNonBindable>{{b}}</div>').toEqual([
['Element', 'div'],
['TextAttribute', 'ngNonBindable', ''],
['Text', '{{b}}'],
]);
});
it('should keep nested children of elements with ngNonBindable', () => {
expectFromHtml('<div ngNonBindable><span>{{b}}</span></div>').toEqual([
['Element', 'div'],
['TextAttribute', 'ngNonBindable', ''],
['Element', 'span'],
['Text', '{{b}}'],
]);
});
it('should ignore <script> elements inside of elements with ngNonBindable', () => {
expectFromHtml('<div ngNonBindable><script></script>a</div>').toEqual([
['Element', 'div'],
['TextAttribute', 'ngNonBindable', ''],
['Text', 'a'],
]);
});
it('should ignore <style> elements inside of elements with ngNonBindable', () => {
expectFromHtml('<div ngNonBindable><style></style>a</div>').toEqual([
['Element', 'div'],
['TextAttribute', 'ngNonBindable', ''],
['Text', 'a'],
]);
});
it('should ignore <link rel="stylesheet"> elements inside of elements with ngNonBindable',
() => {
expectFromHtml('<div ngNonBindable><link rel="stylesheet">a</div>').toEqual([
['Element', 'div'],
['TextAttribute', 'ngNonBindable', ''],
['Text', 'a'],
]);
});
});
describe('deferred blocks', () => {
// TODO(crisbeto): temporary utility while blocks are disabled by default.
function expectDeferred(html: string) {
return expectFromR3Nodes(parse(html, {enabledBlockTypes: ['defer']}).nodes);
}
function expectDeferredError(html: string) {
return expect(() => parse(html, {enabledBlockTypes: ['defer']}));
}
it('should parse a simple deferred block', () => {
expectDeferred('{#defer}hello{/defer}').toEqual([
['DeferredBlock'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with a `when` trigger', () => {
expectDeferred('{#defer when isVisible() && loaded}hello{/defer}').toEqual([
['DeferredBlock'],
['BoundDeferredTrigger', 'isVisible() && loaded'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with a single `on` trigger', () => {
expectDeferred('{#defer on idle}hello{/defer}').toEqual([
['DeferredBlock'],
['IdleDeferredTrigger'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with multiple `on` triggers', () => {
expectDeferred('{#defer on idle, viewport(button)}hello{/defer}').toEqual([
['DeferredBlock'],
['IdleDeferredTrigger'],
['ViewportDeferredTrigger', 'button'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with a non-parenthesized trigger at the end', () => {
expectDeferred('{#defer on idle, viewport(button), immediate}hello{/defer}').toEqual([
['DeferredBlock'],
['IdleDeferredTrigger'],
['ViewportDeferredTrigger', 'button'],
['ImmediateDeferredTrigger'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with `when` and `on` triggers', () => {
const markup =
'{#defer when isVisible(); on timer(100ms), idle, viewport(button)}hello{/defer}';
expectDeferred(markup).toEqual([
['DeferredBlock'],
['BoundDeferredTrigger', 'isVisible()'],
['TimerDeferredTrigger', 100],
['IdleDeferredTrigger'],
['ViewportDeferredTrigger', 'button'],
['Text', 'hello'],
]);
});
it('should allow new line after trigger name', () => {
const markup =
`{#defer\nwhen\nisVisible(); on\ntimer(100ms),\nidle, viewport(button)}hello{/defer}`;
expectDeferred(markup).toEqual([
['DeferredBlock'],
['BoundDeferredTrigger', 'isVisible()'],
['TimerDeferredTrigger', 100],
['IdleDeferredTrigger'],
['ViewportDeferredTrigger', 'button'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with a timeout set in seconds', () => {
expectDeferred('{#defer on timer(10s)}hello{/defer}').toEqual([
['DeferredBlock'],
['TimerDeferredTrigger', 10000],
['Text', 'hello'],
]);
});
it('should parse a deferred block with a timeout that has no units', () => {
expectDeferred('{#defer on timer(100)}hello{/defer}').toEqual([
['DeferredBlock'],
['TimerDeferredTrigger', 100],
['Text', 'hello'],
]);
});
it('should parse a deferred block with a hover trigger', () => {
expectDeferred('{#defer on hover}hello{/defer}').toEqual([
['DeferredBlock'],
['HoverDeferredTrigger'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with an interaction trigger', () => {
expectDeferred('{#defer on interaction(button)}hello{/defer}').toEqual([
['DeferredBlock'],
['InteractionDeferredTrigger', 'button'],
['Text', 'hello'],
]);
});
it('should parse a deferred block with secondary blocks', () => {
expectDeferred(
'{#defer}' +
'<calendar-cmp [date]="current"/>' +
'{:loading}' +
'Loading...' +
'{:placeholder}' +
'Placeholder content!' +
'{:error}' +
'Loading failed :(' +
'{/defer}')
.toEqual([
['DeferredBlock'],
['Element', 'calendar-cmp'],
['BoundAttribute', 0, 'date', 'current'],
['DeferredBlockPlaceholder'],
['Text', 'Placeholder content!'],
['DeferredBlockLoading'],
['Text', 'Loading...'],
['DeferredBlockError'],
['Text', 'Loading failed :('],
]);
});
it('should parse a loading block with parameters', () => {
expectDeferred(
'{#defer}' +
'<calendar-cmp [date]="current"/>' +
'{:loading after 100ms; minimum 1s}' +
'Loading...' +
'{/defer}')
.toEqual([
['DeferredBlock'],
['Element', 'calendar-cmp'],
['BoundAttribute', 0, 'date', 'current'],
['DeferredBlockLoading', 'after 100ms', 'minimum 1000ms'],
['Text', 'Loading...'],
]);
});
it('should parse a placeholder block with parameters', () => {
expectDeferred(
'{#defer}' +
'<calendar-cmp [date]="current"/>' +
'{:placeholder minimum 1s}' +
'Placeholder...' +
'{/defer}')
.toEqual([
['DeferredBlock'],
['Element', 'calendar-cmp'],
['BoundAttribute', 0, 'date', 'current'],
['DeferredBlockPlaceholder', 'minimum 1000ms'],
['Text', 'Placeholder...'],
]);
});
it('should parse a deferred block with prefetch triggers', () => {
const html =
'{#defer on idle; prefetch on viewport(button), hover; prefetch when shouldPrefetch()}hello{/defer}';
expectDeferred(html).toEqual([
['DeferredBlock'],
['IdleDeferredTrigger'],
['ViewportDeferredTrigger', 'button'],
['HoverDeferredTrigger'],
['BoundDeferredTrigger', 'shouldPrefetch()'],
['Text', 'hello'],
]);
});
it('should allow arbitrary number of spaces after the `prefetch` keyword', () => {
const html =
'{#defer on idle; prefetch on viewport(button), hover; prefetch when shouldPrefetch()}hello{/defer}';
expectDeferred(html).toEqual([
['DeferredBlock'],
['IdleDeferredTrigger'],
['ViewportDeferredTrigger', 'button'],
['HoverDeferredTrigger'],
['BoundDeferredTrigger', 'shouldPrefetch()'],
['Text', 'hello'],
]);
});
it('should parse a complete example', () => {
expectDeferred(
'{#defer when isVisible() && foo; on hover, timer(10s), idle, immediate, ' +
'interaction(button), viewport(container); prefetch on immediate; ' +
'prefetch when isDataLoaded()}' +
'<calendar-cmp [date]="current"/>' +
'{:loading minimum 1s; after 100ms}' +
'Loading...' +
'{:placeholder minimum 500}' +
'Placeholder content!' +
'{:error}' +
'Loading failed :(' +
'{/defer}')
.toEqual([
['DeferredBlock'],
['BoundDeferredTrigger', 'isVisible() && foo'],
['HoverDeferredTrigger'],
['TimerDeferredTrigger', 10000],
['IdleDeferredTrigger'],
['ImmediateDeferredTrigger'],
['InteractionDeferredTrigger', 'button'],
['ViewportDeferredTrigger', 'container'],
['ImmediateDeferredTrigger'],
['BoundDeferredTrigger', 'isDataLoaded()'],
['Element', 'calendar-cmp'],
['BoundAttribute', 0, 'date', 'current'],
['DeferredBlockPlaceholder', 'minimum 500ms'],
['Text', 'Placeholder content!'],
['DeferredBlockLoading', 'after 100ms', 'minimum 1000ms'],
['Text', 'Loading...'],
['DeferredBlockError'],
['Text', 'Loading failed :('],
]);
});
it('should treat blocks as plain text inside ngNonBindable', () => {
expectDeferred(
'<div ngNonBindable>' +
'{#defer when isVisible() && foo; on hover, timer(10s); ' +
'prefetch on immediate; prefetch when isDataLoaded()}' +
'<calendar-cmp [date]="current"/>' +
'{:loading}' +
'Loading...' +
'{:placeholder}' +
'Placeholder content!' +
'{:error}' +
'Loading failed :(' +
'{/defer}' +
'</div>')
.toEqual([
['Element', 'div'],
['TextAttribute', 'ngNonBindable', ''],
[
'Text',
'{#defer when isVisible() && foo; on hover, timer(10s); prefetch on immediate; prefetch when isDataLoaded()}'
],
['Element', 'calendar-cmp'],
['TextAttribute', '[date]', 'current'],
['Text', '{:loading}'],
['Text', 'Loading...'],
['Text', '{:placeholder}'],
['Text', 'Placeholder content!'],
['Text', '{:error}'],
['Text', 'Loading failed :('],
['Text', '{/defer}'],
]);
});
describe('block validations', () => {
it('should report syntax error in `when` trigger', () => {
expectDeferredError('{#defer when isVisible(}hello{/defer}')
.toThrowError(/Unexpected end of expression/);
});
it('should report unrecognized trigger', () => {
expectDeferredError('{#defer unknown visible()}hello{/defer}')
.toThrowError(/Unrecognized trigger/);
});
it('should report unrecognized block', () => {
expectDeferredError('{#defer}hello{:unknown}world{/defer}')
.toThrowError(/Unrecognized block "unknown"/);
});
it('should report multiple placeholder blocks', () => {
expectDeferredError('{#defer}hello{:placeholder}p1{:placeholder}p2{/defer}')
.toThrowError(/"defer" block can only have one "placeholder" block/);
});
it('should report multiple loading blocks', () => {
expectDeferredError('{#defer}hello{:loading}l1{:loading}l2{/defer}')
.toThrowError(/"defer" block can only have one "loading" block/);
});
it('should report multiple error blocks', () => {
expectDeferredError('{#defer}hello{:error}e1{:error}e2{/defer}')
.toThrowError(/"defer" block can only have one "error" block/);
});
it('should report unrecognized parameter in placeholder block', () => {
expectDeferredError('{#defer}hello{:placeholder unknown 100ms}hi{/defer}')
.toThrowError(/Unrecognized parameter in "placeholder" block: "unknown 100ms"/);
});
it('should report unrecognized parameter in loading block', () => {
expectDeferredError('{#defer}hello{:loading unknown 100ms}hi{/defer}')
.toThrowError(/Unrecognized parameter in "loading" block: "unknown 100ms"/);
});
it('should report any parameter usage in error block', () => {
expectDeferredError('{#defer}hello{:error foo}hi{/defer}')
.toThrowError(/"error" block cannot have parameters/);
});
it('should report if minimum placeholder time cannot be parsed', () => {
expectDeferredError('{#defer}hello{:placeholder minimum 123abc}hi{/defer}')
.toThrowError(/Could not parse time value of parameter "minimum"/);
});
it('should report if minimum loading time cannot be parsed', () => {
expectDeferredError('{#defer}hello{:loading minimum 123abc}hi{/defer}')
.toThrowError(/Could not parse time value of parameter "minimum"/);
});
it('should report if after loading time cannot be parsed', () => {
expectDeferredError('{#defer}hello{:loading after 123abc}hi{/defer}')
.toThrowError(/Could not parse time value of parameter "after"/);
});
it('should report unrecognized `on` trigger', () => {
expectDeferredError('{#defer on foo}hello{/defer}')
.toThrowError(/Unrecognized trigger type "foo"/);
});
it('should report missing comma after unparametarized `on` trigger', () => {
expectDeferredError('{#defer on hover idle}hello{/defer}').toThrowError(/Unexpected token/);
});
it('should report missing comma after parametarized `on` trigger', () => {
expectDeferredError('{#defer on viewport(button) idle}hello{/defer}')
.toThrowError(/Unexpected token/);
});
it('should report mutliple commas after between `on` triggers', () => {
expectDeferredError('{#defer on viewport(button), , idle}hello{/defer}')
.toThrowError(/Unexpected token/);
});
it('should report unclosed parenthesis in `on` trigger', () => {
expectDeferredError('{#defer on viewport(button}hello{/defer}')
.toThrowError(/Unexpected end of expression/);
});
it('should report incorrect closing parenthesis in `on` trigger', () => {
expectDeferredError('{#defer on viewport(but)ton}hello{/defer}')
.toThrowError(/Unexpected token/);
});
it('should report stray closing parenthesis in `on` trigger', () => {
expectDeferredError('{#defer on idle)}hello{/defer}').toThrowError(/Unexpected token/);
});
it('should report non-identifier token usage in `on` trigger', () => {
expectDeferredError('{#defer on 123)}hello{/defer}').toThrowError(/Unexpected token/);
});
it('should report if identifier is not followed by an opening parenthesis', () => {
expectDeferredError('{#defer on viewport[]}hello{/defer}').toThrowError(/Unexpected token/);
});
it('should report if parameters are passed to `idle` trigger', () => {
expectDeferredError('{#defer on idle(1)}hello{/defer}')
.toThrowError(/"idle" trigger cannot have parameters/);
});
it('should report if no parameters are passed into `timer` trigger', () => {
expectDeferredError('{#defer on timer}hello{/defer}')
.toThrowError(/"timer" trigger must have exactly one parameter/);
});
it('should report if `timer` trigger value cannot be parsed', () => {
expectDeferredError('{#defer on timer(123abc)}hello{/defer}')
.toThrowError(/Could not parse time value of trigger "timer"/);
});
it('should report if `interaction` trigger has more than one parameter', () => {
expectDeferredError('{#defer on interaction(a, b)}hello{/defer}')
.toThrowError(/"interaction" trigger can only have zero or one parameters/);
});
it('should report if parameters are passed to `immediate` trigger', () => {
expectDeferredError('{#defer on immediate(1)}hello{/defer}')
.toThrowError(/"immediate" trigger cannot have parameters/);
});
it('should report if parameters are passed to `hover` trigger', () => {
expectDeferredError('{#defer on hover(1)}hello{/defer}')
.toThrowError(/"hover" trigger cannot have parameters/);
});
it('should report if `viewport` trigger has more than one parameter', () => {
expectDeferredError('{#defer on viewport(a, b)}hello{/defer}')
.toThrowError(/"viewport" trigger can only have zero or one parameters/);
});
it('should report duplicate when triggers', () => {
expectDeferredError('{#defer when isVisible(); when somethingElse()}hello{/defer}')
.toThrowError(/Duplicate "when" trigger is not allowed/);
});
it('should report duplicate on triggers', () => {
expectDeferredError('{#defer on idle; when isVisible(); on timer(10), idle}hello{/defer}')
.toThrowError(/Duplicate "idle" trigger is not allowed/);
});
it('should report duplicate prefetch when triggers', () => {
expectDeferredError(
'{#defer prefetch when isVisible(); prefetch when somethingElse()}hello{/defer}')
.toThrowError(/Duplicate "when" trigger is not allowed/);
});
it('should report duplicate prefetch on triggers', () => {
expectDeferredError(
'{#defer prefetch on idle; prefetch when isVisible(); prefetch on timer(10), idle}hello{/defer}')
.toThrowError(/Duplicate "idle" trigger is not allowed/);
});
it('should report multiple minimum parameters on a placeholder block', () => {
expectDeferredError(
'{#defer}hello{:placeholder minimum 1s; minimum 500ms}placeholder{/defer}')
.toThrowError(/Placeholder block can only have one "minimum" parameter/);
});
it('should report multiple minimum parameters on a loading block', () => {
expectDeferredError('{#defer}hello{:loading minimum 1s; minimum 500ms}loading{/defer}')
.toThrowError(/Loading block can only have one "minimum" parameter/);
});
it('should report multiple after parameters on a loading block', () => {
expectDeferredError('{#defer}hello{:loading after 1s; after 500ms}loading{/defer}')
.toThrowError(/Loading block can only have one "after" parameter/);
});
});
});
describe('switch blocks', () => {
// TODO(crisbeto): temporary utility while control flow is disabled by default.
function expectSwitch(html: string) {
return expectFromR3Nodes(parse(html, {enabledBlockTypes: ['switch']}).nodes);
}
function expectSwitchError(html: string) {
return expect(() => parse(html, {enabledBlockTypes: ['switch']}));
}
it('should parse a switch block', () => {
expectSwitch(`
{#switch cond.kind}
{:case x()} X case
{:case 'hello'} <button>Y case</button>
{:case 42} Z case
{:default} No case matched
{/switch}
`).toEqual([
['SwitchBlock', 'cond.kind'],
['SwitchBlockCase', 'x()'],
['Text', ' X case '],
['SwitchBlockCase', '"hello"'],
['Element', 'button'],
['Text', 'Y case'],
['SwitchBlockCase', '42'],
['Text', ' Z case '],
['SwitchBlockCase', null],
['Text', ' No case matched '],
]);
});
it('should parse a switch block with optional parentheses', () => {
expectSwitch(`
{#switch (cond.kind)}
{:case (x())} X case
{:case ('hello')} <button>Y case</button>
{:case (42)} Z case
{:default} No case matched
{/switch}
`).toEqual([
['SwitchBlock', 'cond.kind'],
['SwitchBlockCase', 'x()'],
['Text', ' X case '],
['SwitchBlockCase', '"hello"'],
['Element', 'button'],
['Text', 'Y case'],
['SwitchBlockCase', '42'],
['Text', ' Z case '],
['SwitchBlockCase', null],
['Text', ' No case matched '],
]);
});
it('should parse a nested switch block', () => {
expectSwitch(`
{#switch cond}
{:case 'a'}
{#switch innerCond}
{:case 'innerA'} Inner A
{:case 'innerB'} Inner B
{/switch}
{:case 'b'} <button>Y case</button>
{:case 'c'} Z case
{:default}
{#switch innerCond}
{:case 'innerC'} Inner C
{:case 'innerD'} Inner D
{:default}
{#switch innerInnerCond}
{:case 'innerInnerA'} Inner inner A
{:case 'innerInnerA'} Inner inner B
{/switch}
{/switch}
{/switch}
`).toEqual([
['SwitchBlock', 'cond'],
['SwitchBlockCase', '"a"'],
['SwitchBlock', 'innerCond'],
['SwitchBlockCase', '"innerA"'],
['Text', ' Inner A '],
['SwitchBlockCase', '"innerB"'],
['Text', ' Inner B '],
['SwitchBlockCase', '"b"'],
['Element', 'button'],
['Text', 'Y case'],
['SwitchBlockCase', '"c"'],
['Text', ' Z case '],
['SwitchBlockCase', null],
['SwitchBlock', 'innerCond'],
['SwitchBlockCase', '"innerC"'],
['Text', ' Inner C '],
['SwitchBlockCase', '"innerD"'],
['Text', ' Inner D '],
['SwitchBlockCase', null],
['SwitchBlock', 'innerInnerCond'],
['SwitchBlockCase', '"innerInnerA"'],
['Text', ' Inner inner A '],
['SwitchBlockCase', '"innerInnerA"'],
['Text', ' Inner inner B '],
]);
});
describe('validations', () => {
it('should report syntax error in switch expression', () => {
expectSwitchError(`
{#switch cond/.kind}
{:case x()} X case
{:default} No case matched
{/switch}
`).toThrowError(/Parser Error: Unexpected token \./);
});
it('should report syntax error in case expression', () => {
expectSwitchError(`
{#switch cond}
{:case x(} X case
{/switch}
`).toThrowError(/Unexpected end of expression: x\(/);
});
it('should report if a block different from "case" and "default" is used in a switch', () => {
expectSwitchError(`
{#switch cond}
{:case x()} X case
{:foo} Foo
{/switch}
`).toThrowError(/Switch block can only contain "case" and "default" blocks/);
});
it('should report if a switch has no parameters', () => {
expectSwitchError(`
{#switch}
{:case 1} case
{/switch}
`).toThrowError(/Switch block must have exactly one parameter/);
});
it('should report if a switch has more than one parameter', () => {
expectSwitchError(`
{#switch foo; bar}
{:case 1} case
{/switch}
`).toThrowError(/Switch block must have exactly one parameter/);
});
it('should report if a case has no parameters', () => {
expectSwitchError(`
{#switch cond}
{:case} case
{/switch}
`).toThrowError(/Case block must have exactly one parameter/);
});
it('should report if a case has more than one parameter', () => {
expectSwitchError(`
{#switch cond}
{:case foo; bar} case
{/switch}
`).toThrowError(/Case block must have exactly one parameter/);
});
it('should report if a switch has multiple default blocks', () => {
expectSwitchError(`
{#switch cond}
{:case foo} foo
{:default} one
{:default} two
{/switch}
`).toThrowError(/Switch block can only have one "default" block/);
});
it('should report if a default block has parameters', () => {
expectSwitchError(`
{#switch cond}
{:case foo} foo
{:default bar} bar
{/switch}
`).toThrowError(/Default block cannot have parameters/);
});
});
});
describe('for loop blocks', () => {
// TODO(crisbeto): temporary utility while control flow is disabled by default.
function expectLoop(html: string) {
return expectFromR3Nodes(parse(html, {enabledBlockTypes: ['for']}).nodes);
}
function expectLoopError(html: string) {
return expect(() => parse(html, {enabledBlockTypes: ['for']}));
}
it('should parse a for loop block', () => {
expectLoop(`
{#for item of items.foo.bar; track item.id}
{{ item }}
{:empty}
There were no items in the list.
{/for}
`).toEqual([
['ForLoopBlock', 'items.foo.bar', 'item.id'],
['BoundText', ' {{ item }} '],
['ForLoopBlockEmpty'],
['Text', ' There were no items in the list. '],
]);
});
it('should parse a for loop block with optional parentheses', () => {
expectLoop(`
{#for (item of items.foo.bar); track item.id}{{ item }}{/for}
`).toEqual([
['ForLoopBlock', 'items.foo.bar', 'item.id'],
['BoundText', '{{ item }}'],
]);
expectLoop(`
{#for (item of items.foo.bar()); track item.id}{{ item }}{/for}
`).toEqual([
['ForLoopBlock', 'items.foo.bar()', 'item.id'],
['BoundText', '{{ item }}'],
]);
expectLoop(`
{#for ( ( (item of items.foo.bar()) ) ); track item.id}{{ item }}{/for}
`).toEqual([
['ForLoopBlock', 'items.foo.bar()', 'item.id'],
['BoundText', '{{ item }}'],
]);
});
it('should parse a for loop block with let parameters', () => {
expectLoop(`
{#for item of items.foo.bar; track item.id; let idx = $index, f = $first, c = $count; let l = $last, ev = $even, od = $odd}
{{ item }}
{/for}
`).toEqual([
[
'ForLoopBlock', 'items.foo.bar', 'item.id',
{'$index': 'idx', '$first': 'f', '$last': 'l', '$even': 'ev', '$odd': 'od', '$count': 'c'}
],
['BoundText', ' {{ item }} '],
]);
});
it('should parse nested for loop blocks', () => {
expectLoop(`
{#for item of items.foo.bar; track item.id}
{{ item }}
<div>
{#for subitem of item.items; track subitem.id}<h1>{{subitem}}</h1>{/for}
</div>
{:empty}
There were no items in the list.
{/for}
`).toEqual([
['ForLoopBlock', 'items.foo.bar', 'item.id'],
['BoundText', ' {{ item }} '],
['Element', 'div'],
['ForLoopBlock', 'item.items', 'subitem.id'],
['Element', 'h1'],
['BoundText', '{{ subitem }}'],
['ForLoopBlockEmpty'],
['Text', ' There were no items in the list. '],
]);
});
it('should parse a for loop block with a function call in the `track` expression', () => {
expectLoop(`
{#for item of items.foo.bar; track trackBy(item.id, 123)}{{ item }}{/for}
`).toEqual([
['ForLoopBlock', 'items.foo.bar', 'trackBy(item.id, 123)'],
['BoundText', '{{ item }}'],
]);
});
describe('validations', () => {
it('should report if for loop does not have an expression', () => {
expectLoopError(`{#for}hello{/for}`).toThrowError(/For loop does not have an expression/);
});
it('should report if for loop does not have a tracking expression', () => {
expectLoopError(`{#for a of b}hello{/for}`)
.toThrowError(/For loop must have a "track" expression/);
});
it('should report mismatching optional parentheses around for loop expression', () => {
expectLoopError(`{#for (a of b; track c}hello{/for}`)
.toThrowError(/Unclosed parentheses in expression/);
expectLoopError(`{#for (a of b(); track c}hello{/for}`)
.toThrowError(/Unexpected end of expression: b\(/);
expectLoopError(`{#for a of b); track c}hello{/for}`)
.toThrowError(/Parser Error: Unexpected token '\)'/);
});
it('should report unrecognized for loop parameters', () => {
expectLoopError(`{#for a of b; foo bar}hello{/for}`)
.toThrowError(/Unrecognized loop paramater "foo bar"/);
});
it('should report multiple `track` parameters', () => {
expectLoopError(`{#for a of b; track c; track d}hello{/for}`)
.toThrowError(/For loop can only have one "track" expression/);
});
it('should report invalid for loop expression', () => {
const errorPattern =
/Cannot parse expression\. For loop expression must match the pattern "<identifier> of <expression>"/;
expectLoopError(`{#for //invalid of items}hello{/for}`).toThrowError(errorPattern);
expectLoopError(`{#for item}hello{/for}`).toThrowError(errorPattern);
expectLoopError(`{#for item in items}hello{/for}`).toThrowError(errorPattern);
expectLoopError(`{#for item of }hello{/for}`).toThrowError(errorPattern);
});
it('should report syntax error in for loop expression', () => {
expectLoopError(`{#for item of items..foo}hello{/for}`).toThrowError(/Unexpected token \./);
});
it('should report for loop with multiple `empty` blocks', () => {
expectLoopError(`
{#for a of b}
main
{:empty} Empty one
{:empty} Empty two
{/for}
`).toThrowError(/For loop can only have one "empty" block/);
});
it('should report empty block with parameters', () => {
expectLoopError(`
{#for a of b}
main
{:empty foo} empty
{/for}
`).toThrowError(/Empty block cannot have parameters/);
});
it('should report unrecognized loop blocks', () => {
expectLoopError(`
{#for a of b}
main
{:unknown} unknown
{/for}
`).toThrowError(/Unrecognized loop block "unknown"/);
});
it('should report an empty `let` parameter', () => {
expectLoopError(`{#for item of items.foo.bar; track item.id; let }{/for}`)
.toThrowError(
/Invalid for loop "let" parameter. Parameter should match the pattern "<name> = <variable name>"/);
});
it('should report an invalid `let` parameter', () => {
expectLoopError(`{#for item of items.foo.bar; track item.id; let i = $index, $odd}{/for}`)
.toThrowError(
/Invalid for loop "let" parameter\. Parameter should match the pattern "<name> = <variable name>"/);
});
it('should an unknown variable in a `let` parameter', () => {
expectLoopError(`{#for item of items.foo.bar; track item.id; let foo = $foo}{/for}`)
.toThrowError(/Unknown "let" parameter variable "\$foo"\. The allowed variables are:/);
});
it('should report duplicate `let` parameter variables', () => {
expectLoopError(
`{#for item of items.foo.bar; track item.id; let i = $index, f = $first, in = $index}{/for}`)
.toThrowError(/Duplicate "let" parameter variable "\$index"/);
});
});
});
describe('if blocks', () => {
// TODO(crisbeto): temporary utility while control flow is disabled by default.
function expectIf(html: string) {
return expectFromR3Nodes(parse(html, {enabledBlockTypes: ['if']}).nodes);
}
function expectIfError(html: string) {
return expect(() => parse(html, {enabledBlockTypes: ['if']}));
}
it('should parse an if block', () => {
expectIf(`
{#if cond.expr; as foo}
Main case was true!
{:else if other.expr}
Extra case was true!
{:else}
False case!
{/if}
`).toEqual([
['IfBlock'],
['IfBlockBranch', 'cond.expr', 'foo'],
['Text', ' Main case was true! '],
['IfBlockBranch', 'other.expr'],
['Text', ' Extra case was true! '],
['IfBlockBranch', null],
['Text', ' False case! '],
]);
});
it('should parse an if block with optional parentheses', () => {
expectIf(`
{#if (cond.expr)}
Main case was true!
{:else if (other.expr)}
Extra case was true!
{:else}
False case!
{/if}
`).toEqual([
['IfBlock'],
['IfBlockBranch', 'cond.expr'],
['Text', ' Main case was true! '],
['IfBlockBranch', 'other.expr'],
['Text', ' Extra case was true! '],
['IfBlockBranch', null],
['Text', ' False case! '],
]);
});
it('should parse nested if blocks', () => {
expectIf(`
{#if a}
{#if a1}
a1
{:else}
b1
{/if}
{:else if b}
b
{:else}
{#if c1}
c1
{:else if c2}
c2
{:else}
c3
{/if}
{/if}
`).toEqual([
['IfBlock'],
['IfBlockBranch', 'a'],
['IfBlock'],
['IfBlockBranch', 'a1'],
['Text', ' a1 '],
['IfBlockBranch', null],
['Text', ' b1 '],
['IfBlockBranch', 'b'],
['Text', ' b '],
['IfBlockBranch', null],
['IfBlock'],
['IfBlockBranch', 'c1'],
['Text', ' c1 '],
['IfBlockBranch', 'c2'],
['Text', ' c2 '],
['IfBlockBranch', null],
['Text', ' c3 '],
]);
});
describe('validations', () => {
it('should report an if block without a condition', () => {
expectIfError(`
{#if}hello{/if}
`).toThrowError(/Conditional block does not have an expression/);
});
it('should report an unknown parameter in an if block', () => {
expectIfError(`
{#if foo; bar}hello{/if}
`).toThrowError(/Unrecognized conditional paramater "bar"/);
});
it('should report an unknown parameter in an else if block', () => {
expectIfError(`
{#if foo}hello{:else if bar; baz}goodbye{/if}
`).toThrowError(/Unrecognized conditional paramater "baz"/);
});
it('should report an if block that has multiple `as` expressions', () => {
expectIfError(`
{#if foo; as foo; as bar}hello{/if}
`).toThrowError(/Conditional can only have one "as" expression/);
});
it('should report an else if block that has an `as` expression', () => {
expectIfError(`
{#if foo}hello{:else if bar; as alias}goodbye{/if}
`).toThrowError(/"as" expression is only allowed on the primary "if" block/);
});
it('should report an unknown block inside an if block', () => {
expectIfError(`
{#if foo}hello{:unknown}goodbye{/if}
`).toThrowError(/Unrecognized conditional block "unknown"/);
});
it('should report an if block inside an if block', () => {
expectIfError(`
{#if foo}hello{:if bar}goodbye{:else if baz}{/if}
`).toThrowError(/Unrecognized conditional block "if"/);
});
it('should report an else block with parameters', () => {
expectIfError(`
{#if foo}hello{:else bar}goodbye{/if}
`).toThrowError(/Else block cannot have parameters/);
});
it('should report a conditional with multiple else blocks', () => {
expectIfError(`
{#if foo}hello{:else}goodbye{:else}goodbye again{/if}
`).toThrowError(/Conditional can only have one "else" block/);
});
it('should report an else if block after an else block', () => {
expectIfError(`
{#if foo}hello{:else}goodbye{:else if bar}goodbye again{/if}
`).toThrowError(/Else block must be last inside the conditional/);
});
});
});
});