Awesomely easy and useful TypeScript and JavaScript testing framework with test cases, compatible with selenium, coverage checkers and TAP reporters.

Quick Start

If you're loving TypeScript then pop on down to our TypeScript Quick Start.

Otherwise if you're more of a JavaScript kinda person, have a gander at our JavaScript Quick Start

Full documentation can be found on our wiki the examples are usually in TypeScript but should be pretty much the same code for JavaScript (just lose the access modifiers and types).

Alsatian is different

Using a different approach than other JavaScript test frameworks allows us to use more powerful patterns.

// no globals and typing support out of the box with intellisense
import { AsyncTest, Expect, Test, TestCase, TestFixture } from "alsatian";

@TestFixture("whatever you'd like to call the fixture")
export class SetOfTests {
    
    // use the async/await pattern in your tests as you would in your code
    @AsyncTest("asychronous test")
    public async asyncTest() {
        const response = await somethingToHappen();

        Expect(response).toBeDefined();
    }

    // pass arguments into your test functions to keep your test code from being repetative
    @TestCase(2, 2, 4)
    @TestCase(2, 3, 5)
    @TestCase(3, 3, 6)
    @Test("addition tests")
    public addTest(firstNumber: number, secondNumber: number, expectedSum: number) {
        Expect(firstNumber + secondNumber).toBe(expectedSum);
    }
}

Why would I use Alsatian?

The key question! Well Alsatian has a lot going for it here are just a few great things to note:

All the awesome features you love from existing frameworks
The TestCase decorator allows you to write smaller, DRY and more readable tests
No globals!
TAP support so you can use your favourite TAP reporter
Great CI process, every pull request and push on every branch is scrutinised to ensure high quality
100% coverage all statements, lines, branches are covered in Alsatian tests
Various services rate us very highly on lots of different factors, check out our badges
Everything is documented in a friendly and simple way to help you get to the unit test setup of your dreams
Being written in TypeScript it fits perfectly into your TypeScript but still compatible with JavaScript too!
Active support - if you've got a question, a suggestion or found an issue let us know and we'll get back to you quickly

Also it's lightning fast, watch it run all of it's unit tests in super quick time! Alsatian Test Run Video

Besides unit tests, what can I do with Alsatian

So many awesome things!

Support

If at any time things are unclear or you think there may be something going wrong feel free to raise an issue and we'll be glad to get back to you with a solution quickly.

Contributing

We're always glad to have help out with Alsatian, check out the guidelines

License

Alsatian has been released under the MIT license

Most popular functions for alsatian

To help you get started, we’ve selected a few alsatian examples, based on popular ways it is used in public projects.

alsatian.AsyncTest

alsatian.Expect

alsatian.TestCase