@storybook/addon-jest
    TypeScript icon, indicating that this package has built-in type declarations

    6.3.6 • Public • Published

    Storybook addon Jest

    Brings Jest results in storybook.

    Framework Support

    Storybook Jest Addon Demo

    Checkout the above Live Storybook.

    Getting started

    Install

    npm install --save-dev @storybook/addon-jest

    or

    yarn add --dev @storybook/addon-jest

    Jest Configuration

    When running Jest, be sure to save the results in a json file:

    package.json

    "scripts": {
      "test:generate-output": "jest --json --outputFile=.jest-test-results.json"
    }

    You may want to add it the result file to .gitignore, since it's a generated file:

    .jest-test-results.json
    

    But much like lockfiles and snapshots checking-in generated files can have certain advantages as well. It's up to you. We recommend to do check in the test results file so starting storybook from an clean git clone doesn't require running all tests first, but this can mean you'll experience merge conflicts on this file in the future. (re-generating this file is very similar to re-generating lockfiles and snapshots)

    Generating the test results

    You need to make sure the generated test-results file exists before you start storybook. During development you will likely start jest in watch-mode and so the json file will be re-generated every time code or tests change.

    npm run test:generate-output -- --watch

    This change will then be HMR (hot module reloaded) using webpack and displayed by this addon.

    If you want to pre-run jest automatically during development or a static build, you may need to consider that if your tests fail, the script receives a non-0 exit code and will exit. You could create a prebuild:storybook npm script, which will never fail by appending || true:

    "scripts": {
      "test:generate-output": "jest --json --outputFile=.jest-test-results.json || true",
      "test": "jest",
      "prebuild:storybook": "npm run test:generate-output",
      "build:storybook": "build-storybook -c .storybook -o build/",
      "predeploy": "npm run build:storybook",
      "deploy": "gh-pages -d build/",
    }

    Register

    within .storybook/main.js:

    module.exports = {
      addons: ['@storybook/addon-jest'],
    };

    Usage

    Assuming that you have created test files MyComponent.test.js and MyOtherComponent.test.js

    In your story.js

    import results from '../.jest-test-results.json';
    import { withTests } from '@storybook/addon-jest';
    
    export default {
      title: 'MyComponent',
      decorators: [withTests({ results })],
    };
    
    export const defaultView = () => <div>Jest results in storybook</div>;
    defaultView.parameters = {
      jest: ['MyComponent.test.js', 'MyOtherComponent.test.js'],
    };

    Or in order to avoid importing .jest-test-results.json in each story, add the decorator in your .storybook/preview.js and results will display for stories that you have set the jest parameter on:

    import { addDecorator } from '@storybook/react'; // <- or your view layer
    import { withTests } from '@storybook/addon-jest';
    
    import results from '../.jest-test-results.json';
    
    addDecorator(
      withTests({
        results,
      })
    );

    Then in your story:

    import React from 'react';
    
    export default {
      title: 'MyComponent',
    };
    
    export const defaultView = () => <div>Jest results in storybook</div>;
    defaultView.parameters = {
      jest: ['MyComponent.test.js', 'MyOtherComponent.test.js'],
    };

    The jest parameter will default to inferring from your story file name if not provided. For example, if your story file is MyComponent.stories.js, then "MyComponent" will be used to find your test file results. This currently doesn't work in production environments.

    Disabling

    You can disable the addon for a single story by setting the jest parameter to {disable: true}:

    import React from 'react';
    
    export default {
      title: 'MyComponent',
    };
    
    export const defaultView = () => <div>Jest results in storybook</div>;
    defaultView.parameters = {
      jest: { disable: true },
    };

    withTests(options)

    • options.results: OBJECT jest output results. mandatory
    • filesExt: STRING test file extension. optional. This allows you to write "MyComponent" and not "MyComponent.test.js". It will be used as regex to find your file results. Default value is ((\\.specs?)|(\\.tests?))?(\\.js)?$. That means it will match: MyComponent.js, MyComponent.test.js, MyComponent.tests.js, MyComponent.spec.js, MyComponent.specs.js...

    Usage with Angular

    Assuming that you have created test files my.component.spec.ts and my-other.component.spec.ts

    Configure Jest with jest-preset-angular

    In project's typings.d.ts add

    declare module '*.json' {
      const value: any;
      export default value;
    }

    In your .storybook/preview.ts:

    import { addDecorator } from '@storybook/angular';
    import { withTests } from '@storybook/addon-jest';
    
    import results from '../.jest-test-results.json';
    
    addDecorator(
      withTests({
        results,
        filesExt: '((\\.specs?)|(\\.tests?))?(\\.ts)?$',
      })
    );
    Example here

    TODO

    • [ ] Add coverage
    • [ ] Display nested test better (describe)
    • [ ] Display the date of the test
    • [ ] Add unit tests
    • [ ] Add linting
    • [ ] Split

    Contributing

    All ideas and contributions are welcomed.

    Licence

    MIT © 2017-present Renaud Tertrais

    Install

    npm i @storybook/addon-jest

    DownloadsWeekly Downloads

    36,653

    Version

    6.3.6

    License

    MIT

    Unpacked Size

    120 kB

    Total Files

    42

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar