Skip to content

mchill/storybook-addon-mock

 
 

Repository files navigation

Storybook Addon Mock Request

dependencies Status Actions Status npm npm version

Follow @nutboltu

NPM

This addon allows you to mock fetch or XMLHttprequest requests in storybook. If your component depends on backend apis, and your backend apis are not ready yet to feed your component, then this addon provides mock response to build your component.

Live Demo

Why we need this

There are few packages those help the developers to mock the backend apis while building components. But those packages aren't integrated properly in storybook and also there's no scope to play with those apis in the storybook. storybook-addon-mock provides a dedicated panel in the storybook which helps the developer to view and update the apis with multiple scenarios.

How to use

Install the addon in your project as dev dependencies.

  yarn add -D storybook-addon-mock

Using Storybook 6

Add the decorator in your addons, in .storybook/main.js:

module.exports = {
  addons: [
    'storybook-addon-mock/register',
  ],
}

Add decorator in the stories.

import React from 'react'
import withMock from 'storybook-addon-mock'
import Component from './Component'

export default {
  title: 'Component',
  component: Component,
  decorators: [withMock],
}

const Template = args => <Component {...args} />

export const Default = Template.bind({})
Default.parameters = {
   mockData: [{
      url: 'https://jsonplaceholder.typicode.com/todos/1',
      method: 'GET',
      status: 200,
      response: {
        data: 'This is a Mock Response!',
      },
   }],
}

Thanks to shilman for this solution

Using older versions of Storybook

Add the register in your .storybook/addons.js file

import 'storybook-addon-mock/register';

Add withMock as a decorator in the stories.

import React from 'react';
import withMock from 'storybook-addon-mock';

storiesOf('Mock Response Story', module)
  .addDecorator(withMock)
  .add('Story Item', () => <ComponentWithAPICall />, {
    mockData: [{
      url: 'https://jsonplaceholder.typicode.com/todos/1',
      method: 'GET',
      status: 200,
      response: {
        data: 'This is a Mock Response!',
      },
    }],
  });

License

This project is licensed under the MIT License - see the LICENSE file in the source code for details.

About

This addon allows you to mock fetch or XMLHttpRequest in the storybook.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%