@testing-library/react-native 9.0.0-alpha.0 → 9.2.0

package/build/helpers/queryByAPI.js.flow

@@ -1,166 +0,0 @@
-// @flow
-import * as React from 'react';
-import type { TextMatchOptions } from './byText';
-import {
-  UNSAFE_getByType,
-  UNSAFE_getByProps,
-  UNSAFE_getAllByType,
-  UNSAFE_getAllByProps,
-} from './getByAPI';
-import { queryByTestId, queryAllByTestId } from './byTestId';
-import { queryByText, queryAllByText } from './byText';
-import {
-  queryByPlaceholderText,
-  queryAllByPlaceholderText,
-} from './byPlaceholderText';
-import { queryByDisplayValue, queryAllByDisplayValue } from './byDisplayValue';
-import {
-  createQueryByError,
-  throwRemovedFunctionError,
-  throwRenamedFunctionError,
-} from './errors';
-
-export type QueryByAPI = {|
-  queryByText: (
-    name: string | RegExp,
-    queryOptions?: TextMatchOptions
-  ) => ReactTestInstance | null,
-  queryAllByText: (
-    text: string | RegExp,
-    queryOptions?: TextMatchOptions
-  ) => Array<ReactTestInstance>,
-  queryByPlaceholderText: (
-    placeholder: string | RegExp,
-    queryOptions?: TextMatchOptions
-  ) => ReactTestInstance | null,
-  queryAllByPlaceholderText: (
-    placeholder: string | RegExp,
-    queryOptions?: TextMatchOptions
-  ) => Array<ReactTestInstance>,
-  queryByDisplayValue: (
-    value: string | RegExp,
-    queryOptions?: TextMatchOptions
-  ) => ReactTestInstance | null,
-  queryAllByDisplayValue: (
-    value: string | RegExp,
-    queryOptions?: TextMatchOptions
-  ) => Array<ReactTestInstance>,
-  queryByTestId: (testID: string | RegExp) => ReactTestInstance | null,
-  queryAllByTestId: (testID: string | RegExp) => Array<ReactTestInstance>,
-
-  // Unsafe aliases
-  UNSAFE_queryByType: <P>(
-    type: React.ComponentType<P>
-  ) => ReactTestInstance | null,
-  UNSAFE_queryAllByType: <P>(
-    type: React.ComponentType<P>
-  ) => Array<ReactTestInstance>,
-  UNSAFE_queryByProps: (props: { [string]: any }) => ReactTestInstance | null,
-  UNSAFE_queryAllByProps: (props: {
-    [string]: any,
-  }) => Array<ReactTestInstance>,
-  queryByName: () => void,
-  queryByType: () => void,
-  queryByProps: () => void,
-  queryAllByName: () => void,
-  queryAllByType: () => void,
-  queryAllByProps: () => void,
-
-  queryByPlaceholder: () => void,
-  queryAllByPlaceholder: () => void,
-|};
-
-export const UNSAFE_queryByType = (
-  instance: ReactTestInstance
-): ((type: React.ComponentType<any>) => ReactTestInstance | null) =>
-  function queryByTypeFn(type: React.ComponentType<any>) {
-    try {
-      return UNSAFE_getByType(instance)(type);
-    } catch (error) {
-      return createQueryByError(error, queryByTypeFn);
-    }
-  };
-
-export const UNSAFE_queryByProps = (
-  instance: ReactTestInstance
-): ((props: { [propName: string]: any }) => ReactTestInstance | null) =>
-  function queryByPropsFn(props: { [propName: string]: any }) {
-    try {
-      return UNSAFE_getByProps(instance)(props);
-    } catch (error) {
-      return createQueryByError(error, queryByPropsFn);
-    }
-  };
-
-export const UNSAFE_queryAllByType = (
-  instance: ReactTestInstance
-): ((type: React.ComponentType<any>) => Array<ReactTestInstance>) => (
-  type: React.ComponentType<any>
-) => {
-  try {
-    return UNSAFE_getAllByType(instance)(type);
-  } catch (error) {
-    return [];
-  }
-};
-
-export const UNSAFE_queryAllByProps = (
-  instance: ReactTestInstance
-): ((props: {
-  [propName: string]: any,
-}) => Array<ReactTestInstance>) => (props: { [propName: string]: any }) => {
-  try {
-    return UNSAFE_getAllByProps(instance)(props);
-  } catch (error) {
-    return [];
-  }
-};
-
-export const queryByAPI = (instance: ReactTestInstance): QueryByAPI => ({
-  queryByTestId: queryByTestId(instance),
-  queryByText: queryByText(instance),
-  queryByPlaceholderText: queryByPlaceholderText(instance),
-  queryByDisplayValue: queryByDisplayValue(instance),
-  queryAllByTestId: queryAllByTestId(instance),
-  queryAllByText: queryAllByText(instance),
-  queryAllByPlaceholderText: queryAllByPlaceholderText(instance),
-  queryAllByDisplayValue: queryAllByDisplayValue(instance),
-
-  // Unsafe
-  UNSAFE_queryByType: UNSAFE_queryByType(instance),
-  UNSAFE_queryAllByType: UNSAFE_queryAllByType(instance),
-  UNSAFE_queryByProps: UNSAFE_queryByProps(instance),
-  UNSAFE_queryAllByProps: UNSAFE_queryAllByProps(instance),
-
-  // Removed
-  queryByName: () =>
-    throwRemovedFunctionError('queryByName', 'migration-v2#removed-functions'),
-  queryAllByName: () =>
-    throwRemovedFunctionError(
-      'queryAllByName',
-      'migration-v2#removed-functions'
-    ),
-  queryByType: () =>
-    throwRemovedFunctionError('queryByType', 'migration-v2#removed-functions'),
-  queryAllByType: () =>
-    throwRemovedFunctionError(
-      'queryAllByType',
-      'migration-v2#removed-functions'
-    ),
-  queryByProps: () =>
-    throwRemovedFunctionError('queryByProps', 'migration-v2#removed-functions'),
-  queryAllByProps: () =>
-    throwRemovedFunctionError(
-      'queryAllByProps',
-      'migration-v2#removed-functions'
-    ),
-
-  // Renamed
-  queryByPlaceholder: () =>
-    throwRenamedFunctionError('queryByPlaceholder', 'queryByPlaceholderText'),
-  queryAllByPlaceholder: () =>
-    throwRenamedFunctionError(
-      'queryAllByPlaceholder',
-      'queryAllByPlaceholderText'
-    ),
-});

