testing-library-queries

testing-library-queries is a library that extends Testing Library with a composable, chainable query API. It addresses common pain points like verbose syntax, lack of strong TypeScript inference, and difficulty creating reusable query logic, making tests cleaner and more maintainable.

Key Features

• Composable Query Builder — Create complex queries using intersect(), transform(), and other builders.
• Chaining API — Compose multi-step queries where each result becomes the container for the next.
• Full TypeScript Support — Strongly typed with excellent IDE autocomplete and inference.
• CSS Selector Queries — Built-in getBySelector() and similar methods for raw CSS selectors.
• Concise Syntax — Use screen.get(by.role('button')) as a shorthand alternative.
• Custom Query Helpers — Build reusable query logic with buildQuery.from().
• Framework Agnostic — Works with React, Vue, Angular, or any Testing Library setup.

Philosophy

The library is designed to enhance Testing Library's core principles by providing a more flexible and type-safe API for query composition, encouraging cleaner test code without sacrificing accessibility best practices.