61fb353197
Jasmine 1.x exposed Suite objects to user code as the `this` in describe functions. That should have been removed in 2.0 but it was missed. It will be removed in 4.0. This change adds a deprecation warning if anything on a describe's `this` is accessed. The deprecation warning relies on Proxy, and won't work in environments that don't have it. Among Jasmine's supported environments, that's Safari 9, Safari 8, and all versions of IE. In those browsers, a describe's `this` will still be a Suite for now, but there will be no deprecation warnings.
A JavaScript Testing Framework
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 projects, or anywhere that JavaScript can run.
Documentation & guides live here: http://jasmine.github.io For a quick start guide of Jasmine, see the beginning of http://jasmine.github.io/edge/introduction.html.
Contributing
Please read the contributors' guide.
Installation
For the Jasmine NPM module:
https://github.com/jasmine/jasmine-npm.
For the Jasmine browser runner:
https://github.com/jasmine/jasmine-browser.
For the Jasmine Ruby Gem:
https://github.com/jasmine/jasmine-gem.
For the Jasmine headless browser gulp plugin:
https://github.com/jasmine/gulp-jasmine-browser.
To install Jasmine standalone on your local box (where {#.#.#} below is substituted by the release number downloaded):
- Download the standalone distribution for your desired release from the releases page.
- Create a Jasmine directory in your project. -
mkdir my-project/jasmine - Move the dist to your project directory. -
mv jasmine/dist/jasmine-standalone-{#.#.#}.zip my-project/jasmine - Change directory. -
cd my-project/jasmine - Unzip the dist. -
unzip jasmine-standalone-{#.#.#}.zip
Add the following to your HTML file:
<link rel="shortcut icon" type="image/png" href="lib/jasmine-{#.#.#}/jasmine_favicon.png">
<link rel="stylesheet" type="text/css" href="lib/jasmine-{#.#.#}/jasmine.css">
<script type="text/javascript" src="lib/jasmine-{#.#.#}/jasmine.js"></script>
<script type="text/javascript" src="lib/jasmine-{#.#.#}/jasmine-html.js"></script>
<script type="text/javascript" src="lib/jasmine-{#.#.#}/boot.js"></script>
Supported environments
Jasmine tests itself across many browsers (Safari, Chrome, Firefox, Microsoft Edge, and Internet Explorer) as well as nodejs.
| Environment | Supported versions |
|---|---|
| Node | 10, 12, 14, 16 |
| Safari | 8-14 |
| Chrome | Evergreen |
| Firefox | Evergreen, 68, 78 |
| Edge | Evergreen |
| Internet Explorer | 10, 11 |
For evergreen browsers, each version of Jasmine is tested against the version of the browser that is available to us at the time of release. Other browsers, as well as older & newer versions of some supported browsers, are likely to work. However, Jasmine isn't tested against them and they aren't actively supported.
Support
- Search past discussions: http://groups.google.com/group/jasmine-js.
- Send an email to the list: jasmine-js@googlegroups.com.
- View the project backlog at Pivotal Tracker: http://www.pivotaltracker.com/projects/10606.
- Follow us on Twitter: @JasmineBDD.
Maintainers
- Gregg Van Hove, Pivotal Labs
Maintainers Emeritus
- Davis W. Frank, Pivotal Labs
- Rajan Agaskar, Pivotal Labs
- Greg Cobb, Pivotal Labs
- Chris Amavisca, Pivotal Labs
- Christian Williams, Cloud Foundry
- Sheel Choksi
Copyright (c) 2008-2018 Pivotal Labs. This software is licensed under the MIT License.
License
