Blog

End-to-End-Tests in React Native

8. November 2022 9 Min. Lesezeit

Ein umfassender Leitfaden für E2E-Tests in React Native mit Detox und anderen Test-Frameworks. Lerne Teststrategien und Best Practices kennen.

End-to-End-Tests in React Native
React NativeTestsE2EDetoxQualitätssicherung

Plattformübergreifende End-to-End-Tests in Javascript schreiben

Tests für den eigenen Code zu schreiben ist heute ein fester Bestandteil des Programmierens. Es gibt verschiedene Methoden für Softwaretests, etwa Unit-Tests, Integrationstests und End-to-End-Tests. Dieser Artikel zeigt, wie wir End-to-End-Tests auf eine einfache React-Native-App anwenden können.

Wir verwenden die Library Detox, die vom Team von Wix entwickelt und gepflegt wird.

Die App ist ziemlich simpel! Nutzer können damit ihr liebstes Nintendo-64-Spiel liken. Es gibt in der App also genau ein bestimmtes Verhalten zu testen: die Like-Funktion!

User Story

Listen wir alle Nutzeraktionen auf, die es für diese Funktion geben kann:

  1. Der Nutzer öffnet die App.

  2. Der Nutzer sieht die Spielkarte, und auf der Spielkarte gibt es einen Like-Button und einen Text mit der Gesamtzahl der Likes. (Um den Text nach der Nutzeraktion zu vergleichen)

  3. Der Nutzer tippt auf den Like-Button.

  4. Der Nutzer bemerkt, dass sich der Like-Text geändert hat. In diesem Fall ist die Zahl der Likes um eins gestiegen.

ACHTUNG: Theoretisch kann man diese User Story als Integrationstest betrachten. Da die App selbst aber nur dafür zuständig ist, dass Nutzer ihr Spiel liken können, wird sie hier als End-to-End-Test behandelt.

Code

Wir schreiben unseren Code, während wir die User Stories der Reihe nach durchgehen. Jeder Codeblock entspricht am Ende einer bestimmten User Story.

  1. Der Nutzer öffnet die App.
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. Der Nutzer sieht die Spielkarte, und auf der Spielkarte gibt es einen Like-Button und einen Text mit der Gesamtzahl der Likes. (Um den Text nach der Nutzeraktion zu vergleichen)
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();
});
  1. Der Nutzer tippt auf den Like-Button.
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. Der Nutzer bemerkt, dass sich der Like-Text geändert hat. In diesem Fall ist die Zahl der Likes um eins gestiegen.
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()
  );
});

Vollständiger Code

// 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()
    );
  });
});

Demo

Sehen wir uns alles in Aktion an.


Fazit

Dieser Artikel hat die Grundlagen von End-to-End-Tests in React-Native-Apps behandelt. Der Einfachheit halber ist die App selbst so simpel, dass sie die grundlegenden Aspekte von End-to-End-Tests zeigt. In echten Anwendungen in Produktion kann das natürlich deutlich komplizierter sein.

Den finalen Quellcode dieser App findest du über den Link unten.

Ich wünsche allen einen bugfreien Tag!

Quellcode auf Github

Veröffentlicht auf

Dieser Artikel ist auch erschienen auf: