{"_id":"55a46241ffd44e0d00fca056","parentDoc":null,"category":{"_id":"559b65be8b04e90d00702d58","version":"559b65bd8b04e90d00702d57","pages":["559b65bf8b04e90d00702d5a","55a46241ffd44e0d00fca056","55a46f45e75ca60d00a39323","55a470b768c7e20d0036d4d6","55a4a758dad9d00d0071fcba","55b6b6276127b12500364560","55baf505d0736b3100bf1033","55c25ef1f2cff20d006d0b8a","56269a8b44c87f0d00fe6378","56498f62f176080d000c78ac","566f59c4fc3abb0d0020fcd5","567cd2228eb5b20d0021059d"],"project":"559b65bd8b04e90d00702d54","__v":12,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-07T05:38:06.409Z","from_sync":false,"order":0,"slug":"chimpjs","title":"Chimp"},"__v":98,"githubsync":"","project":"559b65bd8b04e90d00702d54","user":"559b658d8b04e90d00702d52","version":{"_id":"559b65bd8b04e90d00702d57","project":"559b65bd8b04e90d00702d54","__v":6,"createdAt":"2015-07-07T05:38:05.890Z","releaseDate":"2015-07-07T05:38:05.890Z","categories":["559b65be8b04e90d00702d58","55a46e7468c7e20d0036d4d1","55a4971be6c2470d002a6483","55a4a690e10ba50d00b40bba","55a4bcf31a5f991700a94066","56cf5c8d336aa60b0086a40d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["572408cafda3c70e005b8938","574763dd338b84190025f44e"],"next":{"pages":[],"description":""},"createdAt":"2015-07-14T01:13:37.505Z","link_external":false,"link_url":"","sync_unique":"","hidden":true,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"![Chimpy Logo](https://raw.githubusercontent.com/TheBrainFamily/chimpy/master/images/header.png)\n\n\nChimpy 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\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, Chimpy 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)**, Chimpy 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---\n*Want to learn how to write the best tests?*\n\nCheckout Xolv.io's new guide where you can learn how to can bake quality in 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.","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)","slug":"introduction","type":"basic","title":"Introduction"}

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)

![Chimpy Logo](https://raw.githubusercontent.com/TheBrainFamily/chimpy/master/images/header.png) Chimpy 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)* ### **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, Chimpy 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)**, Chimpy 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). --- *Want to learn how to write the best tests?* Checkout Xolv.io's new guide where you can learn how to can bake quality in 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.