Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Parser(3)	      User Contributed Perl Documentation	     Parser(3)

NAME
       HTML::StripScripts::Parser - XSS	filter using HTML::Parser

SYNOPSIS
	 use HTML::StripScripts::Parser();

	 my $hss = HTML::StripScripts::Parser->new(

	      {
		  Context => 'Document',       ## HTML::StripScripts configuration
		  Rules	  => { ... },
	      },

	      strict_comment =>	1,	       ## HTML::Parser options
	      strict_names   =>	1,

	 );

	 $hss->parse_file("foo.html");

	 print $hss->filtered_document;

	 OR

	 print $hss->filter_html($html);

DESCRIPTION
       This class provides an easy interface to	"HTML::StripScripts", using
       "HTML::Parser" to parse the HTML.

       See HTML::Parser	for details of how to customise	how the	raw HTML is
       parsed into tags, and HTML::StripScripts	for details of how to
       customise the way those tags are	filtered.

CONSTRUCTORS
       new ( {CONFIG}, [PARSER_OPTIONS]	 )
	   Creates a new "HTML::StripScripts::Parser" object.

	   The CONFIG parameter	has the	same semantics as the CONFIG parameter
	   to the "HTML::StripScripts" constructor.

	   Any PARSER_OPTIONS supplied will be passed on to the	HTML::Parser
	   init	method,	allowing you to	influence the way the input is parsed.

	   You cannot use PARSER_OPTIONS to set	the "HTML::Parser" event
	   handlers (see "Events" in HTML::Parser) since
	   "HTML::StripScripts::Parser"	uses all of the	event hooks itself.
	   However, you	can use	"Rules"	(see "Rules" in	HTML::StripScripts) to
	   customise the handling of all tags and attributes.

METHODS
       See HTML::Parser	for input methods, HTML::StripScripts for output
       methods.

   "filter_html()"
       "filter_html()" is a convenience	method for filtering HTML already
       loaded into a scalar variable.  It combines calls to
       "HTML::Parser::parse()",	"HTML::Parser::eof()" and
       "HTML::StripScripts::filtered_document()".

	   $filtered_html = $hss->filter_html($html);

SUBCLASSING
       The "HTML::StripScripts::Parser"	class is subclassable.	Filter objects
       are plain hashes.  The hss_init() method	takes the same arguments as
       new(), and calls	the initialization methods of both
       "HTML::StripScripts" and	"HTML::Parser".

       See "SUBCLASSING" in HTML::StripScripts and "SUBCLASSING" in
       HTML::Parser.

SEE ALSO
       HTML::StripScripts, HTML::Parser, HTML::StripScripts::LibXML

BUGS
       None reported.

       Please report any bugs or feature requests to
       bug-html-stripscripts-parser@rt.cpan.org, or through the	web interface
       at <http://rt.cpan.org>.

AUTHOR
       Original	author Nick Cleaton <nick@cleaton.net>

       New code	added and module maintained by Clinton Gormley
       <clint@traveljury.com>

COPYRIGHT
       Copyright (C) 2003 Nick Cleaton.	 All Rights Reserved.

       Copyright (C) 2007 Clinton Gormley.  All	Rights Reserved.

LICENSE
       This module is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

perl v5.32.1			  2009-11-05			     Parser(3)

NAME | SYNOPSIS | DESCRIPTION | CONSTRUCTORS | METHODS | SUBCLASSING | SEE ALSO | BUGS | AUTHOR | COPYRIGHT | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=HTML::StripScripts::Parser&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help