Struct HtmlRewriter 

pub struct HtmlRewriter<H> { /* private fields */ }

Available on crate features html and http and std only.

A streaming, selector-driven HTML rewriter.

Feed input with write and finish with end; the rewritten bytes accumulate in an internal buffer, drained with take_output. Unmatched content passes through byte-for-byte. For one-shot use, prefer rewrite_str.

Implementations

impl<H> HtmlRewriter<H>

where H: ElementContentHandler,

pub fn new(selectors: &[Selector], handler: H) -> HtmlRewriter<H>

Creates a rewriter that runs handler for elements matching selectors (the selector argument to the handler is the index into this slice).

pub fn write( &mut self, chunk: &[u8], ) -> Result<(), Box<dyn Error + Sync + Send>>

Feeds a chunk of input, appending rewritten bytes to the output.

Errors

Surfaces a handler error, or a ParsingAmbiguityError if the input is ambiguous for streaming parsing.

pub fn end(&mut self) -> Result<(), Box<dyn Error + Sync + Send>>

Finalizes the stream, flushing any remaining input.

Errors

See write.

pub fn take_output(&mut self) -> Vec<u8>

Removes and returns the rewritten output accumulated so far.

pub fn into_handler(self) -> H

Consumes the rewriter, returning the handler (e.g. to read state accumulated during the rewrite).

impl<'h> HtmlRewriter<ElementContentHandlers<'h>>

pub fn from_handlers( handlers: ElementContentHandlers<'h>, ) -> HtmlRewriter<ElementContentHandlers<'h>>

Creates a rewriter from a closure-based ElementContentHandlers.