View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Max Maischein > WWW-Mechanize-Firefox > WWW::Mechanize::Firefox::Installation


Annotate this POD


New  8
Open  5
View/Report Bugs


WWW::Mechanize::Firefox::Installation - How to install the components

Installation ^

If you notice that tests get skipped and/or the module installs but "does not seem to work", there are some more steps required to configure Firefox:

  1. Download mozrepl 1.1.2 available from

    or a later version from

  2. If you downloaded the version from, skip to 5.

    If you downloaded a version from github, unpack the zip archive into a directory. The version distributed by is ready for direct installation.

    The archive contains one subdirectory with a name of the form bard-mozrepl-abcdefg.

  3. Create a new zip archive with the files in the subdirectory bard-mozrepl-abcdefg. This new archive must have the files at the root entry, not in a subdirectory.

    The file layout should look like this:

  4. Rename your new zip archive from .zip to .xpi.
  5. Launch Firefox
  6. Install the downloaded or freshly created .xpi file into Firefox. For example you can drag and drop the file into Firefox.
  7. Start mozrepl in Firefox by going to the menu:
       "Tools" -> "MozRepl" -> "Start"

    You may want to tick the "Activate on startup" item.

    Alternatively, launch the Firefox binary with the -mozrepl command line switch:

      firefox -repl

If tests still fail, especially t/50-click.t and 51-mech-submit.t , this might be because you use the NoScript Mozilla extension and have it blocking Javascript for file:// URLs. While this is good, the tests need Javascript enabled.

  1. Open t/50-click.html in Firefox
  2. Allow Javascript for all file:// URLs
  3. Re-run tests
        perl Makefile.PL
        nmake test

    or if you are using Strawberry Perl or Citrus Perl

        perl Makefile.PL
        dmake test
  4. No test should fail

If tests fail with an error from Firefox that a file could not be found, check that the test suite and the Firefox process are run using the same user. Otherwise, the Firefox process might not have the permissions to access the files created by the test suite.

PPMs ^

If you use ActiveStates package manager, you can find some pre-packaged but untested PPMs at .

As I don't use ppm, I can't offer any support for them.


Max Maischein


Copyright 2010-2014 by Max Maischein

All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.

syntax highlighting: