react-testing-library-utils v1.11.0
react-testing-library-utils
react-testing-library-utils is a utility wrapper around Jest and React Testing Library that simplifies and shortens common test operations. It provides easy-to-use utility functions such as isTruthy
, isFalsy
, and others, helping to make your tests cleaner and more expressive. By wrapping frequently used assertions and actions, this library speeds up test development and improves readability.
Key Features
- Simplified test utility functions like
isTruthy
,isFalsy
, and more. - Reduces boilerplate in your Jest and React Testing Library tests.
- Improves test readability and maintainability.
Installation
npm install react-testing-library-utils -D
Utility Functions
isTruthy
Checks if a given element containing the provided text is present in the DOM.
import { isTruthy } from 'react-testing-library-utils';
isTruthy('Submit'); // Asserts if an element with text 'Submit' exists
Parameters:
text: string
- The text content to search for.options?: MatcherOptions
- Optional matching options from React Testing Library.
Returns:
- The matching element if it exists.
isFalsy
Checks if no element containing the provided text is present in the DOM.
import { isFalsy } from 'react-testing-library-utils';
isFalsy('Cancel'); // Asserts if no element with text 'Cancel' exists
Parameters:
text: string
- The text content to search for.options?: SelectorMatcherOptions
- Optional selector matching options from React Testing Library.
isLabelTruthy
Checks if a form element with the given label text is present in the DOM.
import { isLabelTruthy } from 'react-testing-library-utils';
isLabelTruthy('Username'); // Asserts if an element with the label 'Username' exists
Parameters:
label: string
- The label text to search for.options?: SelectorMatcherOptions
- Optional selector matching options.
Returns:
- The matching element if it exists.
isLabelFalsy
Checks if no form element with the given label text is present in the DOM.
import { isLabelFalsy } from 'react-testing-library-utils';
isLabelFalsy('Password'); // Asserts if no element with the label 'Password' exists
Parameters:
label: string
- The label text to search for.options?: SelectorMatcherOptions
- Optional selector matching options.
isAsyncLabelTruthy
Asynchronously checks if a form element with the given label text is present in the DOM.
import { isAsyncLabelTruthy } from 'react-testing-library-utils';
await isAsyncLabelTruthy('Email'); // Asserts if an element with the label 'Email' exists asynchronously
Parameters:
label: string
- The label text to search for.options?: SelectorMatcherOptions
- Optional selector matching options.
Returns:
- The matching element if it exists.
isTestIdTruthy
Checks if an element with the given data-testid
is present in the DOM.
import { isTestIdTruthy } from 'react-testing-library-utils';
isTestIdTruthy('submit-button'); // Asserts if an element with the test ID 'submit-button' exists
Parameters:
testId: string
- The test ID to search for.options?: MatcherOptions
- Optional matching options.
Returns:
- The matching element if it exists.
isTestIdFalsy
Checks if no element with the given data-testid
is present in the DOM.
import { isTestIdFalsy } from 'react-testing-library-utils';
isTestIdFalsy('cancel-button'); // Asserts if no element with the test ID 'cancel-button' exists
Parameters:
testId: string
- The test ID to search for.options?: MatcherOptions
- Optional matching options.
8 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago