https://github.com/cmstead/approvals-client

Javascript client for interacting with approvals-server node server
https://github.com/cmstead/approvals-client

Last synced: 9 months ago
JSON representation

Javascript client for interacting with approvals-server node server

• Host: GitHub
• URL: https://github.com/cmstead/approvals-client
• Owner: cmstead
• License: mpl-2.0
• Created: 2016-09-14T20:41:36.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2017-05-10T00:54:58.000Z (about 9 years ago)
• Last Synced: 2025-02-19T00:35:11.476Z (over 1 year ago)
• Language: JavaScript
• Size: 17.6 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Approvals Client

A client-side approvals library for making calls to a running Approvals Server instance. This 

has a peer dependency on [Approvals Server](https://www.npmjs.com/package/approvals-server).

## Setup

By default, Approvals Client comes preconfigured to connect with Approvals Server without any configuration. The 

client configuration assumes your connection will be localhost:1338. If this is not how your server is configured,

you can create a new configuration:

~~~

var approvalsClientConfig = {

    port: 1338, // your port goes here

    host: 'localhost' // your host name goes here

}

~~~

This configuration should be made global as the module assumes your configuration will be available at the top-level scope

in your browser.

## Using Approvals Client in your tests

Approvals client is currently designed to work with Mocha test framework. It will be expanded in the future to work with

Jasmine (and others). If you want to help expand support, pull requests are gladly accepted.

When writing tests, Approvals Client needs to be initialized with the test framework name.  A suggested method is as follows:

~~~

describe('My mocha test suite', function () {

    var approvals = approvalsClient('mocha');

    describe('some novel functionality', function () {

        it('should approve my object', function (done) {

            var myObj = {

                foo: 'bar',

                baz: 'quux'

            };

            approvals.verify(JSON.stringify(myObj), this, done);

        });

    });

});

~~~

**Important note:** Verify MUST be called with a string, the test context (this) and a done function. Approvals Client

uses the test context to construct file names, so providing the context allows the client to pass values to the

server correctly. Mocha's done function is needed because approvals requests are asynchronous and Mocha needs to be

alerted when any async behavior is complete.