TypeScript
Unit Testing

elsässisch

Alsatian ist ein in TypeScript geschriebenes Komponententest-Framework. Es ermöglicht die Verwendung von Testfällen und gibt TAP-konformes Markup aus.

Um es zu benutzen, installiere es von npm :

npm install alsatian --save-dev

Dann richten Sie eine Testdatei ein:

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);
    }
    
}

Eine vollständige Dokumentation finden Sie im GitHub-Repo von Alsatian .

Chai-unveränderliches Plugin

1. Installation von npm chai, chai-immutable und ts-node

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

2. Installieren Sie Typen für Mokka und Chai

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

3. Schreiben Sie eine einfache Testdatei:

     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. Führen Sie es in der Konsole aus:

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

Band

Tape ist ein minimalistisches JavaScript - Testframework. Es gibt TAP-konformes Markup aus.

So installieren Sie ein tape mithilfe des Befehls " npm run"

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

Um tape mit Typescript zu verwenden, müssen Sie ts-node als globales Paket installieren, um diesen Ausführungsbefehl auszuführen

npm install -g ts-node

Nun können Sie Ihren ersten Test schreiben

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

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

    t.end();
});

Testlaufbefehl ausführen

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

In der Ausgabe sollten Sie sehen

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

1..2
# tests 2
# pass  2

# ok

Gute Arbeit, Sie haben gerade Ihren TypeScript-Test durchgeführt.

Führen Sie mehrere Testdateien aus

Sie können mehrere Testdateien gleichzeitig mit Pfad-Platzhaltern ausführen. So führen Sie alle Typescript-Tests im tests Ausführungsbefehl aus

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

Scherz (ts-Scherz)

Jest ist ein schmerzloses JavaScript-Testframework von Facebook, mit ts-Jest kann TypeScript-Code getestet werden.

So installieren Sie Jest mit dem Befehl npm run

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

Um die Verwendung zu vereinfachen, installieren Sie jest als globales Paket

npm install -g jest

Damit jest mit TypeScript funktioniert, müssen Sie package.json eine Konfiguration 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"]
  }
}

Nun ist der jest fertig. Angenommen, wir haben Beispiel-Fizz-Buz zum 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;
}

Beispieltest könnte aussehen

//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 ");
});

Testlauf ausführen

jest

In der Ausgabe sollten Sie sehen

 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.

Codeabdeckung

jest unterstützt die Erzeugung von Berichten zur Codeabdeckung.

Um die Codeabdeckung mit TypeScript zu verwenden, müssen Sie package.json eine weitere Konfigurationszeile package.json .

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

Um Tests mit der Generierung des Abdeckungsberichts auszuführen

jest --coverage

Bei Verwendung mit unserem Beispiel-Fizz-Buzz sollten Sie es sehen

 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 erstellte außerdem Ordnerabdeckung coverage die Abdeckungsberichte in verschiedenen Formaten enthält, einschließlich benutzerfreundlicher HTML-Berichte in coverage/lcov-report/index.html