# chai-jquery

> jQuery assertions for the Chai assertion library

Latest version **2.1.0** (published 2018-11-09) · 0 weekly downloads

## Install

```sh
npm install chai-jquery
pnpm add chai-jquery
yarn add chai-jquery
bun add chai-jquery
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2018-11-09 |
| First published | 2012-05-31 |
| Weekly downloads | 0 |
| TypeScript types | separate (@types/chai-jquery) |
| Module format | CommonJS |
| Node | >= 0.4.0 |
| Dependencies | 0 |
| Unpacked size | 44.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 370 |
| Author | John Firebaugh |
| Maintainers | chaijs, domenic, jfirebaugh |
| Keywords | chai, chai-plugin, vendor, browser-only, dom, test, assertion, assert, testing, jQuery |

## Links

- npm: https://www.npmjs.com/package/chai-jquery
- Repository: https://github.com/chaijs/chai-jquery
- Homepage: https://github.com/chaijs/chai-jquery#readme
- Issues: https://github.com/chaijs/chai-jquery/issues
- npm.io page: https://npm.io/package/chai-jquery

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [vest](https://npm.io/package/vest.md) — 50.1K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads

## Recent versions

- 2.1.0 (latest) — 2018-11-09
- 2.0.0 — 2014-10-11
- 1.2.3 — 2014-06-03
- 1.2.2 — 2014-05-21
- 1.2.1 — 2014-01-22
- 1.2.0 — 2013-12-30
- 1.1.2 — 2013-09-26
- 1.1.1 — 2012-12-27
- 1.1.0 — 2012-08-24
- 1.0.0 — 2012-05-31

## README

# chai-jquery

chai-jquery is an extension to the [chai](http://chaijs.com/) assertion library that
provides a set of jQuery-specific assertions.

## Usage

Include `chai-jquery.js` in your test file, after `jquery.js` and `chai.js` (version 1.0.0-rc1 or later):

```html
<script src="jquery.js"></script>
<script src="chai.js"></script>
<script src="chai-jquery.js"></script>
```

Note that `jquery.js` and `chai.js` can be inserted one before another (order does not matter here).

Use the assertions with chai's `expect` or `should` assertions.

## Assertions

### `attr(name[, value])`
Assert that the first element of the selection has the given attribute, using [`.attr()`](http://api.jquery.com/attr/).
Optionally, assert a particular value as well. The return value is available for chaining.

```js
$('#header').should.have.attr('foo');
expect($('body')).to.have.attr('foo', 'bar');
expect($('body')).to.have.attr('foo').match(/bar/);
```

### `prop(name[, value])`
Assert that the first element of the selection has the given property, using [`.prop()`](http://api.jquery.com/prop/).
Optionally, assert a particular value as well. The return value is available for chaining.

```js
$('#header').should.have.prop('disabled');
expect($('body')).to.have.prop('disabled', false);
expect($('body')).to.have.prop('value').match(/bar/);
```

### `css(name[, value])`
Assert that the first element of the selection has the given CSS property, using [`.css()`](http://api.jquery.com/css/).
Optionally, assert the computed value as well. The return value is available for chaining.

```js
$('#header').should.have.css('background');
expect($('body')).to.have.css('background-color', 'rgb(0, 0, 0)');
expect($('body')).to.have.css('font-family').match(/sans-serif/);
```

### `data(name[, value])`
Assert that the first element of the selection has the given data value, using [`.data()`](http://api.jquery.com/data/).
Optionally, assert a particular value as well. The return value is available for chaining.

```js
$('#header').should.have.data('foo');
expect($('body')).to.have.data('foo', 'bar');
expect($('body')).to.have.data('foo').match(/bar/);
```

### `class(className)`
Assert that the first element of the selection has the given class, using [`.hasClass()`](http://api.jquery.com/hasClass/).

```js
$('#header').should.have.class('foo');
expect($('body')).to.have.class('foo');
```

### `id(id)`
Assert that the first element of the selection has the given id, using `.attr('id')`.

```js
$('.header').should.have.id('#main');
expect($('body')).to.have.id('foo');
```

### `html(html)`
Assert that the html of the first element of the selection is equal to the given html, using [`.html()`](http://api.jquery.com/html/).

```js
$('.name').should.have.html('<em>John Doe</em>');
expect($('#title')).to.have.html('Chai Tea');
```

### `text(text)`
Assert that the text of the first element of the selection is equal to the given text, using [`.text()`](http://api.jquery.com/text/).

```js
$('.name').should.have.text('John Doe');
expect($('#title')).to.have.text('Chai Tea');
```

### `value(value)`
Assert that the first element of the selection has the given value, using [`.val()`](http://api.jquery.com/val/).

```js
$('.name').should.have.value('John Doe');
expect($('.year')).to.have.value('2012');
```

### `visible`
Assert that at least one element of the selection is visible, using [`.is(':visible')`](http://api.jquery.com/:visible/).

```js
$('.name').should.be.visible;
expect($('.year')).to.be.visible;
```

### `hidden`
Assert that at least one element of the selection is hidden, using [`.is(':hidden')`](http://api.jquery.com/:hidden/).

```js
$('.name').should.be.hidden;
expect($('.year')).to.be.hidden;
```

### `selected`
Assert that at least one element of the selection is selected, using [`.is(':selected')`](http://api.jquery.com/:selected/).

```js
$('option').should.be.selected;
expect($('option')).not.to.be.selected;
```

### `checked`
Assert that at least one element of the selection is checked, using [`.is(':checked')`](http://api.jquery.com/:checked/).

```js
$('.checked').should.be.checked;
expect($('input')).not.to.be.checked;
```

### `enabled`
Assert that at least one element of the selection is enabled, using [`.is(':enabled')`](http://api.jquery.com/:enabled/).

```js
$('.enabled').should.be.enabled;
expect($('enabled')).to.be.enabled;
```

### `disabled`
Assert that at least one element of the selection is disabled, using [`.is(':disabled')`](http://api.jquery.com/:disabled/).

```js
$('.disabled').should.be.disabled;
expect($('input')).not.to.be.disabled;
```

### `empty`
Assert that at least one element of the selection is empty, using [`.is(':empty')`](http://api.jquery.com/empty-selector/).
If the object asserted against is not a jQuery object, the original implementation will be called.

```js
$('.empty').should.be.empty;
expect($('body')).not.to.be.empty;
```

### `exist`
Assert that the selection is not empty. Note that this overrides the built-in chai assertion. If the object asserted
against is not a jQuery object, the original implementation will be called.

```js
$('#exists').should.exist;
expect($('#nonexistent')).not.to.exist;
```

### `match(selector)`
Assert that the selection matches a given selector, using [`.is()`](http://api.jquery.com/is/). Note that this overrides
the built-in chai assertion. If the object asserted against is not a jQuery object, the original implementation will be called.

```js
$('input').should.match('#foo');
expect($('#empty')).to.match(':empty');
```

### `contain(text)`
Assert that the selection contains the given text, using [`:contains()`](http://api.jquery.com/contains-selector/).
If the object asserted against is not a jQuery object, or if `contain` is not called as a function, the original
implementation will be called.

```js
$('body').should.contain('text');
expect($('#content')).to.contain('text');
```

### `descendants(selector)`
Assert that the selection contains at least one element which has a descendant matching the given selector,
using [`.has()`](http://api.jquery.com/has/).

```js
$('body').should.have.descendants('h1');
expect($('#content')).to.have.descendants('div');
```

### `focus()`
Assert that at least one element of the selection is visible. Note that this assertion does not use [`.is(':focus')`](http://api.jquery.com/:focus/).
It rather uses `$('.element').get(0) === document.activeElement`, because of [incompatibility of .is(':focus') in certain webkit browsers](https://github.com/ariya/phantomjs/issues/10427).

```js
$('#focused').should.have.focus();
expect($('#nonfocused')).not.have.focus();
```

## Contributing

To run the test suite, run `npm install` (requires
[Node.js](http://nodejs.org/) to be installed on your system), and open
`test/index.html` in your web browser.

## License

Copyright (c) 2012 John Firebaugh

MIT License (see the LICENSE file)

---
_Source: https://npm.io/package/chai-jquery · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._