jasmine-expect
Advanced tools
Additional matchers for the Jasmine BDD JavaScript testing library
Readable tests.
The Jasmine testing framework from Pivotal Labs comes with this default set of matchers;
expect(fn).toThrow(e);
expect(instance).toBe(instance);
expect(mixed).toBeDefined();
expect(mixed).toBeFalsy();
expect(number).toBeGreaterThan(number);
expect(number).toBeLessThan(number);
expect(mixed).toBeNull();
expect(mixed).toBeTruthy();
expect(mixed).toBeUndefined();
expect(array).toContain(member);
expect(string).toContain(substring);
expect(mixed).toEqual(mixed);
expect(mixed).toMatch(pattern);
Using the default Matchers your tests and failure output might look something like this;
it('should expose the expected API', function() {
expect(typeof record.save).toEqual('function');
});
Expected "undefined" to equal "function"
it('should distribute evenly', function() {
expect(basket.items % 2 === 0).toEqual(true);
});
Expected false to equal true
Using Jasmine-Matchers the same tests and failure output can be written like this;
it('should expose the expected API', function() {
expect(record).toHaveMethod('save');
});
Expected member "save" of { save : undefined } to be function.
it('should distribute evenly', function() {
expect(basket).toHaveEvenNumber('items');
});
Expected member "items" of { items : 25 } to be even number.
npm install jasmine-expect --save-dev
bower install jasmine-expect --save-dev
Downloads are available on the releases page.
Include Jasmine Matchers after Jasmine but before your tests.
<script src="/path/to/jasmine-matchers.js"></script>
Integration is easy with the karma-jasmine-matchers plugin.
When using jasmine-node 1.x, provide the path to where Jasmine Matchers is installed as the value for --requireJsSetup.
jasmine-node --requireJsSetup node_modules/jasmine-expect/index.js test
jasmine-node 2.x has no such hooks that I'm aware of for loading helpers, in this case the following call is needed before the first test in your suite.
require('jasmine-expect');
Jasmine-Matchers-Snippets can be installed with Package Control to ease development with Jasmine Matchers in Sublime Text.
expect([]).toBeArray();
expect({
memberName: []
}).toHaveArray('memberName');
expect([true, false, true]).toBeArrayOfBooleans();
expect({
memberName: [true, false, true]
}).toHaveArrayOfBooleans('memberName');
expect([12, 82, 7]).toBeArrayOfNumbers();
expect({
memberName: [12, 82, 7]
}).toHaveArrayOfNumbers('memberName');
expect([{}, {}]).toBeArrayOfObjects();
expect({
memberName: [{}, {}]
}).toHaveArrayOfObjects('memberName');
expect([null, 31, 'hi']).toBeArrayOfSize(3);
expect({
memberName: [null, 31, 'hi']).toBeArrayOfSi
}).toHaveArrayOfSize('memberName', size);
expect(['foo', 'bar']).toBeArrayOfStrings();
expect({
memberName: ['foo', 'bar']
}).toHaveArrayOfStrings('memberName');
expect([]).toBeEmptyArray();
expect({
memberName: []
}).toHaveEmptyArray('memberName');
expect([98, 'banana']).toBeNonEmptyArray();
expect({
memberName: [98, 'banana']
}).toHaveNonEmptyArray('memberName');
expect(false).toBeBoolean();
expect({
memberName: false
}).toHaveBoolean('memberName');
expect(false).toBeFalse();
expect({
memberName: false
}).toHaveFalse('memberName');
expect(true).toBeTrue();
expect({
memberName: true
}).toHaveTrue('memberName');
expect(new Date('2014-01-01')).toBeAfter(new Date('1975-01-01'));
expect({
memberName: new Date('2014-01-01')
}).toHaveDateAfter('memberName', new Date('1975-01-01'));
expect(new Date('1975-01-01')).toBeBefore(new Date('2014-01-01'));
expect({
memberName: new Date('1975-01-01')
}).toHaveDateBefore('memberName', new Date('2014-01-01'));
expect(new Date()).toBeDate();
expect({
memberName: new Date()
}).toHaveDate('memberName');
expect('2013-07-08T07:29:15').toBeIso8601();
expect({
memberName: '2013-07-08T07:29:15'
}).toHaveIso8601('memberName');
expect(function() {}).toBeFunction();
expect({
memberName: function() {}
}).toHaveMethod('memberName');
expect(function() {
return badReference.unreachable;
}).toThrowAnyError();
expect(function() {
return badReference.unreachable;
}).toThrowErrorOfType(ReferenceError);
expect('12').toBeCalculable();
expect({
memberName: '14'
}).toHaveCalculable('memberName');
expect(4).toBeEvenNumber();
expect({
memberName: 4
}).toHaveEvenNumber('memberName');
expect(66).toBeNumber();
expect({
memberName: 66
}).toHaveNumber('memberName');
expect(3).toBeOddNumber();
expect({
memberName: 3
}).toHaveOddNumber('memberName');
expect(10).toBeWholeNumber();
expect({
memberName: 10
}).toHaveWholeNumber('memberName');
expect(6).toBeWithinRange(0, 10);
expect({
memberName: 6
}).toHaveNumberWithinRange('memberName', 0, 10);
expect({}).toBeEmptyObject();
expect({
memberName: {}
}).toHaveEmptyObject('memberName');
expect({
some: 'data'
}).toBeNonEmptyObject();
expect({
memberName: {
some: 'data'
}
}).toHaveNonEmptyObject('memberName');
expect({}).toBeObject();
expect({
memberName: {}
}).toHaveObject('memberName');
expect({
memberName: undefined
}).toHaveMember('memberName');
expect({
name: 'Clive',
age: 72
}).toImplement({
name: String,
age: Number
});
expect('').toBeEmptyString();
expect({
memberName: ''
}).toHaveEmptyString('memberName');
expect('<div></div>').toBeHtmlString();
expect({
memberName: '<div></div>'
}).toHaveHtmlString('memberName');
expect('{"name":"Winston"}').toBeJsonString();
expect({
memberName: '{"name":"Winston"}'
}).toHaveJsonString('memberName');
expect('Antidisestablishmentarianism').toBeLongerThan('No');
expect({
memberName: 'Antidisestablishmentarianism'
}).toHaveStringLongerThan('memberName', 'No');
expect('filled up').toBeNonEmptyString();
expect({
memberName: 'filled up'
}).toHaveNonEmptyString('memberName');
expect('Paul').toBeSameLengthAs('Jean');
expect({
memberName: 'Paul'
}).toHaveStringSameLengthAs('memberName', 'Jean');
expect('No').toBeShorterThan('Antidisestablishmentarianism');
expect({
memberName: 'No'
}).toHaveStringShorterThan('memberName', 'Antidisestablishmentarianism');
expect('').toBeString();
expect({
memberName: ''
}).toHaveString('memberName');
expect(' ').toBeWhitespace();
expect('grandmother').toEndWith('mother');
expect('physiotherapy').toStartWith('physio');
expect({
memberName: ' '
}).toHaveWhitespaceString('memberName');
During development, Jasmine-Matchers is tested against the following environments.
FAQs
Write Beautiful Specs with Custom Matchers
We found that jasmine-expect demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Newly introduced telemetry in devenv 1.4 sparked a backlash over privacy concerns, leading to the removal of its AI-powered feature after strong community pushback.
Security News
TC39 met in Seattle and advanced 9 JavaScript proposals, including three to Stage 4, introducing new features and enhancements for a future ECMAScript release.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.