openproject/frontend/app/components/api/api-v3/hal-link/hal-link.service.test.ts

//-- copyright
// OpenProject is a project management system.
// Copyright (C) 2012-2015 the OpenProject Foundation (OPF)
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License version 3.
//
// OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
// Copyright (C) 2006-2013 Jean-Philippe Lang
// Copyright (C) 2010-2013 the ChiliProject Team
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
//
// See doc/COPYRIGHT.rdoc for more details.
//++

describe('HalLink service', () => {
  var $httpBackend:ng.IHttpBackendService;
  var HalLink;

  beforeEach(angular.mock.module('openproject.api'));
  beforeEach(angular.mock.inject((_HalLink_, _$httpBackend_) => {
    HalLink = _HalLink_;
    $httpBackend = _$httpBackend_;
  }));

  it('should exist', () => {
    expect(HalLink).to.exist;
  });

  describe('when creating a HalLink from an empty object', () => {
    var link;

    beforeEach(() => {
      link = HalLink.fromObject({});
    });

    it('should have the "get" method as default', () => {
      expect(link.method).to.eq('get');
    });

    it('should return a promise returning an empty object', () => {
      expect(link.$fetch()).to.eventually.eql({});
    });
  });

  describe('when using the link', () => {
    var link;
    var promise;
    var response;
    var apiRequest = () => {
      promise = link.$fetch();
      $httpBackend.expectGET('/api/link').respond(200, response);
      $httpBackend.flush();
    };

    beforeEach(() => {
      link = HalLink.fromObject({
        href: '/api/link'
      });
      response = {
        hello: 'world'
      };
    });
    
    it('should return a promise that returns the given value', () => {
      apiRequest();

      promise.should.be.fulfilled.then(value => {
        expect(value.hello).to.eq(response.hello);
      })
    });

    it('should not return a restangularized result', () => {
      apiRequest();

      promise.should.be.fulfilled.then(value => {
        expect(value.restangularized).to.not.be.ok;
      });
    });

    it('should return a transformed result if it is a resource', () => {
      response = {
        _links: {},
        hello: 'world'
      };
      apiRequest();

      promise.should.be.fulfilled.then(value => {
        expect(value.$halTransformed).to.be.true;
      });
    });

    it('should return a plain result if it is not a resource', () => {
      apiRequest();

      promise.should.be.fulfilled.then(value => {
        expect(value.$halTransformed).to.not.be.ok;
      });
    });

    it('should perform a GET request by default', () => {
      link.$fetch();
      $httpBackend.expectGET('/api/link').respond(200);
      $httpBackend.flush();
    });

    it('should pass parameters as query params to the request', () => {
      link.$fetch({
        hello: 'world'
      });
      $httpBackend.expectGET('/api/link?hello=world').respond(200);
      $httpBackend.flush();
    });

    it('should perform a POST request', () => {
      link.method = 'post';

      link.$fetch();
      $httpBackend.expectPOST('/api/link').respond(200);
      $httpBackend.flush();
    });

    it('should perform a PUT request', () => {
      link.method = 'put';

      link.$fetch();
      $httpBackend.expectPUT('/api/link').respond(200);
      $httpBackend.flush();
    });

    it('should perform a PATCH request', () => {
      link.method = 'patch';

      link.$fetch();
      $httpBackend.expectPATCH('/api/link').respond(200);
      $httpBackend.flush();
    });


    describe('when using the link function wrapper', () => {
      var func;
      const runChecks = () => {
        it('should return a function that fetches the data', () => {
          func();

          $httpBackend.expectGET('/api/link').respond(200);
          $httpBackend.flush()
        });

        it('should pass the params to $fetch', () => {
          var $fetch = sinon.spy(link, '$fetch');
          func('hello');

          expect($fetch.calledWith('hello')).to.be.true;
        });
      };

      describe('when using $toFunc', () => {
        beforeEach(() => {
          func = link.$toFunc();
        });
        runChecks();
      });

      describe('when using the static factory function', () => {
        beforeEach(() => {
          func = HalLink.asFunc(link);
          link = func.$link;
        });
        runChecks();
      });
    });
  });
});