# Testing

> Source: `src/content/docs/actors/testing.mdx`
> Canonical URL: https://rivet.dev/docs/actors/testing
> Description: Rivet provides a straightforward testing framework to build reliable and maintainable applications. This guide covers how to write effective tests for your actor-based services.

---
## Setup

To set up testing with Rivet:

```bash
# Install Vitest
npm install -D vitest

# Run tests
npm test
```

## Basic Testing Setup

Rivet includes a test helper called `setupTest` that starts your registry in test mode and returns a client connected to it. This allows for fast, isolated tests without external dependencies.

## Testing Actor State

State persists within each test, allowing you to verify that your actor correctly maintains state between operations.

## Testing Events

For actors that emit events, you can verify events are correctly triggered by subscribing to them:

## Testing Schedules

Rivet's schedule functionality can be tested by scheduling work and waiting for it to run:

Use a short real-time delay to wait for scheduled work to run. `setupTest` does not install fake timers, so if you want to use `vi.useFakeTimers()` you must enable it yourself and confirm it works with your selected runtime.

## Best Practices

1. **Isolate tests**: Each test should run independently, avoiding shared state.
2. **Test edge cases**: Verify how your actor handles invalid inputs, concurrent operations, and error conditions.
3. **Test scheduled operations**: Use short real-time delays to wait for scheduled work to run.
4. **Use realistic data**: Test with data that resembles production scenarios.

`setupTest` starts the registry and disposes the returned client when the test finishes, so you can focus on writing effective tests for your business logic.

## API Reference

- [`setupTest`](/typedoc/functions/rivetkit.test_mod.setupTest.html) - Test setup helper function

_Source doc path: /docs/actors/testing_
