This repository has been archived by the owner on May 30, 2023. It is now read-only.
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Improve PhantomJS README, mention well-known related projects.
Also minor editing everywhere else. http://code.google.com/p/phantomjs/issues/detail?id=419
- Loading branch information
Showing
1 changed file
with
17 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,29 +1,40 @@ | ||
# [PhantomJS](http://phantomjs.org) - Scriptable Headless WebKit | ||
|
||
PhantomJS ([www.phantomjs.org](http://phantomjs.org)) is a headless WebKit with JavaScript API. It used by hundreds of [developers](http://code.google.com/p/phantomjs/wiki/ExternalArticles) and dozens of [organizations](http://code.google.com/p/phantomjs/wiki/WhoUsesPhantomJS) for web-related development workflow. | ||
PhantomJS ([www.phantomjs.org](http://phantomjs.org)) is a headless WebKit scriptable with JavaScript or CoffeeScript. It is used by hundreds of [developers](http://code.google.com/p/phantomjs/wiki/ExternalArticles) and dozens of [organizations](http://code.google.com/p/phantomjs/wiki/WhoUsesPhantomJS) for web-related development workflow. | ||
|
||
The latest [stable release](http://code.google.com/p/phantomjs/wiki/ReleaseNotes) is version 1.5 (codenamed "Ghost Flower"). Follow the official Twitter stream [@HeadlessPhantom](http://twitter.com/HeadlessPhantom) to get the frequent development updates. | ||
|
||
## Use Cases | ||
|
||
- **Headless web testing**. Lightning-fast testing without the browser is now possible! Various [test frameworks](http://code.google.com/p/phantomjs/wiki/TestFrameworkIntegration) such as Jasmine, Capybara, QUnit, YUI Test, BusterJS, FuncUnit, and many others are supported. | ||
- **Headless web testing**. Lightning-fast testing without the browser is now possible! Various [test frameworks](http://code.google.com/p/phantomjs/wiki/TestFrameworkIntegration) such as Jasmine, Capybara, QUnit, WebDriver, YUI Test, BusterJS, FuncUnit, Robot Framework, and many others are supported. | ||
|
||
- **Site scraping**. [Access and manipulate](http://code.google.com/p/phantomjs/wiki/QuickStart#DOM_Manipulation) webpages with the standard DOM API, or with usual libraries like jQuery. | ||
|
||
- **Page rendering**. [Capture](http://code.google.com/p/phantomjs/wiki/QuickStart#Rendering) the full contents, even with SVG and Canvas, to an image. Build server-side web graphics apps, from a screenshot service to vector chart generator. | ||
- **Page rendering**. [Capture](http://code.google.com/p/phantomjs/wiki/QuickStart#Rendering) the full contents, even with SVG and Canvas, to an image. Build server-side web graphics apps, from a screenshot service to a vector chart rasterizer. | ||
|
||
- **Network monitoring**. [Monitor](http://code.google.com/p/phantomjs/wiki/QuickStart#Network_traffic) network activity, track resource loading, perform load-balancing tests, verify contents optimization, and many others. | ||
|
||
## Features | ||
|
||
- **Multiplatform**, available on major operating systems: Windows, Mac OS X, Linux, other Unices. | ||
- **Fast and native implementation** of web standards: DOM, CSS, JavaScript, Canvas, SVG. No emulation! | ||
- **Pure headless (X11) on Linux**, ideal for continuous integration systems. | ||
- **Pure headless (X11) on Linux**, ideal for continuous integration systems. Also runs on Amazon EC2. | ||
- **Easy to install**: [Download](http://code.google.com/p/phantomjs/wiki/Installation), unpack, and start having fun in just 5 minutes. | ||
- Scripts can be written in **JavaScript** or **CoffeeScript**. | ||
|
||
## Ecosystem | ||
|
||
PhantomJS needs not be used only as a stand-alone tool. Check also some excellent related projects: | ||
|
||
- [CasperJS](http://casperjs.org) enables easy navigation scripting and common high-level testing. | ||
- [Poltergeist](https://github.com/jonleighton/poltergeist) allows running Capybara tests headlessly. | ||
- [Guard::Jasmine](https://github.com/netzpirat/guard-jasmine) automatically tests Jasmine specs on Rails when files are modified. | ||
- [GhostDriver](http://detro.github.com/ghostdriver/) complements Selenium tests with a PhantomJS WebDriver implementation. | ||
- [PhantomRobot](https://github.com/datakurre/phantomrobot) runs Robot Framework acceptance tests in the background. | ||
|
||
any many others [companion projects](http://code.google.com/p/phantomjs/wiki/WhoUsesPhantomJS). | ||
|
||
## Questions? | ||
|
||
- Explore the complete [documentation](http://code.google.com/p/phantomjs/wiki/PhantomJS?tm=6). | ||
- Read tons of [user articles](http://code.google.com/p/phantomjs/wiki/ExternalArticles) on using PhantomJS. | ||
- Join the [mailing-list](http://groups.google.com/group/phantomjs) and discuss with other PhantomJS fans. | ||
|