Ninjas Practicing Multidimensionality

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

    0.0.2 • Public • Published

    Storybook Testing Vue

    Testing utilities that allow you to reuse your stories in your unit tests


    ⚠️ If you're using Storybook with Vue 3, please check @storybook/testing-vue3 instead!

    Installation

    This library should be installed as one of your project's devDependencies:

    via npm

    npm install --save-dev @storybook/testing-vue
    

    or via yarn

    yarn add --dev @storybook/testing-vue
    

    Setup

    Storybook CSF

    This library requires you to be using Storybook's Component Story Format (CSF) and hoisted CSF annotations, which is the recommended way to write stories since Storybook 6.

    Essentially, if your stories look similar to this, you're good to go!

    // CSF: default export (meta) + named exports (stories)
    export default {
      title: 'Example/Button',
      component: Button,
    };
    
    export const Primary = () => ({
      template: '<my-button primary />',
    });

    Global config

    This is an optional step. If you don't have global decorators, there's no need to do this. However, if you do, this is a necessary step for your global decorators to be applied.

    If you have global decorators/parameters/etc and want them applied to your stories when testing them, you first need to set this up. You can do this by adding to or creating a jest setup file:

    // setupFile.js <-- this will run before the tests in jest.
    import { setGlobalConfig } from '@storybook/testing-vue';
    import * as globalStorybookConfig from './.storybook/preview'; // path of your preview.js file
    
    setGlobalConfig(globalStorybookConfig);

    For the setup file to be picked up, you need to pass it as an option to jest in your test command:

    // package.json
    {
      "test": "jest --setupFiles ./setupFile.js"
    }

    Usage

    composeStories

    composeStories will process all stories from the component you specify, compose args/decorators in all of them and return an object containing the composed stories.

    If you use the composed story (e.g. PrimaryButton), the component will render with the args that are passed in the story. However, you are free to pass any props on top of the component, and those props will override the default values passed in the story's args.

    import { render, screen } from '@testing-library/vue';
    import { composeStories } from '@storybook/testing-vue';
    import * as stories from './Button.stories'; // import all stories from the stories file
    
    // Every component that is returned maps 1:1 with the stories, but they already contain all decorators from story level, meta level and global level.
    const { Primary, Secondary } = composeStories(stories);
    
    test('renders primary button with default args', () => {
      render(Primary());
      const buttonElement = screen.getByText(
        /Text coming from args in stories file!/i
      );
      expect(buttonElement).not.toBeNull();
    });
    
    test('renders primary button with overriden props', () => {
      render(Secondary({ label: 'Hello world' })); // you can override props and they will get merged with values from the Story's args
      const buttonElement = screen.getByText(/Hello world/i);
      expect(buttonElement).not.toBeNull();
    });

    composeStory

    You can use composeStory if you wish to apply it for a single story rather than all of your stories. You need to pass the meta (default export) as well.

    import { render, screen } from '@testing-library/vue';
    import { composeStory } from '@storybook/testing-vue';
    import Meta, { Primary as PrimaryStory } from './Button.stories';
    
    // Returns a component that already contain all decorators from story level, meta level and global level.
    const Primary = composeStory(PrimaryStory, Meta);
    
    test('onclick handler is called', async () => {
      const onClickSpy = jest.fn();
      render(Primary({ onClick: onClickSpy }));
      const buttonElement = screen.getByRole('button');
      buttonElement.click();
      expect(onClickSpy).toHaveBeenCalled();
    });

    License

    MIT

    Install

    npm i @storybook/testing-vue

    DownloadsWeekly Downloads

    430

    Version

    0.0.2

    License

    MIT

    Unpacked Size

    78.5 kB

    Total Files

    15

    Last publish

    Collaborators

    • kylegach
    • tooppaaa
    • ndelangen
    • shilman
    • alexandrebodin
    • hypnosphi
    • danielduan
    • igor-dv
    • pksunkara
    • tmeasday
    • gongreg
    • domyen
    • usulpro
    • kylesuss
    • ghengeveld
    • pago
    • dandean
    • codebyalex
    • mrmckeb
    • dannyhw
    • winkervsbecks
    • rvasikarla
    • amalik2
    • lshadler
    • phated
    • yannbf
    • dylanpiercey
    • monkeyworks
    • darleendenno