| 1 | <h1 align="center">ts-jest</h1>
|
| 2 |
|
| 3 | <p align="center">A TypeScript preprocessor with source map support for Jest that lets you use Jest to test projects written in TypeScript.</p>
|
| 4 |
|
| 5 | <p align="center">
|
| 6 | <a href="https://www.npmjs.com/package/ts-jest"><img src="https://img.shields.io/npm/v/ts-jest/latest.svg?style=flat-square" alt="NPM version" /> </a>
|
| 7 | <a href="https://www.npmjs.com/package/ts-jest"><img src="https://img.shields.io/npm/dm/ts-jest.svg?style=flat-square" alt="NPM downloads"/> </a>
|
| 8 | <a href="https://snyk.io/test/github/kulshekhar/ts-jest"><img src="https://snyk.io/test/github/kulshekhar/ts-jest/badge.svg?style=flat-square" alt="Known vulnerabilities"/> </a>
|
| 9 | <a href="https://coveralls.io/github/kulshekhar/ts-jest?branch=master"><img src="https://coveralls.io/repos/github/kulshekhar/ts-jest/badge.svg?branch=master" alt="Coverage status"/> </a>
|
| 10 | <a href="https://travis-ci.com/kulshekhar/ts-jest"><img src="https://travis-ci.com/kulshekhar/ts-jest.svg?branch=master" alt="Build status"/> </a>
|
| 11 | <a href="https://actions-badge.atrox.dev/kulshekhar/ts-jest/goto?ref=master"><img alt="GitHub actions" src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fkulshekhar%2Fts-jest%2Fbadge%3Fref%3Dmaster&style=flat-square" /> </a>
|
| 12 | <a href="https://github.com/kulshekhar/ts-jest/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/ts-jest.svg?style=flat-square" alt="GitHub license"/> </a>
|
| 13 | </p>
|
| 14 |
|
| 15 | <img src="./icon.png" align="right" title="ts-jest Logo" width="128" height="128">
|
| 16 |
|
| 17 | It supports all features of TypeScript including type-checking. [Read more about Babel7 + `preset-typescript` **vs** TypeScript (and `ts-jest`)](https://kulshekhar.github.io/ts-jest/user/babel7-or-ts).
|
| 18 |
|
| 19 | ---
|
| 20 |
|
| 21 | | We are not doing semantic versioning and `23.10` is a re-write, run `npm i -D ts-jest@"<23.10.0"` to go back to the previous version |
|
| 22 | |---|
|
| 23 |
|
| 24 | [<img src="./docs/assets/img/documentation.png" align="left" height="24"> View the online documentation (usage & technical)](https://kulshekhar.github.io/ts-jest)
|
| 25 |
|
| 26 | [<img src="./docs/assets/img/slack.png" align="left" height="24"> Ask for some help in the `ts-jest` community of Slack](https://bit.ly/3bRHFPQ)
|
| 27 |
|
| 28 | [<img src="./docs/assets/img/troubleshooting.png" align="left" height="24"> Before reporting any issue, be sure to check the troubleshooting page](TROUBLESHOOTING.md)
|
| 29 |
|
| 30 | [<img src="./docs/assets/img/pull-request.png" align="left" height="24"> We're looking for collaborators! Want to help improve `ts-jest`?](https://github.com/kulshekhar/ts-jest/issues/223)
|
| 31 |
|
| 32 | ---
|
| 33 |
|
| 34 | ## Getting Started
|
| 35 |
|
| 36 | These instructions will get you setup to use `ts-jest` in your project. For more detailed documentation, please check [online documentation](https://kulshekhar.github.io/ts-jest).
|
| 37 |
|
| 38 | | | using npm | using yarn |
|
| 39 | |---:|---|---|
|
| 40 | | **Prerequisites** | `npm i -D jest typescript` | `yarn add --dev jest typescript` |
|
| 41 | | **Installing** | `npm i -D ts-jest @types/jest` | `yarn add --dev ts-jest @types/jest` |
|
| 42 | | **Creating config** | `npx ts-jest config:init` | `yarn ts-jest config:init` |
|
| 43 | | **Running tests** | `npm t` or `npx jest` | `yarn test` or `yarn jest` |
|
| 44 |
|
| 45 | ## Built With
|
| 46 |
|
| 47 | * [TypeScript](https://www.typescriptlang.org/) - JavaScript that scales
|
| 48 | * [Jest](https://jestjs.io/) - Delightful JavaScript Testing
|
| 49 | * [`ts-jest`](https://kulshekhar.github.io/ts-jest) - Jest processor for TypeScript _(yes, `ts-jest` uses itself for its tests)_
|
| 50 |
|
| 51 | ## Contributing
|
| 52 |
|
| 53 | Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
|
| 54 |
|
| 55 | ## Versioning
|
| 56 |
|
| 57 | We **DO NOT** use [SemVer](http://semver.org/) for versioning. Though you can think about SemVer when reading our version, except our major number follows the one of Jest. For the versions available, see the [tags on this repository](https://github.com/kulshekhar/ts-jest/tags).
|
| 58 |
|
| 59 | ## Authors/maintainers
|
| 60 |
|
| 61 | * **Kulshekhar Kabra** - [kulshekhar](https://github.com/kulshekhar)
|
| 62 | * **Gustav Wengel** - [GeeWee](https://github.com/GeeWee)
|
| 63 | * **Ahn** - [ahnpnl](https://github.com/ahnpnl)
|
| 64 | * **Huafu Gandon** - [huafu](https://github.com/huafu)
|
| 65 |
|
| 66 | See also the list of [contributors](https://github.com/kulshekhar/ts-jest/contributors) who participated in this project.
|
| 67 |
|
| 68 | ## Supporters
|
| 69 |
|
| 70 | - [JetBrains](https://www.jetbrains.com/?from=ts-jest) has been kind enough to support ts-jest with an [open source license](https://www.jetbrains.com/community/opensource/?from=ts-jest).
|
| 71 |
|
| 72 | ## License
|
| 73 |
|
| 74 | This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
|