<cfdump>
Outputs the elements, variables and values of most kinds of CFML objects.
Very useful for debugging.
You can display the contents of simple and complex variables, objects, components, user-defined functions, and other elements.
This tag may have a body.
This tag has no <cfscript> support or it uses a different syntax.
<cfdump
var=any
eval=string
expand=boolean
label=string
top=number
showUDFs=boolean
show=string
output=string
metainfo=boolean
keys=number
hide=string
format=string
abort=boolean
async=boolean
enabled=boolean
flush=boolean
><!--- body --->[</cfdump>]
| Attribute | Description |
|---|---|
var
any, optional
|
edit
Variable to display. Enclose a variable name in pound signs. |
eval
string, optional
|
edit
name of the variable to display, also used as label, when no label defined. |
expand
boolean, optional
|
edit
expands views |
label
string, optional
|
edit
header for the dump output. |
top
number, optional
|
edit
The number of rows to display. |
showUDFs
boolean, optional
|
edit
show UDFs in cfdump output. |
show
string, optional
|
edit
show column or keys. |
output
string, optional
|
edit
Where to send the results:
Otherwise, this is value is treated as filename to write/append the dump outputs into, unless left blank. |
metainfo
boolean, optional
|
edit
Includes information about the query in the cfdump results. |
keys
number, optional
|
edit
For a structure, number of keys to display. |
hide
string, optional
|
edit
hide column or keys. |
format
string, optional
|
edit
specify the output format of the dump, the following formats are available by default:
You can use your custom style by creating a corresponding file in the lucee/dump/skins folder. Check the folder for examples. |
abort
boolean, optional
|
edit
stops further processing of request. |
async
boolean, optional
|
edit
if true and output is not to browser, Lucee builds the output in a new thread that runs in parallel to the thread that called the dump. please note that if the calling thread modifies the data before the dump takes place, it is possible that the dump will show the modified data. |
enabled
boolean, optional
|
edit
dumps are enabled by default, pass false to short circuit a dump execution and effectively disable it |
flush
boolean, optional
|
edit
flushes the response stream after the dump |
Examples
editSimple example with cfdump
<!--- You can dump any thing here. Easy to see the content of complex data type--->
<cfdump var="#getTimeZoneInfo()#" label="Tag label"/>
See also
- Core CFML Language
- Debugging
- Console logging using SystemOutput
- Dump()
- WriteDump()
- Custom CFDUMP Templates
- Search Issue Tracker open_in_new
- Search Lucee Test Cases open_in_new (good for further, detailed examples)