@testing-library/react-native 7.1.0 → 8.0.0

package/README.md

@@ -4,7 +4,7 @@
     height="80"
     width="80"
     alt="owl"
-    src="https://raw.githubusercontent.com/callstack/react-native-testing-library/master/website/static/img/owl.png"
+    src="https://raw.githubusercontent.com/callstack/react-native-testing-library/main/website/static/img/owl.png"
   />
   <p>Simple and complete React Native testing utilities that encourage good testing practices.</P>
 </div>
@@ -46,7 +46,7 @@ npm install --save-dev @testing-library/react-native
 
 This library has a peerDependencies listing for `react-test-renderer` and, of course, `react`. Make sure to install them too!
 
-> In order to properly use helpers for async tests (`findBy` queries and `waitFor`) you need at least React >=16.9.0 (featuring async `act`) or React Native >=0.60 (which comes with React >=16.9.0).
+> In order to properly use helpers for async tests (`findBy` queries and `waitFor`) you need at least React >=16.9.0 (featuring async `act`) or React Native >=0.61 (which comes with React >=16.9.0).
 
 ### Additional Jest matchers
 
@@ -64,7 +64,7 @@ yarn add --dev @testing-library/jest-native
 npm install --save-dev @testing-library/jest-native
 ```
 
-Then automatically add it to your jest tests by using `setupFilesAfterEnv` option in your Jest configuration (it's usually located either in `package.json` under `"jest"` key or in a `jest.config.js` file):
+Then automatically add it to your jest tests by using `setupFilesAfterEnv` option in your Jest configuration (it's usually located either in `package.json` under `"jest"` key or in a `jest.config.json` file):
 
 ```json
 {
@@ -73,6 +73,24 @@ Then automatically add it to your jest tests by using `setupFilesAfterEnv` optio
 }
 ```
 
+### Custom Jest Preset
+
+> **important** if you use "modern" Fake Timers
+
+We generally advise to use the "react-native" preset when testing with this library. However, if you use ["modern" Fake Timers](https://jestjs.io/blog/2020/05/05/jest-26#new-fake-timers) (default since Jest 27), you'll need to apply our custom Jest preset or awaiting promises, like `waitFor`, will timeout.
+
+This is a [known issue](https://github.com/facebook/react-native/issues/29303). It happens because React Native's Jest preset overrides native Promise. Our preset restores it to defaults, which is not a problem in most apps out there.
+
+Here's how you apply a custom preset in your Jest config:
+
+```json
+{
+  "preset": "@testing-library/react-native"
+}
+```
+
+If this doesn't work for you, please fall back to using "legacy" fake timers.
+
 ### Flow
 
 Note for [Flow](https://flow.org) users – you'll also need to install typings for `react-test-renderer`:
@@ -108,7 +126,7 @@ test('form submits two answers', () => {
 });
 ```
 
