🧪DNT-2724 Accordion Testing
5 Things You Didn't Know About React Testing Library
Excerpt
I've just sold myself to the gods of click-baiting by making an "x things you didn't know about y" post. But hey, at least there no subtitle that says "number three will blow your mind!"
I've just sold myself to the gods of click-baiting by making an "x things you didn't know about y" post. But hey, at least there no subtitle that says "number three will blow your mind!"
Jokes aside the items in this list are concepts that I usually see beginners struggling with. At the same time, learning these concepts will vastyly improve your testing game. I know it did with mine.
1. Everything is a DOM node
This is usually the first misconception that beginners have when they start approaching Testing Library. It is especially true for those developers like me that came from Enzyme.
Many think that getByText and other helper methods return some special wrapper around the React component. People even ask how to implement a getByReactComponent helper.
When you work with Testing Library you are dealing with DOM nodes. This is made clear by the first Guiding Principle:
If it relates to rendering components, then it should deal with DOM nodes rather than component instances, and it should not encourage dealing with component instances.
If you want to check for yourself, it's as simple as this:
import React from "react";
import { render, screen } from "@testing-library/react";
test("everything is a node", () => {
const Foo = () => <div>Hello</div>;
render(<Foo />);
expect(screen.getByText("Hello")).toBeInstanceOf(Node);
});Once you realize that you're dealing with DOM nodes you can start taking advantage of all the DOM APIs like querySelector or closest👍
import React from "react";
import { render, screen } from "@testing-library/react";
test("the button has type of reset", () => {
const ResetButton = () => (
<button type="reset">
<div>Reset</div>
</button>
);
render(<ResetButton />);
const node = screen.getByText("Reset");
// This won't work because `node` is the `<div>`
// expect(node).toHaveProperty("type", "reset");
expect(node.closest("button")).toHaveProperty("type", "reset");
});2. debug's optional parameter
Since we now know that we're dealing with a DOM structure, it would be helpful to be able to "see" it. This is what debug is meant for:
const { debug } = render(<MyComponent />);
debug();ometimes thought debug's output can be very long and difficult to navigate. In those cases, you might want to isolate a subtree of your whole structure. You can do this easily by passing a node to debug:
const { debug } = render(<MyComponent />);
const button = screen.getByText("Click me").closest();
debug(button);3. Restrict your queries with within
Imagine you're testing a component that renders this structure:
<table>
<thead>
<tr>
<th>ID</th>
<th>Fruit</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>Apples</td>
</tr>
<tr>
<td>2</td>
<td>Oranges</td>
</tr>
<tr>
<td>3</td>
<td>Apples</td>
</tr>
</tbody>
</tablYou want to test that each ID gets its correct value. You can't use getByText('Apples') because there are two nodes with that value. Even if that wasn't the case you have no guarantee that the text is in the correct row.
What you want to do is to run getByText only inside the row you're considering at the moment. This is exactly what within is for:
import React from "react";
import { render, screen, within } from "@testing-library/react"; // highlight-line
import "jest-dom/extend-expect";
test("the values are in the table", () => {
const MyTable = ({ values }) => (
<table>
<thead>
<tr>
<th>ID</th>
<th>Fruits</th>
</tr>
</thead>
<tbody>
{values.map(([id, fruit]) => (
<tr key={id}>
<td>{id}</td>
<td>{fruit}</td>
</tr>
))}
</tbody>
</table>
);
const values = [
["1", "Apples"],
["2", "Oranges"],
["3", "Apples"],
];
render(<MyTable values={values} />);
values.forEach(([id, fruit]) => {
const row = screen.getByText(id).closest("tr");
// highlight-start
const utils = within(row);
expect(utils.getByText(id)).toBeInTheDocument();
expect(utils.getByText(fruit)).toBeInTheDocument();
// highlight-end
});
});
j;4. Queries accept functions too
You have probably seen an error like this one:
Unable to find an element with the text: Hello world.
This could be because the text is broken up by multiple elements.
In this case, you can provide a function for your text
matcher to make your matcher more flexible.Usually, it happens because your HTML looks like this:
<div>Hello <span>world</span></div>The solution is contained inside the error message: "[...] you can provide a function for your text matcher [...]".
What's that all about? It turns out matchers accept strings, regular expressions or functions.
The function gets called for each node you're rendering. It receives two arguments: the node's content and the node itself. All you have to do is to return true or false depending on if the node is the one you want.
An example will clarify it:
import { render, screen, within } from "@testing-library/react";
import "jest-dom/extend-expect";
test("pass functions to matchers", () => {
const Hello = () => (
<div>
Hello <span>world</span>
</div>
);
render(<Hello />);
// These won't match
// getByText("Hello world");
// getByText(/Hello world/);
screen.getByText((content, node) => {
const hasText = (node) => node.textContent === "Hello world";
const nodeHasText = hasText(node);
const childrenDontHaveText = Array.from(node.children).every(
(child) => !hasText(child)
);
return nodeHasText && childrenDontHaveText;
});
});We're ignoring the content argument because in this case, it will either be "Hello", "world" or an empty string.
What we are checking instead is that the current node has the right textContent. hasText is a little helper function to do that. I declared it to keep things clean.
That's not all though. Our div is not the only node with the text we're looking for. For example, body in this case has the same text. To avoid returning more nodes than needed we are making sure that none of the children has the same text as its parent. In this way we're making sure that the node we're returning is the smallest—in other words the one closes to the bottom of our DOM tree.
5. You can simulate browsers events with user-event
Ok, this one is a shameless plug since I'm the author of user-event. Still, people—myself included—find it useful. Maybe you will too.
All user-event tries to do is to simulate the events a real user would do while interacting with your application. What does it mean? Imagine you have an input field, and in your tests, you want to enter some text in it. You would probably do something like this:
fireEvent.change(input, { target: { value: "Hello world" } });It works but it doesn't simulate what happens in the browser. A real user would most likely move the mouse to select the input field and then start typing one character at the time. This, in turns, fires many events (blur, focus, mouseEnter, keyDown, keyUp...). user-event simulates all those events for you:
import userEvent from "@testing-library/user-event";
userEvent.type(input, "Hello world");// # TextMatch type accenpts function: https://testing-library.com/docs/queries/about/#textmatch
import { renderWithCTX, screen, Matcher } from "src/lib/testWrappers";
import userEvent from "@testing-library/user-event";
import "@testing-library/jest-dom";
import { Accordion, themeMap } from "./index";
import { compositionFunction } from "./composition";
import data from "./data";
import { stripHTMLTags } from "src/lib/helpers";
jest.mock("src/lib/useIntersection");
describe("Accordion", () => {
const props = compositionFunction(data);
it.skip("should render the correct items", () => {
renderWithCTX(<Accordion {...props} />);
for (let i = 0; i < props.items.length - 1; i++) {
const accordionTitle = screen.getByText(
props?.items[0]?.title?.value as string
);
expect(accordionTitle).toBeTruthy();
}
});
it.skip("should render Accordion Component with image", () => {
renderWithCTX(<Accordion {...props} />);
const img = screen.getByRole("img", { name: /facebook/i });
expect(img).toBeInTheDocument();
});
it("should reveal text when user clicks", async () => {
renderWithCTX(<Accordion {...props} />);
const accordionButton = screen.getByRole("button", {
name: props.items[0].title?.value,
});
// # Full Manual Query:
// (This is actually not good - getByText won't respect eg aria- attrs like getByRole so we aren't actually testing anything)
// These are [not exposed to a11y tree](https://testing-library.com/docs/queries/about/#priority)
// 👉
// screen.getByText(
// /proin laoreet mauris vel urna tempor ultricies\. duis rhoncus lorem sed tellus egestas bibendum\. in aliquam mauris est, vel condimentum metus aliquet a\. nunc volutpat tincidunt nisl luctus pretium\. sagittis elit non, vestibulum metus\. mauris maximus vitae magna in mattis\. integer interdum maximus felis sed placerat\. nam lobortis tellus non felis fermentum, vitae venenatis ligula congue\. donec sit amet luctus odio\. magna commodo, sodales convallis ante scelerisque\. etiam ipsum lorem, rhoncus a sapien id, placerat consequat nunc\. curabitur in orci libero\. morbi tincidunt ante vel sem rutrum tempor\. cras ac purus quis urna maximus volutpat\./i
// );
// # We can still do a findByText,
// but we need to check ourselves whether it is accessible:
// 👉
const hiddenText = await screen.findByText((content, element) => {
const hasTextContent =
element?.innerHTML === props?.items[0]?.text?.value;
return hasTextContent;
});
expect(hiddenText).toBeInTheDocument();
expect(hiddenText).toHaveAttribute("aria-hidden", "true");
await userEvent.click(accordionButton);
// # Compare against textContent stripHTMLTags:
// (similar to https://polvara.me/posts/five-things-you-didnt-know-about-testing-library)
// 👉
// const noTag = stripHTMLTags(props?.items?.[0]?.text?.value as string);
// const [revealedText] = await screen.findAllByText(
// // @ts-ignore
// // eslint-disable-next-line
// (content, element) => element?.textContent === noTag
// // ? console.log('🔥', content) || true : false
// );
// expect(revealedText).toBeInTheDocument();
// console.log('😳', noTag);
// 😳 Proin laoreet mauris vel urna tempor ultricies. Duis rhoncus lorem sed tellus egestas bibendum. In aliquam mauris est, vel condimentum metus aliquet a. Nunc volutpat tincidunt nisl luctus pretium. Duis et ligula semper, sagittis elit non, vestibulum metus. Mauris maximus vitae magna in mattis. Integer interdum maximus felis sed placerat. Nam lobortis tellus non felis fermentum, vitae venenatis ligula congue. Donec sit amet luctus odio. Nam convallis justo vitae magna commodo, sodales convallis ante scelerisque. Etiam ipsum lorem, rhoncus a sapien id, placerat consequat nunc. Curabitur in orci libero. Morbi tincidunt ante vel sem rutrum tempor. Cras ac purus quis urna maximus volutpat.
// # Find by innerHTML:
// 👉
const revealedText = await screen.findByText((content, element) => {
const hasTextContent =
element?.innerHTML === props?.items[0]?.text?.value;
return hasTextContent;
});
expect(revealedText).toBeInTheDocument();
expect(revealedText).toHaveAttribute("aria-hidden", "false");
});
// Overall, probably ultimately more durable / less error prone to use a testid and check aria- attrs
it.skip("renders the correct default style", () => {
const { rerender } = renderWithCTX(<Accordion {...props} />);
const button = screen.getByRole("button", {
name: /accordion trigger one/i,
});
expect(button).toHaveClass(themeMap.default.button);
const altThemeProp = { ...props, theme: "footer" } as const;
rerender(<Accordion {...altThemeProp} />);
expect(button).toHaveClass(themeMap?.footer?.button);
});
});Last updated