/BooJS

Unix swiss army knife for headless browser javascript

Primary LanguageRubyMIT LicenseMIT

boojs: A unix tool to execute headless browser javascript

Gem Version Build Status Bitdeli Badge License

What is this?

A simple tool that allows you to execute javascript in the command line as if you were in a browser. Built on-top of PhantomJS and acts as a well-behaved unix tool.

Wait, isn't this just NodeJS? No, they are for different things. BooJS gives you the full DOM, you can call document in BooJS and import arbitrary browser javascript libraries.

Setup

#Setup
gem install boojs

Usage

SYNOPSIS

boojs [-e statement] [-v file] [file]

DESCRIPTION

The following options are available:

  • -e - Pass a javascript statement to execute after the file (if a file is provided) and then immediately terminate.
  • -v - Verify that a file contains no javascript syntax errors. Returns 0 if there are no errors.

EXAMPLES

Open a javascript pipe that reads from stdin, writes via console.log to stdout, prints exceptions via stderr, and exits with a return code of 1 if there are errors.

(sh)>boojs

Same as boojs but read the javascript file before reading from stdin. (i.e. preload a javascript file into your environment)

(sh)>boojs code.js

Execute a javascript statement, and then immediately exit. Exceptions will return 1.

(sh)>boojs -e "console.log(document);"

Verify that a file contains no javascript runtime initialization errors

(sh)>boojs -v code.js
(sh)>echo $?
0

Requirements

  • Ruby 2.1 or Higher

Communication

  • If you found a bug, submit a pull request.
  • If you have a feature request, submit a pull request.
  • If you want to contribute, submit a pull request.

FAQ

When should I use boojs?

When you need to test javascript code that needs to run in a browser but don't necessarily need to test the UI components.

What's Fittr?

Fittr is a SaaS company that focuses on providing personalized workouts and health information to individuals and corporations through phenomenal interfaces and algorithmic data-collection and processing.


Creator

License

boojs is released under the MIT license. See LICENSE for details.