ServerJS/API/console: Difference between revisions

From MozillaWiki
< ServerJS‎ | API
Jump to navigation Jump to search
(Added a summary.)
(Redacted print, pass, and fail.)
 
Line 9: Line 9:
; warn(message) : logs a warning message
; warn(message) : logs a warning message
; error(message) : logs an error 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.
Messages may be any reference.  Names must be strings.

Latest revision as of 18:34, 14 April 2009

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

Messages may be any reference. Names must be strings.


Prior Art

Relevant Discussions

Show of Hands

Implementations