WWW::Mechanize::Chrome::Troubleshooting - Things to watch out for
If you notice that tests get skipped and/or the module installs but "does not seem to work", most likely you need to close ALL your Chrome windows. If you want Perl to share your browser, you will need to start Chrome yourself with the <--remote-debugging-port=9222> command line switch.
<--remote-debugging-port=9222
If you notice that tests ( most likely, t/51-mech-links.t ) fail with URLs that are not on localhost or 127.0.0.1, another not entirely unlikely explanation is that your machine or your browser has been infected by some "Search Plugin" redirector which exfiltrates your browsing history or redirects your search engine or banking websites to other websites.
t/51-mech-links.t
localhost
127.0.0.1
For confirmation and/or finding out how to remove the offender, maybe a search from a different machine for the URLs injected additionally into the test pages helps you identify the offender.
Install your own version of Chrome/Chromium locally and disable automatic updates. This prevents the API from changing under your scripts.
Chrome / Chromium doesn't have an API for determining whether a download completed or not. Chrome versions v62 and v63 do have working downloads, but Chrome v64 does not send the appropriate API messages.
You get the error message
Timeout while connecting to localhost:9222. Do you maybe have a non-debug instance of Chrome already running?
Most likely you already launched the Chrome binary without supplying the --remote-debugging-port option. Either stop all Chrome instances and (re)launch them using the --remote-debugging-port on the command line or launch a separate Chrome session using a separate data directory using the data_directory option.
--remote-debugging-port
data_directory
When Chrome is run in headless mode, Chrome throws a Lost UI shared context error. This error can be ignored and does not affect the operation of this module.
Lost UI shared context
Ideally you ask your question on the public support forum, as then other people can also provide you with good answers. Your question should include a short script of about 20 lines that reproduces the problem. Remember to remove all passwords from the script.
The public repository of this module is https://github.com/Corion/www-mechanize-chrome.
The public support forum of this module is https://perlmonks.org/.
Please report bugs in this module via the RT CPAN bug queue at https://rt.cpan.org/Public/Dist/Display.html?Name=WWW-Mechanize-Chrome or via mail to www-mechanize-Chrome-Bugs@rt.cpan.org.
Max Maischein corion@cpan.org
corion@cpan.org
Copyright 2010-2019 by Max Maischein corion@cpan.org.
This module is released under the same terms as Perl itself.
To install WWW::Mechanize::Chrome, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::Mechanize::Chrome
CPAN shell
perl -MCPAN -e shell install WWW::Mechanize::Chrome
For more information on module installation, please visit the detailed CPAN module installation guide.