Fork me on GitHub


WireMock is a flexible library for stubbing and mocking web services. Unlike general purpose mocking tools it works by creating an actual HTTP server that your code under test can connect to as it would a real web service.

It supports HTTP response stubbing, request verification, proxy/intercept, record/playback of stubs and fault injection, and can be used from within a unit test or deployed into a test environment.

Although it’s written in Java, there’s also a JSON API so you can use it with pretty much any language out there.

What’s it for?

Some scenarios you might want to consider WireMock for:

  • Testing mobile apps that depend on third-party REST APIs
  • Creating quick prototypes of your APIs
  • Injecting otherwise hard-to-create errors in 3rd party services
  • Any unit testing of code that depends on a web service

Who makes it?

WireMock was created and is maintained by Tom Akehurst.

The following people have been kind enough to submit improvements:

Why shouldn’t I just use my favourite mocking library?

Mocking HTTP client classes in a way that adequately reflects their real behaviour is pretty hard. Creating real HTTP exchanges alleviates this by allowing you to use your production HTTP client implementation in your tests.

Object based mocking isn’t really suitable for acceptance/functional testing scenarios. WireMock can be run as a standalone service or deployed into a servlet container to enable it to be installed into your dev/test environments.

I like the idea, but the implementation stinks/you’ve missed something I need/it’s the wrong colour

Here are some alternative JVM based libraries with similar goals:

I couldn’t possibly be seen using Java, I’ve got my image to think about!

Luckily, Rowan Hill has built a PHP binding, so you can bring it to your next Shoreditch hackathon without fear of ridicule!