{"id":13722170,"url":"https://github.com/testing-library/which-query","last_synced_at":"2025-05-07T14:31:11.484Z","repository":{"id":54550049,"uuid":"266569027","full_name":"testing-library/which-query","owner":"testing-library","description":"🦩 Which query should I use?","archived":true,"fork":false,"pushed_at":"2021-02-11T07:30:37.000Z","size":2319,"stargazers_count":123,"open_issues_count":0,"forks_count":9,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-29T15:21:26.552Z","etag":null,"topics":["chrome-extensions","dom-testing-library","react-testing-library","testcafe-testing-library","testing-library"],"latest_commit_sha":null,"homepage":null,"language":"CSS","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/testing-library.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}},"created_at":"2020-05-24T15:26:06.000Z","updated_at":"2025-03-10T15:49:33.000Z","dependencies_parsed_at":"2022-08-13T19:20:49.817Z","dependency_job_id":null,"html_url":"https://github.com/testing-library/which-query","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testing-library%2Fwhich-query","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testing-library%2Fwhich-query/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testing-library%2Fwhich-query/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testing-library%2Fwhich-query/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/testing-library","download_url":"https://codeload.github.com/testing-library/which-query/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895588,"owners_count":21821186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["chrome-extensions","dom-testing-library","react-testing-library","testcafe-testing-library","testing-library"],"created_at":"2024-08-03T01:01:25.312Z","updated_at":"2025-05-07T14:31:11.447Z","avatar_url":"https://github.com/testing-library.png","language":"CSS","readme":"# ⚠️ Deprecation notice ⚠️\n\nThis repository has been deprecated in favor of [Testing Playground](http://github.com/testing-library/testing-playground), which contains the functionality provided here and can be downloaded through the [Chrome Web Store](https://chrome.google.com/webstore/detail/testing-playground/hejbmebodbijjdhflfknehhcgaklhano).\n\n\n\u003cdiv align=\"center\"\u003e\n\u003ch1\u003e@testing-library/which-query\u003c/h1\u003e\n\u003ca href=\"https://www.joypixels.com/profiles/emoji/flamingo\"\u003e\n    \u003cimg\n    height=\"80\"\n    width=\"80\"\n    alt=\"flamingo\"\n    src=\"https://raw.githubusercontent.com/testing-library/which-query/master/other/flamingo.png\"\n  /\u003e\n\u003c/a\u003e\n\u003cp\u003e🦩 Which query should I use: the chrome extension\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[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)\n[![PRs Welcome][prs-badge]][prs]\n[![Code of Conduct][coc-badge]][coc]\n\u003c!-- prettier-ignore-end --\u003e\n\n## The problem\n\nWhen using testing-library, some developers may not be aware of\n[which query to use](https://testing-library.com/docs/guide-which-query). As a\nresult, folks will jump to using escape hatches like `*ByTestId` or\n`querySelector`.\n\n## This solution\n\nThis chrome extension aims to enable developers to find a better query when writing tests. Right click on an element on any web page and it will copy the best possible query for that element into your clipboard.  Then simply paste into your test code.\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- [Inspiration](#inspiration)\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\n[Install from the chrome web store](https://chrome.google.com/webstore/detail/testing-library-which-que/olmmagdolfehlpjmbkmondggbebeimoh)\n\n### From github releases (for previous versions)\n\n1. Download a release from the [releases](https://github.com/testing-library/which-query/releases) page.\n2. Unzip the file \n3. make sure developer mode is on\n\n4. Click \"Load Unpacked\"\n\n5. Browse to '/path/to/where/you/unzipped\n\n6. click select\n\n### From source:\n\n1. clone \u0026 install:\n\n```bash\ngit clone git@github.com:testing-library/which-query.git\ncd which-query\nnpm i\nnpm run build:chrome:dev\n```\n\n2. in chrome navigate to chrome://extensions\n\n3. make sure developer mode is on\n\n4. Click \"Load Unpacked\"\n\n5. Browse to '/path/to/where/you/cloned/chrome/build/unpacked'\n\n6. click select\n\n## Usage\n\n\u003cimg\n alt=\"demo of which query extension\"\n src=\"https://raw.githubusercontent.com/testing-library/which-query/master/other/demo.gif\" /\u003e\n\n[Use Testing Library in the browser console](https://youtu.be/g4i8k_Hue84)\n\n[Get a Query by inspecting elements in devtools](https://www.youtube.com/watch?v=bt8RGZB6Yyw)\n\n## Inspiration\n\n[This tweet thread](https://twitter.com/benmonro/status/1264551204127780870?s=20)\n\n## Other Solutions\n\nI'm not aware of any, if you are please [make a pull request][prs] and add it\nhere!\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/benmonro\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/399236?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eBen Monro\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/testing-library/which-query/commits?author=benmonro\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/testing-library/which-query/commits?author=benmonro\" title=\"Tests\"\u003e⚠️\u003c/a\u003e \u003ca href=\"#ideas-benmonro\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/testing-library/which-query/commits?author=benmonro\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/smeijer\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/1196524?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eStephan Meijer\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-smeijer\" title=\"Ideas, Planning, \u0026 Feedback\"\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\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://nickmccurdy.com/\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/927220?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eNick McCurdy\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/testing-library/which-query/commits?author=nickmccurdy\" title=\"Code\"\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/testing-library/which-query.svg?style=flat-square\n[build]: https://travis-ci.com/testing-library/which-query\n[coverage-badge]: https://img.shields.io/codecov/c/github/testing-library/which-query.svg?style=flat-square\n[coverage]: https://codecov.io/github/testing-library/which-query\n[version-badge]: https://img.shields.io/npm/v/@testing-library/which-query.svg?style=flat-square\n[package]: https://www.npmjs.com/package/@testing-library/which-query\n[downloads-badge]: https://img.shields.io/npm/dm/@testing-library/which-query.svg?style=flat-square\n[npmtrends]: http://www.npmtrends.com/@testing-library/which-query\n[license-badge]: https://img.shields.io/npm/l/@testing-library/which-query.svg?style=flat-square\n[license]: https://github.com/testing-library/which-query/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/testing-library/which-query/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/testing-library/which-query/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aopen+sort%3Acreated-desc+label%3Abug\n[requests]: https://github.com/testing-library/which-query/issues?utf8=%E2%9C%93\u0026q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+label%3Aenhancement\n[good-first-issue]: https://github.com/testing-library/which-query/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","funding_links":[],"categories":["CSS"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesting-library%2Fwhich-query","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftesting-library%2Fwhich-query","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesting-library%2Fwhich-query/lists"}