package/build/helpers/timers.js.flow

@@ -1,88 +0,0 @@
-// Most content of this file sourced directly from https://github.com/testing-library/dom-testing-library/blob/main/src/helpers.js
-// @flow
-/* globals jest */
-
-const globalObj = typeof window === 'undefined' ? global : window;
-
-// Currently this fn only supports jest timers, but it could support other test runners in the future.
-function runWithRealTimers<T>(callback: () => T): T {
-  const fakeTimersType = getJestFakeTimersType();
-  if (fakeTimersType) {
-    jest.useRealTimers();
-  }
-
-  const callbackReturnValue = callback();
-
-  if (fakeTimersType) {
-    jest.useFakeTimers(fakeTimersType);
-  }
-
-  return callbackReturnValue;
-}
-
-function getJestFakeTimersType() {
-  // istanbul ignore if
-  if (
-    typeof jest === 'undefined' ||
-    typeof globalObj.setTimeout === 'undefined'
-  ) {
-    return null;
-  }
-
-  if (
-    typeof globalObj.setTimeout._isMockFunction !== 'undefined' &&
-    globalObj.setTimeout._isMockFunction
-  ) {
-    return 'legacy';
-  }
-
-  if (
-    typeof globalObj.setTimeout.clock !== 'undefined' &&
-    // $FlowIgnore[prop-missing]
-    typeof jest.getRealSystemTime !== 'undefined'
-  ) {
-    try {
-      // jest.getRealSystemTime is only supported for Jest's `modern` fake timers and otherwise throws
-      // $FlowExpectedError
-      jest.getRealSystemTime();
-      return 'modern';
-    } catch {
-      // not using Jest's modern fake timers
-    }
-  }
-  return null;
-}
-
-const jestFakeTimersAreEnabled = (): boolean =>
-  Boolean(getJestFakeTimersType());
-
-// we only run our tests in node, and setImmediate is supported in node.
-function setImmediatePolyfill(fn) {
-  return globalObj.setTimeout(fn, 0);
-}
-
-type BindTimeFunctions = {
-  clearTimeoutFn: typeof clearTimeout,
-  setImmediateFn: typeof setImmediate,
-  setTimeoutFn: typeof setTimeout,
-};
-
-function bindTimeFunctions(): BindTimeFunctions {
-  return {
-    clearTimeoutFn: globalObj.clearTimeout,
-    setImmediateFn: globalObj.setImmediate || setImmediatePolyfill,
-    setTimeoutFn: globalObj.setTimeout,
-  };
-}
-
-const { clearTimeoutFn, setImmediateFn, setTimeoutFn } = (runWithRealTimers(
-  bindTimeFunctions
-): BindTimeFunctions);
-
-export {
-  runWithRealTimers,
-  jestFakeTimersAreEnabled,
-  clearTimeoutFn as clearTimeout,
-  setImmediateFn as setImmediate,
-  setTimeoutFn as setTimeout,
-};

