# Uniform Session Testing

<!-- Version variant: uniformsessiontesting_2; default: [/nservicebus/messaging/uniformsession-testing.md](/nservicebus/messaging/uniformsession-testing.md) -->


Shows the usage of the `NServiceBus.UniformSession.Testing` package.

## Prerequisites for uniform session testing functionality

The approach shown here works with the `NServiceBus.UniformSession` NuGet package version 2.2.0 or above. Install the `NServiceBus.UniformSession.Testing` NuGet package.



### Testing services

Construct the service under test with an instance of `TestableUniformSession`. Call the methods being tested and make assertions about the messages sent and published.

<!-- snippet: UniformSessionServiceTesting -->

```cs
var session = new TestableUniformSession();
var service = new SomeService(session);

service.DoTheThing();

Assert.AreEqual(1, session.SentMessages.Length);
```

<!-- endsnippet -->



### Testing a handler

Construct the handler under test with an instance of `TestableUniformSession`.

<!-- snippet: UniformSessionHandlerTesting -->

```cs
var session = new TestableUniformSession();
var sharedComponent = new SharedComponent(session);
var handler = new SomeMessageHandler(sharedComponent);

Test.Handler(handler)
    .WithUniformSession(session)
    .ExpectPublish<SomeEvent>()
    .OnMessage<SomeMessage>();
```

<!-- endsnippet -->

### Testing a saga

Construct the saga under test with an instance of `TestableUniformSession`.

<!-- snippet: UniformSessionSagaTesting -->

```cs
var session = new TestableUniformSession();
var saga = new SomeSaga(session);
Test.Saga(saga)
    .WithUniformSession(session)
    .ExpectPublish<SomeEvent>()
    .WhenHandling<SomeCommand>();
```

<!-- endsnippet -->