• This repository has been archived on 11/Feb/2021
  • Stars
    star
    124
  • Rank 279,328 (Top 6 %)
  • Language
    CSS
  • License
    MIT License
  • Created almost 4 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🦩 Which query should I use?

⚠️ Deprecation notice ⚠️

This repository has been deprecated in favor of Testing Playground, which contains the functionality provided here and can be downloaded through the Chrome Web Store.

@testing-library/which-query

flamingo

🦩 Which query should I use: the chrome extension


Build Status Code Coverage version downloads MIT License

All Contributors PRs Welcome Code of Conduct

The problem

When using testing-library, some developers may not be aware of which query to use. As a result, folks will jump to using escape hatches like *ByTestId or querySelector.

This solution

This 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.

Table of Contents

Installation

Install from the chrome web store

From github releases (for previous versions)

  1. Download a release from the releases page.

  2. Unzip the file

  3. make sure developer mode is on

  4. Click "Load Unpacked"

  5. Browse to '/path/to/where/you/unzipped

  6. click select

From source:

  1. clone & install:
git clone [email protected]:testing-library/which-query.git
cd which-query
npm i
npm run build:chrome:dev
  1. in chrome navigate to chrome://extensions

  2. make sure developer mode is on

  3. Click "Load Unpacked"

  4. Browse to '/path/to/where/you/cloned/chrome/build/unpacked'

  5. click select

Usage

demo of which query extension

Use Testing Library in the browser console

Get a Query by inspecting elements in devtools

Inspiration

This tweet thread

Other Solutions

I'm not aware of any, if you are please make a pull request and add it here!

Issues

Looking to contribute? Look for the Good First Issue label.

πŸ› Bugs

Please file an issue for bugs, missing documentation, or unexpected behavior.

See Bugs

πŸ’‘ Feature Requests

Please file an issue to suggest new features. Vote on feature requests by adding a πŸ‘. This helps maintainers prioritize what to work on.

See Feature Requests

Contributors ✨

Thanks goes to these people (emoji key):


Ben Monro

πŸ’» ⚠️ πŸ€” πŸ“–

Stephan Meijer

πŸ€”

Kent C. Dodds

πŸ€”

Nick McCurdy

πŸ’»

This project follows the all-contributors specification. Contributions of any kind welcome!

LICENSE

MIT

More Repositories

1

react-testing-library

🐐 Simple and complete React DOM testing utilities that encourage good testing practices.
JavaScript
18,655
star
2

react-hooks-testing-library

🐏 Simple and complete React hooks testing utilities that encourage good testing practices.
TypeScript
5,083
star
3

jest-dom

πŸ¦‰ Custom jest matchers to test the state of the DOM
JavaScript
4,303
star
4

dom-testing-library

πŸ™ Simple and complete DOM testing utilities that encourage good testing practices.
JavaScript
3,234
star
5

user-event

πŸ• Simulate user events
TypeScript
2,119
star
6

cypress-testing-library

πŸ… Simple and complete custom Cypress commands and utilities that encourage good testing practices.
JavaScript
1,782
star
7

vue-testing-library

🦎 Simple and complete Vue.js testing utilities that encourage good testing practices.
JavaScript
1,047
star
8

eslint-plugin-testing-library

ESLint plugin to follow best practices and anticipate common mistakes when writing tests with Testing Library
TypeScript
958
star
9

testing-playground

Simple and complete DOM testing playground that encourage good testing practices.
JavaScript
770
star
10

angular-testing-library

πŸ¦” Simple and complete Angular testing utilities that encourage good testing practices
TypeScript
626
star
11

svelte-testing-library

🐿️ Simple and complete Svelte DOM testing utilities that encourage good testing practices
JavaScript
601
star
12

native-testing-library

🐳 Simple and complete React Native testing utilities that encourage good testing practices.
JavaScript
516
star
13

testing-library-docs

docs site for @testing-library/*
JavaScript
442
star
14

jest-native

πŸ¦… Custom jest matchers to test the state of React Native
TypeScript
432
star
15

eslint-plugin-jest-dom

eslint rules for use with jest-dom
JavaScript
352
star
16

pptr-testing-library

puppeteer + dom-testing-library = πŸ’–
TypeScript
283
star
17

playwright-testing-library

πŸ” Find elements in Playwright with queries from Testing Library
TypeScript
246
star
18

testing-library-recorder-extension

Testing Library Extension for Chrome DevTools Recorder
TypeScript
144
star
19

preact-testing-library

Simple and complete Preact DOM testing utilities that encourage good testing practices.
JavaScript
139
star
20

testcafe-testing-library

πŸ‚ Simple and complete custom Selectors for Testcafe that encourage good testing practices.
TypeScript
71
star
21

preact-hooks-testing-library

Simple and complete Preact hooks testing utilities that encourage good testing practices.
TypeScript
56
star
22

jasmine-dom

πŸ¦₯ Custom Jasmine matchers to test the state of the DOM
JavaScript
45
star
23

nightwatch-testing-library

πŸ¦‡Simple and complete custom queries for Nightwatch that encourage good testing practices.
JavaScript
31
star
24

dom-testing-library-template

Template repository for bug reports to @testing-library/dom, @testing-library/react, and @testing-library/jest-dom
JavaScript
17
star
25

webdriverio-testing-library

πŸ•·οΈ Simple and complete WebdriverIO DOM testing utilities that encourage good testing practices.
TypeScript
16
star
26

native-testing-library-docs

🐳 Docs site for native-testing-library
JavaScript
16
star
27

react-testing-library-help

Fork this repo to reproduce your issue
HTML
12
star
28

web-testing-library

πŸ™ Experimental Web testing utilities that encourage good testing practices.
JavaScript
3
star