Starts Chromium or Google Chrome in headless mode (using Xvfb) and forwards the output from JavaScript console to stdout.
Xvfb only works on Linux and OS X; Windows is not supported.
Usage
./run-headless-chromium.js [options]
All [options]
are directly passed to Chromium. All console messages are forwarded to the
standard output of this process. Every message generated by console.log
, console.warn
, etc.
is printed with a newline character at the end, unless the message ends with \x03\b
. This is
a special character sequence interpreted as "not end of newline".
In addition to the JavaScript messages, errors from Chromium are also printed in the console. This behavior can be controlled by two environment variables:
LOG_CR_VERBOSITY
- Only print messages from Chromium with this verbosity level.
Allowed values: Any permutation ofINFO|WARNING|ERROR|ERROR_REPORT|FATAL|VERBOSE|UNKNOWN
, defaults toERROR|ERROR_REPORT|FATAL
. UseLOG_CR_VERBOSITY=.
to show all messages.LOG_CR_HIDE_PATTERN
- Exclude messages matching this pattern (case-insensitive).
Allowed values: Any regular expression (ECMAScript/JavaScript syntax), defaults tokwallet
.CHROMIUM_EXE_PATH
- Set the path to the Chromium / Google Chrome executable.
Any webpage that is loaded using run-headless-chromium can close Chromium and exit the process
by sending the magic string console.log("All tests completed!");
.
Insert an integer at the end of the string to change the exit code of this program from 0 to
some other integer within the 0 - 255 range.
Example
Headless Chromium is ideal for unit testing, e.g. with Jasmine:
Jasmine 1.3
Jasmine 2.0
Node.js
The following example shows how to start run-headless-chromium
from Node.js,
and terminate the process in a graceful way. Note that the page from the example
does not call console.info('All tests completed!0')
, so the browser would stay
around indefinitely if we do not explicitly kill it.
// spawn has the same API as child_process.spawn, minus the command argument.// See the "spawn" method at https://nodejs.org/api/child_process.htmlvar spawnHeadlessChromium = spawn; var proc = ;proc;var delayedExit = ;
License
MIT