// 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 System; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Html; using Microsoft.AspNetCore.Mvc.ModelBinding; using Microsoft.AspNetCore.Mvc.TestCommon; using Microsoft.AspNetCore.Mvc.ViewEngines; using Microsoft.AspNetCore.Mvc.ViewFeatures; using Moq; using Xunit; namespace Microsoft.AspNetCore.Mvc.Rendering { public class HtmlHelperPartialExtensionsTest { // Func, expected Model, expected ViewDataDictionary public static TheoryData, object, ViewDataDictionary> PartialExtensionMethods { get { var viewData = new ViewDataDictionary(new EmptyModelMetadataProvider()); var model = new object(); return new TheoryData, object, ViewDataDictionary> { { helper => helper.Partial("test"), null, null }, { helper => helper.Partial("test", model), model, null }, { helper => helper.Partial("test", viewData), null, viewData }, { helper => helper.Partial("test", model, viewData), model, viewData }, }; } } [Theory] [MemberData(nameof(PartialExtensionMethods))] public void PartialMethods_CallHtmlHelperWithExpectedArguments( Func partialMethod, object expectedModel, ViewDataDictionary expectedViewData) { // Arrange var htmlContent = Mock.Of(); var helper = new Mock(MockBehavior.Strict); if (expectedModel == null) { // Extension methods without model parameter use ViewData.Model to get Model. var viewData = expectedViewData ?? new ViewDataDictionary(new EmptyModelMetadataProvider()); helper .SetupGet(h => h.ViewData) .Returns(viewData) .Verifiable(); } helper .Setup(h => h.PartialAsync("test", expectedModel, expectedViewData)) .Returns(Task.FromResult(htmlContent)) .Verifiable(); // Act var result = partialMethod(helper.Object); // Assert Assert.Same(htmlContent, result); helper.VerifyAll(); } [Theory] [MemberData(nameof(PartialExtensionMethods))] public void PartialMethods_DoesNotWrapThrownException( Func partialMethod, object unusedModel, ViewDataDictionary unusedViewData) { // Arrange var expected = new InvalidOperationException(); var helper = new Mock(); helper.Setup(h => h.PartialAsync("test", It.IsAny(), It.IsAny())) .Callback(() => { // Workaround for compilation issue with Moq. helper.ToString(); throw expected; }); helper.SetupGet(h => h.ViewData) .Returns(new ViewDataDictionary(new EmptyModelMetadataProvider())); // Act and Assert var actual = Assert.Throws(() => partialMethod(helper.Object)); Assert.Same(expected, actual); } // Func, expected Model, expected ViewDataDictionary public static TheoryData>, object, ViewDataDictionary> PartialAsyncExtensionMethods { get { var viewData = new ViewDataDictionary(new EmptyModelMetadataProvider()); var model = new object(); return new TheoryData>, object, ViewDataDictionary> { { helper => helper.PartialAsync("test"), null, null }, { helper => helper.PartialAsync("test", model), model, null }, { helper => helper.PartialAsync("test", viewData), null, viewData }, }; } } [Theory] [MemberData(nameof(PartialAsyncExtensionMethods))] public async Task PartialAsyncMethods_CallHtmlHelperWithExpectedArguments( Func> partialAsyncMethod, object expectedModel, ViewDataDictionary expectedViewData) { // Arrange var htmlContent = Mock.Of(); var helper = new Mock(MockBehavior.Strict); if (expectedModel == null) { // Extension methods without model parameter use ViewData.Model to get Model. var viewData = expectedViewData ?? new ViewDataDictionary(new EmptyModelMetadataProvider()); helper .SetupGet(h => h.ViewData) .Returns(viewData) .Verifiable(); } helper .Setup(h => h.PartialAsync("test", expectedModel, expectedViewData)) .Returns(Task.FromResult(htmlContent)) .Verifiable(); // Act var result = await partialAsyncMethod(helper.Object); // Assert Assert.Same(htmlContent, result); helper.VerifyAll(); } // Func, expected Model, expected ViewDataDictionary public static TheoryData, object, ViewDataDictionary> RenderPartialExtensionMethods { get { var viewData = new ViewDataDictionary(new EmptyModelMetadataProvider()); var model = new object(); return new TheoryData, object, ViewDataDictionary> { { helper => helper.RenderPartial("test"), null, null }, { helper => helper.RenderPartial("test", model), model, null }, { helper => helper.RenderPartial("test", viewData), null, viewData }, }; } } [Theory] [MemberData(nameof(RenderPartialExtensionMethods))] public void RenderPartialMethods_DoesNotWrapThrownException( Action partialMethod, object unusedModel, ViewDataDictionary unusedViewData) { // Arrange var expected = new InvalidOperationException(); var helper = new Mock(); helper.Setup(h => h.RenderPartialAsync("test", It.IsAny(), It.IsAny())) .Callback(() => { // Workaround for compilation issue with Moq. helper.ToString(); throw expected; }); helper.SetupGet(h => h.ViewData) .Returns(new ViewDataDictionary(new EmptyModelMetadataProvider())); // Act and Assert var actual = Assert.Throws(() => partialMethod(helper.Object)); Assert.Same(expected, actual); } [Theory] [MemberData(nameof(RenderPartialAsyncExtensionMethods))] public async Task RenderPartialMethods_CallHtmlHelperWithExpectedArguments( Func renderPartialAsyncMethod, object expectedModel, ViewDataDictionary expectedViewData) { // Arrange var htmlContent = Mock.Of(); var helper = new Mock(MockBehavior.Strict); if (expectedModel == null) { // Extension methods without model parameter use ViewData.Model to get Model. var viewData = expectedViewData ?? new ViewDataDictionary(new EmptyModelMetadataProvider()); helper .SetupGet(h => h.ViewData) .Returns(viewData) .Verifiable(); } helper .Setup(h => h.RenderPartialAsync("test", expectedModel, expectedViewData)) .Returns(Task.FromResult(true)) .Verifiable(); // Act await renderPartialAsyncMethod(helper.Object); // Assert helper.VerifyAll(); } // Func, expected Model, expected ViewDataDictionary public static TheoryData, object, ViewDataDictionary> RenderPartialAsyncExtensionMethods { get { var viewData = new ViewDataDictionary(new EmptyModelMetadataProvider()); var model = new object(); return new TheoryData, object, ViewDataDictionary> { { helper => helper.RenderPartialAsync("test"), null, null }, { helper => helper.RenderPartialAsync("test", model), model, null }, { helper => helper.RenderPartialAsync("test", viewData), null, viewData }, }; } } [Theory] [MemberData(nameof(RenderPartialAsyncExtensionMethods))] public async Task RenderPartialAsyncMethods_CallHtmlHelperWithExpectedArguments( Func renderPartialAsyncMethod, object expectedModel, ViewDataDictionary expectedViewData) { // Arrange var htmlContent = Mock.Of(); var helper = new Mock(MockBehavior.Strict); if (expectedModel == null) { // Extension methods without model parameter use ViewData.Model to get Model. var viewData = expectedViewData ?? new ViewDataDictionary(new EmptyModelMetadataProvider()); helper .SetupGet(h => h.ViewData) .Returns(viewData) .Verifiable(); } helper .Setup(h => h.RenderPartialAsync("test", expectedModel, expectedViewData)) .Returns(Task.FromResult(true)) .Verifiable(); // Act await renderPartialAsyncMethod(helper.Object); // Assert helper.VerifyAll(); } [Fact] public void Partial_InvokesPartialAsyncWithCurrentModel() { // Arrange var expected = new HtmlString("value"); var model = new object(); var viewData = new ViewDataDictionary(new EmptyModelMetadataProvider()) { Model = model }; var helper = new Mock(MockBehavior.Strict); helper.Setup(h => h.PartialAsync("test", model, null)) .Returns(Task.FromResult((IHtmlContent)expected)) .Verifiable(); helper.SetupGet(h => h.ViewData) .Returns(viewData); // Act var actual = helper.Object.Partial("test"); // Assert Assert.Same(expected, actual); helper.Verify(); } [Fact] public void PartialWithModel_InvokesPartialAsyncWithPassedInModel() { // Arrange var expected = new HtmlString("value"); var model = new object(); var helper = new Mock(MockBehavior.Strict); helper.Setup(h => h.PartialAsync("test", model, null)) .Returns(Task.FromResult((IHtmlContent)expected)) .Verifiable(); // Act var actual = helper.Object.Partial("test", model); // Assert Assert.Same(expected, actual); helper.Verify(); } [Fact] public void PartialWithViewData_InvokesPartialAsyncWithPassedInViewData() { // Arrange var expected = new HtmlString("value"); var model = new object(); var passedInViewData = new ViewDataDictionary(new EmptyModelMetadataProvider()); var viewData = new ViewDataDictionary(new EmptyModelMetadataProvider()) { Model = model }; var helper = new Mock(MockBehavior.Strict); helper.Setup(h => h.PartialAsync("test", model, passedInViewData)) .Returns(Task.FromResult((IHtmlContent)expected)) .Verifiable(); helper.SetupGet(h => h.ViewData) .Returns(viewData); // Act var actual = helper.Object.Partial("test", passedInViewData); // Assert Assert.Same(expected, actual); helper.Verify(); } [Fact] public void PartialWithViewDataAndModel_InvokesPartialAsyncWithPassedInViewDataAndModel() { // Arrange var expected = new HtmlString("value"); var passedInModel = new object(); var passedInViewData = new ViewDataDictionary(new EmptyModelMetadataProvider()); var helper = new Mock(MockBehavior.Strict); helper.Setup(h => h.PartialAsync("test", passedInModel, passedInViewData)) .Returns(Task.FromResult((IHtmlContent)expected)) .Verifiable(); // Act var actual = helper.Object.Partial("test", passedInModel, passedInViewData); // Assert Assert.Same(expected, actual); helper.Verify(); } [Fact] public void Partial_InvokesAndRendersPartialAsyncOnHtmlHelperOfT() { // Arrange var model = new TestModel(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model); var expected = DefaultTemplatesUtilities.FormatOutput(helper, model); // Act var actual = helper.Partial("some-partial"); // Assert Assert.Equal(expected, HtmlContentUtilities.HtmlContentToString(actual)); } [Fact] public void PartialWithModel_InvokesAndRendersPartialAsyncOnHtmlHelperOfT() { // Arrange var model = new TestModel(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(); var expected = DefaultTemplatesUtilities.FormatOutput(helper, model); // Act var actual = helper.Partial("some-partial", model); // Assert Assert.Equal(expected, HtmlContentUtilities.HtmlContentToString(actual)); } [Fact] public void PartialWithViewData_InvokesAndRendersPartialAsyncOnHtmlHelperOfT() { // Arrange var model = new TestModel(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model); var viewData = new ViewDataDictionary(helper.MetadataProvider); var expected = DefaultTemplatesUtilities.FormatOutput(helper, model); // Act var actual = helper.Partial("some-partial", viewData); // Assert Assert.Equal(expected, HtmlContentUtilities.HtmlContentToString(actual)); } [Fact] public async Task PartialAsync_Throws_IfViewNotFound_MessageUsesGetViewLocations() { // Arrange var expected = "The partial view 'test-view' was not found. The following locations were searched:" + Environment.NewLine + "location1" + Environment.NewLine + "location2"; var model = new TestModel(); var viewEngine = new Mock(MockBehavior.Strict); viewEngine .Setup(v => v.GetView(/*executingFilePath*/ null, It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location1", "location2" })) .Verifiable(); viewEngine .Setup(v => v.FindView(It.IsAny(), It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", Enumerable.Empty())) .Verifiable(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model, viewEngine.Object); var viewData = helper.ViewData; // Act & Assert var exception = await Assert.ThrowsAsync( () => helper.PartialAsync("test-view", model, viewData)); Assert.Equal(expected, exception.Message); } [Fact] public async Task PartialAsync_Throws_IfViewNotFound_MessageUsesFindViewLocations() { // Arrange var expected = "The partial view 'test-view' was not found. The following locations were searched:" + Environment.NewLine + "location1" + Environment.NewLine + "location2"; var model = new TestModel(); var viewEngine = new Mock(MockBehavior.Strict); viewEngine .Setup(v => v.GetView(/*executingFilePath*/ null, It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", Enumerable.Empty())) .Verifiable(); viewEngine .Setup(v => v.FindView(It.IsAny(), It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location1", "location2" })) .Verifiable(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model, viewEngine.Object); var viewData = helper.ViewData; // Act & Assert var exception = await Assert.ThrowsAsync( () => helper.PartialAsync("test-view", model, viewData)); Assert.Equal(expected, exception.Message); } [Fact] public async Task PartialAsync_Throws_IfViewNotFound_MessageUsesAllLocations() { // Arrange var expected = "The partial view 'test-view' was not found. The following locations were searched:" + Environment.NewLine + "location1" + Environment.NewLine + "location2" + Environment.NewLine + "location3" + Environment.NewLine + "location4"; var model = new TestModel(); var viewEngine = new Mock(MockBehavior.Strict); viewEngine .Setup(v => v.GetView(/*executingFilePath*/ null, It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location1", "location2" })) .Verifiable(); viewEngine .Setup(v => v.FindView(It.IsAny(), It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location3", "location4" })) .Verifiable(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model, viewEngine.Object); var viewData = helper.ViewData; // Act & Assert var exception = await Assert.ThrowsAsync( () => helper.PartialAsync("test-view", model, viewData)); Assert.Equal(expected, exception.Message); } [Fact] public async Task RenderPartialAsync_Throws_IfViewNotFound_MessageUsesGetViewLocations() { // Arrange var expected = "The partial view 'test-view' was not found. The following locations were searched:" + Environment.NewLine + "location1" + Environment.NewLine + "location2"; var model = new TestModel(); var viewEngine = new Mock(MockBehavior.Strict); viewEngine .Setup(v => v.GetView(/*executingFilePath*/ null, It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location1", "location2" })) .Verifiable(); viewEngine .Setup(v => v.FindView(It.IsAny(), It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", Enumerable.Empty())) .Verifiable(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model, viewEngine.Object); var viewData = helper.ViewData; // Act & Assert var exception = await Assert.ThrowsAsync( () => helper.RenderPartialAsync("test-view", model, viewData)); Assert.Equal(expected, exception.Message); } [Fact] public async Task RenderPartialAsync_Throws_IfViewNotFound_MessageUsesFindViewLocations() { // Arrange var expected = "The partial view 'test-view' was not found. The following locations were searched:" + Environment.NewLine + "location1" + Environment.NewLine + "location2"; var model = new TestModel(); var viewEngine = new Mock(MockBehavior.Strict); viewEngine .Setup(v => v.GetView(/*executingFilePath*/ null, It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", Enumerable.Empty())) .Verifiable(); viewEngine .Setup(v => v.FindView(It.IsAny(), It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location1", "location2" })) .Verifiable(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model, viewEngine.Object); var viewData = helper.ViewData; // Act & Assert var exception = await Assert.ThrowsAsync( () => helper.RenderPartialAsync("test-view", model, viewData)); Assert.Equal(expected, exception.Message); } [Fact] public async Task RenderPartialAsync_Throws_IfViewNotFound_MessageUsesAllLocations() { // Arrange var expected = "The partial view 'test-view' was not found. The following locations were searched:" + Environment.NewLine + "location1" + Environment.NewLine + "location2" + Environment.NewLine + "location3" + Environment.NewLine + "location4"; var model = new TestModel(); var viewEngine = new Mock(MockBehavior.Strict); viewEngine .Setup(v => v.GetView(/*executingFilePath*/ null, It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location1", "location2" })) .Verifiable(); viewEngine .Setup(v => v.FindView(It.IsAny(), It.IsAny(), /*isMainPage*/ false)) .Returns(ViewEngineResult.NotFound("test-view", new[] { "location3", "location4" })) .Verifiable(); var helper = DefaultTemplatesUtilities.GetHtmlHelper(model, viewEngine.Object); var viewData = helper.ViewData; // Act & Assert var exception = await Assert.ThrowsAsync( () => helper.RenderPartialAsync("test-view", model, viewData)); Assert.Equal(expected, exception.Message); } private sealed class TestModel { public override string ToString() { return "test-model-content"; } } } }