Class TestRenderer

Namespace

Bunit.Rendering

Assembly

Bunit.Core.dll

Represents a bUnit ITestRenderer used to render Blazor components and fragments during bUnit tests.

public class TestRenderer : Renderer, IDisposable, IAsyncDisposable, ITestRenderer

Inheritance

object

Renderer

TestRenderer

Implements

IDisposable

IAsyncDisposable

ITestRenderer

Derived

WebTestRenderer

Inherited Members

Renderer.InstantiateComponent(Type)

Renderer.AssignRootComponentId(IComponent)

Renderer.GetCurrentRenderTreeFrames(int)

Renderer.RenderRootComponentAsync(int)

Renderer.RenderRootComponentAsync(int, ParameterView)

Renderer.RemoveRootComponent(int)

Renderer.GetEventArgsType(ulong)

Renderer.Dispose()

Renderer.DisposeAsync()

Renderer.ElementReferenceContext

Renderer.UnhandledSynchronizationException

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Extension Methods

JSRuntimeAssertExtensions.ShouldBeElementReferenceTo(object?, IElement)

JSRuntimeAssertExtensions.ShouldBeElementReferenceTo(object?, IElement)

JSRuntimeAssertExtensions.ShouldBeElementReferenceTo(object?, IElement)

JSRuntimeAssertExtensions.ShouldBeElementReferenceTo(object?, IElement)

JSRuntimeAssertExtensions.ShouldBeElementReferenceTo(object?, IElement)

JSRuntimeAssertExtensions.ShouldBeElementReferenceTo(object?, IElement)

Constructors

TestRenderer(IRenderedComponentActivator, TestServiceProvider, ILoggerFactory)

Initializes a new instance of the TestRenderer class.

public TestRenderer(IRenderedComponentActivator renderedComponentActivator, TestServiceProvider services, ILoggerFactory loggerFactory)

Parameters

renderedComponentActivator IRenderedComponentActivator

services TestServiceProvider

loggerFactory ILoggerFactory

TestRenderer(IRenderedComponentActivator, TestServiceProvider, ILoggerFactory, IComponentActivator)

Initializes a new instance of the TestRenderer class.

public TestRenderer(IRenderedComponentActivator renderedComponentActivator, TestServiceProvider services, ILoggerFactory loggerFactory, IComponentActivator componentActivator)

Parameters

renderedComponentActivator IRenderedComponentActivator

services TestServiceProvider

loggerFactory ILoggerFactory

componentActivator IComponentActivator

Properties

Dispatcher

public override Dispatcher Dispatcher { get; }

Property Value

Dispatcher

RendererInfo

protected override RendererInfo RendererInfo { get; }

Property Value

RendererInfo

UnhandledException

Gets a Task<TResult>, which completes when an unhandled exception is thrown during the rendering of a component, that is caught by the renderer.

public Task<Exception> UnhandledException { get; }

Property Value

Task<Exception>

Methods

DispatchEventAsync(ulong, EventFieldInfo, EventArgs)

Notifies the renderer that an event has occurred.

public Task DispatchEventAsync(ulong eventHandlerId, EventFieldInfo fieldInfo, EventArgs eventArgs)

Parameters

eventHandlerId ulong

The AttributeEventHandlerId value from the original event attribute.

fieldInfo EventFieldInfo

Information that the renderer can use to update the state of the existing render tree to match the UI.

eventArgs EventArgs

Arguments to be passed to the event handler.

Returns

Task

A Task which will complete once all asynchronous processing related to the event has completed.

DispatchEventAsync(ulong, EventFieldInfo, EventArgs, bool)

Notifies the renderer that an event has occurred.

public Task DispatchEventAsync(ulong eventHandlerId, EventFieldInfo fieldInfo, EventArgs eventArgs, bool ignoreUnknownEventHandlers)

Parameters

eventHandlerId ulong

The AttributeEventHandlerId value from the original event attribute.

fieldInfo EventFieldInfo

Information that the renderer can use to update the state of the existing render tree to match the UI.

eventArgs EventArgs

Arguments to be passed to the event handler.

ignoreUnknownEventHandlers bool

Set to true to ignore the UnknownEventHandlerIdException.

Returns

Task

A Task which will complete once all asynchronous processing related to the event has completed.

Dispose(bool)

protected override void Dispose(bool disposing)

Parameters

disposing bool

DisposeComponents()

Disposes all components rendered by the ITestRenderer.

public void DisposeComponents()

FindComponent<TComponent>(IRenderedFragmentBase)

Performs a depth-first search for the first TComponent child component of the parentComponent.

public IRenderedComponentBase<TComponent> FindComponent<TComponent>(IRenderedFragmentBase parentComponent) where TComponent : IComponent

Parameters

parentComponent IRenderedFragmentBase

Parent component to search.

Returns

IRenderedComponentBase<TComponent>

Type Parameters

TComponent

Type of component to find.

FindComponents<TComponent>(IRenderedFragmentBase)

Performs a depth-first search for all TComponent child components of the parentComponent.

public IReadOnlyList<IRenderedComponentBase<TComponent>> FindComponents<TComponent>(IRenderedFragmentBase parentComponent) where TComponent : IComponent

Parameters

parentComponent IRenderedFragmentBase

Parent component to search.

Returns

IReadOnlyList<IRenderedComponentBase<TComponent>>

Type Parameters

TComponent

Type of components to find.

GetComponentRenderMode(IComponent)

protected override IComponentRenderMode? GetComponentRenderMode(IComponent component)

Parameters

component IComponent

Returns

IComponentRenderMode

HandleException(Exception)

protected override void HandleException(Exception exception)

Parameters

exception Exception

ProcessPendingRender()

protected override void ProcessPendingRender()

RenderComponent<TComponent>(ComponentParameterCollection)

Renders a TComponent with the parameters passed to it.

public IRenderedComponentBase<TComponent> RenderComponent<TComponent>(ComponentParameterCollection parameters) where TComponent : IComponent

Parameters

parameters ComponentParameterCollection

The parameters to pass to the component.

Returns

IRenderedComponentBase<TComponent>

A IRenderedComponentBase<TComponent> that provides access to the rendered component.

Type Parameters

TComponent

The type of component to render.

RenderFragment(RenderFragment)

Renders the renderFragment.

public IRenderedFragmentBase RenderFragment(RenderFragment renderFragment)

Parameters

renderFragment RenderFragment

The RenderFragment to render.

Returns

IRenderedFragmentBase

A IRenderedFragmentBase that provides access to the rendered renderFragment.

ResolveComponentForRenderMode(Type, int?, IComponentActivator, IComponentRenderMode)

protected override IComponent ResolveComponentForRenderMode(Type componentType, int? parentComponentId, IComponentActivator componentActivator, IComponentRenderMode renderMode)

Parameters

componentType Type

parentComponentId int?

componentActivator IComponentActivator

renderMode IComponentRenderMode

Returns

IComponent

SetRendererInfo(RendererInfo?)

Sets the RendererInfo for the renderer.

public void SetRendererInfo(RendererInfo? rendererInfo)

Parameters

rendererInfo RendererInfo

UpdateDisplayAsync(in RenderBatch)

protected override Task UpdateDisplayAsync(in RenderBatch renderBatch)

Parameters

renderBatch RenderBatch

Returns

Task