Packages

trait TestRoute extends AnyRef

A wrapped route that has a run method to run a request through the underlying route to create a TestResponse.

A TestRoute is created by deriving a test class from the concrete RouteTest implementation for your testing framework (like JUnitRouteTest for JUnit) and then using its testRoute method to wrap a route with testing support.

Source
TestRoute.scala
Linear Supertypes
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. TestRoute
  2. AnyRef
  3. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Abstract Value Members

  1. abstract def run(request: HttpRequest): TestRouteResult

    Run the request against the sealed route, meaning that exceptions and rejections will be handled by the default exception and rejection handlers.

    Run the request against the sealed route, meaning that exceptions and rejections will be handled by the default exception and rejection handlers. The default handlers will convert exceptions and rejections into HTTP responses with corresponding status codes (like 404 when no route matches the path or 500 in cases of exceptions).

    If you want to assert on the original rejections instead, use TestRoute#runWithRejections.

  2. abstract def runClientServer(request: HttpRequest): TestRouteResult

    Similar to TestRoute#run but runs the request through a full HTTP client and server stack.

    Similar to TestRoute#run but runs the request through a full HTTP client and server stack.

    Run the request against the sealed route, meaning that exceptions and rejections will be handled by the default exception and rejection handlers. The default handlers will convert exceptions and rejections into HTTP responses with corresponding status codes (like 404 when no route matches the path or 500 in cases of exceptions).

    If you want to assert on the original rejections instead, use TestRoute#runWithRejections.

  3. abstract def runWithRejections(request: HttpRequest): TestRouteResult

    Run the request against the "semi-sealed" route, meaning that exceptions will be handled by the default exception handler but rejections will not be handled.

    Run the request against the "semi-sealed" route, meaning that exceptions will be handled by the default exception handler but rejections will not be handled. This means that the test will not see HTTP responses with error status codes for routes that rejected a request. Instead, the TestRouteResult allows access to the original rejection containing all the rejection details in structured form. Use TestRouteResult#assertRejections to check that a route rejected a request with expected rejections.

    Otherwise, to assert on the actual error HTTP response generated by the default rejection handler, use the TestRoute#run method, instead.

  4. abstract def underlying: Route