RHINO(1)

💖 RHINO(1) — like, the manual page bestie 💖

General Commands Manual energy, but make it a group chat. This is rhino, and yes, we're doing the whole thing, no skipping, no cap. 🦋

---

✨ NAME ✨

rhino — invokes the JavaScript shell for running scripts in batch mode or interactive. That's it, that's the whole vibe. 🌸

---

✨ SYNOPSIS ✨

rhino [options] script_filename_or_url [script_arguments]

---

✨ DESCRIPTION ✨

Okay so, real talk: this manual page documents briefly the rhino command. It's giving summary, not dissertation.

rhino is a start script for the rhino JavaScript shell. What does that mean for you, bestie? It provides a simple way to run scripts in batch mode or an interactive environment for exploratory programming. Two moods, one binary. 💅

---

✨ OPTIONS ✨

Every single one, let's go, no crumbs left behind:

• -debug — Generate debug information. Heads up though, this sets the optimization level to zero. Zero! 🫠
• -e script_source — Executes script_source as a JavaScript script.
• -encoding characterEncoding — Set the character encoding to apply in case it could not be detected. Like a lil fallback wig for your bytes. 🎀
• -f script_filename_or_url — Reads script_filename_or_url content and execute it as a JavaScript script.
• -fatal-warnings — Set warnings as errors. Dramatic? Yes. Useful? Also yes. 💀
• -help, -? — Display help.
• -modules module — Add a module to the path.
• -opt, -O optLevel — Optimizes at level optLevel, which must be an integer between 0 and 9.
• -require — Use require().
• -sandbox — The created require() instances will be sandboxed. Cute lil protective bubble fr fr. 🫶
• -sealedlib — Use a sealed standard library.
• -strict — Set strict mode. No mess, no chaos, main character discipline. 👑
• -version versionNumber — Specifies the language version to compile with. It must be one of 100, 110, 120, 130, 140, 150, 160, 170, 180 or 200.
• -w — Report warnings.

---

✨ PREDEFINED PROPERTIES ✨

So scripts executing in the shell have access to some additional properties of the top-level object. Free goodies, bestie, they just come with the place. 🍓

• arguments — The arguments object is an array containing the strings of all the arguments given at the command line when the shell was invoked.
• help() — Executing the help function will print usage and help messages.
• defineClass(className) — Define an extension using the Java class named with the string argument className. Uses ScriptableObject.defineClass() to define the extension.
• deserialize(filename) — Restore from the specified file an object previously written by a call to serialize.
• load([filename,...]) — Load JavaScript source files named by string arguments. If multiple arguments are given, each file is read in and executed in turn.
• loadClass(className) — Load and execute the class named by the string argument className. The class must be a class that implements the Script interface, as will any script compiled by jsc.
• print([expr...]) — Evaluate and print expressions. Evaluates each expression, converts the result to a string, and prints it.
• readFile(path[,characterCoding]) — Read given file and convert its bytes to a string using the specified character coding or default character coding if explicit coding argument is not given.
• readUrl(url[,characterCoding]) — Open an input connection to the given string url, read all its bytes and convert them to a string using the specified character coding or default character coding if explicit coding argument is not given.
• runCommand(commandName,[arg,...][options]) — Execute the specified command with the given argument and options as a separate process and return the exit status of the process. For details, see JavaDoc for org.mozilla.javascript.tools.shell.Global#runCommand.
• setTimeout(function[,delay,arg,...]) — Execute "function" after "delay" milliseconds. (If "delay" is not set, then it is set to 0.) Pass any trailing parameters as arguments. Timeouts run after the current function is done executing, and in the interactive shell, only after the shell is exited. Return an ID that may be passed to "clearTimeout".
• clearTimeout(id) — Cancel a timeout set using "setTimeout".
• serialize(object,filename) — Serialize the given object to the specified file.
• spawn(functionOrScript) — Run the given function or script in a different thread. Parallel bestie era. 🌈
• sync(function) — creates a synchronized function (in the sense of a Java synchronized method) from an existing function. The new function synchronizes on the this object of its invocation.
• quit() — Quit shell. The shell will also quit in interactive mode if an end-of-file character is typed at the prompt.
• version([number]) — Get or set JavaScript version number. If no argument is supplied, the current version number is returned. If an argument is supplied, it is expected to be one of 100, 110, 120, 130, 150, 160, 170, 180 or 200 to indicate JavaScript version 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8 or ECMAScript 6 respectively.
• write([expr...]) — Evaluate and print expressions like in "print", but without the trailing newline.
• console — The console object provides a simple debugging console similar to the console object provided by web browsers.
  • console.log(format[arg,...]) — For general output of logging information. String substitution and additional arguments are supported. Prints formatted text according to the format and args supplied with "INFO" prefix. This function is identical to console.info(format[arg,...]).
  • console.trace(format[arg,...]) — This function is identical to console.log(format[arg,...]) except it prints "TRACE" prefix instead of "INFO".
  • console.debug(format[arg,...]) — This function is identical to console.log(format[arg,...]) except it prints "DEBUG" prefix instead of "INFO".
  • console.info(format[arg,...]) — This function is identical to console.log(format[arg,...]).
  • console.warn(format[arg,...]) — This function is identical to console.log(format[arg,...]) except it prints "WARN" prefix instead of "INFO".
  • console.error(format[arg,...]) — This function is identical to console.log(format[arg,...]) except it prints "ERROR" prefix instead of "INFO".
  • console.assert(expression[arg,...]) — Prints error if expression is false. If args are supplied, they will be printed also.
  • console.count([label]) — Increases the counter of label by one which starts from zero and prints the label and value after increment. If label is not supplied, "default" is the label.
  • console.countReset([label]) — Resets the counter of label to zero. If label is not supplied, "default" is the label.
  • console.time([label]) — Starts a timer of label. Use console.timeEnd([label]) to stop the timer and print the elapsed time. Use console.timeLog([label]) to print the elapsed time without stopping the timer.
  • console.timeLog([label]) — See console.time([label]).
  • console.timeEnd([label]) — See console.time([label]).

---

✨ SEE ALSO ✨

The archived online documentation under https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino/Shell — go read it, it's giving lore. 📚

---

✨ AUTHOR ✨

This manual page was created by Wolfgang Baer <WBaer@gmx.de>, see Git history for later modifications. Respect the author, periodt. 👑

---

Okay bestie that's the whole page, no notes, you ate this. This came out of the General Commands Manual, dated December 11, 2021 — yeah, a lil vintage, still iconic. 💖🦋✨