{"bugs":{"url":"https://github.com/kentcdodds/dom-testing-library/issues"},"dist":{"shasum":"c45f7ecfdde10eb17f2b810a9a9840c2e5522df9","tarball":"https://registry.npmjs.org/dom-testing-library/-/dom-testing-library-4.0.0-alpha.0.tgz","fileCount":66,"integrity":"sha512-tJRQVKtBujrUXxReJcXybVPfLAhYg7BcwrHlc/Vf3mkPIeVW++fq4ZtF48N9z3bLqD+rUtKrAVV+6CdYsww/og==","signatures":[{"sig":"MEQCIEiH/Fa5d+8fcasLkZJHwIoe56CVSfrHvq+6M3vXUBgaAiBel8bf1hKKVOUlukB/OomOldhr4OutJE+FIanNqGM5Yw==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":253676,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJcuQYCCRA9TVsSAnZWagAAZOUP/iorcUO5z5kkv6iIXzIm\n1WJ10zu+X2K2qgIZyp3f2Lmd6Zx92kaJ17JZZiCI5MvujzLfMOSRrlZnmHm7\nRLTuEhn90xiaVwRF6ElAL8aQwJFIiAHGocPSZs2IaiFgHxNGwkbB9LKMDKo4\nRvO7PVVVH65Az9aycrKxHpa5H8h/Qnw+BrqVtJxFBADng9wjMw9PQrU7I1Dt\ntePp4z6L8Rc4nxwLTJsB9U24zM2Lh1odJZMeiDq6basLDkH8gc3zoVa/sFQo\nnzHuft1hIghtCNLdJS+FXQi2+oD31pPN2Xaf4B66n+wsdR16vbaXkAOwziit\njGdcAkcR+WO2MyLbku0lEz53BiIv7QsK8w5xmO1/kHK5xmjvBcsJmxlEPlZE\n1La9Uel6OG1fJhNHCscrLLTDUOtRNSdIYpQNNltllPJAewYXzGV7u/F8jzP/\nb0jF+atMe8fLHdG2FN4PS/oqQJiaZxvQFRLKgwEpvYLUUKCceFOz4SNuEP1v\nc1H3bEvEdl9GxCmJczFWjQKrllT2+OLIRwoFv2qBswu4bsDALU9bpMOoiswm\nqoMWGg7FQlRVHLdYAI2DuyKzM05KQGhMwJmNVFCk7PoTW6dHBHXiynleShAr\ndzIHYiXu6icb2VyEj9G8F3CpK3kwNNitYEktiDefk+YdySb6oRsic13msQ/S\nv1gP\r\n=CAXd\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/index.js","name":"dom-testing-library","husky":{"hooks":{"pre-commit":"kcd-scripts pre-commit"}},"author":{"url":"http://kentcdodds.com/","name":"Kent C. Dodds","email":"kent@doddsfamily.us"},"module":"dist/dom-testing-library.esm.js","readme":"
\n

dom-testing-library

\n\n\n\"octopus\"\n\n\n

Simple and complete DOM testing utilities that encourage good testing practices.

\n\n[**Read the docs**](https://testing-library.com/) | [Edit the docs](https://github.com/alexkrolick/testing-library-docs)\n\n
\n\n
\n\n\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-54-orange.svg?style=flat-square)](#contributors)\n[![PRs Welcome][prs-badge]][prs]\n[![Code of Conduct][coc-badge]][coc]\n\n[![Watch on GitHub][github-watch-badge]][github-watch]\n[![Star on GitHub][github-star-badge]][github-star]\n[![Tweet][twitter-badge]][twitter]\n\n\n
\n\n\"TestingJavaScript.com\n\n
\n\n## Table of Contents\n\n\n\n\n- [The Problem](#the-problem)\n- [This Solution](#this-solution)\n- [Installation](#installation)\n- [Implementations](#implementations)\n- [Other Solutions](#other-solutions)\n- [Guiding Principles](#guiding-principles)\n- [Contributors](#contributors)\n- [LICENSE](#license)\n\n\n\n## The Problem\n\nYou want to write maintainable tests for your Web UI. As a part of\nthis goal, you want your tests to avoid including implementation details of\nyour components and rather focus on making your tests give you the confidence\nfor which they are intended. As part of this, you want your testbase to be\nmaintainable in the long run so refactors of your components (changes to\nimplementation but not functionality) don't break your tests and slow you and\nyour team down.\n\n## This Solution\n\nThe `dom-testing-library` is a very light-weight solution for testing DOM nodes\n(whether simulated with [`JSDOM`](https://github.com/jsdom/jsdom) as provided by\ndefault with [Jest][] or in the browser). The main utilities it provides involve\nquerying the DOM for nodes in a way that's similar to how the user finds\nelements on the page. In this way, the library helps ensure your tests give you\nconfidence in your UI code. The `dom-testing-library`'s primary guiding\nprinciple is:\n\n> [The more your tests resemble the way your software is used, the more confidence they can give you.][guiding-principle]\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 dom-testing-library\n```\n\n> [**Docs**](https://testing-library.com/docs/install)\n\n## Implementations\n\nThis library was not built to be used on its own. The original implementation\nof these utilities was in the `react-testing-library`.\n\nImplementations include:\n\n- [`react-testing-library`](https://github.com/kentcdodds/react-testing-library)\n- [`pptr-testing-library`](https://github.com/patrickhulce/pptr-testing-library)\n- [`cypress-testing-library`](https://github.com/kentcdodds/cypress-testing-library)\n- [`vue-testing-library`](https://github.com/dfcook/vue-testing-library)\n- [`snabbdom-testing-library`](https://github.com/lukaszmakuch/snabbdom-testing-library)\n\n## Other Solutions\n\n- [browser-monkey](https://github.com/featurist/browser-monkey)\n\n## Guiding Principles\n\n> [The more your tests resemble the way your software is used, the more confidence they can give you.][guiding-principle]\n\nWe try to only expose methods and utilities that encourage you to write tests\nthat closely resemble how your web pages are used.\n\nUtilities are included in this project based on the following guiding\nprinciples:\n\n1. If it relates to rendering components, it deals with DOM nodes rather than\n component instances, nor should it encourage dealing with component\n instances.\n2. It should be generally useful for testing the application components in the\n way the user would use it. We _are_ making some trade-offs here because\n we're using a computer and often a simulated browser environment, but in\n general, utilities should encourage tests that use the components the way\n they're intended to be used.\n3. Utility implementations and APIs should be simple and flexible.\n\nAt the end of the day, what we want is for this library to be pretty\nlight-weight, simple, and understandable.\n\n## Contributors\n\nThanks goes to these people ([emoji key][emojis]):\n\n\n\n
\"Kent
Kent C. Dodds
πŸ’» πŸ“– πŸš‡ ⚠️		\"Ryan
Ryan Castner
πŸ“–		\"Daniel
Daniel Sandiego
πŸ’»		\"PaweΕ‚
PaweΕ‚ MikoΕ‚ajczyk
πŸ’»		\"Alejandro
Alejandro ÑÑñez Ortiz
πŸ“–		\"Matt
Matt Parrish
πŸ› πŸ’» πŸ“– ⚠️		\"Justin
Justin Hall
πŸ“¦
\"Anto
Anto Aravinth
πŸ’» ⚠️ πŸ“–		\"Jonah
Jonah Moses
πŸ“–		\"Łukasz
Łukasz Gandecki
πŸ’» ⚠️ πŸ“–		\"Ivan
Ivan Babak
πŸ› πŸ€” πŸ’» πŸ“–		\"Jesse
Jesse Day
πŸ’»		\"Ernesto
Ernesto GarcΓ­a
πŸ’¬ πŸ’» πŸ“–		\"Josef
Josef Maxx Blake
πŸ’» πŸ“– ⚠️
\"Alex
Alex Cook
πŸ“– πŸ’‘ πŸ‘€		\"Daniel
Daniel Cook
πŸ’» πŸ“– ⚠️		\"Thomas
Thomas Chia
πŸ› πŸ’»		\"Tim
Tim Deschryver
πŸ’» ⚠️		\"Alex
Alex Krolick
πŸ’»		\"Maddi
Maddi Joyce
πŸ’»		\"Peter
Peter Kamps
πŸ› πŸ’» ⚠️
\"Jonathan
Jonathan Stoye
πŸ“–		\"Sanghyeon
Sanghyeon Lee
πŸ’‘		\"Justice
Justice Mba
πŸ’» πŸ“– πŸ€”		\"Wayne
Wayne Crouch
πŸ’»		\"Ben
Ben Elliott
πŸ’»		\"Ruben
Ruben Costa
πŸ’»		\"Robert
Robert Smith
πŸ› πŸ€” πŸ“–
\"dadamssg\"/
dadamssg
πŸ’»		\"Neil
Neil Kistner
πŸ’»		\"Ben
Ben Chauvette
πŸ’»		\"Jeff
Jeff Baumgardt
πŸ’» πŸ“–		\"Matan
Matan Kushner
πŸ’» πŸ“– πŸ€” ⚠️		\"Alex
Alex Wendte
πŸ’» πŸ“– ⚠️		\"Tamas
Tamas Fodor
πŸ“–
\"Benjamin
Benjamin Eckardt
πŸ’»		\"Ryan
Ryan Campbell
πŸ“–		\"Taylor
Taylor Briggs
⚠️		\"John
John Gozde
πŸ’»		\"C.
C. T. Lin
πŸ“–		\"Terrence
Terrence Wong
πŸ’»		\"Soo
Soo Jae Hwang
πŸ’»
\"Royston
Royston Shufflebotham
πŸ› πŸ’» πŸ“– ⚠️		\"Vadim
Vadim Brodsky
πŸ’»		\"Eunjae
Eunjae Lee
πŸ’»		\"David
David Peter
πŸ’»		\"Shy
Shy Alter
πŸ’» πŸ“–		\"Łukasz
Łukasz Makuch
πŸ“¦		\"Tyler
Tyler Haas
πŸ’» ⚠️
\"Vesa
Vesa Laakso
πŸ’» ⚠️		\"Tulsi
Tulsi Sapkota
πŸ’»		\"Tiago
Tiago Nunes
πŸ’» ⚠️		\"JaxCavalera\"/
JaxCavalera
πŸ’» πŸ‘€		\"bopfer\"/
bopfer
⚠️
\n\n\n\nThis project follows the [all-contributors][all-contributors] specification.\nContributions of any kind welcome!\n\n## LICENSE\n\nMIT\n\n[npm]: https://www.npmjs.com/\n[node]: https://nodejs.org\n[build-badge]: https://img.shields.io/travis/kentcdodds/dom-testing-library.svg?style=flat-square\n[build]: https://travis-ci.org/kentcdodds/dom-testing-library\n[coverage-badge]: https://img.shields.io/codecov/c/github/kentcdodds/dom-testing-library.svg?style=flat-square\n[coverage]: https://codecov.io/github/kentcdodds/dom-testing-library\n[version-badge]: https://img.shields.io/npm/v/dom-testing-library.svg?style=flat-square\n[package]: https://www.npmjs.com/package/dom-testing-library\n[downloads-badge]: https://img.shields.io/npm/dm/dom-testing-library.svg?style=flat-square\n[npmtrends]: http://www.npmtrends.com/dom-testing-library\n[license-badge]: https://img.shields.io/npm/l/dom-testing-library.svg?style=flat-square\n[license]: https://github.com/kentcdodds/dom-testing-library/blob/master/LICENSE\n[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\n[prs]: http://makeapullrequest.com\n[donate-badge]: https://img.shields.io/badge/$-support-green.svg?style=flat-square\n[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square\n[coc]: https://github.com/kentcdodds/dom-testing-library/blob/master/CODE_OF_CONDUCT.md\n[github-watch-badge]: https://img.shields.io/github/watchers/kentcdodds/dom-testing-library.svg?style=social\n[github-watch]: https://github.com/kentcdodds/dom-testing-library/watchers\n[github-star-badge]: https://img.shields.io/github/stars/kentcdodds/dom-testing-library.svg?style=social\n[github-star]: https://github.com/kentcdodds/dom-testing-library/stargazers\n[twitter]: https://twitter.com/intent/tweet?text=Check%20out%20dom-testing-library%20by%20%40kentcdodds%20https%3A%2F%2Fgithub.com%2Fkentcdodds%2Fdom-testing-library%20%F0%9F%91%8D\n[twitter-badge]: https://img.shields.io/twitter/url/https/github.com/kentcdodds/dom-testing-library.svg?style=social\n[emojis]: https://github.com/kentcdodds/all-contributors#emoji-key\n[all-contributors]: https://github.com/kentcdodds/all-contributors\n[set-immediate]: https://developer.mozilla.org/en-US/docs/Web/API/Window/setImmediate\n[guiding-principle]: https://twitter.com/kentcdodds/status/977018512689455106\n[data-testid-blog-post]: https://blog.kentcdodds.com/making-your-ui-tests-resilient-to-change-d37a6ee37269\n[jest]: https://facebook.github.io/jest\n","source":"src/index.js","engines":{"node":">=8"},"gitHead":"21fdfde7b2efc02ac7a00998e6400504332cf16a","license":"MIT","scripts":{"lint":"kcd-scripts lint","test":"kcd-scripts test","build":"kcd-scripts build && kcd-scripts build --bundle --no-clean","setup":"npm install && npm run validate -s","dtslint":"dtslint typings","validate":"kcd-scripts validate","test:update":"npm test -- --updateSnapshot --coverage"},"typings":"typings","_npmUser":{"name":"kentcdodds","email":"kent@doddsfamily.us"},"homepage":"https://github.com/kentcdodds/dom-testing-library#readme","keywords":["testing","ui","dom","jsdom","unit","integration","functional","end-to-end","e2e"],"umd:main":"dist/dom-testing-library.umd.js","repository":{"url":"git+https://github.com/kentcdodds/dom-testing-library.git","type":"git"},"_npmVersion":"6.9.0","description":"Simple and complete DOM testing utilities that encourage good testing practices.","directories":{},"maintainers":[{"name":"kentcdodds","email":"kent@doddsfamily.us"}],"_nodeVersion":"10.15.3","dependencies":{"pretty-format":"^24.5.0","@babel/runtime":"^7.3.4","wait-for-expect":"^1.1.0","@sheerun/mutationobserver-shim":"^0.3.2"},"eslintConfig":{"rules":{"import/no-unassigned-import":"off","import/prefer-default-export":"off","import/no-useless-path-segments":"off"},"extends":"./node_modules/kcd-scripts/eslint.js"},"eslintIgnore":["node_modules","coverage","dist"],"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"dtslint":"^0.5.3","jest-dom":"^3.1.2","kcd-scripts":"^1.1.0","jest-in-case":"^1.0.2"},"_npmOperationalInternal":{"tmp":"tmp/dom-testing-library_4.0.0-alpha.0_1555629569090_0.5997102492951105","host":"s3://npm-registry-packages"},"_id":"dom-testing-library@4.0.0-alpha.0","version":"4.0.0-alpha.0"}