Blog

End-to-end testen in React Native

8 november 2022 9 min leestijd

Een uitgebreide gids voor E2E-testen in React Native met Detox en andere testframeworks. Leer teststrategieën en best practices.

End-to-end testen in React Native
React NativeTestenE2EDetoxKwaliteitsborging

Schrijf cross-platform end-to-end tests in JavaScript

Tests schrijven voor je code is tegenwoordig een essentieel onderdeel van programmeren. Er zijn verschillende soorten methodes om software te testen, zoals unit tests, integratietests en end-to-end tests. Dit artikel laat zien hoe we end-to-end testen kunnen toepassen op een eenvoudige React Native-app.

We gebruiken daarvoor de library Detox, die ontwikkeld en onderhouden wordt door het team van Wix.

De app is heel eenvoudig! Gebruikers kunnen er hun favoriete Nintendo 64-game mee liken. Er is in de app dus eigenlijk maar één specifiek gedrag om te testen: de like-functionaliteit!

User story

Laten we alle mogelijke gebruikersacties voor deze functionaliteit op een rij zetten:

  1. De gebruiker opent de app.

  2. De gebruiker ziet de gamekaart, en op die kaart staan een like-knop en een tekst met het totale aantal likes. (Om de tekst na de gebruikersactie te kunnen vergelijken)

  3. De gebruiker drukt op de like-knop.

  4. De gebruiker ziet dat de like-tekst is veranderd. In dit geval is het aantal likes met één gestegen.

KANTTEKENING: In theorie kun je deze user story als een integratietest beschouwen. Maar omdat de app zelf alleen verantwoordelijk is voor het liken van games, behandelen we het als een end-to-end test.

Code

We bouwen onze code op terwijl we de user stories een voor een doorlopen. Elk codeblok hoort uiteindelijk bij een specifieke user story.

  1. De gebruiker opent de 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. De gebruiker ziet de gamekaart, en op die kaart staan een like-knop en een tekst met het totale aantal likes. (Om de tekst na de gebruikersactie te kunnen vergelijken)
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.De gebruiker drukt op de like-knop.

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. De gebruiker ziet dat de like-tekst is veranderd. In dit geval is het aantal likes met één gestegen.
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()
  );
});

Volledige 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

Laten we alles in actie zien.


Conclusie

Dit artikel behandelde de basis van end-to-end testen in React Native-apps. Om het eenvoudig te houden is de app zelf simpel genoeg om de fundamentele aspecten van end-to-end testen te laten zien. In echte productie-apps kan het natuurlijk een stuk ingewikkelder worden dan dit.

Via de link hieronder kun je de uiteindelijke broncode van deze app bekijken.

Ik wens iedereen een bugvrije dag!

Broncode op GitHub

Gepubliceerd op

Dit artikel is ook gepubliceerd op: