2013-06-20 05:38:19 +00:00
|
|
|
---
|
2013-10-14 02:36:58 +00:00
|
|
|
title: Chai.js
|
2015-11-24 05:06:06 +00:00
|
|
|
category: JavaScript libraries
|
2017-08-30 06:20:27 +00:00
|
|
|
weight: -3
|
2020-07-04 13:33:09 +00:00
|
|
|
updated: 2018-06-25
|
2017-08-30 06:22:27 +00:00
|
|
|
version: chai v4.x
|
2017-10-14 18:53:08 +00:00
|
|
|
description: |
|
|
|
|
expect(x).to.be.equal(y) 〉 assert.equal(x, y) 〉 .to.be.true 〉 jQuery, assertions, TDD and BDD, and other Chai examples.
|
2013-10-14 02:36:58 +00:00
|
|
|
---
|
2013-06-20 05:38:19 +00:00
|
|
|
|
|
|
|
### Assert
|
|
|
|
|
2017-08-30 06:22:27 +00:00
|
|
|
```js
|
|
|
|
const { assert } = require('chai')
|
|
|
|
```
|
|
|
|
{: .-setup}
|
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
```js
|
|
|
|
assert(val)
|
|
|
|
assert.fail(actual, expected)
|
|
|
|
assert.ok(val) // is truthy
|
|
|
|
assert.equal(actual, expected) // compare with ==
|
|
|
|
assert.strictEqual(actual, expected) // compare with ===
|
|
|
|
assert.deepEqual(actual, expected) // deep equal check
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
assert.isTrue(val)
|
|
|
|
assert.isFalse(val)
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
assert.isNull(val)
|
|
|
|
assert.isNotNull(val)
|
|
|
|
assert.isUndefined(val)
|
|
|
|
assert.isDefined(val)
|
|
|
|
assert.isFunction(val)
|
|
|
|
assert.isObject(val)
|
|
|
|
assert.isArray(val)
|
|
|
|
assert.isString(val)
|
|
|
|
assert.isNumber(val)
|
|
|
|
assert.isBoolean(val)
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
assert.typeOf(/tea/, 'regexp') // Object.prototype.toString()
|
|
|
|
assert.instanceOf(chai, Tea)
|
|
|
|
assert.include([ a,b,c ], a)
|
|
|
|
assert.match(val, /regexp/)
|
|
|
|
assert.property(obj, 'tea') // 'tea' in object
|
|
|
|
assert.deepProperty(obj, 'tea.green')
|
|
|
|
assert.propertyVal(person, 'name', 'John')
|
|
|
|
assert.deepPropertyVal(post, 'author.name', 'John')
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
assert.lengthOf(object, 3)
|
|
|
|
assert.throws(function() { ... })
|
|
|
|
assert.throws(function() { ... }, /reference error/)
|
|
|
|
assert.doesNotThrow
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
assert.operator(1, '<', 2)
|
|
|
|
assert.closeTo(actual, expected)
|
|
|
|
```
|
|
|
|
|
|
|
|
See: [Assert API](http://chaijs.com/api/assert/) _(chaijs.com)_
|
|
|
|
|
|
|
|
### BDD syntax
|
|
|
|
|
2017-08-30 06:22:27 +00:00
|
|
|
```js
|
|
|
|
const { expect } = require('chai')
|
|
|
|
```
|
|
|
|
{: .-setup}
|
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
```js
|
|
|
|
expect(object)
|
|
|
|
.to.equal(expected)
|
|
|
|
.to.eql(expected) // deep equality
|
|
|
|
.to.deep.equal(expected) // same as .eql
|
|
|
|
.to.be.a('string')
|
|
|
|
.to.include(val)
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.be.ok(val)
|
|
|
|
.be.true
|
|
|
|
.be.false
|
|
|
|
.to.exist
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.to.be.null
|
|
|
|
.to.be.undefined
|
|
|
|
.to.be.empty
|
|
|
|
.to.be.arguments
|
|
|
|
.to.be.function
|
|
|
|
.to.be.instanceOf
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.to.be.gt(5) // aka: .above .greaterThan
|
|
|
|
.to.be.gte(5) // aka: .at.least
|
|
|
|
.to.be.lt(5) // aka: .below
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.to.respondTo('bar')
|
|
|
|
.to.satisfy((n) => n > 0)
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.to.have.members([2, 3, 4])
|
|
|
|
.to.have.keys(['foo'])
|
|
|
|
.to.have.key('foo')
|
2018-06-25 09:10:01 +00:00
|
|
|
.to.have.lengthOf(3)
|
2017-08-30 06:20:27 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
expect(() => { ··· })
|
|
|
|
.to.throw(/not a function/)
|
|
|
|
```
|
|
|
|
|
|
|
|
See: [BDD](http://chaijs.com/api/bdd/) _(chaijs.com)_
|
2013-06-20 05:38:19 +00:00
|
|
|
|
|
|
|
### Should: chains
|
|
|
|
|
|
|
|
.to .be .been .is .that .and .have .with .at .of .same
|
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
These don't do anything and can be chained.
|
2014-02-25 10:32:14 +00:00
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
### Should not
|
2013-06-20 05:38:19 +00:00
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
```js
|
|
|
|
expect(object).not.equal('x')
|
|
|
|
```
|
2014-03-26 11:56:06 +00:00
|
|
|
|
2017-08-30 13:57:25 +00:00
|
|
|
## Chai with jQuery
|
|
|
|
|
|
|
|
### Using chai-jquery
|
2014-02-25 10:32:14 +00:00
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
```js
|
|
|
|
global.jQuery = ···
|
|
|
|
chai.use(require('chai-jquery'))
|
|
|
|
```
|
2017-08-30 13:57:25 +00:00
|
|
|
{: .-setup}
|
2017-08-30 06:20:27 +00:00
|
|
|
|
|
|
|
```js
|
|
|
|
expect($body)
|
|
|
|
.have.attr('foo')
|
|
|
|
.have.prop('disabled')
|
|
|
|
.have.css('background')
|
|
|
|
.have.css('background-color', '#ffffff')
|
|
|
|
.have.data('foo')
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.have.class('active')
|
|
|
|
.have.id('id')
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.have.html('<em>hi</em>')
|
|
|
|
.have.text('hello')
|
|
|
|
.have.value('2013')
|
|
|
|
```
|
|
|
|
|
2017-08-30 13:57:25 +00:00
|
|
|
### Continued
|
|
|
|
|
|
|
|
```js
|
|
|
|
expect($body)
|
|
|
|
```
|
|
|
|
|
2017-08-30 06:20:27 +00:00
|
|
|
```js
|
|
|
|
.be.visible
|
|
|
|
.be.hidden
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.be.checked
|
|
|
|
.be.selected
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.be.enabled
|
|
|
|
.be.disabled
|
|
|
|
```
|
|
|
|
|
|
|
|
```js
|
|
|
|
.be.empty
|
|
|
|
.to.exist
|
|
|
|
.to.contain('text')
|
|
|
|
.to.have('.selector')
|
|
|
|
```
|