f6abcfe676
Although it is mentioned in http://phantomjs.org/build.html, many people are not aware this, they compile from source (even if a binary package is available) and get shocked to realize the build takes ages. The build script is thus modified to give the initial warning. Unattended build is still possible, just use --confirm flag. http://code.google.com/p/phantomjs/issues/detail?id=862 |
||
---|---|---|
deploy | ||
examples | ||
src | ||
test | ||
tools | ||
website | ||
.gitignore | ||
CONTRIBUTING.md | ||
ChangeLog | ||
LICENSE.BSD | ||
README.md | ||
build.sh | ||
phantomjs.pro | ||
third-party.txt |
README.md
PhantomJS - Scriptable Headless WebKit
PhantomJS (www.phantomjs.org) is a headless WebKit scriptable with JavaScript or CoffeeScript. It is used by hundreds of developers and dozens of organizations for web-related development workflow.
The latest stable release is version 1.7 (codenamed "Blazing Star"). Follow the official Twitter stream @PhantomJS to get the frequent development updates.
Note: Please do not create a GitHub pull request without reading the Contribution Guide first. Failure to do so may result in the rejection of the pull request.
Use Cases
- Headless web testing. Lightning-fast testing without the browser is now possible! Various test frameworks such as Jasmine, Capybara, QUnit, Mocha, WebDriver, YUI Test, BusterJS, FuncUnit, Robot Framework, and many others are supported.
- Page automation. Access and manipulate web pages with the standard DOM API, or with usual libraries like jQuery.
- Screen capture. Programmatically capture web contents, including CSs, SVG and Canvas. Build server-side web graphics apps, from a screenshot service to a vector chart rasterizer.
- Network monitoring. Automate performance analysis, track page loading and export as standard HAR format.
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 (no X11) on Linux, ideal for continuous integration systems. Also runs on Amazon EC2, Heroku, Iron.io.
- Easy to install: Download, unpack, and start having fun in just 5 minutes.
Ecosystem
PhantomJS needs not be used only as a stand-alone tool. Check also some excellent related projects:
- CasperJS enables easy navigation scripting and common high-level testing.
- Poltergeist allows running Capybara tests headlessly.
- Guard::Jasmine automatically tests Jasmine specs on Rails when files are modified.
- GhostDriver complements Selenium tests with a PhantomJS WebDriver implementation.
- PhantomRobot runs Robot Framework acceptance tests in the background via PhantomJS.
and many others related projects.
Questions?
- Explore the complete documentation
- Read tons of user articles on using PhantomJS.
- Join the mailing-list and discuss with other PhantomJS fans.
PhantomJS is free software/open source, and is distributed under the BSD license. It contains third-party code, see the included third-party.txt
file for the license information on third-party code.
PhantomJS is created and maintained by Ariya Hidayat (Twitter: @ariyahidayat), with the help of many contributors.