Version: 27.1

测试React Native程序

在 Facebook，我们使用 Jest 测试 React 应用。

阅读以下系列文章来深入了解如何使用 Jest 测试一个真实的 React Native 示例应用：第一篇： Jest – Snapshot come into play 和 第二篇： Jest – Redux Snapshots for your Actions and Reducers.

安装

Starting from react-native version 0.38, a Jest setup is included by default when running react-native init. The following configuration should be automatically added to your package.json file: The following configuration should be automatically added to your package.json file:

  1. {
  3.   "scripts": {
  5.     "test": "jest"
  7.   },
  9.   "jest": {
  11.     "preset": "react-native"
  13.   }
  15. }

Note: If you are upgrading your react-native application and previously used the jest-react-native preset, remove the dependency from your package.json file and change the preset to react-native instead.

用 yarn test 来运行 Jest 测试。

Snapshot Test

下面来为一个入门的小型组件创建一个快照测试，它的内部有些View、Text组件和一些样式：

Intro.js

  1. import React, {Component} from 'react';
  3. import {StyleSheet, Text, View} from 'react-native';
  8. class Intro extends Component {
  10.   render() {
  12.     return (
  14.       <View style={styles.container}>
  16.         <Text style={styles.welcome}>Welcome to React Native!</Text>
  18.         <Text style={styles.instructions}>
  20.           This is a React Native snapshot test.
  22.         </Text>
  24.       </View>
  26.     );
  28.   }
  30. }
  35. const styles = StyleSheet.create({
  37.   container: {
  39.     alignItems: 'center',
  41.     backgroundColor: '#F5FCFF',
  43.     flex: 1,
  45.     justifyContent: 'center',
  47.   },
  49.   instructions: {
  51.     color: '#333333',
  53.     marginBottom: 5,
  55.     textAlign: 'center',
  57.   },
  59.   welcome: {
  61.     fontSize: 20,
  63.     margin: 10,
  65.     textAlign: 'center',
  67.   },
  69. });
  74. export default Intro;

现在，使用React的test renderer和Jest的快照特性来和组件交互，获得渲染结果和生成快照文件：

__tests__/Intro-test.js

  1. import React from 'react';
  3. import renderer from 'react-test-renderer';
  5. import Intro from '../Intro';
  10. test('renders correctly', () => {
  12.   const tree = renderer.create(<Intro />).toJSON();
  14.   expect(tree).toMatchSnapshot();
  16. });

当你运行 npm test 或者 jest，将产生一个像下面的文件：

__tests__/__snapshots__/Intro-test.js.snap

  1. exports[`Intro renders correctly 1`] = `
  3. <View
  5.   style={
  7.     Object {
  9.       "alignItems": "center",
  11.       "backgroundColor": "#F5FCFF",
  13.       "flex": 1,
  15.       "justifyContent": "center",
  17.     }
  19.   }>
  21.   <Text
  23.     style={
  25.       Object {
  27.         "fontSize": 20,
  29.         "margin": 10,
  31.         "textAlign": "center",
  33.       }
  35.     }>
  37.     Welcome to React Native!
  39.   </Text>
  41.   <Text
  43.     style={
  45.       Object {
  47.         "color": "#333333",
  49.         "marginBottom": 5,
  51.         "textAlign": "center",
  53.       }
  55.     }>
  57.     This is a React Native snapshot test.
  59.   </Text>
  61. </View>
  63. `;

下次你运行测试时，渲染的结果将会和之前创建的快照进行比较。 代码变动时，快照也应该被提交。 当快照测试失败，你需要去检查是否是你想要或不想要的变动。 如果变动符合预期，你可以通过jest -u调用Jest从而重写存在的快照。

The code for this example is available at examples/react-native.

预设配置

Preset是基于我们在Facebook的经验生成的一套基本配置，并且可自定义覆盖。 所有的配置项都可以被重写。

环境

