Controlling Firefox from Perl

UPDATE In 0.55, Firefox removed the features which allowed MozRepl to work.

I’ve been playing with WWW::Mechanize::Firefox. It’s like the LWP-backended WWW::Mechanize, but with a browser doing all the work. Instead of doing it all in Perl, I can use it as the glue language that it is.

Sometimes WWW::Mechanize, LWP::UserAgent, or Mojo::UserAgent aren’t enough. For basic web scraping and automation they work well, but fail miserably for anything that requires JavaScript. Some people have luck with SpiderMonkey (with several Perl interfaces), but that still isn’t the whole browser environment.

Before you start, you need the Firefox browser (or one of its forks) with the MozRepl add-on, which provides an interactive JavaScript console that you can telnet into. Once activated, you can connect to the console and can control the browser.


I have to know JavaScript to control Firefox directly. I can telnet into the MozRepl server and issue commands. It’s a bit more work than I’d like to do.


I’m not going to control Firefox directly, though, because I’m going to let some Perl modules do that for me. The basic interface of WWW::Mechanize::Firefox is the same as WWW::Mechanize:

use v5.10;
use WWW::Mechanize::Firefox;

my $mech = WWW::Mechanize::Firefox->new;
$mech->autoclose_tab( 0 );

$mech->get( '' );

foreach my $link ( $mech->links ) {
    state $count = 0;
    say $count++, ": ", $link->url;

I get a list of the links on the PerlTricks main page:


That’s not even the good part yet.

Executing JavaScript

Since I’m connected to a JavaScript terminal, I can evaluate JavaScript code. The eval returns the result and its type:

use v5.10;
use WWW::Mechanize::Firefox;

my $mech = WWW::Mechanize::Firefox->new;
$mech->autoclose_tab( 0 );

my( $result, $type ) = $mech->eval( '2+2' );

say "2+2 is $result (type $type)";
2+2 is 4 (type number)

That evaluates the JavaScript in its own context, which isn’t that interesting for me. I want to interact and control parts of a web page. To do that, I use the eval_in_page. That runs the JavaScript with everything else going on in the current tab, including all the JavaScript code it has loaded. Here’s an example that uses the StackExchange JavaScript to change the view from the desktop mode to the mobile mode:

use v5.10;
use WWW::Mechanize::Firefox;

my $mech = WWW::Mechanize::Firefox->new;
$mech->autoclose_tab( 0 );

$mech->get( '' );
sleep 5;
$mech->eval_in_page( 'StackExchange.switchMobile("on")' );

When I run this, the screen changes from the full site to the mobile site.


Some problems

This approach has some problem though, almost none of which come from Perl. If I want to automate something that makes many requests or runs for a long time, Firefox is likely to have problems. Over time, it’s memory footprint grows, leading to poor performance and crashes. Sometimes the connection to the console breaks, taking down my program with it.

Because of this, I limit my use of WWW::Mechanize::Firefox to the parts of my problem that require JavaScript. I can extract the information I need then use Mojo::UserAgent to handle the other parts.

Similar solutions

The WWW::Mechanize::Firefox isn’t the only way to do this sort of thing. Rob Hammond posted on about PhantomJS, which received some comments about WWW::WebKit. There used to be a Win32::IE::Mechanize, but apparently it doesn’t work in IE 8. Selenium and Test::WWW::Selenium is another tool that I could use, but that’s more geared to browser acceptance testing and replays.

Join the discussion on the Perl subreddit about this article!

Update: last paragraph updated to include Selenium reference. 2014-12-09

This article was originally posted on


brian d foy

brian d foy is a Perl trainer and writer, and a senior editor at He’s the author of Mastering Perl, Mojolicious Web Clients, Learning Perl Exercises, and co-author of Programming Perl, Learning Perl, Intermediate Perl and Effective Perl Programming.

Browse their articles


Something wrong with this article? Help us out by opening an issue or pull request on GitHub