bogdanp/marionette

A Racket library that lets you control Firefox via the Marionette Protocol.

marionette

A Racket library that lets you control Firefox via the Marionette Protocol.

Quickstart

Install marionette:

$ raco pkg install marionette

Run Firefox with the -marionette flag:

$ /path/to/firefox -headless -marionette -safe-mode

Run this script:

#lang racket

(require marionette)

(call-with-browser!
  (lambda (b)
    (call-with-page! b
      (lambda (p)
        (page-goto! p "https://racket-lang.org")
        (call-with-page-screenshot! p
          (lambda (data)
            (define filename (make-temporary-file "~a.png"))
            (with-output-to-file filename
              #:exists 'truncate/replace
              (lambda ()
                (write-bytes data)))

            (system* (find-executable-path "open") filename)))))))

Tips

To run a headless, marionette-enabled Firefox while you've got another instance of the browser open, add the -no-remote flag:

$ /path/to/firefox -no-remote -headless -marionette -safe-mode

It's advisable that you use a separate profile as well:

$ /path/to/firefox -P marionette -no-remote -headless -marionette -safe-mode

You can create new profiles by visiting about:profiles in the browser.

marionette's Issues

Example Script Crashes

First off, thanks for writing this library. I'm keen to try it out.

After launching firefox in headless marionette mode as specified in the README, I try to run the script (the one in the README) and it fails with this output:

system*: contract violation
  expected: path-string?
  given: #f
  context...:
   /usr/share/racket/collects/racket/system.rkt:181:19
   /usr/share/racket/collects/racket/system.rkt:174:0: do-system*/exit-code
   /usr/share/racket/collects/racket/system.rkt:210:0: system*40
   "/home/person/Learning/racket/marionette/test.rkt": [running body]
   for-loop
   run-module-instance!125
   perform-require!78

I'm running the script with racket test.rkt, and this is using Racket v7.0

I am pretty new to Racket, and assuming it's something simple.

PDF example fails

Hello again!

Enjoying learning from this library.

The PDF example fails for me with a timeout error. I tried running the javascript with another marionette client, and got the same error: Timed out after 30000 ms

Does it work for you though?

match-define: no matching clause for #f in private\transport.rkt

To be honest, I forgot why this happened... but the error was this.
\7.9\pkgs\marionette-lib\marionette\private\transport.rkt:85:2: match-define: no matching clause for #f

Leaving it here just in case, but could have been an user (my) error.