v12 release (#1314)

Co-authored-by: Michał Pierzchała <thymikee@gmail.com>
Co-authored-by: Pierre Zimmermann <64224599+pierrezimmermannbam@users.noreply.github.com>

Author: 3 people

examples/basic/jest-setup.js

@@ -1,13 +1,7 @@
 /* eslint-disable no-undef, import/no-extraneous-dependencies */
-import { configure } from '@testing-library/react-native';
 
 // Import Jest Native matchers
 import '@testing-library/jest-native/extend-expect';
 
 // Silence the warning: Animated: `useNativeDriver` is not supported because the native animated module is missing
 jest.mock('react-native/Libraries/Animated/NativeAnimatedHelper');
-
-// Enable excluding hidden elements from the queries by default
-configure({
-  defaultIncludeHiddenElements: false,
-});

examples/react-navigation/README.md

@@ -8,8 +8,6 @@ There are two types of recommeded tests:
 1. Tests operating on navigator level - these use `renderNavigator` helper to render a navigator component used in the app. It is useful when you want to test a scenario that includes multiple screens.
 2. Tests operating on single screen level - these use regular `render` helper but require refactoring screen components into `Screen` and `ScreenContent` components. Where `Screen` receives React Navigation props and/or uses hooks like `useNavigation` while `ScreenContent` does not have a direct relation to React Navigation API but gets props from `Screen` and calls relevant callbacks to trigger navigation.
 
-> Note that this example applies `includeHiddenElements: false` by default, so all queries will ignore elements on the hidden screens, e.g. inactive tabs or screens present in stack navigators. This option is enabled in `jest-setup.js` file, using `defaultIncludeHiddenElements: false` option to `configure` function.
-
 ## Non-recommended tests
 
 There also exists another popular type of screen level tests, where users mock React Navigation objects like `navigation`, `route` and/or hooks like  `useNavigation`, etc. We don't recommend this way of testing. **Mocking internal parts of the libraries is effectively testing implementation details, which goes against the Testing Library's [Guiding Principles](https://testing-library.com/docs/guiding-principles/)**.

examples/react-navigation/jest-setup.js

@@ -1,5 +1,4 @@
 /* eslint-disable no-undef, import/no-extraneous-dependencies */
-import { configure } from '@testing-library/react-native';
 
 // Import Jest Native matchers
 import '@testing-library/jest-native/extend-expect';
@@ -10,8 +9,3 @@ jest.mock('react-native/Libraries/Animated/NativeAnimatedHelper');
 // Setup Reanimated mocking for Drawer navigation
 global.ReanimatedDataMock = { now: () => Date.now() };
 require('react-native-reanimated/lib/reanimated2/jestUtils').setUpTests();
-
-// Enable excluding hidden elements from the queries by default
-configure({
-  defaultIncludeHiddenElements: false,
-});

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testing-library/react-native",
-  "version": "11.5.4",
+  "version": "12.0.0-rc.2",
   "description": "Simple and complete React Native testing utilities that encourage good testing practices.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -10,6 +10,12 @@
   },
   "homepage": "https://callstack.github.io/react-native-testing-library",
   "author": "Michał Pierzchała <thymikee@gmail.com>",
+  "contributors": [
+    "Maciej Jastrzębski <mdjastrzebski@gmail.com> (https://github.com/mdjastrzebski)",
+    "Augustin Le Fèvre <augustin.le-fevre@klarna.com> (https://github.com/AugustinLF)",
+    "Pierre Zimmermann <pierrez@nam.tech> (https://github.com/pierrezimmermannbam)",
+    "MattAgn <matthieua@bam.tech> (https://github.com/MattAgn)"
+  ],
   "license": "MIT",
   "private": false,
   "keywords": [

src/__tests__/__snapshots__/render.breaking.test.tsx.snap

@@ -6,9 +6,8 @@ import {
 } from '../config';
 
 test('getConfig() returns existing configuration', () => {
-  expect(getConfig().useBreakingChanges).toEqual(false);
   expect(getConfig().asyncUtilTimeout).toEqual(1000);
-  expect(getConfig().defaultIncludeHiddenElements).toEqual(true);
+  expect(getConfig().defaultIncludeHiddenElements).toEqual(false);
 });
 
 test('configure() overrides existing config values', () => {
@@ -17,37 +16,36 @@ test('configure() overrides existing config values', () => {
   expect(getConfig()).toEqual({
     asyncUtilTimeout: 5000,
     defaultDebugOptions: { message: 'debug message' },
-    defaultIncludeHiddenElements: true,
-    useBreakingChanges: false,
+    defaultIncludeHiddenElements: false,
   });
 });
 
 test('resetToDefaults() resets config to defaults', () => {
   configure({
     asyncUtilTimeout: 5000,
-    defaultIncludeHiddenElements: false,
+    defaultIncludeHiddenElements: true,
   });
   expect(getConfig().asyncUtilTimeout).toEqual(5000);
-  expect(getConfig().defaultIncludeHiddenElements).toEqual(false);
+  expect(getConfig().defaultIncludeHiddenElements).toEqual(true);
 
   resetToDefaults();
   expect(getConfig().asyncUtilTimeout).toEqual(1000);
-  expect(getConfig().defaultIncludeHiddenElements).toEqual(true);
+  expect(getConfig().defaultIncludeHiddenElements).toEqual(false);
 });
 
 test('resetToDefaults() resets internal config to defaults', () => {
   configureInternal({
-    useBreakingChanges: true,
+    hostComponentNames: { text: 'A', textInput: 'A' },
   });
-  expect(getConfig().useBreakingChanges).toEqual(true);
+  expect(getConfig().hostComponentNames).toEqual({ text: 'A', textInput: 'A' });
 
   resetToDefaults();
-  expect(getConfig().useBreakingChanges).toEqual(false);
+  expect(getConfig().hostComponentNames).toBe(undefined);
 });
 
 test('configure handles alias option defaultHidden', () => {
-  expect(getConfig().defaultIncludeHiddenElements).toEqual(true);
-
-  configure({ defaultHidden: false });
   expect(getConfig().defaultIncludeHiddenElements).toEqual(false);
+
+  configure({ defaultHidden: true });
+  expect(getConfig().defaultIncludeHiddenElements).toEqual(true);
 });