Is it possible to Outside-In TDD on front-end?

Traditionally, because of lack of tools or knowledge, there have not been that many good practices in front-end development. You probably just made the jQuery work and if you were lucky you used Selenium to automate the tests from a user perspective.

Which led to this:

Inverted testing pyramid

An inverted testing pyramid, which gives slow feedback (I'm looking at you, 8h test battery) alongside many other issues.

Latest frameworks (React, Vue, Angular...) are encouraging unit testing and people are embracing the power it provides. But we still have some way to go to be as mature as backend development is.

How is usually tested

In the best case, you probably have:

  • Mounted (shallow rather) individual components to test their behaviour, mocking their dependencies and not rendering their children.
  • Tested your dependencies separately: actions, reducers, services, store...

If you are doing TDD, of course you will have done that writing every test first, right?

Well, you have done a classicist approach, which is completely fine.

But probably testing the correctness of the system is left to the e2e tests, making the top of the testing pyramid painfully big (and slow), when at that point you shouldn't be testing for accuracy.

What we're going to do

Either for the sake of being able to do outside-in or to be able to leave the e2e to test browser integration and some happy paths instead of everything.

These are going to be our next steps:

  1. Create a brand new app with 1 use case
  2. Mock our APIs
  3. Mount our whole application
  4. Start testing our acceptance criteria
  5. Drive our design from that test, creating unit tests and implementing components
  6. Enjoy the robustness and speed of our tests

If you already want to see the final solution, it is in this repository.

Create App

This is our acceptance criteria:

When I am in the home page

Then 5 random phrases from Chuck Norris will show

We have joined with our backend folks and we have come up with an API definition. This contract will go to a mock server for development purposes.

In this case, we're going to create a React app using Create react app. Of course this could have been any other framework (or without one), the methodology remains the same.

Setup tests (Mock API and mount App)

We're going to mock our API so it returns a fixture with the example in our contract. We don't want to test the correctness of our system alongside backend: That will be done in e2e tests and it would make this tests much more fragile with almost no benefit.

If you are consuming a 3rd party and you're worried about the contract changing, make a contract test.

If the contract is owned by your team, just don't break it ;).

Since we're using axios for the requests, we will use it for mocking.

To mount the application we will use Enzyme's mount (because we want the whole app) and one little hack to wait for promises resolution.

import React from 'react'
import { Provider } from 'react-redux'
import MockAdapter from 'axios-mock-adapter'
import * as axios from 'axios'
import randomPhraseResponse from 'src/test/fixtures/randomPhraseResponse'
import { API_URL } from 'src/config'
import App from '../App'
import store from 'src/store'

const axiosMocked = new MockAdapter(axios)
axiosMocked.onGet(API_URL + '/jokes/random/5').reply(200, randomPhraseResponse)

async function mountApp() {
  const app = mount(<Provider store={store}> <App/> </Provider>)
  await flushPromises()
  app.update()
  return app
}

export default mountApp

Test our acceptance criteria

There are discussions about how to call these kind of tests: Component testing, integration testing, acceptance testing...

But here we're going to see that the hardest part was how to name them and the setup, because the test itself if this simple:

import randomPhraseResponse from 'src/test/fixtures/randomPhraseResponse'
import mountApp from 'src/test/setupAcceptanceTests'

describe('App', () => {
  let app

  beforeEach(async () => {
    app = await mountApp()
  })

  it('shows some random Chuck Norris phrases after clicking its button', () => {
    const phraseTexts = randomPhraseResponse.value.map(phrase => phrase.joke)
    const phraseComponents = app.find('.phrase')

    phraseTexts.forEach((phraseText, index) => {
      const text = phraseComponents.at(index).text()
      expect(text).toEqual(phraseText)
    })
  })
})

It will probably remind you of how tests are written with tools like Selenium. It is pretty standard.

Outside-in TDD

Ok. We have created our acceptance criteria from a user perspective. Now what.

It's time for TDD double loop to kick in!

TDD double loop

We will begin by creating unit tests for our container. For instance, let's test that it shows the phrases:

import randomPhrases from 'src/test/fixtures/randomPhrases'

describe('App', () => {
  let wrapper

  beforeEach(() => {
    wrapper = shallow(<App phrases={randomPhrases}/>)
  })

  it('shows phrases', () => {
    const phraseComponents = wrapper.find(Phrase)

    randomPhrases.forEach((phrase, index) => {
      const phraseComponent = phraseComponents.at(index)
      expect(phraseComponent.prop('joke')).toEqual(phrase.joke)
    })
  })
})

As you can see, the test here differs greatly from the acceptance. We're entering in details about components instances and props.

These are unit tests, so we delegate the logic of showing the phrase to that Phrase component, which we will create empty in the beginning, and then unit test it and implement it - red, green, refactor. Remember?

The same goes for the store, actions, etc.

The acceptance tests will help us remember not to forget anything, and will test the interaction between all the collaborators.

Enjoy our app

This is the moment to realize we have develop a whole App without even starting the browser.

Of course there will be work remaining (Those CSS that we like so much, right?) but the feature itself will be pretty much done.

Our tests have been running smoothly and quickly providing us valuable feedback.

If we need to, now is the moment to implement a e2e test (maybe we want to test the interaction with the backend, automated visual regression tests, or some features that are a cross-browser pain).

If you didn't before, you might want to check the final solution, it is in this repository.

Keep in mind that this solution is one of many to solve our needs. You can use many other frameworks like Cypress or Protractor with their advantages and disadvantages.