Setup and docs for unit testing javascript in browser and node.js

4 files changed, 1015 insertions, 0 deletions

diff --git a/tests/web/easypiechart.spec.js b/tests/web/easypiechart.spec.js
new file mode 100644
index 0000000000..3888de27cd
--- /dev/null
+++ b/tests/web/easypiechart.spec.js
@@ -0,0 +1,58 @@
+// delete these comments if not needed anymore.
+
+describe("percentage calculations for easy pie charts", function () {
+
+    // some easy functions to test. incomplete yet.
+    it('should return 50 if positive value between min and max', function () {
+        // act
+        var result = NETDATA.easypiechartPercentFromValueMinMax(1, 0, 2);
+        // assert
+        expect(result).toBe(50);
+    });
+
+    it('should return 0.1 if value is zero', function () {
+        // act
+        var result = NETDATA.easypiechartPercentFromValueMinMax(0, 0, 2);
+        // assert
+        expect(result).toBe(0.1);
+    });
+
+});
+
+
+// with xdescribe, this is skipped.
+// Delete the x to enable again and let it fail to test the build
+describe('creation of easy pie charts', function () {
+
+    beforeAll(function () {
+        // karma stores the loaded files relative to "base/".
+        // This command is needed to load HTML fixtures
+        jasmine.getFixtures().fixturesPath = "base/tests/web/fixtures";
+    });
+
+    it('should create new chart', function () {
+        // arrange
+        // Theoretically we can load some html. What about jquery? could this work?
+        // https://stackoverflow.com/questions/5337481/spying-on-jquery-selectors-in-jasmine
+        loadFixtures("easypiechart.creation.fixture1.html");
+
+        // for easy pie chart, we can fake the data result:
+        var data = {
+            result: [5]
+        };
+        // act
+        var result = NETDATA.easypiechartChartCreate(createState(), data);
+        // assert
+        expect(result).toBe(true);
+    });
+
+    function createState() {
+        // create a fake state with only needed properties? Spying? not figured it out yet...
+        return {
+            tmp: {
+
+            }
+        };
+    }
+
+});
\ No newline at end of file
diff --git a/tests/web/fixtures/easypiechart.creation.fixture1.html b/tests/web/fixtures/easypiechart.creation.fixture1.html
new file mode 100644
index 0000000000..f0f4eb777d
--- /dev/null
+++ b/tests/web/fixtures/easypiechart.creation.fixture1.html
@@ -0,0 +1,6 @@
+<div    data-netdata="system.cpu"
+        data-chart-library="easypiechart"
+        data-width="5%"
+        data-height="20"
+        data-after="-30"
+></div>
\ No newline at end of file
diff --git a/tests/web/karma.conf.js b/tests/web/karma.conf.js
new file mode 100644
index 0000000000..b3ee0943dc
--- /dev/null
+++ b/tests/web/karma.conf.js
@@ -0,0 +1,110 @@
+// Karma configuration
+// Generated on Sun Jul 16 2017 02:28:05 GMT+0200 (CEST)
+
+module.exports = function (config) {
+    config.set({
+
+        // base path that will be used to resolve all patterns (eg. files, exclude)
+        // this path should always resolve so that "." is the "netdata" root folder.
+        basePath: '../../',
+
+        // frameworks to use
+        // available frameworks: https://npmjs.org/browse/keyword/karma-adapter
+        frameworks: ['jasmine'],
+
+
+        // list of files / patterns to load in the browser
+        files: [
+            // order matters! load jquery libraries first
+            'web/lib/jquery*.js',
+            // our jasmine libs and fixtures
+            'tests/web/lib/*.js',
+            'tests/web/fixtures/*.html',
+            // then bootstrap
+            'web/lib/bootstrap*.js',
+            // then the rest
+            'web/lib/perfect-scrollbar*.js',
+            'web/lib/dygraph*.js',
+            'web/lib/gauge*.js',
+            'web/lib/morris*.js',
+            'web/lib/raphael*.js',
+            'web/lib/tableExport*.js',
+            'web/lib/d3*.js',
+            'web/lib/c3*.js',
+            // some CSS
+            'web/css/*.css',
+            'web/dashboard.css',
+            // our dashboard
+            'web/dashboard.js',
+            // finally our test specs
+            'tests/web/*.spec.js',
+        ],
+
+
+        // list of files to exclude
+        exclude: [],
+
+
+        // preprocess matching files before serving them to the browser
+        // available preprocessors: https://npmjs.org/browse/keyword/karma-preprocessor
+        preprocessors: {
+            'web/dashboard.js': ['coverage']
+        },
+
+
+        // test results reporter to use
+        // possible values: 'dots', 'progress'
+        // available reporters: https://npmjs.org/browse/keyword/karma-reporter
+        reporters: ['progress', 'coverage'],
+
+        // optionally, configure the reporter
+        coverageReporter: {
+            type : 'html',
+            dir : 'coverage/'
+        },
+
+        // web server port
+        port: 9876,
+
+
+        // enable / disable colors in the output (reporters and logs)
+        colors: true,
+
+
+        // level of logging
+        // possible values: config.LOG_DISABLE || config.LOG_ERROR || config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
+        logLevel: config.LOG_INFO,
+
+
+        // enable / disable watching file and executing tests whenever any file changes
+        autoWatch: false,
+        // not needed with WebStorm. Just hit Alt+Shift+R to rerun.
+
+        // start these browsers
+        // available browser launchers: https://npmjs.org/browse/keyword/karma-launcher
+        browsers: ['Chromium', 'ChromiumHeadless'],
+
+        customLaunchers: {
+            // Headless browsers could be useful for CI integration, if installed.
+            ChromiumHeadless: {
+                // needs Chrome/Chromium version >= 59
+                // see https://chromium.googlesource.com/chromium/src/+/lkgr/headless/README.md
+                base: "Chromium",
+                flags: [
+                    "--headless",
+                    "--disable-gpu",
+                    // Without a remote debugging port, Chromium exits immediately.
+                    "--remote-debugging-port=9222"
+                ]
+            }
+        },
+
+        // Continuous Integration mode
+        // if true, Karma captures browsers, runs the tests and exits
+        singleRun: false,
+
+        // Concurrency level
+        // how many browser should be started simultaneous
+        concurrency: Infinity
+    })
+};
diff --git a/tests/web/lib/jasmine-jquery.js b/tests/web/lib/jasmine-jquery.js
new file mode 100644
index 0000000000..6e4611c191
--- /dev/null
+++ b/tests/web/lib/jasmine-jquery.js
@@ -0,0 +1,841 @@
+/*!
+ Jasmine-jQuery: a set of jQuery helpers for Jasmine tests.
+
+ Version 2.1.1
+
+ https://github.com/velesin/jasmine-jquery
+
+ Copyright (c) 2010-2014 Wojciech Zawistowski, Travis Jeffery
+
+ Permission is hereby granted, free of charge, to any person obtaining
+ a copy of this software and associated documentation files (the
+ "Software"), to deal in the Software without restriction, including
+ without limitation the rights to use, copy, modify, merge, publish,
+ distribute, sublicense, and/or sell copies of the Software, and to
+ permit persons to whom the Software is furnished to do so, subject to
+ the following conditions:
+
+ The above copyright notice and this permission notice shall be
+ included in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+(function (root, factory) {
+    if (typeof module !== 'undefined' && module.exports && typeof exports !== 'undefined') {
+        factory(root, root.jasmine, require('jquery'));
+    } else {
+        factory(root, root.jasmine, root.jQuery);
+    }
+}((function() {return this; })(), function (window, jasmine, $) { "use strict";
+
+    jasmine.spiedEventsKey = function (selector, eventName) {
+        return [$(selector).selector, eventName].toString()
+    }
+
+    jasmine.getFixtures = function () {
+        return jasmine.currentFixtures_ = jasmine.currentFixtures_ || new jasmine.Fixtures()
+    }
+
+    jasmine.getStyleFixtures = function () {
+        return jasmine.currentStyleFixtures_ = jasmine.currentStyleFixtures_ || new jasmine.StyleFixtures()
+    }
+
+    jasmine.Fixtures = function () {
+        this.containerId = 'jasmine-fixtures'
+        this.fixturesCache_ = {}
+        this.fixturesPath = 'spec/javascripts/fixtures'
+    }
+
+    jasmine.Fixtures.prototype.set = function (html) {
+        this.cleanUp()
+        return this.createContainer_(html)
+    }
+
+    jasmine.Fixtures.prototype.appendSet= function (html) {
+        this.addToContainer_(html)
+    }
+
+    jasmine.Fixtures.prototype.preload = function () {
+        this.read.apply(this, arguments)
+    }
+
+    jasmine.Fixtures.prototype.load = function () {
+        this.cleanUp()
+        this.createContainer_(this.read.apply(this, arguments))
+    }
+
+    jasmine.Fixtures.prototype.appendLoad = function () {
+        this.addToContainer_(this.read.apply(this, arguments))
+    }
+
+    jasmine.Fixtures.prototype.read = function () {
+        var htmlChunks = []
+            , fixtureUrls = arguments
+
+        for(var urlCount = fixtureUrls.length, urlIndex = 0; urlIndex < urlCount; urlIndex++) {
+            htmlChunks.push(this.getFixtureHtml_(fixtureUrls[urlIndex]))
+        }
+
+        return htmlChunks.join('')
+    }
+
+    jasmine.Fixtures.prototype.clearCache = function () {
+        this.fixturesCache_ = {}
+    }
+
+    jasmine.Fixtures.prototype.cleanUp = function () {
+        $('#' + this.containerId).remove()
+    }
+
+    jasmine.Fixtures.prototype.sandbox = function (attributes) {
+        var attributesToSet = attributes || {}
+        return $('<div id="sandbox" />').attr(attributesToSet)
+    }
+
+    jasmine.Fixtures.prototype.createContainer_ = function (html) {
+        var container = $('<div>')
+            .attr('id', this.containerId)
+            .html(html)
+
+        $(document.body).append(container)
+        return container
+    }
+
+    jasmine.Fixtures.prototype.addToContainer_ = function (html){
+        var container = $(document.body).find('#'+this.containerId).append(html)
+
+        if (!container.length) {
+            this.createContainer_(html)
+        }
+    }
+
+    jasmine.Fixtures.prototype.getFixtureHtml_ = function (url) {
+        if (typeof this.fixturesCache_[url] === 'undefined') {
+            this.loadFixtureIntoCache_(url)
+        }
+        return this.fixturesCache_[url]
+    }
+
+    jasmine.Fixtures.prototype.loadFixtureIntoCache_ = function (relativeUrl) {
+        var self = this
+            , url = this.makeFixtureUrl_(relativeUrl)
+            , htmlText = ''
+            , request = $.ajax({
+            async: false, // must be synchronous to guarantee that no tests are run before fixture is loaded
+            cache: false,
+            url: url,
+            dataType: 'html',
+            success: function (data, status, $xhr) {
+                htmlText = $xhr.responseText
+            }
+        }).fail(function ($xhr, status, err) {
+            throw new Error('Fixture could not be loaded: ' + url + ' (status: ' + status + ', message: ' + err.message + ')')
+        })
+
+        var scripts = $($.parseHTML(htmlText, true)).find('script[src]') || [];
+
+        scripts.each(function(){
+            $.ajax({
+                async: false, // must be synchronous to guarantee that no tests are run before fixture is loaded
+                cache: false,
+                dataType: 'script',
+                url: $(this).attr('src'),
+                success: function (data, status, $xhr) {
+                    htmlText += '<script>' + $xhr.responseText + '</script>'
+                },
+                error: function ($xhr, status, err) {
+                    throw new Error('Script could not be loaded: ' + url + ' (status: ' + status + ', message: ' + err.message + ')')
+                }
+            });
+        })
+
+        self.fixturesCache_[relativeUrl] = htmlText;
+    }
+
+    jasmine.Fixtures.prototype.makeFixtureUrl_ = function (relativeUrl){
+        return this.fixturesPath.match('/$') ? this.fixturesPath + relativeUrl : this.fixturesPath + '/' + relativeUrl
+    }
+
+    jasmine.Fixtures.prototype.proxyCallTo_ = function (methodName, passedArguments) {
+        return this[methodName].apply(this, passedArguments)
+    }
+
+
+    jasmine.StyleFixtures = function () {
+        this.fixturesCache_ = {}
+        this.fixturesNodes_ = []
+        this.fixturesPath = 'spec/javascripts/fixtures'
+    }
+
+    jasmine.StyleFixtures.prototype.set = function (css) {
+        this.cleanUp()
+        this.createStyle_(css)
+    }
+
+    jasmine.StyleFixtures.prototype.appendSet = function (css) {
+        this.createStyle_(css)
+    }
+
+    jasmine.StyleFixtures.prototype.preload = function () {
+        this.read_.apply(this, arguments)
+    }
+
+    jasmine.StyleFixtures.prototype.load = function () {
+        this.cleanUp()
+        this.createStyle_(this.read_.apply(this, arguments))
+    }
+
+    jasmine.StyleFixtures.prototype.appendLoad = function () {
+        this.createStyle_(this.read_.apply(this, arguments))
+    }
+
+    jasmine.StyleFixtures.prototype.cleanUp = function () {
+        while(this.fixturesNodes_.length) {
+            this.fixturesNodes_.pop().remove()
+        }
+    }
+
+    jasmine.StyleFixtures.prototype.createStyle_ = function (html) {
+        var styleText = $('<div></div>').html(html).text()
+            , style = $('<style>' + styleText + '</style>')
+
+        this.fixturesNodes_.push(style)
+        $('head').append(style)
+    }
+
+    jasmine.StyleFixtures.prototype.clearCache = jasmine.Fixtures.prototype.clearCache
+    jasmine.StyleFixtures.prototype.read_ = jasmine.Fixtures.prototype.read
+    jasmine.StyleFixtures.prototype.getFixtureHtml_ = jasmine.Fixtures.prototype.getFixtureHtml_
+    jasmine.StyleFixtures.prototype.loadFixtureIntoCache_ = jasmine.Fixtures.prototype.loadFixtureIntoCache_
+    jasmine.StyleFixtures.prototype.makeFixtureUrl_ = jasmine.Fixtures.prototype.makeFixtureUrl_
+    jasmine.StyleFixtures.prototype.proxyCallTo_ = jasmine.Fixtures.prototype.proxyCallTo_
+
+    jasmine.getJSONFixtures = function () {
+        return jasmine.currentJSONFixtures_ = jasmine.currentJSONFixtures_ || new jasmine.JSONFixtures()
+    }
+
+    jasmine.JSONFixtures = function () {
+        this.fixturesCache_ = {}
+        this.fixturesPath = 'spec/javascripts/fixtures/json'
+    }
+
+    jasmine.JSONFixtures.prototype.load = function () {
+        this.read.apply(this, arguments)
+        return this.fixturesCache_
+    }
+
+    jasmine.JSONFixtures.prototype.read = function () {
+        var fixtureUrls = arguments
+
+        for(var urlCount = fixtureUrls.length, urlIndex = 0; urlIndex < urlCount; urlIndex++) {
+            this.getFixtureData_(fixtureUrls[urlIndex])
+        }
+
+        return this.fixturesCache_
+    }
+
+    jasmine.JSONFixtures.prototype.clearCache = function () {
+        this.fixturesCache_ = {}
+    }
+
+    jasmine.JSONFixtures.prototype.getFixtureData_ = function (url) {
+        if (!this.fixturesCache_[url]) this.loadFixtureIntoCache_(url)
+        return this.fixturesCache_[url]
+    }
+
+    jasmine.JSONFixtures.prototype.loadFixtureIntoCache_ = function (relativeUrl) {
+        var self = this
+            , url = this.fixturesPath.match('/$') ? this.fixturesPath + relativeUrl : this.fixturesPath + '/' + relativeUrl
+
+        $.ajax({
+            async: false, // must be synchronous to guarantee that no tests are run before fixture is loaded
+            cache: false,
+            dataType: 'json',
+            url: url,
+            success: function (data) {
+                self.fixturesCache_[relativeUrl] = data
+            },
+            error: function ($xhr, status, err) {
+                throw new Error('JSONFixture could not be loaded: ' + url + ' (status: ' + status + ', message: ' + err.message + ')')
+            }
+        })
+    }
+
+    jasmine.JSONFixtures.prototype.proxyCallTo_ = function (methodName, passedArguments) {
+        return this[methodName].apply(this, passedArguments)
+    }
+
+    jasmine.jQuery = function () {}
+
+    jasmine.jQuery.browserTagCaseIndependentHtml = function (html) {
+        return $('<div/>').append(html).html()
+    }
+
+    jasmine.jQuery.elementToString = function (element) {
+        return $(element).map(function () { return this.outerHTML; }).toArray().join(', ')
+    }
+
+    var data = {
+        spiedEvents: {}
+        , handlers:    []
+    }
+
+    jasmine.jQuery.events = {
+        spyOn: function (selector, eventName) {
+            var handler = function (e) {
+                var calls = (typeof data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)] !== 'undefined') ? data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)].calls : 0
+                data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)] = {
+                    args: jasmine.util.argsToArray(arguments),
+                    calls: ++calls
+                }
+            }
+
+            $(selector).on(eventName, handler)
+            data.handlers.push(handler)
+
+            return {
+                selector: selector,
+                eventName: eventName,
+                handler: handler,
+                reset: function (){
+                    delete data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)]
+                },
+                calls: {
+                    count: function () {
+                        return data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)] ?
+                            data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)].calls : 0;
+                    },
+                    any: function () {
+                        return data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)] ?
+                            !!data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)].calls : false;
+                    }
+                }
+            }
+        },
+
+        args: function (selector, eventName) {
+            var actualArgs = data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)].args
+
+            if (!actualArgs) {
+                throw "There is no spy for " + eventName + " on " + selector.toString() + ". Make sure to create a spy using spyOnEvent."
+            }
+
+            return actualArgs
+        },
+
+        wasTriggered: function (selector, eventName) {
+            return !!(data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)])
+        },
+
+        wasTriggeredWith: function (selector, eventName, expectedArgs, util, customEqualityTesters) {
+            var actualArgs = jasmine.jQuery.events.args(selector, eventName).slice(1)
+
+            if (Object.prototype.toString.call(expectedArgs) !== '[object Array]')
+                actualArgs = actualArgs[0]
+
+            return util.equals(actualArgs, expectedArgs, customEqualityTesters)
+        },
+
+        wasPrevented: function (selector, eventName) {
+            var spiedEvent = data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)]
+                , args = (jasmine.util.isUndefined(spiedEvent)) ? {} : spiedEvent.args
+                , e = args ? args[0] : undefined
+
+            return e && e.isDefaultPrevented()
+        },
+
+        wasStopped: function (selector, eventName) {
+            var spiedEvent = data.spiedEvents[jasmine.spiedEventsKey(selector, eventName)]
+                , args = (jasmine.util.isUndefined(spiedEvent)) ? {} : spiedEvent.args
+                , e = args ? args[0] : undefined
+
+            return e && e.isPropagationStopped()
+        },
+
+        cleanUp: function () {
+            data.spiedEvents = {}
+            data.handlers    = []
+        }
+    }
+
+    var hasProperty = function (actualValue, expectedValue) {
+        if (expectedValue === undefined)
+            return actualValue !== undefined
+
+        return actualValue === expectedValue
+    }
+
+    beforeEach(function () {
+        jasmine.addMatchers({
+            toHaveClass: function () {
+                return {
+                    compare: function (actual, className) {
+                        return { pass: $(actual).hasClass(className) }
+                    }
+                }
+            },
+
+            toHaveCss: function () {
+                return {
+                    compare: function (actual, css) {
+                        var stripCharsRegex = /[\s;\"\']/g
+                        for (var prop in css) {
+                            var value = css[prop]
+                                // see issue #147 on gh
+                            ;if ((value === 'auto') && ($(actual).get(0).style[prop] === 'auto')) continue
+                            var actualStripped = $(actual).css(prop).replace(stripCharsRegex, '')
+                            var valueStripped = value.replace(stripCharsRegex, '')
+                            if (actualStripped !== valueStripped) return { pass: false }
+                        }
+                        return { pass: true }
+                    }
+                }
+            },
+
+            toBeVisible: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $(actual).is(':visible') }
+                    }
+                }
+            },
+
+            toBeHidden: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $(actual).is(':hidden') }
+                    }
+                }
+            },
+
+            toBeSelected: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $(actual).is(':selected') }
+                    }
+                }
+            },
+
+            toBeChecked: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $(actual).is(':checked') }
+                    }
+                }
+            },
+
+            toBeEmpty: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $(actual).is(':empty') }
+                    }
+                }
+            },
+
+            toBeInDOM: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $.contains(document.documentElement, $(actual)[0]) }
+                    }
+                }
+            },
+
+            toExist: function () {
+                return {
+                    compare: function (actual) {
+                        return { pass: $(actual).length }
+                    }
+                }
+            },
+
+            toHaveLength: function () {
+                return {
+                    compare: function (actual, length) {
+                        return { pass: $(actual).length === length }
+                    }
+                }
+            },
+
+            toHaveAttr: function () {
+                return {
+                    compare: function (actual, attributeName, expectedAttributeValue) {
+                        return { pass: hasProperty($(actual).attr(attributeName), expectedAttributeValue) }
+                    }
+                }
+            },
+
+            toHaveProp: function () {
+                return {
+                    compare: function (actual, propertyName, expectedPropertyValue) {
+                        return { pass: hasProperty($(actual).prop(propertyName), expectedPropertyValue) }
+                    }
+                }
+            },
+
+            toHaveId: function () {
+                return {
+                    compare: function (actual, id) {
+                        return { pass: $(actual).attr('id') == id }
+                    }
+                }
+            },
+
+            toHaveHtml: function () {
+                return {
+                    compare: function (actual, html) {
+                        return { pass: $(actual).html() == jasmine.jQuery.browserTagCaseIndependentHtml(html) }
+                    }
+                }
+            },
+
+            toContainHtml: function () {
+                return {
+                    compare: function (actual, html) {
+                        var actualHtml = $(actual).html()
+                            , expectedHtml = jasmine.jQuery.browserTagCaseIndependentHtml(html)
+
+                        return { pass: (actualHtml.indexOf(expectedHtml) >= 0) }
+                    }
+                }
+            },
+
+            toHaveText: function () {
+                return {
+                    compare: function (actual, text) {
+                        var actualText = $(actual).text()
+                        var trimmedText = $.trim(actualText)
+
+                        if (text && $.isFunction(text.test)) {
+                            return { pass: text.test(actualText) || text.test(trimmedText) }
+                        } else {
+                            return { pass: (actualText == text || trimmedText == text) }
+                        }
+                    }
+                }
+            },
+
+            toContainText: function () {
+                return {
+                    compare: function (actual, text) {
+                        var trimmedText = $.trim($(actual).text())
+
+                        if (text && $.isFunction(text.test)) {
+                            return { pass: text.test(trimmedText) }
+                        } else {
+                            return { pass: trimmedText.indexOf(text) != -1 }
+                        }
+                    }
+                }
+            },
+
+            toHaveValue: function () {
+                return {
+                    compare: function (actual, value) {
+                        return { pass: $(actual).val() === value }
+                    }
+                }
+            },
+
+            toHaveData: function () {
+                return {
+                    compare: function (actual, key, expectedValue) {
+                        return { pass: hasProperty($(actual).data(key), expectedValue) }
+                    }
+                }
+            },
+
+            toContainElement: function () {
+                return {
+                    compare: function (actual, selector) {
+                        return { pass: $(actual).find(selector).length }
+                    }
+                }
+            },
+
+            toBeMatchedBy: function () {
+                return {
+                    compare: function (actual, selector) {
+                        return { pass: $(actual).filter(selector).length }
+                    }
+                }
+            },
+
+            toBeDisabled: function () {
+                return {
+                    compare: function (actual, selector) {
+                        return { pass: $(actual).is(':disabled') }
+                    }
+                }
+            },
+
+            toBeFocused: function (selector) {
+                return {
+                    compare: function (actual, selector) {
+                        return { pass: $(actual)[0] === $(actual)[0].ownerDocument.activeElement }
+                    }
+                }
+            },
+
+            toHandle: function () {
+                return {
+                    compare: function (actual, event) {
+                        if ( !actual || actual.length === 0 ) return { pass: false };
+                        var events = $._data($(actual).get(0), "events")
+
+                        if (!events || !event || typeof event !== "string") {
+                            return { pass: false }
+                        }
+
+                        var namespaces = event.split(".")
+                            , eventType = namespaces.shift()
+                            , sortedNamespaces = namespaces.slice(0).sort()
+                            , namespaceRegExp = new RegExp("(^|\\.)" + sortedNamespaces.join("\\.(?:.*\\.)?") + "(\\.|$)")
+
+                        if (events[eventType] && namespaces.length) {
+                            for (var i = 0; i < events[eventType].length; i++) {
+                                var namespace = events[eventType][i].namespace
+
+                                if (namespaceRegExp.test(namespace))
+                                    return { pass: true }
+                            }
+                        } else {
+                            return { pass: (events[eventType] && events[eventType].length > 0) }
+                        }
+
+                        return { pass: false }
+                    }
+                }
+            },
+
+            toHandleWith: function () {
+                return {
+                    compare: function (actual, eventName, eventHandler) {
+                        if ( !actual || actual.length === 0 ) return { pass: false };
+                        var normalizedEventName = eventName.split('.')[0]
+                            , stack = $._data($(actual).get(0), "events")[normalizedEventName]
+
+                        for (var i = 0; i < stack.length; i++) {
+                            if (stack[i].handler == eventHandler) return { pass: true }
+                        }
+
+                        return { pass: false }
+                    }
+                }
+            },
+
+            toHaveBeenTriggeredOn: function () {
+                return {
+                    compare: function (actual, selector) {
+                        var result = { pass: jasmine.jQuery.events.wasTriggered(selector, actual) }
+
+                        result.message = result.pass ?
+                            "Expected event " + $(actual) + " not to have been triggered on " + selector :
+                            "Expected event " + $(actual) + " to have been triggered on " + selector
+
+                        return result;
+                    }
+                }
+            },
+
+            toHaveBeenTriggered: function (){
+                return {
+                    compare: function (actual) {
+                        var eventName = actual.eventName
+                            , selector = actual.selector
+                            , result = { pass: jasmine.jQuery.events.wasTriggered(selector, eventName) }
+
+                        result.message = result.pass ?
+                            "Expected event " + eventName + " not to have been triggered on " + selector :
+                            "Expected event " + eventName + " to have been triggered on " + selector
+
+                        return result
+                    }
+                }
+            },
+
+            toHaveBeenTriggeredOnAndWith: function (j$, customEqualityTesters) {
+                return {
+                    compare: function (actual, selector, expectedArgs) {
+                        var wasTriggered = jasmine.jQuery.events.wasTriggered(selector, actual)
+                            , result = { pass: wasTriggered && jasmine.jQuery.events.wasTriggeredWith(selector, actual, expectedArgs, j$, customEqualityTesters) }
+
+                        if (wasTriggered) {
+                            var actualArgs = jasmine.jQuery.events.args(selector, actual, expectedArgs)[1]
+                            result.message = result.pass ?
+                                "Expected event " + actual + " not to have been triggered with " + jasmine.pp(expectedArgs) + " but it was triggered with " + jasmine.pp(actualArgs) :
+                                "Expected event " + actual + " to have been triggered with " + jasmine.pp(expectedArgs) + "  but it was triggered with " + jasmine.pp(actualArgs)
+
+                        } else {
+                            // todo check on this
+                            result.message = result.pass ?
+                                "Expected event " + actual + " not to have been triggered on " + selector :
+                                "Expected event " + actual + " to have been triggered on " + selector
+                        }
+
+                        return result
+                    }
+                }
+            },
+
+            toHaveBeenPreventedOn: function () {
+                return {
+                    compare: function (actual, selector) {
+                        var result = { pass: jasmine.jQuery.events.wasPrevented(selector, actual) }
+
+                        result.message = result.pass ?
+                            "Expected event " + actual + " not to have been prevented on " + selector :
+                            "Expected event " + actual + " to have been prevented on " + selector
+
+                        return result
+                    }
+                }
+            },
+
+            toHaveBeenPrevented: function () {
+                return {
+                    compare: function (actual) {
+                        var eventName = actual.eventName
+                            , selector = actual.selector
+                            , result = { pass: jasmine.jQuery.events.wasPrevented(selector, eventName) }
+
+                        result.message = result.pass ?
+                            "Expected event " + eventName + " not to have been prevented on " + selector :
+                            "Expected event " + eventName + " to have