ColdFusion.Log.dump

Description

Displays a debug-level message in the log window that shows a cfdump-like representation of a complex JavaScript object. The log window does not have a separate dump level.

Function syntax

ColdFusion.Log.dump(object [, category])

See also

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

History

ColdFusion 8: Added this function

Parameters

Parameter

Description

object

The variable whose contents you want to display. You cannot specify additional contents, such as a text message, when you dump a complex object. To provide additional information, also use the ColdFusion.Log.debug function.

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.dump(objArg, "Pod A");