onTrace

            onTrace ( [function ])
         

The function takes and object with the following properties as an argument:

• gravity (String) - The message severity ("error", "warning", "info", "status", "verbose")
• type (String) - The message type ("log", "wdbc", etc.)
• message (String) - The message

The function is protected against re-entrance: it will not intercept trace messages which it created itself. Example:

var file = new File("c:/temp/trace.txt")
file.open("w")

// Add a new trace handler
application.onTrace(function(log) {
  file.writeln(log.gravity.toString() + " " + log.message)
  return true
})

logInfo("This is an information message")
logWarning("This is a warning")

// Remove the trace handler
application.onTrace()

file.close()