Struct HtmlRewriter

pub struct HtmlRewriter<'h, O: OutputSink, H: HandlerTypes = LocalHandlerTypes> { /* private fields */ }

A streaming HTML rewriter.

Example

use lol_html::{element, HtmlRewriter, Settings};

let mut output = vec![];

{
    let mut rewriter = HtmlRewriter::new(
        Settings {
            element_content_handlers: vec![
                // Rewrite insecure hyperlinks
                element!("a[href]", |el| {
                    let href = el
                        .get_attribute("href")
                        .unwrap()
                        .replace("http:", "https:");

                    el.set_attribute("href", &href).unwrap();

                    Ok(())
                })
            ],
            ..Settings::new()
        },
        |c: &[u8]| output.extend_from_slice(c)
    );

    rewriter.write(b"<div><a href=").unwrap();
    rewriter.write(b"http://example.com>").unwrap();
    rewriter.write(b"</a></div>").unwrap();
    rewriter.end().unwrap();
}

assert_eq!(
    String::from_utf8(output).unwrap(),
    r#"<div><a href="https://example.com"></a></div>"#
);

Implementations

impl<'h, O: OutputSink, H: HandlerTypes> HtmlRewriter<'h, O, H>

pub fn new<'s>(settings: Settings<'h, 's, H>, output_sink: O) -> Self

Constructs a new rewriter with the provided settings that writes the output to the output_sink.

Note

For the convenience the OutputSink trait is implemented for closures.

pub fn write(&mut self, data: &[u8]) -> Result<(), RewritingError>

Writes a chunk of input data to the rewriter.

Panics

• If previous invocation of the method returned a RewritingError (these errors are unrecovarable).

pub fn end(self) -> Result<(), RewritingError>

Finalizes the rewriting process.

Should be called once the last chunk of the input is written.

Panics

• If previous invocation of write returned a RewritingError (these errors are unrecovarable).

Trait Implementations

impl<O: OutputSink, H: HandlerTypes> Debug for HtmlRewriter<'_, O, H>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.