This package is a wrapper for react-testing-library, providing a more convenient way to test React components.
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.
isTruthy, isFalsy, and more.``bash`
npm install react-testing-library-utils -D
`ts
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.
`ts
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.
`ts
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.
`ts
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.
`ts
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.
is present in the DOM.`ts
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.
$3
Checks if no element with the given data-testid is present in the DOM.`ts
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.