ServerJS/API/console

Many client-side libraries already support a JavaScript console object. Since this functionality is useful on the server, and to ease migration of client-side JavaScript to the server, server-side JavaScript platforms need to provide a "console" object suitable for use with minimal modification to existing scripts. Rather than provide a "console" free variable like web browsers, interoperable JavaScript modules may explicitly import the "console" module and bind it to a module local "console" variable.

Specification

The "console" top-level module must be available in all platforms. The module must provide the following exports:

log(message)

logs a message

info(message)

logs an informational message

warn(message)

logs a warning message

error(message)

logs an error message

debug(message)

logs a debug message

pass(name)

logs the success of a test

fail(name)

logs the failure of a test

print(message, [level])

logs a message. The level may be any of "log", "info", "warn", "error", "debug", "pass", "fail", null, or undefined. Other labels beginning with "x" and a platform-specific identifier are reserved for the corresponding platform.

Messages may be any reference. Names must be strings.

Prior Art

• Firebug
• Safari 1.3 Console
• Opera JavaScript Console
• Internet Explorer 8 JavaScript Console