Skip to main content

StreamParser

Struct StreamParser 

Source
pub struct StreamParser { /* private fields */ }
Expand description

A streaming HTML parser that builds a DOM tree incrementally.

Buffers the first 1 KB of input for encoding detection (matching the HTML spec’s meta prescan limit), then decodes and tokenizes all subsequent chunks into the tree.

§Example

use fhp_tree::streaming::StreamParser;

let mut parser = StreamParser::new();
parser.feed(b"<div>");
parser.feed(b"<p>Hello</p>");
parser.feed(b"</div>");
let doc = parser.finish().unwrap();
assert_eq!(doc.root().text_content(), "Hello");

Implementations§

Source§

impl StreamParser

Source

pub fn new() -> StreamParser

Create a new streaming parser.

Source

pub fn feed(&mut self, chunk: &[u8])

Feed a chunk of raw bytes into the parser.

Initial chunks are buffered until 1 KB is reached for encoding detection. After that, each chunk is decoded and processed immediately.

Source

pub fn finish(self) -> Result<Document, HtmlError>

Finish parsing and return the completed document.

If encoding hasn’t been detected yet (total input < 1 KB), detection happens now.

Trait Implementations§

Source§

impl Default for StreamParser

Source§

fn default() -> StreamParser

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.