phantomjs/_posts/documentation/help/2000-01-01-troubleshooting.md

layout	title	categories	permalink
post	Troubleshooting	docs docs-help	troubleshooting.html

Latest Version

Before reporting an issue, make sure you are using the latest version:

phantomjs --version

All examples are designed to work with the latest version of PhantomJS. If some examples do not work, make sure that there is not more than one version of PhantomJS installed in the system. Multiple versions may lead to conflict as to which one is being invoked in the terminal.

Network Problem

If the data is not transferred correctly, check if the network works as expected.

Since every network request and response can be "sniffed", add simple callbacks to facilitate such troubleshooting. For more details, see the wiki page on Network Monitoring. An example of a simple logging:

page.onResourceRequested = function (request) {
    console.log('Request ' + JSON.stringify(request, undefined, 4));
};

Transport Layer Security (TLS) and Secure Sockets Layer (SSL) are necessary to access encrypted data, for example when connecting to a server using HTTPS. Thus, if PhantomJS works well with HTTP but it shows some problem when using HTTPS, the first useful thing to check it whether the SSL libraries, usually OpenSSL, have been installed properly.

On Windows, the default proxy setting may cause a massive network latency (see Known Issues in the release note). The workaround is to disable proxy completely, e.g. by launching PhantomJS with ----proxy-type=none command-line argument.

SELinux

SELinux can stop PhantomJS working. The solution given here, to create a custom policy, has been reported to work: http://serverfault.com/a/430499/87322

Error Handling

To easily catch an error occured in a web page, whether it is a syntax error or other thrown exception, an onError handler for the WebPage object has been added. An example on such a handler is:

page.onError = function (msg, trace) {
    console.log(msg);
    trace.forEach(function(item) {
        console.log('  ', item.file, ':', item.line);
    })
}

Now if the page opens a site with some JavaScript exceptions, a detailed information (including the stack trace) will be printed out.

Remote Debugging

Remote debugging permits inspection of the script and web page via another WebKit-based browser (Safari and Chrome). This is achieved by launching PhantomJS with the new option, as in this example

phantomjs --remote-debugger-port=9000 test.js

After that, open Safari/Chrome/Chromium and go to the URL http://ipaddress:9000. If you executed the phantomjs command on the same machine, it will be http://127.0.0.1:9000

You will see a list of links. Click the first (it may say "about:blank"). It will show a version of the Web Inspector interface which in this case works on the script being tested..

To set breakpoints, look for your script in the drop-down in the Scripts tab; it should have the same URL that you just clicked on.

After setting breakpoints (or if you are using debugger instead), to run your script, simply enter the __run() command in the Web Inspector Console. Alternatively, use --remote-debugger-autorun=yes command-line argument to have your script launched immediately.

To debug inside a target web page requires two inspectors and a multi-step process using a function like this:

function debugPage() {
  console.log("Refresh a second debugger-port page and open a second webkit inspector for the target page.");
  console.log("Letting this page continue will then trigger a break in the target page.");
  debugger; // pause here in first web browser tab for steps 5 & 6
  page.evaluateAsync(function() {
    debugger; // step 7 will wait here in the second web browser tab
  });
}

1. start on command line with remote-debugger-port option.
2. navigate to debugging port in web browser
3. get first web inspector for phantom context
4. from the web browser console execute __run(), which will hit first debugger point
5. navigate to debugging port (http://127.0.0.1:9000 if you use 9000 and everything is on the same machine) in a second web browser tab
6. get second web inspector (for page context)
7. return to the first web inspector tab and click continue on debugger
8. navigate back to second tab and you should find debugger waiting

Interactive Mode (REPL)

If PhantomJS is launched without any argument, it starts in the so-called interactive mode, also known as REPL (read-eval-print-loop). This mode allows a faster cycle of experiment and script prototyping. PhantomJS REPL supports the expected features: command editing, persistent history, and autocomplete (with Tab key). Read more about REPL.