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:
-
Der Nutzer öffnet die App.
-
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)
-
Der Nutzer tippt auf den Like-Button.
-
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.
- 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();
});
- 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();
});
- 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();
});
- 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!
Veröffentlicht auf
Dieser Artikel ist auch erschienen auf: