Security News
NIST Misses 2024 Deadline to Clear NVD Backlog
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.
Chai is a BDD / TDD assertion library for node and the browser that can be delightfully paired with any javascript testing framework. It provides functions to express assertions in a readable language, supporting both 'should' and 'expect' style syntaxes, as well as a traditional 'assert' style interface.
Should Style Assertions
Allows you to write assertions in a more human-readable form, which reads like English. The 'should' style extends each object with a 'should' property to start your chain.
chai.should();
var should = chai.should();
should.exist(value, 'value should not be null or undefined');
Expect Style Assertions
Provides a function called 'expect' to make assertions about values. This style is similar to 'should' but does not extend any objects, which is useful for working with libraries that don't allow object extensions.
var expect = chai.expect;
expect(value).to.exist.and.be.an('object');
Assert Style Assertions
Offers a more traditional testing interface, which is similar to Node.js' core 'assert' module but with more capabilities and better error messages.
var assert = chai.assert;
assert.typeOf(value, 'string', 'value is a string');
Chainable Language Chains
Provides chainable getters to improve the readability of your assertions, allowing you to write more expressive tests.
expect(value).to.be.an('array').that.includes(3);
Plugins
Supports plugins to extend its core functionalities, which can be used to add new assertions, matchers, or methods to the library.
var chaiHttp = require('chai-http');
chai.use(chaiHttp);
Jest is a delightful JavaScript Testing Framework with a focus on simplicity. It works out of the box for any React project and includes its own assertion library, which provides a similar but more integrated testing experience compared to Chai.
Jasmine is a behavior-driven development framework for testing JavaScript code. It does not rely on browsers, DOM, or any JavaScript framework, making it suitable for websites, Node.js projects, or anywhere JavaScript can run. It has its own assertion syntax that is somewhat similar to Chai's 'expect' syntax.
Expect.js is a minimalistic BDD-style assertions library that can be considered an alternative to Chai's 'expect' interface. It provides a similar API but is no longer actively maintained.
Chai is a multi-style assert library for node and the browser. It is based on @visionmedia's awesome should.js assert library and is completely API compatable.
This library was developed because, as awesome as should.js
is, it doesn't work in the browser.
As the lines blur (and sometimes disappear) between modules that run on either side, I needed
an assert package that allowed the same tests to run on both sides.
Chai is available for both node.js server-side and the browser.
Package is available through npm:
npm install chai
Recommend adding it to package.json devDependancies.
Include the chai browser build in your testing suite.
<script src="chai.js" type="text/javascript"></script>
Chai tests itself in the browser using mocha mocha.
Have a look at the test/browser
folder for an example.
The expect
style is server/browser BDD style assert language.
var expect = require('chai').expect;
var foo = 'bar';
expect(foo).to.be.a('string');
expect(foo).to.equal('bar');
expect(foo).to.have.length(3);
The should
style allows for chai to be a replacement for should.js
if the need arises.
var should = require('chai').should(); //actually call the the function
var foo = 'bar';
foo.should.be.a('string');
foo.should.equal('bar');
foo.should.have.length(3);
Should tests do not run in the browser.
Notice that the expect
require is just a reference to the expect
function, whereas
with the should
require, the function is being executed.
The assert
style is like the node.js included assert utility with few extras.
var assert = require('chai').assert;
var foo = 'bar';
assert.typeOf(foo, 'string');
assert.equal(foo, 'bar');
assert.length(foo, 3);
(The MIT License)
Copyright (c) 2011 Jake Luer jake@alogicalparadox.com
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.
FAQs
BDD/TDD assertion library for node.js and the browser. Test framework agnostic.
The npm package chai receives a total of 8,500,408 weekly downloads. As such, chai popularity was classified as popular.
We found that chai demonstrated a healthy version release cadence and project activity because the last version was released less than 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
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.
Security News
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
Security News
The Socket Research team breaks down a malicious npm package targeting the legitimate DOMPurify library. It uses obfuscated code to hide that it is exfiltrating browser and crypto wallet data.