dom-testing-library - npm Package Compare versions

Comparing version 2.0.0 to 2.1.0

dist/queries.js

@@ -6,3 +6,3 @@ 'use strict';
 });
-exports.getAllByTitle = exports.getByTitle = exports.queryAllByTitle = exports.queryByTitle = exports.getAllByTestId = exports.getByTestId = exports.queryAllByTestId = exports.queryByTestId = exports.getAllByAltText = exports.getByAltText = exports.queryAllByAltText = exports.queryByAltText = exports.getAllByLabelText = exports.getByLabelText = exports.queryAllByLabelText = exports.queryByLabelText = exports.getAllByText = exports.getByText = exports.queryAllByText = exports.queryByText = exports.getAllByPlaceholderText = exports.getByPlaceholderText = exports.queryAllByPlaceholderText = exports.queryByPlaceholderText = undefined;
+exports.getAllByValue = exports.getByValue = exports.queryAllByValue = exports.queryByValue = exports.getAllByTitle = exports.getByTitle = exports.queryAllByTitle = exports.queryByTitle = exports.getAllByTestId = exports.getByTestId = exports.queryAllByTestId = exports.queryByTestId = exports.getAllByAltText = exports.getByAltText = exports.queryAllByAltText = exports.queryByAltText = exports.getAllByLabelText = exports.getByLabelText = exports.queryAllByLabelText = exports.queryByLabelText = exports.getAllByText = exports.getByText = exports.queryAllByText = exports.queryByText = exports.getAllByPlaceholderText = exports.getByPlaceholderText = exports.queryAllByPlaceholderText = exports.queryByPlaceholderText = undefined;
 
@@ -158,2 +158,4 @@ var _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; };
 var queryAllByTitle = queryAllByAttribute.bind(null, 'title');
+var queryByValue = queryByAttribute.bind(null, 'value');
+var queryAllByValue = queryAllByAttribute.bind(null, 'value');
 