package/build/index.js.flow

@@ -1,18 +0,0 @@
-// @flow
-import { cleanup } from './pure';
-import { flushMicroTasks } from './flushMicroTasks';
-
-// If we're running in a test runner that supports afterEach
-// then we'll automatically run cleanup afterEach test
-// this ensures that tests run in isolation from each other
-// if you don't like this then either import the `pure` module
-// or set the RNTL_SKIP_AUTO_CLEANUP env variable to 'true'.
-if (typeof afterEach === 'function' && !process.env.RNTL_SKIP_AUTO_CLEANUP) {
-  // eslint-disable-next-line no-undef
-  afterEach(async () => {
-    await flushMicroTasks();
-    cleanup();
-  });
-}
-
-export * from './pure';

package/build/matches.js.flow

@@ -1,41 +0,0 @@
-// @flow
-export type NormalizerFn = (textToNormalize: string) => string;
-
-export function matches(
-  matcher: string | RegExp,
-  text: string,
-  normalizer?: NormalizerFn = getDefaultNormalizer(),
-  exact?: boolean = true
-): boolean {
-  if (typeof text !== 'string') {
-    return false;
-  }
-
-  const normalizedText = normalizer(text);
-  if (typeof matcher === 'string') {
-    return exact
-      ? normalizedText === matcher
-      : normalizedText.toLowerCase().includes(matcher.toLowerCase());
-  } else {
-    return matcher.test(normalizedText);
-  }
-}
-
-type NormalizerConfig = {
-  trim?: boolean,
-  collapseWhitespace?: boolean,
-};
-
-export function getDefaultNormalizer({
-  trim = true,
-  collapseWhitespace = true,
-}: NormalizerConfig = {}): NormalizerFn {
-  return (text: string) => {
-    let normalizedText = text;
-    normalizedText = trim ? normalizedText.trim() : normalizedText;
-    normalizedText = collapseWhitespace
-      ? normalizedText.replace(/\s+/g, ' ')
-      : normalizedText;
-    return normalizedText;
-  };
-}

package/build/render.js.flow

