React Academy · Lektion

Integrationstest med React Testing Library

Render komponenter i tests, udløs events, og kontrollér den synlige output frem for implementeringen.

Lektion 1 af 413 trin

Integrationstest med React Testing Library er en gratis React Academy-lektion på CoddyKit. Dette er lektion 1 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i React Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. React Academy-kurset indeholder 4 lektioner i alt.

Hvad er React Testing Library?

React Testing Library (RTL) lægger op til test fra brugerens perspektiv: gengiv komponenter, interagér med dem, som en bruger ville gøre, og kontrollér synlige resultater i stedet for implementeringsdetaljer.

Opsætning

RTL følger med Create React App og Vites React-skabelon. Ved manuel opsætning skal du installere @testing-library/react og @testing-library/jest-dom.

// package.json
// "@testing-library/react": "^14.0.0",
// "@testing-library/jest-dom": "^6.0.0"

// setupTests.ts
import '@testing-library/jest-dom';

Gengivelse af en komponent

render() monterer en komponent i en virtuel DOM. Den returnerer forespørgselsfunktioner, der er afgrænset til det gengivne resultat.

import { render, screen } from '@testing-library/react';
import { Button } from './Button';

test('renders button label', () => {
  render(<Button label="Submit" onClick={() => {}} />);
  expect(screen.getByText('Submit')).toBeInTheDocument();
});

Forespørgsel efter elementer

Foretræk forespørgsler i denne rækkefølge: getByRole > getByLabelText > getByPlaceholderText > getByText. Rolleforespørgsler matcher tilgængelighedssemantik.

// Best: query by role
const button = screen.getByRole('button', { name: /submit/i });

// Good: query by label (for form inputs)
const input = screen.getByLabelText('Email address');

// Acceptable: query by text
const heading = screen.getByText('Welcome');

Udløsning af hændelser

Brug userEvent fra @testing-library/user-event (anbefalet) eller fireEvent (grundlæggende). userEvent simulerer virkelige browserinteraktioner, herunder fokus og sløring.

import userEvent from '@testing-library/user-event';

test('types into input', async () => {
  const user = userEvent.setup();
  render(<SearchBar />);
  const input = screen.getByRole('textbox');
  await user.type(input, 'react');
  expect(input).toHaveValue('react');
});

Test af formularindsendelse

Gengiv formularen, udfyld inddatafelterne med userEvent.type, klik på indsend, og kontrollér resultatet: en succesmeddelelse, navigation eller et callback-kald.

test('submits the login form', async () => {
  const onLogin = jest.fn();
  const user = userEvent.setup();
  render(<LoginForm onLogin={onLogin} />);

  await user.type(screen.getByLabelText('Email'), 'test@example.com');
  await user.type(screen.getByLabelText('Password'), 'password123');
  await user.click(screen.getByRole('button', { name: /log in/i }));

  expect(onLogin).toHaveBeenCalledWith({ email: 'test@example.com', password: 'password123' });
});

Kontrol af synlighed

Matchere fra jest-dom som toBeInTheDocument(), toBeVisible() og toHaveValue() gør kontroller læselige.

expect(screen.getByText('Error: required')).toBeInTheDocument();
expect(screen.getByRole('dialog')).toBeVisible();
expect(screen.getByRole('textbox')).toHaveValue('hello');
expect(screen.queryByText('Loading...')).not.toBeInTheDocument();

Test af betinget gengivelse

Brug queryBy, som returnerer null, når elementet mangler, til at kontrollere, at et element ikke gengives. Brug getBy, når du forventer, at det er til stede.

test('shows error message when validation fails', async () => {
  const user = userEvent.setup();
  render(<SignUpForm />);
  await user.click(screen.getByRole('button', { name: /submit/i }));
  expect(screen.getByText('Email is required')).toBeInTheDocument();
});

Indpakning med providers

De fleste komponenter har brug for kontekst eller en router. Pak dem ind i providers i render-kaldet, eller opret en brugerdefineret renderWithProviders-hjælpefunktion.

function renderWithProviders(ui: React.ReactElement) {
  return render(
    <QueryClientProvider client={new QueryClient()}>
      <MemoryRouter>
        {ui}
      </MemoryRouter>
    </QueryClientProvider>
  );
}

test('shows user data', () => {
  renderWithProviders(<UserProfile />);
});

Test af tilstandsændringer

Interagér med komponenten, og kontrollér derefter, at den nye tilstand afspejles i brugerfladen. RTL pakker de fleste interaktioner automatisk ind i act, når du bruger userEvent.

test('counter increments', async () => {
  const user = userEvent.setup();
  render(<Counter />);
  expect(screen.getByText('Count: 0')).toBeInTheDocument();
  await user.click(screen.getByRole('button', { name: /increment/i }));
  expect(screen.getByText('Count: 1')).toBeInTheDocument();
});

Hjælp til fejlsøgning med screen

Kald screen.debug() for at udskrive den aktuelle gengivne HTML til konsollen — nyttigt, når en forespørgsel fejler, og du har brug for at se, hvad der faktisk gengives.

test('debugging a failing query', () => {
  render(<MyComponent />);
  screen.debug(); // prints rendered HTML
  screen.getByRole('button', { name: /save/i }); // then inspect output
});

Hurtigt tjek

Hvilken forespørgsel bør du foretrække, når du tester en knap i React Testing Library?

Besvar den i den interaktive lektion

Opsummering

RTL-gengivelser tester komponenter og interagerer med dem via rollebaserede forespørgsler og userEvent. Pak komponenter ind i de nødvendige providers, brug jest-dom-matchere til læselige kontroller, og foretræk queryBy, når du kontrollerer fravær.

Gratis at komme i gang

Lær React med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser: 88
Lektioner: 324

Start gratis Se hele kurset

Ofte stillede spørgsmål

Er lektionen “Integrationstest med React Testing Library” gratis?

Ja — hele teksten til “Integrationstest med React Testing Library” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af React Academy-kurset, skal du opgradere til CoddyKit PRO. React Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “Integrationstest med React Testing Library”?

Render komponenter i tests, udløs events, og kontrollér den synlige output frem for implementeringen. Du øver dig i React Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på React Academy?

Der kræves ingen tidligere erfaring. React Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 1 af 4.

Hvor lang tid tager lektionen “Integrationstest med React Testing Library”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne React Academy-lektion?

Ja. Alle React Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

Integrationstest med React Testing Library
Test af asynkron brugerflade og API-kald med MSW
Kom godt i gang med Playwright til React
Test af formularer og brugerflows fra start til slut

← Tilbage til React Academy