Testing

L'unit-testing n'est pas optionnel.

Avec un langage dynamiquement typé comme le JavaScript, si la couverture de code par les tests n'est pas suffisante, nous ne sommes même pas à l'abris des erreurs de syntaxe.

Pas de tests unitaires => pas de refactoring & pas d'update de dépendances => dette technique & régression perpétuelle => peur du changement => vélocité 0

Les tests unitaires permettent de localiser immédiatement les sources des erreurs.

Les tests unitaires doivent être implémentés en premier.

https://guide-agile.wishtack.io/extreme-programming/testing

TestingLe Guide Agile par Wishtack

La modularité facilite l'implémentation des tests unitaires.

Les Outils

Il existe plusieurs frameworks et outils pour implémenter les tests unitaires Node.js

Les frameworks les plus utilisés sont Jasmine et Mocha. Ceux-ci étant très similaires, il est recommandé d'utiliser Jasmine qui permet également d'implémenter les tests Angular.

http://thejsguy.com/2015/01/12/jasmine-vs-mocha-chai-and-sinon.html

http://thejsguy.com/2015/01/12/jasmine-vs-mocha-chai-and-sinon.htmlthejsguy.com

http://jasmine.github.io/

Jasmine Documentation

https://mochajs.org/

Mocha - the fun, simple, flexible JavaScript test framework

https://jestjs.io/

Jest

Jasmine

Exemple avec Jasmine

const cache = require('cache');
const User = require('user');
const Wish = require('wish');

describe('User', () => {

    beforeEach(() => {
        cache.clear();
    });

    afterEach(() => {
        cache.clear();
    });

    it('should add wishes', function() {

        const user = new User();
        const wish = new Wish({title: 'Holidays'});

        /* Add a wish. */
        user.addWish(wish);

        /* Check wishlist. */
        expect(user.wishList().length).toEqual(1);
        expect(user.wishList()[0].title()).toEqual('Holidays');

    });

});

Exécution des tests avec jasmine-node

yarn add --dev jasmine-node

yarn jasmine-node --autoTest --watchFolders app.js routes views test/unit

Jasmine's Spies

Les spies de Jasmine sont une implémentation de mocks.

Ils permettent d'implémenter des tests comportementaux. Autrement dit, ils permettent de simuler le comportement d'une partie de code que l'on souhaite exclure du test unitare.

Sans mocks, les tests seraient des tests d'intégration et non des tests unitaires.

describe('SearchEngine', () => {

    it('should pass locale to third party api', () => {

        /* Spying on `thirdPartySearchApi.search` and faking result. */
        spyOn(thirdPartySearchApi, 'search').and.returnValue([
            {
                title: 'Wishtack - Making Your Wishes Come True',
                url: 'https://www.wishtack.com'
            }
        ]);

        /* Trigger search. */
        searchEngine.search({keywords: 'Wishtack'});

        /* Check spy's call count. */
        expect(thirdPartySearchApi.search.callCount).toBe(1);

        /* Check spy's call args. */
        expect(thirdPartySearchApi.search).toHaveBeenCalledWith({
            country: 'US',
            keywords: 'Wishtack',
            language: 'en'
        });

    });

});

Pensez à tester les cas d'erreur !

HTTP Testing

Pour tester le routing et les interactions avec le serveur, il faut simuler les requêtes à l'aide d'outils comme supertest.

https://github.com/visionmedia/supertest

GitHub - visionmedia/supertest: 🕷 Super-agent driven library for testing node.js HTTP servers using a fluent API.GitHub

const express = require('express');
const request = require('supertest');

describe('wishes RESTful API', () => {

    it('should return wishes', (done) => {

        request(app)
            .get('/users/123456/wishes/')
            .set('Accept', 'application/json')
            .expect(200, [
                {
                    id: 'abcdef',
                    title: 'Holidays'
                }
            ], done);

    });
    
});