Chapter 5: Action Reference
229
delete( ) Deletes all components of the specified header.
Note: An error results if two header modification actions modify the same header. The error is noted
at compile time if the conflicting actions are within the same action definition block. A
runtime error is recorded in the event log if the conflicting actions are defined in different
blocks.
Syntax
delete(header)
where:
header—A header specified using the following form. For a list of recognized headers, see Appendix
C.
•request.header.header_name—Identifies a recognized HTTP request header.
•response.header.header_name—Identifies a recognized HTTP response header.
•request.x_header.header_name—Identifies any request header, including custom headers.
•response.x_header.header_name—Identifies any response header, including custom headers.
•exception.response.header.header_name—Identifies a recognized HTTP response header
from the exception response.
Layer and Transaction Notes
•Use with exception.response.header.header_name in <Proxy> or <Exception> layers.
•Use with request or response headers in <Proxy> or <Cache> layers.
•Do not use in <Admin> or <Forward> layers.
•Applies to HTTP transactions.
Example
; Delete the Referer request header, and also log the action taken.
define action DeleteReferer
log_message("Referer header deleted: $(request.header.Referer)")
delete(request.header.Referer)
end action DeleteReferer
See Also
•Actions: append( ), delete_matching( ), rewrite(header, regex_pattern,
replacement_component), set(header, string)
•Conditions: request.header.header_name=, request.header.header_name.address=,
request.x_header.header_name=, request.x_header.header_name.address=,
response.header.header_name=, response.x_header.header_name=