@@ -229,3 +231,3 @@ function queryAllByAltText(container, alt) {
 
-function getAllByPlaceholderText(container, text) {
+function getAllByValue(container, value) {
   for (var _len10 = arguments.length, rest = Array(_len10 > 2 ? _len10 - 2 : 0), _key10 = 2; _key10 < _len10; _key10++) {
@@ -235,2 +237,22 @@ rest[_key10 - 2] = arguments[_key10];
 
+  var els = queryAllByValue.apply(undefined, [container, value].concat(rest));
+  if (!els.length) {
+    throw new Error(`Unable to find an element with the value: ${value}. \n\n${debugDOM(container)}`);
+  }
+  return els;
+}
+
+function getByValue() {
+  for (var _len11 = arguments.length, args = Array(_len11), _key11 = 0; _key11 < _len11; _key11++) {
+    args[_key11] = arguments[_key11];
+  }
+
+  return firstResultOrNull.apply(undefined, [getAllByValue].concat(args));
+}
+
+function getAllByPlaceholderText(container, text) {
+  for (var _len12 = arguments.length, rest = Array(_len12 > 2 ? _len12 - 2 : 0), _key12 = 2; _key12 < _len12; _key12++) {
+    rest[_key12 - 2] = arguments[_key12];
+  }
+
   var els = queryAllByPlaceholderText.apply(undefined, [container, text].concat(rest));
@@ -244,4 +266,4 @@ if (!els.length) {
 function getByPlaceholderText() {
-  for (var _len11 = arguments.length, args = Array(_len11), _key11 = 0; _key11 < _len11; _key11++) {
-    args[_key11] = arguments[_key11];
+  for (var _len13 = arguments.length, args = Array(_len13), _key13 = 0; _key13 < _len13; _key13++) {
+    args[_key13] = arguments[_key13];
   }
@@ -253,4 +275,4 @@
 function getAllByLabelText(container, text) {
-  for (var _len12 = arguments.length, rest = Array(_len12 > 2 ? _len12 - 2 : 0), _key12 = 2; _key12 < _len12; _key12++) {
-    rest[_key12 - 2] = arguments[_key12];
+  for (var _len14 = arguments.length, rest = Array(_len14 > 2 ? _len14 - 2 : 0), _key14 = 2; _key14 < _len14; _key14++) {
+    rest[_key14 - 2] = arguments[_key14];
   }
@@ -271,4 +293,4 @@
 function getByLabelText() {
-  for (var _len13 = arguments.length, args = Array(_len13), _key13 = 0; _key13 < _len13; _key13++) {
-    args[_key13] = arguments[_key13];
+  for (var _len15 = arguments.length, args = Array(_len15), _key15 = 0; _key15 < _len15; _key15++) {
+    args[_key15] = arguments[_key15];
   }
@@ -280,4 +302,4 @@
 function getAllByText(container, text) {
-  for (var _len14 = arguments.length, rest = Array(_len14 > 2 ? _len14 - 2 : 0), _key14 = 2; _key14 < _len14; _key14++) {
-    rest[_key14 - 2] = arguments[_key14];
+  for (var _len16 = arguments.length, rest = Array(_len16 > 2 ? _len16 - 2 : 0), _key16 = 2; _key16 < _len16; _key16++) {
+    rest[_key16 - 2] = arguments[_key16];
   }
@@ -293,4 +315,4 @@
 function getByText() {
-  for (var _len15 = arguments.length, args = Array(_len15), _key15 = 0; _key15 < _len15; _key15++) {
-    args[_key15] = arguments[_key15];
+  for (var _len17 = arguments.length, args = Array(_len17), _key17 = 0; _key17 < _len17; _key17++) {
+    args[_key17] = arguments[_key17];
   }
@@ -302,4 +324,4 @@
 function getAllByAltText(container, alt) {
-  for (var _len16 = arguments.length, rest = Array(_len16 > 2 ? _len16 - 2 : 0), _key16 = 2; _key16 < _len16; _key16++) {
-    rest[_key16 - 2] = arguments[_key16];
+  for (var _len18 = arguments.length, rest = Array(_len18 > 2 ? _len18 - 2 : 0), _key18 = 2; _key18 < _len18; _key18++) {
+    rest[_key18 - 2] = arguments[_key18];
   }
@@ -315,4 +337,4 @@
 function getByAltText() {
-  for (var _len17 = arguments.length, args = Array(_len17), _key17 = 0; _key17 < _len17; _key17++) {
-    args[_key17] = arguments[_key17];
+  for (var _len19 = arguments.length, args = Array(_len19), _key19 = 0; _key19 < _len19; _key19++) {
+    args[_key19] = arguments[_key19];
   }
@@ -347,3 +369,7 @@
 exports.getAllByTitle = getAllByTitle;
+exports.queryByValue = queryByValue;
+exports.queryAllByValue = queryAllByValue;
+exports.getByValue = getByValue;
+exports.getAllByValue = getAllByValue;
 
 /* eslint complexity:["error", 14] */

package.json

 {
   "name": "dom-testing-library",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Simple and complete DOM testing utilities that encourage good testing practices.",
@@ -5,0 +5,0 @@ "main": "dist/index.js",

README.md

@@ -80,2 +80,3 @@ <div align="center">
   * [`getByTitle`](#getbytitle)
+  * [`getByValue`](#getbyvalue)
   * [`getByTestId`](#getbytestid)
@@ -324,2 +325,22 @@ * [`wait`](#wait)
 
+### `getByValue`
+
+```typescript
+getByValue(
+  container: HTMLElement,
+  value: TextMatch,
+  options?: {
+    exact?: boolean = true,
+    collapseWhitespace?: boolean = false,
+    trim?: boolean = true,
+  }): HTMLElement
+```
+
+Returns the element that has the matching value.
+
+```javascript
+// <input type="text" id="lastName" defaultValue="Norris" />
+const lastNameInput = getByValue('Norris')
+```
+
 ### `getByTestId`
@@ -326,0 +347,0 @@

No alert changes

Improved metrics

Total package byte prevSize

75966

increased by1.98%

Lines of code

901

increased by2.5%

Number of lines in readme file

905

increased by2.38%

No dependency changes