{"__v":97,"_id":"55a46241ffd44e0d00fca056","api":{"auth":"required","params":[],"results":{"codes":[]},"settings":"","url":""},"body":"![Chimp.js Logo](https://raw.githubusercontent.com/xolvio/chimp/master/images/header.png)\n\nChimp makes it super easy for developers to write automated tests, by taking away all the pain associated with setting up tools and allowing developers to focus on building-in quality.\n\nIt does so by integrating and sprinkling magic over the following tools:\n\n* **[Mocha](https://mochajs.org)**, **[Jasmine](http://jasmine.github.io/edge/introduction.html)** or **[Cucumber.js](https://github.com/cucumber/cucumber-js)**\n* **[Selenium](http://www.seleniumhq.org/)** and **[WebdriverIO](http://webdriver.io/)** \n* **[Chai](http://chaijs.com)** or **[Jasmine assertion](http://jasmine.github.io/edge/introduction.html#section-Expectations)** libraries inside your steps\n* Built in Node.js, works for any web application *(with special **[Meteor](http://www.meteor.com)** support)*\n\nWe use Chimp everyday at **[Xolv.io](http://xolv.io)** and we are in the business of specs. Our philosophy, services and products are all about getting you to deliver higher quality features, faster.\n\n### **Use what you are comfortable with** \nYou can use  **[Mocha](https://mochajs.org)**, **[Jasmine](http://jasmine.github.io/edge/introduction.html)** or **[Cucumber.js](https://github.com/cucumber/cucumber-js)** to write your acceptance / end-to-end tests.\n\n### **Test using Javascript - The language of the web**\nBuilt in Node.js, works with any platform. If you're building a web application, Chimp can add quality.\n\n### **A unique watch mode** \nReruns only the specs you tag, allowing you to stay hyper-focused on the feature you're working on.\n\n### **Write your step definitions in a synchronous style** \nTests don't need to be complicated! No more callback hell or confusing promise chains. Just write easy to read, clean code.\n\n### **First-class Meteor.js Support** \nWhen used with **[Meteor](https://www.meteor.com)**, Chimp is aware of Meteor's hot-code pushes and also allows you to run code within the client or server, allowing you to test deep within the Meteor context.\n\n### **Full Continuous Integration Support**\nTested on **[Travis](https://travis-ci.com)**, **[CircleCI](https://circleci.com)**, **[CodeShip](https://codeship.com)** and of course **[Jenkins](https://jenkins-ci.org/)**.\n\n### **Automatically Downloads & Configures Dependencies**\nLike **[Selenium](http://www.seleniumhq.org/)** / **[ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/)** / **[IEDriver](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)** / **[PhantomJS](http://phantomjs.org/)**.\n\n### **OSX, Linux and Windows**\nWorks on all these platforms.\n\n### **Mobile Testing Support**\nUsing **[Appium](http://appium.io)**. You can even connect to real cloud devices services like the **[Amazon Device Farm](https://aws.amazon.com/device-farm/)**\n\n### **Run your tests in the cloud**\n**[SauceLabs](https://saucelabs.com)** / **[BrowserStack](https://www.browserstack.com)** support out the box.\n\n### **Intelligently Reuses Browser Sessions**\nTests re-run fast, and you don't get annoying window-flicker whilst running your specs.\n\n### **Automatically Takes Screenshots on Failures**\nThis happens automatically on CI servers when a step fails so you can track down errors. Can save them to file or include them in the JSON report as embedded images for easy artifact publishing and reporting. (Cucumber.js only for now, Mocha / Jasmine coming soon).\n\n### **Integrates with Simian**\n**[Simian](http://simian.io)** allows you to develop specifications in a collaborative environment. Chimp posts your results from your CI server back to Simian allowing you close the loop and have an integrated company-wide BDD practice.\n\n---\n<a href=\"http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Home&utm_campaign=QFLaunch\"><img src=\"https://files.readme.io/7d17391-qualityfasterbook-commas.small.png\" align=\"right\" width=\"300\" /></a>\n#Want to be a Chimp Ninja?\n*Want to learn how to write the best tests from the creators of Chimp?*\n\n\n\nCheckout our new book where you can learn how to can use Chimp across the Full Stack from React to Node.JS, Mocha, Meteor and more.\n* [Quality, Faster.](http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Home&utm_campaign=QFLaunch) By Sam Hatoum, creator of Chimp.","category":"559b65be8b04e90d00702d58","createdAt":"2015-07-14T01:13:37.505Z","excerpt":"[![Circle CI](https://circleci.com/gh/xolvio/chimp.svg?style=shield&circle-token=:circle-token)](https://circleci.com/gh/xolvio/chimp) [![npm Version](https://img.shields.io/npm/dm/chimp.svg)](https://www.npmjs.com/package/chimp) [![Code Climate](https://codeclimate.com/github/xolvio/chimp/badges/gpa.svg)](https://codeclimate.com/github/xolvio/chimp) [![License](https://img.shields.io/npm/l/chimp.svg)](https://www.npmjs.com/package/chimp) [![OpenCollective](https://opencollective.com/chimp/backers/badge.svg)](#backers) [![OpenCollective](https://opencollective.com/chimp/sponsors/badge.svg)](#sponsors)\n\n[![Gitter](https://img.shields.io/gitter/room/xolvio/chimp.svg)](https://gitter.im/xolvio/chimp)  [![Slack Status](http://community.xolv.io/badge.svg)](http://community.xolv.io)","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","order":0,"parentDoc":null,"project":"559b65bd8b04e90d00702d54","slug":"introduction","sync_unique":"","title":"Introduction","type":"basic","updates":["572408cafda3c70e005b8938","574763dd338b84190025f44e"],"user":"559b658d8b04e90d00702d52","version":"559b65bd8b04e90d00702d57","childrenPages":[]}

Introduction

[![Circle CI](https://circleci.com/gh/xolvio/chimp.svg?style=shield&circle-token=:circle-token)](https://circleci.com/gh/xolvio/chimp) [![npm Version](https://img.shields.io/npm/dm/chimp.svg)](https://www.npmjs.com/package/chimp) [![Code Climate](https://codeclimate.com/github/xolvio/chimp/badges/gpa.svg)](https://codeclimate.com/github/xolvio/chimp) [![License](https://img.shields.io/npm/l/chimp.svg)](https://www.npmjs.com/package/chimp) [![OpenCollective](https://opencollective.com/chimp/backers/badge.svg)](#backers) [![OpenCollective](https://opencollective.com/chimp/sponsors/badge.svg)](#sponsors) [![Gitter](https://img.shields.io/gitter/room/xolvio/chimp.svg)](https://gitter.im/xolvio/chimp) [![Slack Status](http://community.xolv.io/badge.svg)](http://community.xolv.io)

![Chimp.js Logo](https://raw.githubusercontent.com/xolvio/chimp/master/images/header.png) Chimp makes it super easy for developers to write automated tests, by taking away all the pain associated with setting up tools and allowing developers to focus on building-in quality. It does so by integrating and sprinkling magic over the following tools: * **[Mocha](https://mochajs.org)**, **[Jasmine](http://jasmine.github.io/edge/introduction.html)** or **[Cucumber.js](https://github.com/cucumber/cucumber-js)** * **[Selenium](http://www.seleniumhq.org/)** and **[WebdriverIO](http://webdriver.io/)** * **[Chai](http://chaijs.com)** or **[Jasmine assertion](http://jasmine.github.io/edge/introduction.html#section-Expectations)** libraries inside your steps * Built in Node.js, works for any web application *(with special **[Meteor](http://www.meteor.com)** support)* We use Chimp everyday at **[Xolv.io](http://xolv.io)** and we are in the business of specs. Our philosophy, services and products are all about getting you to deliver higher quality features, faster. ### **Use what you are comfortable with** You can use **[Mocha](https://mochajs.org)**, **[Jasmine](http://jasmine.github.io/edge/introduction.html)** or **[Cucumber.js](https://github.com/cucumber/cucumber-js)** to write your acceptance / end-to-end tests. ### **Test using Javascript - The language of the web** Built in Node.js, works with any platform. If you're building a web application, Chimp can add quality. ### **A unique watch mode** Reruns only the specs you tag, allowing you to stay hyper-focused on the feature you're working on. ### **Write your step definitions in a synchronous style** Tests don't need to be complicated! No more callback hell or confusing promise chains. Just write easy to read, clean code. ### **First-class Meteor.js Support** When used with **[Meteor](https://www.meteor.com)**, Chimp is aware of Meteor's hot-code pushes and also allows you to run code within the client or server, allowing you to test deep within the Meteor context. ### **Full Continuous Integration Support** Tested on **[Travis](https://travis-ci.com)**, **[CircleCI](https://circleci.com)**, **[CodeShip](https://codeship.com)** and of course **[Jenkins](https://jenkins-ci.org/)**. ### **Automatically Downloads & Configures Dependencies** Like **[Selenium](http://www.seleniumhq.org/)** / **[ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/)** / **[IEDriver](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)** / **[PhantomJS](http://phantomjs.org/)**. ### **OSX, Linux and Windows** Works on all these platforms. ### **Mobile Testing Support** Using **[Appium](http://appium.io)**. You can even connect to real cloud devices services like the **[Amazon Device Farm](https://aws.amazon.com/device-farm/)** ### **Run your tests in the cloud** **[SauceLabs](https://saucelabs.com)** / **[BrowserStack](https://www.browserstack.com)** support out the box. ### **Intelligently Reuses Browser Sessions** Tests re-run fast, and you don't get annoying window-flicker whilst running your specs. ### **Automatically Takes Screenshots on Failures** This happens automatically on CI servers when a step fails so you can track down errors. Can save them to file or include them in the JSON report as embedded images for easy artifact publishing and reporting. (Cucumber.js only for now, Mocha / Jasmine coming soon). ### **Integrates with Simian** **[Simian](http://simian.io)** allows you to develop specifications in a collaborative environment. Chimp posts your results from your CI server back to Simian allowing you close the loop and have an integrated company-wide BDD practice. --- <a href="http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Home&utm_campaign=QFLaunch"><img src="https://files.readme.io/7d17391-qualityfasterbook-commas.small.png" align="right" width="300" /></a> #Want to be a Chimp Ninja? *Want to learn how to write the best tests from the creators of Chimp?* Checkout our new book where you can learn how to can use Chimp across the Full Stack from React to Node.JS, Mocha, Meteor and more. * [Quality, Faster.](http://quality.xolv.io/?utm_source=XolvOSS&utm_medium=OSSDocs&utm_content=ChimpRM-Home&utm_campaign=QFLaunch) By Sam Hatoum, creator of Chimp.