ColdFusion.Log.error

Description

Displays an error-level message in a log window.

Function syntax

ColdFusion.Log.error(message [, category])

See also

ColdFusion.Log.debug, ColdFusion.Log.dump, ColdFusion.Log.info, Logging information in the Developing ColdFusion Applications

History

ColdFusion 8: Added this function

Parameters

Parameter

Description

message

The text message to display in the log window. The log message can include HTML markup and JavaScript variables.

category

A category identifier that you can use in the logging window to filter the output. You can specify any arbitrary category in this function. The default value is global.

Returns

This function does not return a value.

Usage

If the page that calls this function does not have any ColdFusion AJAX-based controls, you use a cfajaximport tag on the page to ensure that the page includes the JavaScript definition for this function.

The log window appears if you specify a URL parameter of the format cfdebug or cfdebug="true" in your page request and you select the Enable Ajax Debug Log Window option on the ColdFusion Administrator Debugging & Logging > Debug Output Settings page.

Example

ColdFusion.Log.error("<b>Invalid value:</b><br>" + arg.A, "Pod A");