@@ -1,109 +0,0 @@
-// @flow
-import * as React from 'react';
-import TestRenderer, { type ReactTestRenderer } from 'react-test-renderer'; // eslint-disable-line import/no-extraneous-dependencies
-import act from './act';
-import { addToCleanupQueue } from './cleanup';
-import { getByAPI, type GetByAPI } from './helpers/getByAPI';
-import { queryByAPI, type QueryByAPI } from './helpers/queryByAPI';
-import { findByAPI, type FindByAPI } from './helpers/findByAPI';
-import { a11yAPI, type A11yAPI } from './helpers/a11yAPI';
-import debugShallow from './helpers/debugShallow';
-import debugDeep from './helpers/debugDeep';
-
-type Options = {
-  wrapper?: React.ComponentType<any>,
-  createNodeMock?: (element: React.Element<any>) => any,
-};
-type TestRendererOptions = {
-  createNodeMock: (element: React.Element<any>) => any,
-};
-
-/**
- * Renders test component deeply using react-test-renderer and exposes helpers
- * to assert on the output.
- */
-export default function render<T>(
-  component: React.Element<T>,
-  { wrapper: Wrapper, createNodeMock }: Options = {}
-): {
-  ...FindByAPI,
-  ...QueryByAPI,
-  ...GetByAPI,
-  ...A11yAPI,
-  update: (component: React.Element<any>) => void,
-  container: ReactTestInstance,
-  rerender: (component: React.Element<any>) => void,
-  unmount: (nextElement?: React.Element<any>) => void,
-  toJSON: () => null | ReactTestRendererJSON,
-  debug: DebugFunction,
-} {
-  const wrap = (innerElement: React.Element<any>) =>
-    Wrapper ? <Wrapper>{innerElement}</Wrapper> : innerElement;
-
-  const renderer = renderWithAct(
-    wrap(component),
-    createNodeMock ? { createNodeMock } : undefined
-  );
-  const update = updateWithAct(renderer, wrap);
-  const instance = renderer.root;
-  const unmount = () => {
-    act(() => {
-      renderer.unmount();
-    });
-  };
-
-  addToCleanupQueue(unmount);
-
-  return {
-    ...getByAPI(instance),
-    ...queryByAPI(instance),
-    ...findByAPI(instance),
-    ...a11yAPI(instance),
-    update,
-    unmount,
-    container: instance,
-    rerender: update, // alias for `update`
-    toJSON: renderer.toJSON,
-    debug: debug(instance, renderer),
-  };
-}
-
-function renderWithAct(
-  component: React.Element<any>,
-  options?: TestRendererOptions
-): ReactTestRenderer {
-  let renderer: ReactTestRenderer;
-
-  act(() => {
-    renderer = TestRenderer.create(component, options);
-  });
-
-  return ((renderer: any): ReactTestRenderer);
-}
-
-function updateWithAct(
-  renderer: ReactTestRenderer,
-  wrap: (innerElement: React.Element<any>) => React.Element<any>
-) {
-  return function (component: React.Element<any>) {
-    act(() => {
-      renderer.update(wrap(component));
-    });
-  };
-}
-
-interface DebugFunction {
-  (message?: string): void;
-  shallow: (message?: string) => void;
-}
-
-function debug(
-  instance: ReactTestInstance,
-  renderer: ReactTestRenderer
-): DebugFunction {
-  function debugImpl(message?: string) {
-    return debugDeep(renderer.toJSON(), message);
-  }
-  debugImpl.shallow = (message) => debugShallow(instance, message);
-  return debugImpl;
-}

package/build/shallow.js.flow

@@ -1,26 +0,0 @@
-// @flow
-import * as React from 'react';
-import ShallowRenderer from 'react-test-renderer/shallow'; // eslint-disable-line import/no-extraneous-dependencies
-import { throwRemovedFunctionError } from './helpers/errors';
-
-/**
- * Renders test component shallowly using react-test-renderer/shallow
- */
-export function shallowInternal(
-  instance: ReactTestInstance | React.Element<any>
-): {| output: any |} {
-  const renderer = new ShallowRenderer();
-
-  renderer.render(React.createElement(instance.type, instance.props));
-
-  return {
-    output: renderer.getRenderOutput(),
-  };
-}
-
-export default function shallow(_: ReactTestInstance | React.Element<any>) {
-  throwRemovedFunctionError(
-    'shallow',
-    'migration-v2#removed-global-shallow-function'
-  );
-}

package/build/types.flow.js

@@ -1 +0,0 @@
-"use strict";

package/build/types.flow.js.flow

@@ -1,59 +0,0 @@
-// @flow
-
-export type Thenable = {
-  then(resolve: () => mixed, reject?: () => mixed): mixed,
-};
-
-export type A11yRole =
-  | 'none'
-  | 'button'
-  | 'link'
-  | 'search'
-  | 'image'
-  | 'keyboardkey'
-  | 'text'
-  | 'adjustable'
-  | 'imagebutton'
-  | 'header'
-  | 'summary'
-  | 'alert'
-  | 'checkbox'
-  | 'combobox'
-  | 'menu'
-  | 'menubar'
-  | 'menuitem'
-  | 'progressbar'
-  | 'radio'
-  | 'radiogroup'
-  | 'scrollbar'
-  | 'spinbutton'
-  | 'switch'
-  | 'tab'
-  | 'tablist'
-  | 'timer'
-  | 'toolbar';
-
-export type A11yState = {|
-  disabled?: boolean,
-  selected?: boolean,
-  checked?: boolean | 'mixed',
-  busy?: boolean,
-  expanded?: boolean,
-|};
-
-export type A11yStates =
-  | 'disabled'
-  | 'selected'
-  | 'checked'
-  | 'unchecked'
-  | 'busy'
-  | 'expanded'
-  | 'collapsed'
-  | 'hasPopup';
-
-export type A11yValue = {
-  min?: number,
-  max?: number,
-  now?: number,
-  text?: string,
-};