Headless Browsing


PhantomJS is a headless WebKit scriptable with a JavaScript API. It has fast and native support for various web standards: DOM handling, CSS selector, JSON, Canvas, and SVG. RSelenium can drive PhantomJS using two methods: directly or via the standalone Selenium Server.

Driving PhantomJS Directly

The PhantomJS binary can be driven directly with RSelenium. PhantomJS needs to be started in webdriver mode then RSelenium can communicate with it directly without the need for Selenium Server. The command line options for PhantomJS are outlined at http://phantomjs.org/api/command-line.html. We note that it is necessary to start PhantomJS with the --webdriver option and an optional IP/port. RSelenium as of v1.3.2 has a utility function phantom that will handle starting the PhantomJS binary in webdriver mode by default on port 4444. So to drive PhantomJS sans Selenium Server can be done as follows:

Driving PhantomJS Using Selenium Server

For completeness we outline the process of opening a PhantomJS browser using selenium server. It is assummed that the PhantomJS binary is in the users path.

Providing the PhantomJS Path

It may not be possible for a user to have the PhantomJS binary in their path. In this case a user may pass the path of the PhantomJS binary to Selenium Server:

So in the above example I suppose the PhantomJS binary has been moved to my Desktop which we assume is not in my path. An extra capability phantomjs.binary.path detailed https://github.com/detro/ghostdriver can be used to provide the path to PhantomJS to Selenium Server.

Additional PhantomJS Capabilities

Setting a User Agent

A user agent can be set using the phantomjs.page.settings.userAgent capability.

## [1] "Your User Agent String is:\nMozilla/5.0 (Unknown; Linux x86_64)
## AppleWebKit/534.34 (KHTML, like Gecko) PhantomJS/1.9.7 Safari/534.34"
## [1] "Your User Agent String is:\nMozilla/5.0 (Windows NT 6.1; WOW64; rv:29.0)
## Gecko/20120101 Firefox/29.0"

The https://github.com/ariya/phantomjs/wiki/API-Reference-WebPage#webpage-settings In the above example it can be seen that the default useragent identifies us as PhantomJS. Some web content maybe inaccessible or blocked for PhantomJS users. Here we demonstrate changing our user agent so the website sees us as Firefox 29.0.

Other Possible Options

The general form of specifying PhantomJS internal page objects take the form phantomjs.page.settings.SETTING = VALUE where SETTING is the appropriate PhantomJS internal page object. As an example we inhibit the loading of inline images:

We can see that the images are not loaded:

X Virtual Frame Buffer

For the discussion on xvfb and the related VPS, I refer you to this blog entry. How to setup a VPS with rstudio server and shiny server etc. is outlined.


The VPS i am connecting to has an ip of I have rstudio server running on port 8787. On the remote server we observe


So we have started a selenium server running on (default) port 4444. Firefox and google chrome are not currently installed on this remote machine. Lets install firefox first. On the remote VPS we run

Now checking in the remote rstudio

##            firefox 
## "/usr/bin/firefox" 

If we try now to connect to the remote server and open firefox:

## [1] "Connecting to remote server"
## Error:    Summary: UnknownError
##    Detail: An unknown server-side error occurred while processing the command.
##    class: org.openqa.selenium.WebDriverException

We can see the problem if we try to run firefox in the remote shell:

Firefox is install but there is no display on our headless VPS. We can use xvfb to provide a virtual display for our browser to run in.

Xvfb :0 -screen 0 1024x768x24 2>&1 >/dev/null &
export DISPLAY=:0
nohup xvfb-run java -jar selenium-server-standalone.jar > selenium.log &

PhantomJS API Examples

The phantomExecute method of the remoteDriver class allows the user to interact with the PhantomJS API. Currently the method only works for direct calls to PhantomJS using the phantom utility function. Driving PhantomJS through the Selenium Server and calling the phantomExecute method currently doesnt function and is an open issue (in the ghostDriver project). In the following sections we outline examples of using the PhantomJS API.

Interacting with the Console

The PhantomJS API implements a number of callbacks which can be defined. onLoadFinished is one such callback. This callback is invoked when the page finishes the loading. It may accept a single argument indicating the pages status: success if no network errors occurred, otherwise fail.

We give a simple example of writing to the console log when a page is loaded.

## Status:  success
## Loaded:  http://www.google.com/
## Status:  success
## Loaded:  http://www.bbc.co.uk/
## Status:  success
## Loaded:  http://www.bbc.com/

It can be seen that the callback persists across page calls.

PhantomJS Writing to File

The next example demonstrates writing to file from PhantomJS. Once again the onLoadFinished callback is utilised. In this example the html source of the page that is navigated to is downloaded to output.htm relative to getwd(). An example is given of using phantom.exit() to close PhantomJS from the API.

## Google

Injecting a Library into PhantomJS

Next we look at includeJs.

This includes an external script from the specified url (usually a remote location) on the page and executes the callback upon completion. The library we shall include is JQuery using the google CDN. Now any page we call with PhantomJS will have the JQuery library loaded after the page has finished loading.

## Status:  success
## Loaded:  http://www.google.com/
## Loaded jQuery!

Starting a PhantomJS Web Server

PhantomJS has the ability to act as a Web Server. Here we demonstrate setting PhantomJS up as a web server on the localhost on port 8080. When a user browses to http://localhost:8080 they are returned a list of the current blog titles on http://www.r-bloggers.com. The Jquery library is also injected to aid extraction of the blog titles.

## Loaded jQuery!
## [1] "Current blogs on r-bloggers:"                        "Specifying complicated groups of time series in hts"
## [3] "Creating Inset Map with ggplot2"                     "R and Vertica"                                      
## [5] "RGolf: NGSL Scrabble"                                "European talks. June-July 2014"