-You can find the source of `QuestionsBoard` component and this example [here](https://github.com/callstack/react-native-testing-library/blob/master/src/__tests__/questionsBoard.test.js).
+You can find the source of `QuestionsBoard` component and this example [here](https://github.com/callstack/react-native-testing-library/blob/main/src/__tests__/questionsBoard.test.js).
 
 ## API / Usage
 
@@ -135,6 +153,8 @@ The [public API](https://callstack.github.io/react-native-testing-library/docs/a
 
 React Native Testing Library is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Callstack](https://callstack.com) is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!
 
+Like the project? ⚛️ [Join the team](https://callstack.com/careers/?utm_campaign=Senior_RN&utm_source=github&utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥
+
 ---
 
 Supported and used by [Rally Health](https://www.rallyhealth.com/careers-home).

package/build/act.js.flow

@@ -1,8 +1,9 @@
 // @flow
 import { act } from 'react-test-renderer';
+import type { Thenable } from './types.flow';
 
 const actMock = (callback: () => void) => {
   callback();
 };
 
-export default act || actMock;
+export default (act || actMock: (callback: () => void) => Thenable);

package/build/fireEvent.js

@@ -7,8 +7,6 @@ exports.default = void 0;
 
 var _act = _interopRequireDefault(require("./act"));
 
-var _errors = require("./helpers/errors");
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 const isHostElement = element => {
@@ -25,32 +23,41 @@ const isTextInput = element => {
 
 const isTouchResponder = element => {
   if (!isHostElement(element)) return false;
-  return !!(element === null || element === void 0 ? void 0 : element.props.onStartShouldSetResponder) || isTextInput(element);
+  return !!(element !== null && element !== void 0 && element.props.onStartShouldSetResponder) || isTextInput(element);
+};
+
+const isPointerEventEnabled = (element, isParent) => {
+  const parentCondition = isParent ? (element === null || element === void 0 ? void 0 : element.props.pointerEvents) === 'box-only' : (element === null || element === void 0 ? void 0 : element.props.pointerEvents) === 'box-none';
+
+  if ((element === null || element === void 0 ? void 0 : element.props.pointerEvents) === 'none' || parentCondition) {
+    return false;
+  }
+
+  if (!(element !== null && element !== void 0 && element.parent)) return true;
+  return isPointerEventEnabled(element.parent, true);
 };
 
 const isEventEnabled = (element, touchResponder) => {
-  var _touchResponder$props, _touchResponder$props2;
+  var _touchResponder$props, _touchResponder$props2, _touchResponder$props3, _touchResponder$props4;
 
   if (isTextInput(element)) return (element === null || element === void 0 ? void 0 : element.props.editable) !== false;
-  return (touchResponder === null || touchResponder === void 0 ? void 0 : (_touchResponder$props = (_touchResponder$props2 = touchResponder.props).onStartShouldSetResponder) === null || _touchResponder$props === void 0 ? void 0 : _touchResponder$props.call(_touchResponder$props2)) !== false;
+  if (!isPointerEventEnabled(element)) return false;
+  const touchStart = touchResponder === null || touchResponder === void 0 ? void 0 : (_touchResponder$props = (_touchResponder$props2 = touchResponder.props).onStartShouldSetResponder) === null || _touchResponder$props === void 0 ? void 0 : _touchResponder$props.call(_touchResponder$props2);
+  const touchMove = touchResponder === null || touchResponder === void 0 ? void 0 : (_touchResponder$props3 = (_touchResponder$props4 = touchResponder.props).onMoveShouldSetResponder) === null || _touchResponder$props3 === void 0 ? void 0 : _touchResponder$props3.call(_touchResponder$props4);
+  if (touchStart || touchMove) return true;
+  return touchStart === undefined && touchMove === undefined;
 };
 
-const findEventHandler = (element, eventName, callsite, nearestTouchResponder, hasDescendandHandler) => {
+const findEventHandler = (element, eventName, callsite, nearestTouchResponder) => {
   const touchResponder = isTouchResponder(element) ? element : nearestTouchResponder;
   const handler = getEventHandler(element, eventName);
-  if (handler && isEventEnabled(element, touchResponder)) return handler; // Do not bubble event to the root element
-
-  const hasHandler = handler != null || hasDescendandHandler;
+  if (handler && isEventEnabled(element, touchResponder)) return handler;
 
   if (element.parent === null || element.parent.parent === null) {
-    if (hasHandler) {
-      return null;
-    } else {
-      throw new _errors.ErrorWithStack(`No handler function found for event: "${eventName}"`, callsite || invokeEvent);
-    }
+    return null;
   }
 
-  return findEventHandler(element.parent, eventName, callsite, touchResponder, hasHandler);
+  return findEventHandler(element.parent, eventName, callsite, touchResponder);
 };
 
 const getEventHandler = (element, eventName) => {
@@ -71,7 +78,7 @@ const invokeEvent = (element, eventName, callsite, ...data) => {
   const handler = findEventHandler(element, eventName, callsite);
 
   if (!handler) {
-    return null;
+    return;
   }
 
   let returnValue;
@@ -83,7 +90,7 @@ const invokeEvent = (element, eventName, callsite, ...data) => {
 
 const toEventHandlerName = eventName => `on${eventName.charAt(0).toUpperCase()}${eventName.slice(1)}`;
 
-const pressHandler = element => invokeEvent(element, 'press', pressHandler);
+const pressHandler = (element, ...data) => invokeEvent(element, 'press', pressHandler, ...data);
 
 const changeTextHandler = (element, ...data) => invokeEvent(element, 'changeText', changeTextHandler, ...data);
 

package/build/fireEvent.js.flow

@@ -1,6 +1,5 @@
 // @flow
 import act from './act';
-import { ErrorWithStack } from './helpers/errors';
 
 const isHostElement = (element?: ReactTestInstance) => {
   return typeof element?.type === 'string';
@@ -17,21 +16,43 @@ const isTouchResponder = (element?: ReactTestInstance) => {
   return !!element?.props.onStartShouldSetResponder || isTextInput(element);
 };
 
+const isPointerEventEnabled = (
+  element?: ReactTestInstance,
+  isParent?: boolean
+) => {
+  const parentCondition = isParent
+    ? element?.props.pointerEvents === 'box-only'
+    : element?.props.pointerEvents === 'box-none';
+
+  if (element?.props.pointerEvents === 'none' || parentCondition) {
+    return false;
+  }
+
+  if (!element?.parent) return true;
+
+  return isPointerEventEnabled(element.parent, true);
+};
+
 const isEventEnabled = (
   element?: ReactTestInstance,
   touchResponder?: ReactTestInstance
 ) => {
   if (isTextInput(element)) return element?.props.editable !== false;
+  if (!isPointerEventEnabled(element)) return false;
+
+  const touchStart = touchResponder?.props.onStartShouldSetResponder?.();
+  const touchMove = touchResponder?.props.onMoveShouldSetResponder?.();
 
-  return touchResponder?.props.onStartShouldSetResponder?.() !== false;
+  if (touchStart || touchMove) return true;
+
+  return touchStart === undefined && touchMove === undefined;
 };
 
 const findEventHandler = (
   element: ReactTestInstance,
   eventName: string,
   callsite?: any,
-  nearestTouchResponder?: ReactTestInstance,
-  hasDescendandHandler?: boolean
+  nearestTouchResponder?: ReactTestInstance
 ) => {
   const touchResponder = isTouchResponder(element)
     ? element
@@ -40,26 +61,11 @@ const findEventHandler = (
   const handler = getEventHandler(element, eventName);
   if (handler && isEventEnabled(element, touchResponder)) return handler;
 
-  // Do not bubble event to the root element
-  const hasHandler = handler != null || hasDescendandHandler;
   if (element.parent === null || element.parent.parent === null) {
-    if (hasHandler) {
-      return null;
-    } else {
-      throw new ErrorWithStack(
-        `No handler function found for event: "${eventName}"`,
-        callsite || invokeEvent
-      );
-    }
+    return null;
   }
 
-  return findEventHandler(
-    element.parent,
-    eventName,
-    callsite,
-    touchResponder,
-    hasHandler
-  );
+  return findEventHandler(element.parent, eventName, callsite, touchResponder);
 };
 
 const getEventHandler = (element: ReactTestInstance, eventName: string) => {
@@ -84,7 +90,7 @@ const invokeEvent = (
   const handler = findEventHandler(element, eventName, callsite);
 
   if (!handler) {
-    return null;
+    return;
   }
 
   let returnValue;
@@ -99,18 +105,20 @@ const invokeEvent = (
 const toEventHandlerName = (eventName: string) =>
   `on${eventName.charAt(0).toUpperCase()}${eventName.slice(1)}`;
 
-const pressHandler = (element: ReactTestInstance) =>
-  invokeEvent(element, 'press', pressHandler);
-const changeTextHandler = (element: ReactTestInstance, ...data: Array<any>) =>
-  invokeEvent(element, 'changeText', changeTextHandler, ...data);
-const scrollHandler = (element: ReactTestInstance, ...data: Array<any>) =>
+const pressHandler = (element: ReactTestInstance, ...data: Array<any>): void =>
+  invokeEvent(element, 'press', pressHandler, ...data);
+const changeTextHandler = (
+  element: ReactTestInstance,
+  ...data: Array<any>
+): void => invokeEvent(element, 'changeText', changeTextHandler, ...data);
+const scrollHandler = (element: ReactTestInstance, ...data: Array<any>): void =>
   invokeEvent(element, 'scroll', scrollHandler, ...data);
 
 const fireEvent = (
   element: ReactTestInstance,
   eventName: string,
   ...data: Array<any>
-) => invokeEvent(element, eventName, fireEvent, ...data);
+): void => invokeEvent(element, eventName, fireEvent, ...data);
 
 fireEvent.press = pressHandler;
 fireEvent.changeText = changeTextHandler;

package/build/flushMicroTasks.js

@@ -8,6 +8,8 @@ exports.flushMicroTasks = flushMicroTasks;
 
 var _errors = require("./helpers/errors");
 
+var _timers = require("./helpers/timers");
+
 /**
  * Wait for microtasks queue to flush
  */
@@ -21,7 +23,7 @@ function flushMicroTasks() {
     // using "thenable" instead of a Promise, because otherwise it breaks when
     // using "modern" fake timers
     then(resolve) {
-      setImmediate(resolve);
+      (0, _timers.setImmediate)(resolve);
     }
 
   };

package/build/flushMicroTasks.js.flow

@@ -1,5 +1,6 @@
 // @flow
 import { printDeprecationWarning } from './helpers/errors';
+import { setImmediate } from './helpers/timers';
 
 type Thenable<T> = { then: (() => T) => mixed };
 

package/build/helpers/a11yAPI.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.matchStringValue = matchStringValue;
 exports.matchArrayValue = matchArrayValue;
 exports.matchObject = matchObject;
-exports.default = void 0;
+exports.a11yAPI = void 0;
 
-var _makeQuery = _interopRequireDefault(require("./makeQuery"));
+var _makeA11yQuery = _interopRequireDefault(require("./makeA11yQuery"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
@@ -40,7 +40,7 @@ function matchObject(prop, matcher) {
   return prop ? Object.keys(matcher).length !== 0 && Object.keys(prop).length !== 0 && !Object.keys(matcher).some(key => prop[key] !== matcher[key]) : false;
 }
 
-const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel', {
+const a11yAPI = instance => ({ ...(0, _makeA11yQuery.default)('accessibilityLabel', {
     getBy: ['getByA11yLabel', 'getByAccessibilityLabel', 'getByLabelText'],
     getAllBy: ['getAllByA11yLabel', 'getAllByAccessibilityLabel', 'getAllByLabelText'],
     queryBy: ['queryByA11yLabel', 'queryByAccessibilityLabel', 'queryByLabelText'],
@@ -48,7 +48,7 @@ const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel',
     findBy: ['findByA11yLabel', 'findByAccessibilityLabel', 'findByLabelText'],
     findAllBy: ['findAllByA11yLabel', 'findAllByAccessibilityLabel', 'findAllByLabelText']
   }, matchStringValue)(instance),
-  ...(0, _makeQuery.default)('accessibilityHint', {
+  ...(0, _makeA11yQuery.default)('accessibilityHint', {
     getBy: ['getByA11yHint', 'getByAccessibilityHint', 'getByHintText'],
     getAllBy: ['getAllByA11yHint', 'getAllByAccessibilityHint', 'getAllByHintText'],
     queryBy: ['queryByA11yHint', 'queryByAccessibilityHint', 'queryByHintText'],
@@ -56,7 +56,7 @@ const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel',
     findBy: ['findByA11yHint', 'findByAccessibilityHint', 'findByHintText'],
     findAllBy: ['findAllByA11yHint', 'findAllByAccessibilityHint', 'findAllByHintText']
   }, matchStringValue)(instance),
-  ...(0, _makeQuery.default)('accessibilityRole', {
+  ...(0, _makeA11yQuery.default)('accessibilityRole', {
     getBy: ['getByA11yRole', 'getByAccessibilityRole', 'getByRole'],
     getAllBy: ['getAllByA11yRole', 'getAllByAccessibilityRole', 'getAllByRole'],
     queryBy: ['queryByA11yRole', 'queryByAccessibilityRole', 'queryByRole'],
@@ -64,7 +64,7 @@ const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel',
     findBy: ['findByA11yRole', 'findByAccessibilityRole', 'findByRole'],
     findAllBy: ['findAllByA11yRole', 'findAllByAccessibilityRole', 'findAllByRole']
   }, matchStringValue)(instance),
-  ...(0, _makeQuery.default)('accessibilityStates', {
+  ...(0, _makeA11yQuery.default)('accessibilityStates', {
     getBy: ['getByA11yStates', 'getByAccessibilityStates'],
     getAllBy: ['getAllByA11yStates', 'getAllByAccessibilityStates'],
     queryBy: ['queryByA11yStates', 'queryByAccessibilityStates'],
@@ -72,7 +72,7 @@ const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel',
     findBy: ['findByA11yStates', 'findByAccessibilityStates'],
     findAllBy: ['findAllByA11yStates', 'findAllByAccessibilityStates']
   }, matchArrayValue)(instance),
-  ...(0, _makeQuery.default)('accessibilityState', {
+  ...(0, _makeA11yQuery.default)('accessibilityState', {
     getBy: ['getByA11yState', 'getByAccessibilityState'],
     getAllBy: ['getAllByA11yState', 'getAllByAccessibilityState'],
     queryBy: ['queryByA11yState', 'queryByAccessibilityState'],
@@ -80,7 +80,7 @@ const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel',
     findBy: ['findByA11yState', 'findByAccessibilityState'],
     findAllBy: ['findAllByA11yState', 'findAllByAccessibilityState']
   }, matchObject)(instance),
-  ...(0, _makeQuery.default)('accessibilityValue', {
+  ...(0, _makeA11yQuery.default)('accessibilityValue', {
     getBy: ['getByA11yValue', 'getByAccessibilityValue'],
     getAllBy: ['getAllByA11yValue', 'getAllByAccessibilityValue'],
     queryBy: ['queryByA11yValue', 'queryByAccessibilityValue'],
@@ -90,5 +90,4 @@ const a11yAPI = instance => ({ ...(0, _makeQuery.default)('accessibilityLabel',
   }, matchObject)(instance)
 });
 
-var _default = a11yAPI;
-exports.default = _default;
+exports.a11yAPI = a11yAPI;

package/build/helpers/a11yAPI.js.flow

@@ -1,16 +1,16 @@
 // @flow
 import type { A11yRole, A11yStates, A11yState, A11yValue } from '../types.flow';
 import type { WaitForOptions } from '../waitFor';
-import makeQuery from './makeQuery';
+import makeA11yQuery from './makeA11yQuery';
 
 type GetReturn = ReactTestInstance;
 type GetAllReturn = Array<ReactTestInstance>;
 type QueryReturn = ReactTestInstance | null;
-type QueryAllReturn = Array<ReactTestInstance> | [];
+type QueryAllReturn = Array<ReactTestInstance>;
 type FindReturn = Promise<GetReturn>;
 type FindAllReturn = Promise<GetAllReturn>;
 
-type A11yAPI = {|
+export type A11yAPI = {|
   // Label
   getByA11yLabel: (string | RegExp) => GetReturn,
   getByLabelText: (string | RegExp) => GetReturn,
@@ -116,9 +116,9 @@ export function matchObject<T: {}>(prop?: T, matcher: T): boolean {
     : false;
 }
 
-const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
+export const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
   ({
-    ...makeQuery(
+    ...makeA11yQuery(
       'accessibilityLabel',
       {
         getBy: ['getByA11yLabel', 'getByAccessibilityLabel', 'getByLabelText'],
@@ -150,7 +150,7 @@ const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
       },
       matchStringValue
     )(instance),
-    ...makeQuery(
+    ...makeA11yQuery(
       'accessibilityHint',
       {
         getBy: ['getByA11yHint', 'getByAccessibilityHint', 'getByHintText'],
@@ -178,7 +178,7 @@ const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
       },
       matchStringValue
     )(instance),
-    ...makeQuery(
+    ...makeA11yQuery(
       'accessibilityRole',
       {
         getBy: ['getByA11yRole', 'getByAccessibilityRole', 'getByRole'],
@@ -202,7 +202,7 @@ const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
       },
       matchStringValue
     )(instance),
-    ...makeQuery(
+    ...makeA11yQuery(
       'accessibilityStates',
       {
         getBy: ['getByA11yStates', 'getByAccessibilityStates'],
@@ -214,7 +214,7 @@ const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
       },
       matchArrayValue
     )(instance),
-    ...makeQuery(
+    ...makeA11yQuery(
       'accessibilityState',
       {
         getBy: ['getByA11yState', 'getByAccessibilityState'],
@@ -226,7 +226,7 @@ const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
       },
       matchObject
     )(instance),
-    ...makeQuery(
+    ...makeA11yQuery(
       'accessibilityValue',
       {
         getBy: ['getByA11yValue', 'getByAccessibilityValue'],
@@ -239,5 +239,3 @@ const a11yAPI = (instance: ReactTestInstance): A11yAPI =>
       matchObject
     )(instance),
   }: any);
-
-export default a11yAPI;

package/build/helpers/byDisplayValue.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.queryByDisplayValue = exports.queryAllByDisplayValue = exports.getByDisplayValue = exports.getAllByDisplayValue = exports.findByDisplayValue = exports.findAllByDisplayValue = void 0;
+
+var _makeQueries = require("./makeQueries");
+
+var _filterNodeByType = require("./filterNodeByType");
+
+var _errors = require("./errors");
+
+const getTextInputNodeByDisplayValue = (node, value) => {
+  try {
+    const {
+      TextInput
+    } = require('react-native');
+
+    const nodeValue = node.props.value !== undefined ? node.props.value : node.props.defaultValue;
+    return (0, _filterNodeByType.filterNodeByType)(node, TextInput) && (typeof value === 'string' ? value === nodeValue : value.test(nodeValue));
+  } catch (error) {
+    throw (0, _errors.createLibraryNotSupportedError)(error);
+  }
+};
+
+const queryAllByDisplayValue = instance => function queryAllByDisplayValueFn(displayValue) {
+  return instance.findAll(node => getTextInputNodeByDisplayValue(node, displayValue));
+};
+
+exports.queryAllByDisplayValue = queryAllByDisplayValue;
+
+const getMultipleError = displayValue => `Found multiple elements with display value: ${String(displayValue)} `;
+
+const getMissingError = displayValue => `Unable to find an element with displayValue: ${String(displayValue)}`;
+
+const {
+  getBy: getByDisplayValue,
+  getAllBy: getAllByDisplayValue,
+  queryBy: queryByDisplayValue,
+  findBy: findByDisplayValue,
+  findAllBy: findAllByDisplayValue
+} = (0, _makeQueries.makeQueries)(queryAllByDisplayValue, getMissingError, getMultipleError);
+exports.findAllByDisplayValue = findAllByDisplayValue;
+exports.findByDisplayValue = findByDisplayValue;
+exports.queryByDisplayValue = queryByDisplayValue;
+exports.getAllByDisplayValue = getAllByDisplayValue;
+exports.getByDisplayValue = getByDisplayValue;

package/build/helpers/byDisplayValue.js.flow

@@ -0,0 +1,56 @@
+// @flow
+import { makeQueries } from './makeQueries';
+import type { Queries } from './makeQueries';
+import { filterNodeByType } from './filterNodeByType';
+import { createLibraryNotSupportedError } from './errors';
+
+const getTextInputNodeByDisplayValue = (node, value) => {
+  try {
+    const { TextInput } = require('react-native');
+    const nodeValue =
+      node.props.value !== undefined
+        ? node.props.value
+        : node.props.defaultValue;
+    return (
+      filterNodeByType(node, TextInput) &&
+      (typeof value === 'string' ? value === nodeValue : value.test(nodeValue))
+    );
+  } catch (error) {
+    throw createLibraryNotSupportedError(error);
+  }
+};
+
+const queryAllByDisplayValue = (
+  instance: ReactTestInstance
+): ((displayValue: string | RegExp) => Array<ReactTestInstance>) =>
+  function queryAllByDisplayValueFn(displayValue) {
+    return instance.findAll((node) =>
+      getTextInputNodeByDisplayValue(node, displayValue)
+    );
+  };
+
+const getMultipleError = (displayValue: string | RegExp) =>
+  `Found multiple elements with display value: ${String(displayValue)} `;
+const getMissingError = (displayValue: string | RegExp) =>
+  `Unable to find an element with displayValue: ${String(displayValue)}`;
+
+const {
+  getBy: getByDisplayValue,
+  getAllBy: getAllByDisplayValue,
+  queryBy: queryByDisplayValue,
+  findBy: findByDisplayValue,
+  findAllBy: findAllByDisplayValue,
+}: Queries<string | RegExp> = makeQueries(
+  queryAllByDisplayValue,
+  getMissingError,
+  getMultipleError
+);
+
+export {
+  findAllByDisplayValue,
+  findByDisplayValue,
+  getAllByDisplayValue,
+  getByDisplayValue,
+  queryAllByDisplayValue,
+  queryByDisplayValue,
+};

package/build/helpers/byPlaceholderText.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.queryByPlaceholderText = exports.queryAllByPlaceholderText = exports.getByPlaceholderText = exports.getAllByPlaceholderText = exports.findByPlaceholderText = exports.findAllByPlaceholderText = void 0;
+
+var _makeQueries = require("./makeQueries");
+
+var _filterNodeByType = require("./filterNodeByType");
+
+var _errors = require("./errors");
+
+const getTextInputNodeByPlaceholderText = (node, placeholder) => {
+  try {
+    const {
+      TextInput
+    } = require('react-native');
+
+    return (0, _filterNodeByType.filterNodeByType)(node, TextInput) && (typeof placeholder === 'string' ? placeholder === node.props.placeholder : placeholder.test(node.props.placeholder));
+  } catch (error) {
+    throw (0, _errors.createLibraryNotSupportedError)(error);
+  }
+};
+
+const queryAllByPlaceholderText = instance => function queryAllByPlaceholderFn(placeholder) {
+  return instance.findAll(node => getTextInputNodeByPlaceholderText(node, placeholder));
+};
+
+exports.queryAllByPlaceholderText = queryAllByPlaceholderText;
+
+const getMultipleError = placeholder => `Found multiple elements with placeholder: ${String(placeholder)} `;
+
+const getMissingError = placeholder => `Unable to find an element with placeholder: ${String(placeholder)}`;
+
+const {
+  getBy: getByPlaceholderText,
+  getAllBy: getAllByPlaceholderText,
+  queryBy: queryByPlaceholderText,
+  findBy: findByPlaceholderText,
+  findAllBy: findAllByPlaceholderText
+} = (0, _makeQueries.makeQueries)(queryAllByPlaceholderText, getMissingError, getMultipleError);
+exports.findAllByPlaceholderText = findAllByPlaceholderText;
+exports.findByPlaceholderText = findByPlaceholderText;
+exports.queryByPlaceholderText = queryByPlaceholderText;
+exports.getAllByPlaceholderText = getAllByPlaceholderText;
+exports.getByPlaceholderText = getByPlaceholderText;

package/build/helpers/byPlaceholderText.js.flow

@@ -0,0 +1,54 @@
+// @flow
+import { makeQueries } from './makeQueries';
+import type { Queries } from './makeQueries';
+import { filterNodeByType } from './filterNodeByType';
+import { createLibraryNotSupportedError } from './errors';
+
+const getTextInputNodeByPlaceholderText = (node, placeholder) => {
+  try {
+    const { TextInput } = require('react-native');
+    return (
+      filterNodeByType(node, TextInput) &&
+      (typeof placeholder === 'string'
+        ? placeholder === node.props.placeholder
+        : placeholder.test(node.props.placeholder))
+    );
+  } catch (error) {
+    throw createLibraryNotSupportedError(error);
+  }
+};
+
+const queryAllByPlaceholderText = (
+  instance: ReactTestInstance
+): ((placeholder: string | RegExp) => Array<ReactTestInstance>) =>
+  function queryAllByPlaceholderFn(placeholder) {
+    return instance.findAll((node) =>
+      getTextInputNodeByPlaceholderText(node, placeholder)
+    );
+  };
+
+const getMultipleError = (placeholder) =>
+  `Found multiple elements with placeholder: ${String(placeholder)} `;
+const getMissingError = (placeholder) =>
+  `Unable to find an element with placeholder: ${String(placeholder)}`;
+
+const {
+  getBy: getByPlaceholderText,
+  getAllBy: getAllByPlaceholderText,
+  queryBy: queryByPlaceholderText,
+  findBy: findByPlaceholderText,
+  findAllBy: findAllByPlaceholderText,
+}: Queries<string | RegExp> = makeQueries(
+  queryAllByPlaceholderText,
+  getMissingError,
+  getMultipleError
+);
+
+export {
+  findAllByPlaceholderText,
+  findByPlaceholderText,
+  getAllByPlaceholderText,
+  getByPlaceholderText,
+  queryAllByPlaceholderText,
+  queryByPlaceholderText,
+};