emrun - emscripten tool to compile as an HTML page
usage: emrun [emrun_options] filename.html --
[html_cmdline_options]
- where emrun_options specifies command line options for emrun itself,
whereas html_cmdline_options specifies startup arguments to the
program.
If you are seeing "unrecognized arguments" when trying
to pass arguments to your page, remember to add `--` between arguments to
emrun itself and arguments to your page.
- -h, --help
- show this help message and exit
- --kill_start
- If true, any previously running instances of the target browser are killed
before starting.
- --kill_exit
- If true, the spawned browser process is forcibly killed when it calls
exit(). Note: Using this option may require explicitly passing the option
--browser=/path/to/browser, to avoid emrun being detached from the
browser process it spawns.
- --no_server
- If specified, a HTTP web server is not launched to host the page to
run.
- --no_browser
- If specified, emrun will not launch a web browser to run the page.
- --no_emrun_detect
- If specified, skips printing the warning message if html page is detected
to not have been built with --emrun linker flag.
- --serve_after_close
- If true, serves the web page even after the application quits by user
closing the web page.
- --serve_after_exit
- If true, serves the web page even after the application quits by a call to
exit().
- --serve_root
SERVE_ROOT
- If set, specifies the root path that the emrun web server serves. If not
specified, the directory where the target .html page lives in is
served.
- --verbose
- Enable verbose logging from emrun internal operation.
- --hostname
HOSTNAME
- Specifies the hostname the server runs in.
- --port PORT
- Specifies the port the server runs in.
- --log_stdout
LOG_STDOUT
- Specifies a log filename where the browser process stdout data will be
appended to.
- --log_stderr
LOG_STDERR
- Specifies a log filename where the browser process stderr data will be
appended to.
- --silence_timeout
SILENCE_TIMEOUT
- If no activity is received in this many seconds, the browser process is
assumed to be hung, and the web server is shut down and the target browser
killed. Disabled by default.
- --timeout
TIMEOUT
- If the browser process does not quit or the page exit() in this many
seconds, the browser is assumed to be hung, and the web server is shut
down and the target browser killed. Disabled by default.
- --timeout_returncode
TIMEOUT_RETURNCODE
- Sets the exit code that emrun reports back to caller in the case that a
page timeout occurs. Default: 99999.
- --list_browsers
- Prints out all detected browser that emrun is able to use with the
--browser command and exits.
- --browser
BROWSER
- Specifies the browser executable to run the web page in.
- --browser_args
BROWSER_ARGS
- Specifies the arguments to the browser executable.
- --android
- Launches the page in a browser of an Android device connected to an USB on
the local system. (via adb)
- --system_info
- Prints information about the current system at startup.
- --browser_info
- Prints information about the target browser to launch at startup.
- --json
- If specified, --system_info and --browser_info are outputted
in JSON format.
- --safe_firefox_profile
- If true, the browser is launched into a new clean Firefox profile that is
suitable for unattended automated runs. (If target browser != Firefox,
this parameter is ignored)
- --log_html
- If set, information lines are printed out an HTMLfriendly format.
- --private_browsing
- If specified, opens browser in private/incognito mode.
- --dump_out_directory
DUMP_OUT_DIRECTORY
- If specified, overrides the directory for dump files using emrun_file_dump
method.