| 1 | <a name="README">[<img src="https://rawgithub.com/jasmine/jasmine/main/images/jasmine-horizontal.svg" width="400px" />](http://jasmine.github.io)</a>
|
|---|
| 2 |
|
|---|
| 3 | [](https://circleci.com/gh/jasmine/jasmine)
|
|---|
| 4 | [](https://www.codetriage.com/jasmine/jasmine)
|
|---|
| 5 | [](https://app.fossa.io/projects/git%2Bgithub.com%2Fjasmine%2Fjasmine?ref=badge_shield)
|
|---|
| 6 |
|
|---|
| 7 | # A JavaScript Testing Framework
|
|---|
| 8 |
|
|---|
| 9 | Jasmine is a Behavior Driven Development testing framework for JavaScript. It does not rely on browsers, DOM, or any JavaScript framework. Thus it's suited for websites, [Node.js](http://nodejs.org) projects, or anywhere that JavaScript can run.
|
|---|
| 10 |
|
|---|
| 11 | Documentation & guides live here: [http://jasmine.github.io](http://jasmine.github.io/)
|
|---|
| 12 | For a quick start guide of Jasmine, see the beginning of [http://jasmine.github.io/edge/introduction.html](http://jasmine.github.io/edge/introduction.html).
|
|---|
| 13 |
|
|---|
| 14 | ## Contributing
|
|---|
| 15 |
|
|---|
| 16 | Please read the [contributors' guide](https://github.com/jasmine/jasmine/blob/main/.github/CONTRIBUTING.md).
|
|---|
| 17 |
|
|---|
| 18 | ## Installation
|
|---|
| 19 |
|
|---|
| 20 | For the Jasmine NPM module:<br>
|
|---|
| 21 | [https://github.com/jasmine/jasmine-npm](https://github.com/jasmine/jasmine-npm).
|
|---|
| 22 |
|
|---|
| 23 | For the Jasmine browser runner:<br>
|
|---|
| 24 | [https://github.com/jasmine/jasmine-browser](https://github.com/jasmine/jasmine-browser).
|
|---|
| 25 |
|
|---|
| 26 | For the Jasmine Ruby Gem:<br>
|
|---|
| 27 | [https://github.com/jasmine/jasmine-gem](https://github.com/jasmine/jasmine-gem).
|
|---|
| 28 |
|
|---|
| 29 | To install Jasmine standalone on your local box (where **_{#.#.#}_** below is substituted by the release number downloaded):
|
|---|
| 30 |
|
|---|
| 31 | * Download the standalone distribution for your desired release from the [releases page](https://github.com/jasmine/jasmine/releases).
|
|---|
| 32 | * Create a Jasmine directory in your project. - `mkdir my-project/jasmine`
|
|---|
| 33 | * Move the dist to your project directory. - `mv jasmine/dist/jasmine-standalone-{#.#.#}.zip my-project/jasmine`
|
|---|
| 34 | * Change directory. - `cd my-project/jasmine`
|
|---|
| 35 | * Unzip the dist. - `unzip jasmine-standalone-{#.#.#}.zip`
|
|---|
| 36 |
|
|---|
| 37 | Add the following to your HTML file:
|
|---|
| 38 |
|
|---|
| 39 | ```html
|
|---|
| 40 | <link rel="shortcut icon" type="image/png" href="lib/jasmine-{#.#.#}/jasmine_favicon.png">
|
|---|
| 41 | <link rel="stylesheet" type="text/css" href="lib/jasmine-{#.#.#}/jasmine.css">
|
|---|
| 42 |
|
|---|
| 43 | <script type="text/javascript" src="lib/jasmine-{#.#.#}/jasmine.js"></script>
|
|---|
| 44 | <script type="text/javascript" src="lib/jasmine-{#.#.#}/jasmine-html.js"></script>
|
|---|
| 45 | <script type="text/javascript" src="lib/jasmine-{#.#.#}/boot.js"></script>
|
|---|
| 46 | ```
|
|---|
| 47 |
|
|---|
| 48 | ## Supported environments
|
|---|
| 49 |
|
|---|
| 50 | Jasmine tests itself across many browsers (Safari, Chrome, Firefox, Microsoft Edge, and Internet Explorer) as well as nodejs.
|
|---|
| 51 |
|
|---|
| 52 | | Environment | Supported versions |
|
|---|
| 53 | |-------------------|--------------------|
|
|---|
| 54 | | Node | 10, 12, 14, 16 |
|
|---|
| 55 | | Safari | 8-14 |
|
|---|
| 56 | | Chrome | Evergreen |
|
|---|
| 57 | | Firefox | Evergreen, 68, 78 |
|
|---|
| 58 | | Edge | Evergreen |
|
|---|
| 59 | | Internet Explorer | 10, 11 |
|
|---|
| 60 |
|
|---|
| 61 | For evergreen browsers, each version of Jasmine is tested against the version of the browser that is available to us
|
|---|
| 62 | at the time of release. Other browsers, as well as older & newer versions of some supported browsers, are likely to work.
|
|---|
| 63 | However, Jasmine isn't tested against them and they aren't actively supported.
|
|---|
| 64 |
|
|---|
| 65 | ## Support
|
|---|
| 66 |
|
|---|
| 67 | * Search past discussions: [http://groups.google.com/group/jasmine-js](http://groups.google.com/group/jasmine-js).
|
|---|
| 68 | * Send an email to the list: [jasmine-js@googlegroups.com](mailto:jasmine-js@googlegroups.com).
|
|---|
| 69 | * View the project backlog at Pivotal Tracker: [http://www.pivotaltracker.com/projects/10606](http://www.pivotaltracker.com/projects/10606).
|
|---|
| 70 | * Follow us on Twitter: [@JasmineBDD](http://twitter.com/JasmineBDD).
|
|---|
| 71 |
|
|---|
| 72 | ## Maintainers
|
|---|
| 73 |
|
|---|
| 74 | * [Gregg Van Hove](mailto:gvanhove@pivotal.io), Pivotal Labs
|
|---|
| 75 |
|
|---|
| 76 | ### Maintainers Emeritus
|
|---|
| 77 |
|
|---|
| 78 | * [Davis W. Frank](mailto:dwfrank@pivotal.io), Pivotal Labs
|
|---|
| 79 | * [Rajan Agaskar](mailto:rajan@pivotal.io), Pivotal Labs
|
|---|
| 80 | * [Greg Cobb](mailto:gcobb@pivotal.io), Pivotal Labs
|
|---|
| 81 | * [Chris Amavisca](mailto:camavisca@pivotal.io), Pivotal Labs
|
|---|
| 82 | * [Christian Williams](mailto:antixian666@gmail.com), Cloud Foundry
|
|---|
| 83 | * Sheel Choksi
|
|---|
| 84 |
|
|---|
| 85 | Copyright (c) 2008-2018 Pivotal Labs. This software is licensed under the MIT License.
|
|---|
| 86 |
|
|---|
| 87 |
|
|---|
| 88 | ## License
|
|---|
| 89 | [](https://app.fossa.io/projects/git%2Bgithub.com%2Fjasmine%2Fjasmine?ref=badge_large)
|
|---|
