Blog

Tests end-to-end en React Native

8 novembre 2022 9 min de lecture

Un guide complet des tests E2E en React Native avec Detox et d’autres frameworks de test. Découvrez des stratégies et des bonnes pratiques de test.

Tests end-to-end en React Native
React NativeTestsE2EDetoxAssurance qualité

Écrire des tests end-to-end multiplateformes en Javascript

Écrire des tests pour son code est devenu une partie essentielle de la programmation aujourd’hui. Il existe différentes méthodologies de test logiciel, comme les tests unitaires, les tests d’intégration et les tests end-to-end. Cet article montre comment appliquer des tests end-to-end à une application react-native simple.

Nous allons utiliser la bibliothèque Detox, développée et maintenue par l’équipe de Wix.

L’application est très simple ! Elle permet aux utilisateurs de liker leur jeu Nintendo 64 préféré. Cela dit, il n’y a en réalité qu’un seul comportement à tester dans l’application : la fonctionnalité like !

User story

Listons toutes les actions que l’utilisateur peut effectuer pour cette fonctionnalité :

  1. L’utilisateur ouvre l’application.

  2. L’utilisateur voit la carte du jeu, et cette carte comporte un bouton like ainsi qu’un texte affichant le nombre total *de likes. *(Pour comparer le texte après l’action de l’utilisateur)

  3. L’utilisateur appuie sur le bouton like.

  4. L’utilisateur remarque que le texte like a changé. Ici, le nombre de likes a augmenté de un.

ATTENTION : en théorie, cette user story peut être considérée comme un test d’intégration. Mais comme l’application elle-même sert uniquement à permettre aux utilisateurs de liker leur jeu, on la traite comme un test end-to-end.

Code

Nous allons écrire notre code en parcourant les user stories dans l’ordre. Chaque bloc de code correspondra à une user story précise.

  1. L’utilisateur ouvre l’application.
const detox = require("detox");
const config = require("../package.json").detox;

// before doing any test, ensure the app is launched by the device.
beforeAll(async () => {
  await detox.init(config);
  await device.launchApp();
});
  1. L’utilisateur voit la carte du jeu, et cette carte comporte un bouton like ainsi qu’un texte affichant le nombre total de likes. (Pour comparer le texte après l’action de l’utilisateur)
it("Game card has the like text and button are available on the screen", async () => {
  // test if the elements are on the screen
  await expect(element(by.id("game-card-like-text-1"))).toExist();
  await expect(element(by.id("game-card-like-button-1"))).toExist();

  // test game card has the like text available on the screen
  const likeTextAttrs = await element(
    by.id("game-card-like-text-1")
  ).getAttributes();

  await expect(element(by.text(likeTextAttrs.text))).toExist();
});

3.L’utilisateur appuie sur le bouton like.

it("pressing the like button", async () => {
  // Tap to the like button to increase like count
  await element(by.id("game-card-like-button-1")).tap();
});
  1. L’utilisateur remarque que le texte like a changé. Ici, le nombre de likes a augmenté de un.
it("pressing the like button of the first game card should increase the like count by one", async () => {
  // get like text(like count) before the like button is "tapped"
  const beforeLikeTextAttrs = await element(
    by.id("game-card-like-text-1")
  ).getAttributes();

  // Tap to the like button to increase like count
  await element(by.id("game-card-like-button-1")).tap();

  // calculate final like text(count)
  const increasedLike = Number(beforeLikeTextAttrs.text) + 1;

  // get updated like text
  const afterLikeText = await element(
    by.id("game-card-like-text-1")
  ).getAttributes();

  // test whether the like text(count) has been increased
  await expect(element(by.text(afterLikeText.text.toString()))).toHaveText(
    increasedLike.toString()
  );
});

Code complet

// For more info on how to write Detox tests, see the official docs:
// https://github.com/wix/Detox/blob/master/docs/README.md

const { reloadApp } = require("./reload");

describe("Example", () => {
  beforeEach(async () => {
    await reloadApp();
  });

  it("First game card has the like text and button are available on the screen", async () => {
    // tests if the elements are on the screen
    await expect(element(by.id("game-card-like-text-1"))).toExist();
    await expect(element(by.id("game-card-like-button-1"))).toExist();

    // test game card has the like text available on the screen
    const likeTextAttrs = await element(
      by.id("game-card-like-text-1")
    ).getAttributes();

    await expect(element(by.text(likeTextAttrs.text))).toExist();
  });

  it("pressing the like button of the first game card should increase the like count by one", async () => {
    // get like text(like count) before the like button is "tapped"
    const beforeLikeTextAttrs = await element(
      by.id("game-card-like-text-1")
    ).getAttributes();

    // Tap to the like button to increase like count
    await element(by.id("game-card-like-button-1")).tap();

    // calculate final like text(count)
    const increasedLike = Number(beforeLikeTextAttrs.text) + 1;

    // get updated like text
    const afterLikeText = await element(
      by.id("game-card-like-text-1")
    ).getAttributes();

    // test whether the like text(count) has been increased
    await expect(element(by.text(afterLikeText.text.toString()))).toHaveText(
      increasedLike.toString()
    );
  });
});

Démo

Voyons tout cela en action.


Conclusion

Cet article a présenté les bases des tests end-to-end dans les applications react-native. Par souci de simplicité, l’application est volontairement basique pour illustrer les aspects fondamentaux des tests end-to-end. Dans de vraies applications en production, les choses peuvent bien sûr être plus complexes.

Vous pouvez consulter le code source final de cette application via le lien ci-dessous.

Bonne journée sans bugs à tous !

Code source sur Github

Publié sur

Cet article est également publié sur :