mirror of
https://github.com/callstack/react-native-testing-library.git
synced 2026-09-18 23:09:04 +08:00
07d3be1c51
* feat: add toJSON to render; cleanup shallow * Remove empty dependencies entry * revert shallow import * add docs * add TS typings
68 lines
2.4 KiB
TypeScript
68 lines
2.4 KiB
TypeScript
import * as React from 'react';
|
|
import { ReactTestInstance, ReactTestRendererJSON } from 'react-test-renderer';
|
|
|
|
export interface GetByAPI {
|
|
getByName: (name: React.ReactType) => ReactTestInstance;
|
|
getByText: (text: string | RegExp) => ReactTestInstance;
|
|
getByProps: (props: Record<string, any>) => ReactTestInstance;
|
|
getByTestId: (testID: string) => ReactTestInstance;
|
|
getAllByName: (name: React.ReactType) => Array<ReactTestInstance>;
|
|
getAllByText: (text: string | RegExp) => Array<ReactTestInstance>;
|
|
getAllByProps: (props: Record<string, any>) => Array<ReactTestInstance>;
|
|
}
|
|
|
|
export interface QueryByAPI {
|
|
queryByName: (name: React.ReactType) => ReactTestInstance | null;
|
|
queryByText: (name: string | RegExp) => ReactTestInstance | null;
|
|
queryByProps: (props: Record<string, any>) => ReactTestInstance | null;
|
|
queryByTestId: (testID: string) => ReactTestInstance | null;
|
|
queryAllByName: (name: React.ReactType) => Array<ReactTestInstance> | [];
|
|
queryAllByText: (text: string | RegExp) => Array<ReactTestInstance> | [];
|
|
queryAllByProps: (
|
|
props: Record<string, any>
|
|
) => Array<ReactTestInstance> | [];
|
|
}
|
|
|
|
export interface RenderOptions {
|
|
createNodeMock: (element: React.ReactElement<any>) => any;
|
|
}
|
|
|
|
export interface RenderAPI extends GetByAPI, QueryByAPI {
|
|
update(nextElement: React.ReactElement<any>): void;
|
|
unmount(nextElement?: React.ReactElement<any>): void;
|
|
toJSON(): ReactTestRendererJSON | null;
|
|
}
|
|
|
|
export type FireEventFunction = (
|
|
element: ReactTestInstance,
|
|
eventName: string,
|
|
data?: any
|
|
) => any;
|
|
|
|
export type FireEventAPI = FireEventFunction & {
|
|
press: (element: ReactTestInstance) => any;
|
|
doublePress: (element: ReactTestInstance) => any;
|
|
changeText: (element: ReactTestInstance, data?: any) => any;
|
|
scroll: (element: ReactTestInstance, data?: any) => any;
|
|
};
|
|
|
|
export type WaitForElementFunction = <T = any>(
|
|
expectation: () => T,
|
|
timeout?: number,
|
|
interval?: number
|
|
) => Promise<T>;
|
|
|
|
export declare const render: (
|
|
component: React.ReactElement<any>,
|
|
options?: RenderOptions
|
|
) => RenderAPI;
|
|
export declare const shallow: <P = {}>(
|
|
instance: ReactTestInstance | React.ReactElement<P>
|
|
) => { output: React.ReactElement<P> };
|
|
export declare const flushMicrotasksQueue: () => Promise<any>;
|
|
export declare const debug: (
|
|
instance: ReactTestInstance | React.ReactElement<any>
|
|
) => void;
|
|
export declare const fireEvent: FireEventAPI;
|
|
export declare const waitForElement: WaitForElementFunction;
|