Bruke matchere

Unofficial Beta Translation

This page was AI-translated by PageTurner (beta). Not officially endorsed by the project. Found an error? Report issue →

Jest bruker "matchere" for å teste verdier på forskjellige måter. Denne dokumentasjonen introduserer noen vanlig brukte matchere. For full oversikt, se expect API-dokumentasjonen.

Vanlige matchere

Den enkleste måten å teste en verdi er med eksakt likhet.

test('two plus two is four', () => {
  expect(2 + 2).toBe(4);
});

I denne koden returnerer expect(2 + 2) et "forventningsobjekt". Du vil vanligvis ikke gjøre mye med disse objektene bortsett fra å kalle matchere på dem. Her er .toBe(4) matcheren. Når Jest kjører, sporer den alle feilede matchere slik at den kan vise tydelige feilmeldinger.

toBe bruker Object.is for eksakt likhetstesting. For å sjekke verdien til et objekt, bruk toEqual:

test('object assignment', () => {
  const data = {one: 1};
  data['two'] = 2;
  expect(data).toEqual({one: 1, two: 2});
});

toEqual sjekker hvert felt i et objekt eller en array rekursivt.

tips

toEqual ignorerer objektnøkler med undefined-egenskaper, undefined array-elementer, sparsomme arrays eller objekttypemismatch. Bruk toStrictEqual for å ta disse med i betraktning.

Du kan også teste det motsatte av en matcher med not:

test('adding positive numbers is not zero', () => {
  for (let a = 1; a < 10; a++) {
    for (let b = 1; b < 10; b++) {
      expect(a + b).not.toBe(0);
    }
  }
});

Sannhetsverdier

I tester må du noen ganger skille mellom undefined, null og false, men ikke alltid. Jest har verktøy som lar deg være eksplisitt om hva du ønsker.

• toBeNull matcher kun null

• toBeUndefined matcher kun undefined

• toBeDefined er motsatt av toBeUndefined

• toBeTruthy matcher alt som en if-setning behandler som sant

• toBeFalsy matcher alt som en if-setning behandler som usant

For eksempel:

test('null', () => {
  const n = null;
  expect(n).toBeNull();
  expect(n).toBeDefined();
  expect(n).not.toBeUndefined();
  expect(n).not.toBeTruthy();
  expect(n).toBeFalsy();
});

test('zero', () => {
  const z = 0;
  expect(z).not.toBeNull();
  expect(z).toBeDefined();
  expect(z).not.toBeUndefined();
  expect(z).not.toBeTruthy();
  expect(z).toBeFalsy();
});

Bruk den matcheren som best samsvarer med det koden din skal gjøre.

Tall

De fleste tall-sammenligninger har tilsvarende matchere.

test('two plus two', () => {
  const value = 2 + 2;
  expect(value).toBeGreaterThan(3);
  expect(value).toBeGreaterThanOrEqual(3.5);
  expect(value).toBeLessThan(5);
  expect(value).toBeLessThanOrEqual(4.5);

  // toBe and toEqual are equivalent for numbers
  expect(value).toBe(4);
  expect(value).toEqual(4);
});

For flyttall-likhet, bruk toBeCloseTo istedenfor toEqual, fordi du ikke vil at en test skal avhenge av en liten avrundingsfeil.

test('adding floating point numbers', () => {
  const value = 0.1 + 0.2;
  //expect(value).toBe(0.3);           This won't work because of rounding error
  expect(value).toBeCloseTo(0.3); // This works.
});

Strenger

Du kan sjekke strenger mot regulære uttrykk med toMatch:

test('there is no I in team', () => {
  expect('team').not.toMatch(/I/);
});

test('but there is a "stop" in Christoph', () => {
  expect('Christoph').toMatch(/stop/);
});

Arrays og iterable objekter

Du kan sjekke om en array eller iterable inneholder et bestemt element med toContain:

const shoppingList = [
  'diapers',
  'kleenex',
  'trash bags',
  'paper towels',
  'milk',
];

test('the shopping list has milk on it', () => {
  expect(shoppingList).toContain('milk');
  expect(new Set(shoppingList)).toContain('milk');
});

Unntak

Bruk toThrow for å teste om en funksjon kaster en feil når den kalles.

function compileAndroidCode() {
  throw new Error('you are using the wrong JDK!');
}

test('compiling android goes as expected', () => {
  expect(() => compileAndroidCode()).toThrow();
  expect(() => compileAndroidCode()).toThrow(Error);

  // You can also use a string that must be contained in the error message or a regexp
  expect(() => compileAndroidCode()).toThrow('you are using the wrong JDK');
  expect(() => compileAndroidCode()).toThrow(/JDK/);

  // Or you can match an exact error message using a regexp like below
  expect(() => compileAndroidCode()).toThrow(/^you are using the wrong JDK$/); // Test fails
  expect(() => compileAndroidCode()).toThrow(/^you are using the wrong JDK!$/); // Test pass
});

tips

Funksjonen som kaster unntaket må kalles inni en omsluttende funksjon, ellers vil toThrow-assertionen feile.

Og mer

Dette er bare en smakebit. Se referansedokumentasjonen for fullstendig liste over matchere.

Når du kan matcherene, er neste steg å lære hvordan Jest lar deg teste asynkron kode.