title | description | tags | publishDate | references | tldr | shoutouts | cover | coverAlt | |||
---|---|---|---|---|---|---|---|---|---|---|---|
Storybook Actions in Action |
Stop using `console.log` to debug component events. Upgrade to event mocks with Storybook Actions. (Storybook 6 and 7). |
|
2023-08-24 |
Stop using `console.log` to drive component implementation.
Upgrade to event mocks with Storybook Actions.
- 👻 Actions are defined in stories, not component code
- 👀 Actions can be shared across all stories
- 🤝 Actions can be triggered by interactions (using testing-library/dom)
|
|
./storybook-actions/storybook-actions_cover.png |
Storybook Actions in Action |
Let's talk about console.log
-driven development.
We all do it.
So, instead of fighting it, let's upgrade it with Storybook Actions.
:::hidden-script
Let's dive in… :::
Storybook actions are a feature of Storybook 6 and 7.
There's an active design proposal to make them work like conventional testing mocks. This would be a welcome change, imo.
Knowing that a change is on the horizon, let's focus on the features of the current API that will remain (or migrate easily with codemods).
In a fresh Storybook 7 installation (sandboxes here), we find two example components configured to use Storybook actions.
The included Button stories log the common event — onClick
— when clicked. Logs can then be expanded to show full event details.
Heading stories also log events but this time with custom events onLogin
and onCreateAccount
. These events are logged when the respective buttons are clicked.
Actions pair perfectly with Storybook interactions. Interactions are a way to document component states thru simulated user input. Interactions trigger their corresponding actions.
:::hidden-script
Upgrade your console-log
-driven development workflow with Storybook Actions.
Storybook actions can log event details, across stories, for both common and custom events.
(full segment script)
We have more videos on how to use this. So follow for more component-driven development tips. :::
Let's define actions for the example Button component.
- Open the story file and locate component
meta
. - Add an
argTypes
property if one doesn't exist. - Add an
onClick
property (this needs to match the component prop name). - Set the value to
{ action: "clicked" }
. (The logged text can be anything we like.)
// Button.stories.tsx
// (surronding code omitted)
const meta = {
title: 'Example/Button',
component: Button,
tags: ['autodocs'],
argTypes: {
backgroundColor: {control: 'color'},
onClick: {action: 'onClick'},
},
} satisfies Meta<typeof Button>
Now click your button in Storybook and watch the Actions log!
:::hidden-script
Inspect actions in Storybook without litering your implementation with console.log
statements!
(full segment script)
This is a great way to test and log event data without touching implementation code.
We have more videos on how to use this. So follow for more component-driven development tips. :::
Let's add an interaction to the example Button component.
- Create or find a new story.
- Add a
play
function to the story object. - Within the
canvasElement
, find the button. - then simulate a click event.
// Button.stories.tsx
// (surronding code omitted)
export const Primary: Story = {
args: {
primary: true,
label: 'Button',
},
play: async ({canvasElement}) => {
const canvas = within(canvasElement)
const button = await canvas.getByRole('button', {
name: /Button/i,
})
await userEvent.click(button)
},
}
Now the story will run the interaction when it loads. Logging both the interaction and the action — in their respective tabs.
:::hidden-script
Storybook actions and interactions are a match made in heaven. :::
console.log
-driven development is something I do when driving out a component implementation. It's a quick, cheap way to ensure that events are hooked up (early in the process).
But log statements has one huge drawback: they live in component code. And I'm guilty of pushing a log (or a few dozen) into production.
Storybook actions let you validate implementation in story files, leaving component code alone.
Check out this X thread.
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>Let's talk about console.log…
— chan 👉 chan.dev (@chantastic) August 25, 2023
It's not the best tool for the bugging UI but I use it anyway because it cheap and easy.
But when when driving component design in @storybookjs we can use Actions — which are much more like callback mocks.
Here's how… pic.twitter.com/8HNDXRslBJ
Check out the video for this post on YouTube!
Or just get to the goods with shorts!