Testarea aplicațiilor React Native

At Facebook, we use Jest to test React Native applications.

Dobândiți o înţelegere mai profundă în testarea unei aplicații exemplu React Native citind următoarele serii: Partea 1: Jest – Instantaneele intră în joc şi Partea 2: Jest – Instantanee Redux pentru Acţiuni şi Reductori.

Instalare

Incepand cu versiunea react-native 0.38, instalarea Jest este inclusă implicit atunci când se rulează react-native init. Urmatoarea configuratie ar trebui să fie adăugată automat în fişierul package.json:

{
  "scripts": {
    "test": "jest"
  },
  "jest": {
    "preset": "react-native"
  }
}

Run yarn test to run tests with Jest.

tip

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._

Testarea de imagine

Să creăm un test de imagine pentru o componentă micuță cu câteva view-uri şi componente de text şi unele stiluri:

Intro.js

import React, {Component} from 'react';
import {StyleSheet, Text, View} from 'react-native';

class Intro extends Component {
  render() {
    return (
      <View style={styles.container}>
        <Text style={styles.welcome}>Welcome to React Native!</Text>
        <Text style={styles.instructions}>
          This is a React Native snapshot test.
        </Text>
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    alignItems: 'center',
    backgroundColor: '#F5FCFF',
    flex: 1,
    justifyContent: 'center',
  },
  instructions: {
    color: '#333333',
    marginBottom: 5,
    textAlign: 'center',
  },
  welcome: {
    fontSize: 20,
    margin: 10,
    textAlign: 'center',
  },
});

export default Intro;

Acum haideţi să utilizăm procesorul de randare React şi funcționalitatea din Jest pentru testarea de imagine pentru a interacţiona cu componenta şi a captura rezultatul şi a crea un fişier de imagine:

__tests__/Intro-test.js

import React from 'react';
import renderer from 'react-test-renderer';
import Intro from '../Intro';

test('renders correctly', () => {
  const tree = renderer.create(<Intro />).toJSON();
  expect(tree).toMatchSnapshot();
});

When you run yarn test or jest, this will produce an output file like this:

__tests__/__snapshots__/Intro-test.js.snap

exports[`Intro renders correctly 1`] = `
<View
  style={
    Object {
      "alignItems": "center",
      "backgroundColor": "#F5FCFF",
      "flex": 1,
      "justifyContent": "center",
    }
  }>
  <Text
    style={
      Object {
        "fontSize": 20,
        "margin": 10,
        "textAlign": "center",
      }
    }>
    Welcome to React Native!
  </Text>
  <Text
    style={
      Object {
        "color": "#333333",
        "marginBottom": 5,
        "textAlign": "center",
      }
    }>
    This is a React Native snapshot test.
  </Text>
</View>
`;

Data viitoare când executaţi testele, rezultatul va fi comparat cu imaginea creată anterior. The snapshot should be committed along with code changes. Atunci când un test de imagine eșuează, trebuie să inspectați dacă este vorba de o modificare intenționată sau neintenţionată. În cazul în care schimbarea este intenționată se poate apela Jest cu jest -u pentru a suprascrie imaginea existentă.

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

Configurarea presetării

Presetarea inițializează mediul şi este foarte dogmatic și se bazează pe ceea ce am găsit a fi util la Facebook. Toate opţiunile de configurare pot fi suprascrise aşa cum acestea pot fi personalizate atunci când nu se utilizează nicio presetare.

Mediu

react-native este livrat cu o presetare Jest, astfel încât câmpul jest.preset din package.json ar trebui să indice către 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.

Personalizări de transformIgnorePatterns

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.

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:

{
  "transformIgnorePatterns": [
    "node_modules/(?!(react-native|my-project|react-native-button)/)"
  ]
}

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:

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

setupFiles

Dacă doriţi să specificați configurări suplimentare pentru fiecare fişier de test, opţiunea de configurare setupFiles poate fi folosită pentru a specifica script-uri de inițializare.

moduleNameMapper

Opțiunea moduleNameMapper poate fi utilizată pentru maparea o cale de modul către un modul diferit. În mod implicit presetarea mapează toate imaginile către un modul dublură de imagine dar dacă un modul nu poate fi găsit această opţiune de configurare poate ajuta:

{
  "moduleNameMapper": {
    "my-module.js": "<rootDir>/path/to/my-module.js"
  }
}

Recomandări

Mock-uiți module native cu jest.mock

Presetarea Jest incorporată în react-native vine cu câteva mock-uri implicite, care sunt aplicate pe un proiect react-native. However, some react-native components or third party components rely on native code to be rendered. În astfel de cazuri, sistem manual de mocking din Jest poate ajuta pentru dublarea implementării.

De exemplu, în cazul în care codul vostru depinde de o componentă video nativă externă numită react-native-video aţi putea-o dubla cu un mock manual în felul următor:

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

Acest lucru va randa componenta ca <Video {...props} /> cu toate proprietățile sale regăsite în instantaneu. See also caveats around Enzyme and React 16.

Uneori, este nevoie să furnizați o dublură manuală mai complexă. De exemplu în cazul în care doriţi să redirecţionaţi proprietăți sau câmpuri statice ale unei componente native către mock, puteţi returna o componentă React diferită dintr-un mock prin acest ajutor din jest-react-native:

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

Sau dacă doriţi să vă creați propriul mock manual, puteţi face ceva de genul acesta:

jest.mock('Text', () => {
  const RealComponent = jest.requireActual('Text');
  const React = require('React');
  class Text extends React.Component {
    render() {
      return React.createElement('Text', this.props, this.props.children);
    }
  }
  Text.propTypes = RealComponent.propTypes;
  return Text;
});

În alte cazuri, poate doriţi să mock-uiți un modul nativ, care nu este o componentă React. Aceeași tehnică poate fi aplicată. Se recomandă inspectarea codului sursă din modulul nativ şi logarea atunci când rulează o aplicaţie react native pe un dispozitiv real şi apoi modelarea unui mock manual după modulul real.

Dacă ajungeți să mock-uiți aceleași module de multe ori este recomandată definirea acestor mock-uri într-un fişier separat şi adăugarea lor la lista de setupFiles.