ltm rule command HTML comment

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



HTML::comment
       Query and update HTML comment.

SYNOPSIS
       HTML::comment ((append STRING) | (prepend STRING) | remove)?

DESCRIPTION
       Queries, removes HTML comment or appends/prepends it by a string.

       HTML::comment Return the entire HTML comment, including the opening and
       the closing delimiter.

       HTML::comment append  Insert a string after the closing
       delimiter of the HTML comment; when multiple appends are issued, the
       inserted strings are ordered according to the sequence of the append
       commands as they are issued for the given comment.

       HTML::comment prepend  Insert a string before the opening
       delimiter of the HTML comment; when multiple prepends are issued, the
       inserted strings are ordered according to the sequence of the prepend
       commands as they are issued for the given comment.

       HTML::comment remove Remove the HTML comment.

RETURN VALUE
       HTML::comment returns the entire HTML comment; others do not return
       anything.

VALID DURING
       HTML_COMMENT_MATCHED

EXAMPLES
	when HTML_COMMENT_MATCHED {
	    if { ! ( [HTML::comment] contains "\[" ) } {
		HTML::comment remove
	    }
	}

	when HTML_COMMENT_MATCHED {
	    HTML::comment append "some_string"
	}

	when HTML_COMMENT_MATCHED {
	    HTML::comment prepend "some_string"
	}

HINTS
       The httpcompression profile, which strips off the Accept-Encoding
       header from the HTTP request headers so that the backend server does
       not respond to BIG-IP with compressed content, can be used to allow the
       HTML filter to see the HTTP body (containing HTML) uncompressed.
       Alternatively, using an iRule command such as HTTP::header remove
       "Accept-Encoding" in the HTTP_REQUEST event will accomplishes the same
       thing.

       The HTML::enable command running in HTTP_RESPONSE enables HTML
       processing for every transaction in a flow. Adding some iRules to
       selectively enable (or disable) HTML based on the Content-Type header
       in HTTP response helps to improve performance.

       Internet Explorer-specific conditional comments, which contain
       brackets, should not be removed, and the iRule recognizes these as HTML
       comments.

SEE ALSO
CHANGE LOG
       @BIGIP-11.0.0
	   --First introduced the command.



BIG-IP				  2017-01-31			      iRule(1)