test/test.contacts.js

describe("contacts", function () {
    var contacts = require('cordova/plugin/contacts'),
        exec = require('cordova/exec'),
        Contact = require('cordova/plugin/Contact'),
        ContactError = require('cordova/plugin/ContactError');

    describe("create", function () {
        it("returns a new contact", function () {
            expect(contacts.create() instanceof Contact).toBe(true);
        });

        it("will copy over properties that are set in the arguments", function () {
            var c = contacts.create({
                name: "Gord Tanner",
                note: "he moved the cheese"
            });

            expect(c.name).toBe("Gord Tanner");
            expect(c.note).toBe("he moved the cheese");
        });

        it("will not copy over properties that don't exist in the Contact object", function () {
            var c = contacts.create({
                isAwesome: "probably"
            });

            expect(c.isAwesome).not.toBeDefined();
        });
    });

    describe("find", function () {
        it("throws an error with no success callback", function () {
            expect(contacts.find).toThrow("You must specify a success callback for the find command.");
        });
        
        it("doesn't call exec with null fields", function () {
            exec.reset();
            contacts.find(null, jasmine.createSpy());
            expect(exec).not.toHaveBeenCalled();
        });

        it("doesn't call exec with empty fields", function () {
            exec.reset();
            contacts.find([], jasmine.createSpy());
            expect(exec).not.toHaveBeenCalled();
        });

        it("calls the error callback when no fields provied", function () {
            var success = jasmine.createSpy(),
                error = jasmine.createSpy();

            contacts.find(undefined, success, error);
            expect(error).toHaveBeenCalledWith(new ContactError(ContactError.INVALID_ARGUMENT_ERROR));
        });

        it("calls exec", function () {
            //http://www.imdb.com/title/tt0181536/ 
            var success = jasmine.createSpy(),
                error = jasmine.createSpy(),
                fields = {name: "Forrester"},
                options = {};

            contacts.find(fields, success, error, options);
            expect(exec).toHaveBeenCalledWith(jasmine.any(Function), error, "Contacts", "search", [fields, options]);
            //HACK: I am not expecting to have our success function passed in as there is some stuff done clientside
            expect(exec).not.toHaveBeenCalledWith(success, error, "Contacts", "search", [fields, options]);
        });

        it("creates a contact for each value returned", function () {
            //http://www.imdb.com/title/tt0266543/
            var success = jasmine.createSpy(),
                error = jasmine.createSpy(),
                fields = {name: "Nemo"},
                options = {};

            spyOn(contacts, "create");
            contacts.find(fields, success, error, options);
            //exec the success callback
            exec.mostRecentCall.args[0]([{
                name: "Nemo", 
                note: "He has a lucky fin"
            },
            {
                name: "Nemo",
                note: "He is also a clownfish"
            }]);

            expect(contacts.create.callCount).toBe(2);
            expect(contacts.create).toHaveBeenCalledWith({
                name: "Nemo",
                note: "He has a lucky fin"
            });
            expect(contacts.create).toHaveBeenCalledWith({
                name: "Nemo",
                note: "He is also a clownfish"
            });
        });

        it("calls the success callback on success", function () {
            //http://www.imdb.com/title/tt0889134/
            var success = jasmine.createSpy(),
                error = jasmine.createSpy(),
                fields = {name: "Amanda"},
                options = {};

            spyOn(contacts, "create").andReturn("Rehab");
            contacts.find(fields, success, error, options);
            //exec the success callback
            exec.mostRecentCall.args[0]([0, 0, 0]);
            expect(success).toHaveBeenCalledWith(["Rehab", "Rehab", "Rehab"]);
        });
    });
});