{"id":47677958,"url":"https://github.com/balavishnuvj/rtl-simple-queries","last_synced_at":"2026-04-02T13:38:33.446Z","repository":{"id":101627220,"uuid":"297733888","full_name":"balavishnuvj/rtl-simple-queries","owner":"balavishnuvj","description":"Simple wrapper queries for @testing-library/react","archived":false,"fork":false,"pushed_at":"2021-07-20T03:43:23.000Z","size":57,"stargazers_count":20,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-15T13:59:00.564Z","etag":null,"topics":["react","react-testing","testing-library-react","testing-tools"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/balavishnuvj.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-22T18:14:49.000Z","updated_at":"2024-03-06T08:27:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9bbb57a-e60d-475a-9ca1-ccc46d5e0f18","html_url":"https://github.com/balavishnuvj/rtl-simple-queries","commit_stats":{"total_commits":16,"total_committers":5,"mean_commits":3.2,"dds":0.5,"last_synced_commit":"8f31e93dbd548c1297009dc7d1417becaea63784"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/balavishnuvj/rtl-simple-queries","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/balavishnuvj%2Frtl-simple-queries","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/balavishnuvj%2Frtl-simple-queries/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/balavishnuvj%2Frtl-simple-queries/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/balavishnuvj%2Frtl-simple-queries/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/balavishnuvj","download_url":"https://codeload.github.com/balavishnuvj/rtl-simple-queries/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/balavishnuvj%2Frtl-simple-queries/sbom","scorecard":{"id":224356,"data":{"date":"2025-08-11","repo":{"name":"github.com/balavishnuvj/rtl-simple-queries","commit":"8f31e93dbd548c1297009dc7d1417becaea63784"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":2,"reason":"Found 2/8 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 16 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T03:21:15.667Z","repository_id":101627220,"created_at":"2025-08-17T03:21:15.667Z","updated_at":"2025-08-17T03:21:15.667Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["react","react-testing","testing-library-react","testing-tools"],"created_at":"2026-04-02T13:38:33.373Z","updated_at":"2026-04-02T13:38:33.437Z","avatar_url":"https://github.com/balavishnuvj.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1\u003ertl-simple-queries\u003c/h1\u003e\n\n\u003cp\u003eSimple wrapper queries for @testing-library/react\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n\u003c!-- prettier-ignore-start --\u003e\n[![Build Status][build-badge]][build]\n[![Code Coverage][coverage-badge]][coverage]\n[![version][version-badge]][package]\n[![downloads][downloads-badge]][npmtrends]\n[![MIT License][license-badge]][license]\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-4-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n[![PRs Welcome][prs-badge]][prs]\n[![Code of Conduct][coc-badge]][coc]\n\u003c!-- prettier-ignore-end --\u003e\n\n## The problem\n\nTo get an element from while testing with -\n[@testing-library/react](https://github.com/testing-library/react-testing-library),\nwe have 6 variants viz. `getBy`, `getAllBy`, `queryBy`, `queryAllBy`, `findBy`,\nand `findAllBy`.\n\nWe have to remember which one to use when. The name of methods is entirely a\nfamiliarity thing. But just by the name of the method it bit difficult to know\nwhich one would throw error if an element is not found or which takes into account async updates.\n\n## This solution\n\nThis library wraps those methods with easier to remember APIs\n\n## Table of Contents\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Other Solutions](#other-solutions)\n- [Issues](#issues)\n  - [🐛 Bugs](#-bugs)\n  - [💡 Feature Requests](#-feature-requests)\n- [Contributors ✨](#contributors-)\n- [LICENSE](#license)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Installation\n\nThis module is distributed via [npm][npm] which is bundled with [node][node] and\nshould be installed as one of your project's `devDependencies`:\n\n```\nnpm install --save-dev rtl-simple-queries\n```\n\n## Usage\n\n`screen` can be exported from `'rtl-simple-queries'`\n\nAddional parameters from sync query `allowEmpty` and `allowMultiple` and for\nasync we only have one option `allowMultiple`\n\n```javascript\nimport {screen} from 'rtl-simple-queries'\n\nscreen.fetchByText(/text/, {allowEmpty: true, allowMultiple: false})\nscreen.fetchByText(/text/, {allowMultiple: false})\nscreen.fetchByText(/text/)\n\n// async\nawait screen.fetchByTextAsync(/text/, {allowMultiple: true})\n```\n\nTo use queies for scoped container we could do\n\n```javascript\n// test-utils. js\nfunction render(component, options) {\n  const utils = rtlRender(component, options)\n  const queries = getSimpleQueries(utils)\n  return {...utils, ...renderSyncQueries}\n}\n\n// use this render instead of importing from @testing-library/react\nconst {fetchByText} = render(\u003cp\u003etext\u003c/p\u003e)\n```\n\n## Other Solutions\n\nYou can refer to\n[cheatsheet](https://testing-library.com/docs/react-testing-library/cheatsheet#queries)\nas a quick reference.\n\n## Issues\n\n_Looking to contribute? Look for the [Good First Issue][good-first-issue]\nlabel._\n\n### 🐛 Bugs\n\nPlease file an issue for bugs, missing documentation, or unexpected behavior.\n\n[**See Bugs**][bugs]\n\n### 💡 Feature Requests\n\nPlease file an issue to suggest new features. Vote on feature requests by adding\na 👍. This helps maintainers prioritize what to work on.\n\n[**See Feature Requests**][requests]\n\n## Contributors ✨\n\nThanks goes to these people ([emoji key][emojis]):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/balavishnuvj\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/13718688\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eBalavishnu V J\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/balavishnuvj/rtl-simple-queries/commits?author=balavishnuvj\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/balavishnuvj/rtl-simple-queries/commits?author=balavishnuvj\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"#infra-balavishnuvj\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e \u003ca href=\"https://github.com/balavishnuvj/rtl-simple-queries/commits?author=balavishnuvj\" title=\"Tests\"\u003e⚠️\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://kentcdodds.com\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/1500684?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eKent C. Dodds\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-kentcdodds\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/balavishnuvj/rtl-simple-queries/commits?author=kentcdodds\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"http://www.pcoroneos.com\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/40515238?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ePaul Coroneos\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/balavishnuvj/rtl-simple-queries/commits?author=PaulACoroneos\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/adamochayon\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/2094874?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAdam Ochayon\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/balavishnuvj/rtl-simple-queries/commits?author=adamochayon\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-enable --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors][all-contributors] specification.\nContributions of any kind welcome!\n\n## LICENSE\n\nMIT\n\n\u003c!-- prettier-ignore-start --\u003e\n[npm]: https://www.npmjs.com\n[node]: https://nodejs.org\n[build-badge]: https://img.shields.io/travis/com/balavishnuvj/rtl-simple-queries.svg?style=flat-square\n[build]: https://travis-ci.com/balavishnuvj/rtl-simple-queries\n[coverage-badge]: https://img.shields.io/codecov/c/github/balavishnuvj/rtl-simple-queries.svg?style=flat-square\n[coverage]: https://codecov.io/github/balavishnuvj/rtl-simple-queries\n[version-badge]: https://img.shields.io/npm/v/rtl-simple-queries.svg?style=flat-square\n[package]: https://www.npmjs.com/package/rtl-simple-queries\n[downloads-badge]: https://img.shields.io/npm/dm/rtl-simple-queries.svg?style=flat-square\n[npmtrends]: http://www.npmtrends.com/rtl-simple-queries\n[license-badge]: https://img.shields.io/npm/l/rtl-simple-queries.svg?style=flat-square\n[license]: https://github.com/balavishnuvj/rtl-simple-queries/blob/master/LICENSE\n[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\n[prs]: http://makeapullrequest.com\n[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square\n[coc]: https://github.com/balavishnuvj/rtl-simple-queries/blob/master/other/CODE_OF_CONDUCT.md\n[emojis]: https://github.com/all-contributors/all-contributors#emoji-key\n[all-contributors]: https://github.com/all-contributors/all-contributors\n[bugs]: https://github.com/balavishnuvj/rtl-simple-queries/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aopen+sort%3Acreated-desc+label%3Abug\n[requests]: https://github.com/balavishnuvj/rtl-simple-queries/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+label%3Aenhancement\n[good-first-issue]: https://github.com/balavishnuvj/rtl-simple-queries/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+label%3Aenhancement+label%3A%22good+first+issue%22\n\u003c!-- prettier-ignore-end --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbalavishnuvj%2Frtl-simple-queries","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbalavishnuvj%2Frtl-simple-queries","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbalavishnuvj%2Frtl-simple-queries/lists"}