README.md in boojs-0.0.20 vs README.md in boojs-0.0.21

- old
+ new

@@ -8,14 +8,13 @@ <p align="center"> <img src="https://raw.githubusercontent.com/sotownsend/boojs/master/usage.gif" /> </p> # 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](http://phantomjs.org/) and -acts as a well-behaved unix tool. +**BooJS** allows you to execute javascript on the command line as if you were in a browser. It has well defined behavior that follows `unix` conventions and is built on-top of [PhantomJS](http://phantomjs.org/). -**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.** +**BooJS** was purpose built for our continuous integration infrastructure at [FittrĀ®](http://www.fittr.com). # Setup ```sh #Setup gem install boojs @@ -72,9 +71,22 @@ - If you **want to contribute**, submit a pull request. --- ## FAQ + +### 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. + +### ...But PhantomJS has a perfectly good REPL, kids these days... +There are a myriad issues with the *PhantomJS repl*; most notably, the *PhantomJS repl*: + * Outputs special format characters even when not attached to a `tty` + * Does not have well defined behavior which makes it a nightmare to integrate with + * **Has no support for asynchronous stdin** + * Changes what it considers a newline based on the attached terminal (A QT quirk) + * Is not a unix tool in any sense + +I don't think any of this is the `PhantomJS`'s team fault; it's just not their focus or target. ### 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.