SideBar
User Login TAG:CFTRACE
last edited by
gef
on 20-Oct-2011
gef
on 20-Oct-2011
|
cftrace
Syntax
<cftrace [abort="boolean"] [category="string"] [follow="boolean"] [inline="boolean"] [text="string"] [type="string"] [var="string"] [variable="string"]> [</cftrace>]
This tag is also supported within cfscript.
<cfscript> trace [abort="boolean"] [category="string"] [follow="boolean"] [inline="boolean"] [text="string"] [type="string"] [var="string"] [variable="string"] { } </cfscript>
[] = Optional attribute
Description
Displays and logs debugging data about the state of an application at the time the cftrace tag executes.
Body
This tag may have a body.
Attributes
The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
| Name | Type | Required | Description |
| abort | boolean | No | Calls cfabort tag when the tag is executed |
| category | string | No | User-defined string for identifying trace groups |
| follow | boolean | No | If true, Railo follows the variable defined in the [var] attribute and will log any changes to it. Ignored when attribute [var] is not defined. |
| inline | boolean | No | Displays trace code in line on the page in the location of the cftrace tag, addition to the debugging information output. |
| text | string | No | User-defined string, which can include simple variable, but not complex variables such as arrays. Outputs to cflog text attribute |
| type | string | No | Corresponds to the cflog type attribute; displays an appropriate icon. - Information - Warning - Error - Fatal |
| var | string | No | The name of a simple or complex variable to display. Useful for displaying a temporary value, or a value that does not display on any CFM page. |
| variable | string | No | The name of a simple or complex variable to display. Useful for displaying a temporary value, or a value that does not display on any CFM page (alias for attribute "var"). |
History
The follow attribute has been introduced in Railo 3.3.
