![](\"https://jestjs.io/img/jest.png\")
![](\"https://jestjs.io/img/circus.png\")
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"dafa4737dc02887314fd99e4be92781c9f8f9415","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"b29acb355ae23ccdb2a6248fbbd933fc93f320b9","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"d10f645b04ba9febb7308392e635c0351d0f027c","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"7ca8a22b8453e95c63842ee6aa4d8d8d8b4f9612","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"2cb20e945a26b2c9867b30b787e81f6317e59aa1","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"be16e47afcc9f64653b9a47782cb48a5ca243e65","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"e2eb9aeee8aacd441f1c8ac992c698ac4d303f60","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"6f44529270310b7dbdf9a0b72b21b5cd50fda4b1","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"d836f33f98845794b4eae8149548a81ddcfc6521","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"d7ba5030e274b52f029179dfdb860349a36eea37","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"28c763e6be8f57bda89238b95dc801460c2d6601","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"974d2f22b7deeb4f683fb38dd1ee3a0e984916df","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"0a2b94282170b6d4cc26c2d2003cc04ffebe5e3f","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"941c414f0b757fdc619778c46c21fda26b3e5504","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"2e34f2cfaf9b6864c3ad4bdca05d3097d3108a41","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"0006b152354237416ffbbc26d78c0b10375c0a49","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"774c1898bbb078c20fa53906d535335babc6585d","description":"
jest-circus
The next-gen test runner for Jest=15.0.0"},"publishConfig":{"access":"public"},"gitHead":"4f77c70602cab8419794f10fa39510f13baafef8","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"2f6931e91d5ab126de70caf150c68709752e7f6c","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"4c46930615602cbf983fb7e8e82884c282a624d5","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"f6366db60e32f1763e612288bf3984bcfa7a0a15","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"b254fd82fdedcba200e1c7eddeaab83a09bdaaef","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"71152afbbda76fd09ddb2527b54c365d753f42aa","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"d2bacceb51e7f05c9cb6d764d5cd886a2fd71267","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"8a70bc269edfc10e20803a0f69e1e39fb2942511","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"68d1b1b638bc7464c2794a957c1b894de7da2ee3","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"2586a798260886c28b6d28256cdfe354e039d5d1","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"e1d51deea8d089a06f28b4dbe9287a4428508610","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"0b1e41d1d93ce4d15646f4a39fd5a7ffae5f43c3","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"3a7e06fe855515a848241bb06a6f6e117847443d","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"a6a5abb7ef47ed2c31bf8987771a79f97ae65430","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"da61421faee6fdbf2a2b355b10d4e6eb1a842233","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"4a716811a309dae135b780a87dc1647b285800eb","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"817d8b6aca845dd4fcfd7f8316293e69f3a116c5","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"40b8e1e157c9981dda5a68d73fff647e80fc9f5c","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"fb04716adb223ce2da1e6bb2b4ce7c011bad1807","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"343532a21f640ac2709c4076eef57e52279542e1","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"68b65afc97688bd5b0b433f8f585da57dcd1d418","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"2bac04ffb8e533d12a072998da5c3751a41b796f","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 10.14.2"},"publishConfig":{"access":"public"},"gitHead":"ba962e7e9669a4a2f723c2536c97462c8ddfff2d","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"389d13724bbf6bb64dcde9700a6ecea3333942db","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"80b69051271602aa62ed8de896ba80ca3150f4a5","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"ad1b9dc090922a8ed5632ec7382ac999e6b8cac1","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"c5f2fd756331895b8177a19304feb49657687e22","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"ddd73d18adfb982b9b0d94bad7d41c9f78567ca7","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"5b129d714cadb818be28afbe313cbeae8fbb1dde","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"45a4936d96d74cdee6b91122a51a556e3ebe6dc8","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"3c2fa9347b86460b5dfc558f033b8d4eec0ff8e1","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"43207b743df164e9e58bd483dd9167b9084da18b","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"324938561c608e0e9dddc008e5dde1589d7abc68","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"6f8bf80c38567ba076ae979af2dedb42b285b2d5","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"96aaf892bb90ac5054b6e57a7661c35ff9ab6873","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"a679390828b6c30aeaa547d8c4dc9aed6531e357","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"79b7ab67c63d3708f9689e25fbc0e8b0094bd019","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"5cc2ccdacb1b2433581222252e43cb5a1f6861a9","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"9f0339c1c762e39f869f7df63e88470287728b93","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"cd98198c9397d8b69c55155d7b224d62ef117a90","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 8.3"},"publishConfig":{"access":"public"},"gitHead":"170eee11d03b0ed5c60077982fdbc3bafd403638","description":"
jest-circus
The next-gen test runner for Jest= 8"},"publishConfig":{"access":"public"},"gitHead":"ff9269be05fd8316e95232198fce3463bf2f270e","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"9ad0f4bc6b8bdd94989804226c28c9960d9da7d1","description":"Circus is a flux-based test runner for Jest that is fast, easy to maintain, and simple to extend.","_id":"jest-circus@24.9.0","dist":{"shasum":"8a557683636807d537507eac02ba64c95b686485","size":19332,"noattachment":false,"key":"/jest-circus/-/jest-circus-24.9.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/jest-circus/download/jest-circus-24.9.0.tgz"},"maintainers":[{"name":"aaronabramov","email":""},{"name":"cpojer","email":"christoph.pojer@gmail.com"},{"name":"openjs-operations","email":""},{"name":"rickhanlonii","email":"rickhanlonii@gmail.com"},{"name":"simenb","email":"sbekkhus91@gmail.com"}],"_npmUser":{"name":"scotthovestadt","email":"scott.hovestadt@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/jest-circus_24.9.0_1565935966581_0.7351677372490857"},"_hasShrinkwrap":false,"publish_time":1565935966820,"_cnpm_publish_time":1565935966820},"24.8.0":{"name":"jest-circus","version":"24.8.0","repository":{"type":"git","url":"git+https://github.com/facebook/jest.git","directory":"packages/jest-circus"},"license":"MIT","main":"build/index.js","types":"build/index.d.ts","dependencies":{"@babel/traverse":"^7.1.0","@jest/environment":"^24.8.0","@jest/test-result":"^24.8.0","@jest/types":"^24.8.0","chalk":"^2.0.1","co":"^4.6.0","expect":"^24.8.0","is-generator-fn":"^2.0.0","jest-each":"^24.8.0","jest-matcher-utils":"^24.8.0","jest-message-util":"^24.8.0","jest-snapshot":"^24.8.0","jest-util":"^24.8.0","pretty-format":"^24.8.0","stack-utils":"^1.0.1","throat":"^4.0.0"},"devDependencies":{"@jest/test-utils":"^24.4.0","@types/babel__traverse":"^7.0.4","@types/co":"^4.6.0","@types/stack-utils":"^1.0.1","execa":"^1.0.0","jest-runtime":"^24.8.0"},"engines":{"node":">= 6"},"publishConfig":{"access":"public"},"gitHead":"845728f24b3ef41e450595c384e9b5c9fdf248a4","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"0efb1d7809cb96ae87a7601e7802f1dab3774280","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"eb0413622542bc0f70c32950d9daeeab9f6802ac","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"04e6a66d2ba8b18bee080bb28547db74a255d2c7","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"800533020f5b2f153615c821ed7cb12fd868fa6f","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"a018000fc162db3cfd0ebf9f23fdb734f05821a6","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"65c6e9d5e398711c011078bb72648c77fc8a8cb3","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"3a7a4f3a3f5489ac8e07dcddf76bb949c482ec87","description":"
jest-circus
The next-gen test runner for Jest= 6"},"publishConfig":{"access":"public"},"gitHead":"800f2f803d01c8ae194d71b251e4965dd70e5bf2","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"b16789230fd45056a7f2fa199bae06c7a1780deb","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"634e5a54f46b2a62d1dc81a170562e6f4e55ad60","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"634e5a54f46b2a62d1dc81a170562e6f4e55ad60","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"28971c5f794330e8acc6861288e6daafcd32238e","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"28971c5f794330e8acc6861288e6daafcd32238e","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"6de22dde9a10f775adc7b6f80080bdd224f6ae31","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"4f2bcb861d1f0fb150c05970362e52a38c31f67e","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"6a066c6afe2ae08669a27d3b703a6cf0d898e7b7","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"722049ccd66947d48296dcb666bc99fccab86065","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"c7caa7ba5904d0c61e586694cde5f536639e4afc","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"700e0dadb85f5dc8ff5dac6c7e98956690049734","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"49d08403a941e596eda1279c07a1eaf4d4a73dad","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"2c18a53e8ff2437bba5fcb8076b754ac5f79f9f8","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"e41f0bb257c6652c3100b97a1087f9f812fbea0d","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"e41f0bb257c6652c3100b97a1087f9f812fbea0d","readmeFilename":"README.md","description":"
jest-circus
The next-gen test runner for Jest= 6"},"gitHead":"c5e36835cff4b241327db9cf58c8f6f7227ed1f7","description":"
jest-circus
The next-gen test runner for Jest
jest-circus
The next-gen test runner for Jest
jest-circus
The next-gen test runner for Jest\n \n \n
jest-circus
\nThe next-gen test runner for Jest
\n\n\n## Overview\n\nCircus is a flux-based test runner for Jest that is fast, maintainable, and simple to extend.\n\nCircus allows you to bind to events via an optional event handler on any [custom environment](https://jestjs.io/docs/configuration#testenvironment-string). See the [type definitions][type-definitions] for more information on the events and state data currently available.\n\n```ts\nimport type {Event, State} from 'jest-circus';\nimport {TestEnvironment as NodeEnvironment} from 'jest-environment-node';\n\nclass MyCustomEnvironment extends NodeEnvironment {\n //...\n\n async handleTestEvent(event: Event, state: State) {\n if (event.name === 'test_start') {\n // ...\n }\n }\n}\n```\n\nMutating event or state data is currently unsupported and may cause unexpected behavior or break in a future release without warning. New events, event data, and/or state data will not be considered a breaking change and may be added in any minor release.\n\nNote, that `jest-circus` test runner would pause until a promise returned from `handleTestEvent` gets fulfilled. **However, there are a few events that do not conform to this rule, namely**: `start_describe_definition`, `finish_describe_definition`, `add_hook`, `add_test` or `error` (for the up-to-date list you can look at [SyncEvent type in the types definitions][type-definitions]). That is caused by backward compatibility reasons and `process.on('unhandledRejection', callback)` signature, but that usually should not be a problem for most of the use cases.\n\n## Installation\n\n> Note: As of Jest 27, `jest-circus` is the default test runner, so you do not have to install it to use it.\n\nInstall `jest-circus` using yarn:\n\n```bash\nyarn add --dev jest-circus\n```\n\nOr via npm:\n\n```bash\nnpm install --save-dev jest-circus\n```\n\n## Configure\n\nConfigure Jest to use `jest-circus` via the [`testRunner`](https://jestjs.io/docs/configuration#testrunner-string) option:\n\n```json\n{\n \"testRunner\": \"jest-circus/runner\"\n}\n```\n\nOr via CLI:\n\n```bash\njest --testRunner='jest-circus/runner'\n```\n","_attachments":{},"license":"MIT"}