// 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.Blazor.Components; using Microsoft.Blazor.Rendering; using Microsoft.Blazor.RenderTree; using Microsoft.Blazor.Test.Shared; using System; using System.Linq; using Xunit; namespace Microsoft.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.Equal(0, nodes.Offset); Assert.Empty(nodes); } [Fact] public void CanAddText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.AddText("First item"); builder.AddText("Second item"); // Assert var nodes = builder.GetNodes(); Assert.Equal(0, nodes.Offset); Assert.Collection(nodes, node => AssertNode.Text(node, "First item"), node => AssertNode.Text(node, "Second item")); } [Fact] public void UnclosedElementsHaveNoEndDescendantIndex() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.OpenElement("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("some node so that the element isn't at position zero"); builder.OpenElement("my element"); builder.CloseElement(); // Assert var nodes = builder.GetNodes(); Assert.Equal(2, nodes.Count); AssertNode.Element(nodes[1], "my element", 1); } [Fact] public void ClosedElementsHaveCorrectEndDescendantIndex() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.OpenElement("my element"); builder.AddText("child 1"); builder.AddText("child 2"); builder.CloseElement(); builder.AddText("unrelated item"); // Assert var nodes = builder.GetNodes(); Assert.Equal(4, nodes.Count); AssertNode.Element(nodes[0], "my element", 2); } [Fact] public void CanNestElements() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.AddText("standalone text 1"); // 0: standalone text 1 builder.OpenElement("root"); // 1: builder.AddText("root text 1"); // 2: root text 1 builder.AddText("root text 2"); // 3: root text 2 builder.OpenElement("child"); // 4: builder.AddText("child text"); // 5: child text builder.OpenElement("grandchild"); // 6: builder.AddText("grandchild text 1"); // 7: grandchild text 1 builder.AddText("grandchild text 2"); // 8: grandchild text 2 builder.CloseElement(); // builder.CloseElement(); // builder.AddText("root text 3"); // 9: root text 3 builder.OpenElement("child 2"); // 10: builder.CloseElement(); // builder.CloseElement(); // builder.AddText("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("myelement"); // 0: builder.OpenElement("child"); // 3: builder.AddText("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", "value 2"), 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("name", "value"); }); } [Fact] public void CannotAddEventHandlerAttributeAtRoot() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.AddAttribute("name", eventInfo => { }); }); } [Fact] public void CannotAddAttributeToText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.OpenElement("some element"); builder.AddText("hello"); builder.AddAttribute("name", "value"); }); } [Fact] public void CannotAddEventHandlerAttributeToText() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act/Assert Assert.Throws(() => { builder.OpenElement("some element"); builder.AddText("hello"); builder.AddAttribute("name", eventInfo => { }); }); } [Fact] public void CanAddChildComponents() { // Arrange var builder = new RenderTreeBuilder(new TestRenderer()); // Act builder.OpenElement("parent"); // 0: builder.AddComponent(); // 1: builder.AddComponent(); // 4: 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("some text"); builder.OpenElement("elem"); builder.AddText("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 override void UpdateDisplay(int componentId, ArraySegment renderTree) => throw new NotImplementedException(); } } }