TypeScript
Testen van een eenheid

Elzasser

Elzas is een eenheidstestraamwerk geschreven in TypeScript. Het maakt het gebruik van testgevallen mogelijk en voert TAP-compatibele markup uit.

Installeer het vanaf npm om het te gebruiken:

npm install alsatian --save-dev

Stel vervolgens een testbestand op:

import { Expect, Test, TestCase } from "alsatian";
import { SomeModule } from "../src/some-module";    

export SomeModuleTests {

    @Test()
    public statusShouldBeTrueByDefault() {
        let instance = new SomeModule();
        
        Expect(instance.status).toBe(true);
    }
    
    @Test("Name should be null by default")
    public nameShouldBeNullByDefault() {
        let instance = new SomeModule();
        
        Expect(instance.name).toBe(null);
    }
    
    @TestCase("first name")
    @TestCase("apples")
    public shouldSetNameCorrectly(name: string) {
        let instance = new SomeModule();
        
        instance.setName(name);
        
        Expect(instance.name).toBe(name);
    }
    
}

Zie de GitHub-repo van Elzas voor een volledige documentatie.

chai-onveranderlijke plug-in

1. Installeren vanaf npm chai, chai-immutable en ts-node

   npm install --save-dev chai chai-immutable ts-node
   

2. Installeer types voor mokka en chai

   npm install --save-dev @types/mocha @types/chai
   

3. Schrijf eenvoudig testbestand:

     import {List, Set} from 'immutable';
     import * as chai from 'chai';
     import * as chaiImmutable from 'chai-immutable';
   
     chai.use(chaiImmutable);
   
     describe('chai immutable example', () => {
       it('example', () => {
         expect(Set.of(1,2,3)).to.not.be.empty;
   
         expect(Set.of(1,2,3)).to.include(2);
         expect(Set.of(1,2,3)).to.include(5);
       })
     })
   

4. Voer het uit in de console:

   mocha --compilers ts:ts-node/register,tsx:ts-node/register 'test/**/*.spec.@(ts|tsx)'
   

plakband

tape is een minimalistisch JavaScript-testraamwerk, het voert TAP-compatibele markup uit.

tape installeren met de opdracht npm run

npm install --save-dev tape @types/tape

Als u tape met Typescript wilt gebruiken, moet u ts-node als globaal pakket installeren om deze opdracht uit te voeren

npm install -g ts-node

Nu ben je klaar om je eerste test te schrijven

//math.test.ts
import * as test from "tape";

test("Math test", (t) => {
    t.equal(4, 2 + 2);
    t.true(5 > 2 + 2);

    t.end();
});

Om een testrun-opdracht uit te voeren

ts-node node_modules/tape/bin/tape math.test.ts

In output zou je moeten zien

TAP version 13
# Math test
ok 1 should be equal
ok 2 should be truthy

1..2
# tests 2
# pass  2

# ok

Goed gedaan, je hebt net je TypeScript-test uitgevoerd.

Voer meerdere testbestanden uit

U kunt meerdere testbestanden tegelijk uitvoeren met behulp van padjokertekens. Om alle Typescript tests uit te voeren tests directory run command

ts-node node_modules/tape/bin/tape tests/**/*.ts

grap (ts-grap)

jest is een pijnloos JavaScript-testraamwerk door Facebook, met ts-jest kan worden gebruikt om TypeScript-code te testen.

Om jest te installeren met de opdracht npm run

npm install --save-dev jest @types/jest ts-jest typescript

Installeer jest voor het gebruiksgemak als wereldwijd pakket

npm install -g jest

Om jest met TypeScript te laten werken, moet u configuratie toevoegen aan package.json

//package.json
{
...
"jest": {
    "transform": {
      ".(ts|tsx)": "<rootDir>/node_modules/ts-jest/preprocessor.js"
    },
    "testRegex": "(/__tests__/.*|\\.(test|spec))\\.(ts|tsx|js)$",
    "moduleFileExtensions": ["ts", "tsx", "js"]
  }
}

Nu is jest klaar. Stel dat we een voorbeeld van Fizz Buz hebben om te testen

//fizzBuzz.ts
export function fizzBuzz(n: number): string {
    let output = "";
    for (let i = 1; i <= n; i++) {
        if (i % 5 && i % 3) {
            output += i + ' ';
        }
        if (i % 3 === 0) {
            output += 'Fizz ';
        }
        if (i % 5 === 0) {
            output += 'Buzz ';
        }
    }
    return output;
}

Voorbeeldtest kan eruit zien

//FizzBuzz.test.ts
/// <reference types="jest" />

import {fizzBuzz} from "./fizzBuzz";
test("FizzBuzz test", () =>{
    expect(fizzBuzz(2)).toBe("1 2 ");
    expect(fizzBuzz(3)).toBe("1 2 Fizz ");
});

Om een testrun uit te voeren

jest

In output zou je moeten zien

 PASS  ./fizzBuzz.test.ts
  ✓ FizzBuzz test (3ms)

Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total
Snapshots:   0 total
Time:        1.46s, estimated 2s
Ran all test suites.

Codedekking

jest ondersteunt het genereren van codedekkingsrapporten.

Als u codedekking met TypeScript wilt gebruiken, moet u een andere configuratieregel toevoegen aan package.json .

{
...
  "jest": {
  ...
    "testResultsProcessor": "<rootDir>/node_modules/ts-jest/coverageprocessor.js"
  }
}

Om tests uit te voeren met het genereren van een rapport voor de dekking

jest --coverage

Als je het gebruikt met onze voorbeeld bruiszoem, moet je het zien

 PASS  ./fizzBuzz.test.ts
  ✓ FizzBuzz test (3ms)

-------------|----------|----------|----------|----------|----------------|
File         |  % Stmts | % Branch |  % Funcs |  % Lines |Uncovered Lines |
-------------|----------|----------|----------|----------|----------------|
All files    |    92.31 |     87.5 |      100 |    91.67 |                |
 fizzBuzz.ts |    92.31 |     87.5 |      100 |    91.67 |             13 |
-------------|----------|----------|----------|----------|----------------|
Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total
Snapshots:   0 total
Time:        1.857s
Ran all test suites.

jest ook gemaakte map coverage die dekking rapport bevat in verschillende formaten, waaronder gebruiksvriendelijke html rapport in coverage/lcov-report/index.html