Struct scraper::html::Html

pub struct Html {
    pub errors: Vec<Cow<'static, str>>,
    pub quirks_mode: QuirksMode,
    pub tree: Tree<Node>,
}

An HTML tree.

Parsing does not fail hard. Instead, the quirks_mode is set and errors are added to the errors field. The tree will still be populated as best as possible.

Implements the TreeSink trait from the html5ever crate, which allows HTML to be parsed.

Fields

errors: Vec<Cow<'static, str>>

Parse errors.

quirks_mode: QuirksMode

The quirks mode.

tree: Tree<Node>

The node tree.

Methods

impl Html

fn new_document() -> Self

Creates an empty HTML document.

fn new_fragment() -> Self

Creates an empty HTML fragment.

fn parse_document(document: &str) -> Self

Parses a string of HTML as a document.

fn parse_fragment(fragment: &str) -> Self

Parses a string of HTML as a fragment.

fn select<'a, 'b>(&'a self, selector: &'b Selector) -> Select<'a, 'b>

Returns an iterator over elements matching a selector.

Trait Implementations

impl TreeSink for Html

Note: does not support the <template> element.

type Output = Self

The overall result of parsing.

type Handle = NodeId<Node>

Handle is a reference to a DOM node. The tree builder requires that a Handle implements Clone to get another reference to the same node.

fn finish(self) -> Self

Consume this sink and return the overall result of parsing.

fn parse_error(&mut self, msg: Cow<'static, str>)

Signal a parse error.

fn set_quirks_mode(&mut self, mode: QuirksMode)

Set the document's quirks mode.

fn get_document(&mut self) -> Self::Handle

Get a handle to the Document node.

fn same_node(&self, x: Self::Handle, y: Self::Handle) -> bool

Do two handles refer to the same node?

fn elem_name(&self, target: Self::Handle) -> QualName

What is the name of this element?

fn create_element(&mut self, name: QualName, attrs: Vec<Attribute>) -> Self::Handle

Create an element.

fn create_comment(&mut self, text: StrTendril) -> Self::Handle

Create a comment node.

fn append_doctype_to_document(&mut self, name: StrTendril, public_id: StrTendril, system_id: StrTendril)

Append a DOCTYPE element to the Document node.

fn append(&mut self, parent: Self::Handle, child: NodeOrText<Self::Handle>)

Append a node as the last child of the given node. If this would produce adjacent sibling text nodes, it should concatenate the text instead.

fn append_before_sibling(&mut self, sibling: Self::Handle, new_node: NodeOrText<Self::Handle>) -> Result<(), NodeOrText<Self::Handle>>

Append a node as the sibling immediately before the given node. If that node has no parent, do nothing and return Err(new_node).

fn remove_from_parent(&mut self, target: Self::Handle)

Detach the given node from its parent.

fn reparent_children(&mut self, node: Self::Handle, new_parent: Self::Handle)

Remove all the children from node and append them to new_parent.

fn add_attrs_if_missing(&mut self, target: Self::Handle, attrs: Vec<Attribute>)

Add each attribute to the given element, if no attribute with that name already exists. The tree builder promises this will never be called with something else than an element.

fn get_template_contents(&self, _target: Self::Handle) -> Self::Handle

Get a handle to a template's template contents. The tree builder promises this will never be called with something else than a template element.

fn mark_script_already_started(&mut self, _node: Self::Handle)

Mark a HTML <script> element as "already started".

fn complete_script(&mut self, _node: Self::Handle) -> NextParserState

Indicate that a <script> element is complete.

fn is_mathml_annotation_xml_integration_point(&self, handle: Self::Handle) -> bool

impl Eq for Html

impl PartialEq for Html

fn eq(&self, __arg_0: &Html) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &Html) -> bool

This method tests for !=.

impl Clone for Html

fn clone(&self) -> Html

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Html

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.