DocumentationCommunityGitHubSlackSpectrum

Getting Started

IntroductionInstallCSSStyled ComponentsCompositionObject StylesNested SelectorsMedia QueriesGlobal Styles

Packages

emotionreact-emotionbabel-plugin-emotioneslint-plugin-emotionemotion-serveremotion-themingjest-emotion@emotion/primitivescreate-emotioncreate-emotion-styledcreate-emotion-serverpreact-emotion

jest-emotion

Edit this page

Jest testing utilities for emotion

Installation

npm install --save-dev jest-emotion

Snapshot Serializer

The easiest way to test React components with emotion is with the snapshot serializer. You can register the serializer via the snapshotSerializers configuration property in your jest configuration like so:

// jest.config.js
module.exports = {
  // ... other config
  snapshotSerializers: ['jest-emotion/serializer']
}

Or you can customize the serializer via the createSerializer method like so: (the example below is with react-test-renderer but jest-emotion also works with enzyme and react-testing-library)

import React from 'react'
import renderer from 'react-test-renderer'
import { createSerializer } from 'jest-emotion'
import * as emotion from 'emotion'
import styled from 'react-emotion'

expect.addSnapshotSerializer(createSerializer(emotion))

test('renders with correct styles', () => {
  const H1 = styled.h1`
    float: left;
  `

  const tree = renderer.create(<H1>hello world</H1>).toJSON()

  expect(tree).toMatchSnapshot()
})

Refer to the testing doc for more information about snapshot testing with emotion.

Options

classNameReplacer

jest-emotion’s snapshot serializer replaces the hashes in class names with an index so that things like whitespace changes won’t break snapshots. It optionally accepts a custom class name replacer, it defaults to the below.

function classNameReplacer(className, index) {
  return `emotion-${index}`
}
import * as emotion from 'emotion'
import { createSerializer } from 'jest-emotion'

expect.addSnapshotSerializer(
  createSerializer(emotion, {
    classNameReplacer(className, index) {
      return `my-new-class-name-${index}`
    }
  })
)

DOMElements

jest-emotion’s snapshot serializer inserts styles and replaces class names in both React and DOM elements. If you would like to disable this behavior for the latter, you can do so by setting this property to false. For example:

import * as emotion from 'emotion'
import { createSerializer } from 'jest-emotion'

// configures jest-emotion to ignore DOM elements
expect.addSnapshotSerializer(createSerializer(emotion, { DOMElements: false }))

getStyles

jest-emotion also allows you to get all the css that emotion has inserted. This is meant to be an escape hatch if you don’t use React or you want to build your own utilities for testing with emotion.

import * as emotion from 'emotion'
import { css } from 'emotion'
import { getStyles } from 'jest-emotion'

test('correct styles are inserted', () => {
  const cls = css`
    display: flex;
  `

  expect(getStyles(emotion)).toMatchSnapshot()
})

Custom matchers

toHaveStyleRule

To make more explicit assertions when testing your styled components you can use the toHaveStyleRule matcher.

import React from 'react'
import renderer from 'react-test-renderer'
import { createMatchers } from 'jest-emotion'
import * as emotion from 'emotion'
import styled from 'react-emotion'

// Add the custom matchers provided by 'jest-emotion'
expect.extend(createMatchers(emotion))

test('renders with correct styles', () => {
  const H1 = styled.h1`
    float: left;
  `

  const tree = renderer.create(<H1>hello world</H1>).toJSON()

  expect(tree).toHaveStyleRule('float', 'left')
  expect(tree).not.toHaveStyleRule('color', 'hotpink')
})

Thanks

Thanks to Kent C. Dodds who wrote jest-glamor-react which this library is largely based on.

Previous Page
emotion-theming