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 | [![Build Status](https://circleci.com/gh/jasmine/jasmine.svg?style=shield)](https://circleci.com/gh/jasmine/jasmine)
|
---|
4 | [![Open Source Helpers](https://www.codetriage.com/jasmine/jasmine/badges/users.svg)](https://www.codetriage.com/jasmine/jasmine)
|
---|
5 | [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fjasmine%2Fjasmine.svg?type=shield)](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 | [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fjasmine%2Fjasmine.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fjasmine%2Fjasmine?ref=badge_large)
|
---|