// Copyright (c) .NET Foundation. All rights reserved. // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information. using Microsoft.AspNetCore.Blazor.Components; using Microsoft.AspNetCore.Blazor.Rendering; using Microsoft.AspNetCore.Blazor.RenderTree; using Microsoft.AspNetCore.Blazor.Test.Shared; using System; using System.Linq; using Xunit; namespace Microsoft.AspNetCore.Blazor.Test { public class RenderTreeBuilderTest { [Fact] public void RequiresNonnullRenderer() { Assert.Throws(() => { new RenderTreeBuilder(null); }); } [Fact] public void StartsEmpty() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Assert var nodes = builder.GetNodes(); Assert.NotNull(nodes.Array); Assert.Empty(nodes); } [Fact] public void CanAddText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); var nullString = (string)null; // Act builder.AddText(0, "First item"); builder.AddText(0, nullString); builder.AddText(0, "Second item"); // Assert var nodes = builder.GetNodes(); Assert.Collection(nodes, node => AssertNode.Text(node, "First item"), node => AssertNode.Text(node, string.Empty), node => AssertNode.Text(node, "Second item")); } [Fact] public void CanAddNonStringValueAsText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); var nullObject = (object)null; // Act builder.AddText(0, 1234); builder.AddText(0, nullObject); // Assert var nodes = builder.GetNodes(); Assert.Collection(nodes, node => AssertNode.Text(node, "1234"), node => AssertNode.Text(node, string.Empty)); } [Fact] public void UnclosedElementsHaveNoEndDescendantIndex() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.OpenElement(0, "my element"); // Assert var node = builder.GetNodes().Single(); AssertNode.Element(node, "my element", 0); } [Fact] public void ClosedEmptyElementsHaveSelfAsEndDescendantIndex() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.AddText(0, "some node so that the element isn't at position zero"); builder.OpenElement(0, "my element"); builder.CloseElement(); // Assert var nodes = builder.GetNodes(); Assert.Equal(2, nodes.Count); AssertNode.Element(nodes.Array[1], "my element", 1); } [Fact] public void ClosedElementsHaveCorrectEndDescendantIndex() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.OpenElement(0, "my element"); builder.AddText(0, "child 1"); builder.AddText(0, "child 2"); builder.CloseElement(); builder.AddText(0, "unrelated item"); // Assert var nodes = builder.GetNodes(); Assert.Equal(4, nodes.Count); AssertNode.Element(nodes.Array[0], "my element", 2); } [Fact] public void CanNestElements() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.AddText(0, "standalone text 1"); // 0: standalone text 1 builder.OpenElement(0, "root"); // 1: builder.AddText(0, "root text 1"); // 2: root text 1 builder.AddText(0, "root text 2"); // 3: root text 2 builder.OpenElement(0, "child"); // 4: builder.AddText(0, "child text"); // 5: child text builder.OpenElement(0, "grandchild"); // 6: builder.AddText(0, "grandchild text 1"); // 7: grandchild text 1 builder.AddText(0, "grandchild text 2"); // 8: grandchild text 2 builder.CloseElement(); // builder.CloseElement(); // builder.AddText(0, "root text 3"); // 9: root text 3 builder.OpenElement(0, "child 2"); // 10: builder.CloseElement(); // builder.CloseElement(); // builder.AddText(0, "standalone text 2"); // 11: standalone text 2 // Assert Assert.Collection(builder.GetNodes(), node => AssertNode.Text(node, "standalone text 1"), node => AssertNode.Element(node, "root", 10), node => AssertNode.Text(node, "root text 1"), node => AssertNode.Text(node, "root text 2"), node => AssertNode.Element(node, "child", 8), node => AssertNode.Text(node, "child text"), node => AssertNode.Element(node, "grandchild", 8), node => AssertNode.Text(node, "grandchild text 1"), node => AssertNode.Text(node, "grandchild text 2"), node => AssertNode.Text(node, "root text 3"), node => AssertNode.Element(node, "child 2", 10), node => AssertNode.Text(node, "standalone text 2")); } [Fact] public void CanAddAttributes() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); UIEventHandler eventHandler = eventInfo => { }; // Act builder.OpenElement(0, "myelement"); // 0: builder.OpenElement(0, "child"); // 3: builder.AddText(0, "some text"); // 5: some text builder.CloseElement(); // builder.CloseElement(); // // Assert Assert.Collection(builder.GetNodes(), node => AssertNode.Element(node, "myelement", 5), node => AssertNode.Attribute(node, "attribute1", "value 1"), node => AssertNode.Attribute(node, "attribute2", "123"), node => AssertNode.Element(node, "child", 5), node => AssertNode.Attribute(node, "childevent", eventHandler), node => AssertNode.Text(node, "some text")); } [Fact] public void CannotAddAttributeAtRoot() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.AddAttribute(0, "name", "value"); }); } [Fact] public void CannotAddEventHandlerAttributeAtRoot() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.AddAttribute(0, "name", eventInfo => { }); }); } [Fact] public void CannotAddAttributeToText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.OpenElement(0, "some element"); builder.AddText(1, "hello"); builder.AddAttribute(2, "name", "value"); }); } [Fact] public void CannotAddEventHandlerAttributeToText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.OpenElement(0, "some element"); builder.AddText(1, "hello"); builder.AddAttribute(2, "name", eventInfo => { }); }); } [Fact] public void CanAddChildComponents() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.OpenElement(10, "parent"); // 0: builder.OpenComponentElement(11); // 1: builder.CloseElement(); // builder.OpenComponentElement(14); // 4: builder.CloseElement(); // builder.CloseElement(); // // Assert Assert.Collection(builder.GetNodes(), node => AssertNode.Element(node, "parent", 5), node => AssertNode.Component(node), node => AssertNode.Attribute(node, "child1attribute1", "A"), node => AssertNode.Attribute(node, "child1attribute2", "B"), node => AssertNode.Component(node), node => AssertNode.Attribute(node, "child2attribute", "C")); } [Fact] public void CanClear() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.AddText(0, "some text"); builder.OpenElement(1, "elem"); builder.AddText(2, "more text"); builder.CloseElement(); builder.Clear(); // Assert Assert.Empty(builder.GetNodes()); } private class TestComponent : IComponent { public void BuildRenderTree(RenderTreeBuilder builder) => throw new NotImplementedException(); } private class TestRenderer : Renderer { protected internal override void UpdateDisplay(RenderBatch renderBatch) => throw new NotImplementedException(); } } }