react-native ships with a Jest preset, so the jest.preset field of your package.json should point to react-native. The preset is a node environment that mimics the environment of a React Native app. Because it doesn’t load any DOM or browser APIs, it greatly improves Jest’s startup time. The preset is a node environment that mimics the environment of a React Native app. Because it doesn’t load any DOM or browser APIs, it greatly improves Jest’s startup time.

transformIgnorePatterns customization

The transformIgnorePatterns option can be used to specify which files shall be transformed by Babel. Many react-native npm modules unfortunately don’t pre-compile their source code before publishing. Many react-native npm modules unfortunately don’t pre-compile their source code before publishing.

By default the jest-react-native preset only processes the project’s own source files and react-native. If you have npm dependencies that have to be transformed you can customize this configuration option by including modules other than react-native by grouping them and separating them with the | operator:

  1. {
  3.   "transformIgnorePatterns": [
  5.     "node_modules/(?!(react-native|my-project|react-native-button)/)"
  7.   ]
  9. }

You can test which paths would match (and thus be excluded from transformation) with a tool like this.

transformIgnorePatterns will exclude a file from transformation if the path matches against any pattern provided. Splitting into multiple patterns could therefore have unintended results if you are not careful. In the example below, the exclusion (also known as a negative lookahead assertion) for foo and bar cancel each other out:

  1. {
  3.   "transformIgnorePatterns": ["node_modules/(?!foo/)", "node_modules/(?!bar/)"] // not what you want
  5. }

setupFiles

If you’d like to provide additional configuration for every test file, the setupFiles configuration option can be used to specify setup scripts.

moduleNameMapper

可以使用 modulenamemapper 将模块路径映射到其他模块。 By default the preset maps all images to an image stub module but if a module cannot be found this configuration option can help:

  1. {
  3.   "moduleNameMapper": {
  5.     "my-module.js": "<rootDir>/path/to/my-module.js"
  7.   }
  9. }

Tips

Mock native modules using jest.mock

The Jest preset built into react-native comes with a few default mocks that are applied on a react-native repository. However, some react-native components or third party components rely on native code to be rendered. In such cases, Jest’s manual mocking system can help to mock out the underlying implementation. However, some react-native components or third party components rely on native code to be rendered. In such cases, Jest’s manual mocking system can help to mock out the underlying implementation.

For example, if your code depends on a third party native video component called react-native-video you might want to stub it out with a manual mock like this:

  1. jest.mock('react-native-video', () => 'Video');

This will render the component as <Video {...props} /> with all of its props in the snapshot output. 想了解更多还可以阅读 caveats around Enzyme and React 16. 想了解更多还可以阅读 caveats around Enzyme and React 16.

Sometimes you need to provide a more complex manual mock. Sometimes you need to provide a more complex manual mock. For example if you’d like to forward the prop types or static fields of a native component to a mock, you can return a different React component from a mock through this helper from jest-react-native:

  1. jest.mock('path/to/MyNativeComponent', () => {
  3.   const mockComponent = require('react-native/jest/mockComponent');
  5.   return mockComponent('path/to/MyNativeComponent');
  7. });

Or if you’d like to create your own manual mock, you can do something like this:

  1. jest.mock('Text', () => {
  3.   const RealComponent = jest.requireActual('Text');
  5.   const React = require('react');
  7.   class Text extends React.Component {
  9.     render() {
  11.       return React.createElement('Text', this.props, this.props.children);
  13.     }
  15.   }
  17.   Text.propTypes = RealComponent.propTypes;
  19.   return Text;
  21. });

In other cases you may want to mock a native module that isn’t a React component. The same technique can be applied. We recommend inspecting the native module’s source code and logging the module when running a react native app on a real device and then modeling a manual mock after the real module. The same technique can be applied. We recommend inspecting the native module’s source code and logging the module when running a react native app on a real device and then modeling a manual mock after the real module.

If you end up mocking the same modules over and over it is recommended to define these mocks in a separate file and add it to the list of setupFiles.