Struct lol_html::errors::ParsingAmbiguityError

pub struct ParsingAmbiguityError { /* fields omitted */ }

An error that occurs when HTML parser runs into an ambigious state in the strict mode.

Since the rewriter operates on a token stream and doesn't have access to a full DOM-tree, there are certain rare cases of non-conforming HTML markup which can't be guaranteed to be parsed correctly without an ability to backtrace the tree.

Therefore, due to security considerations, sometimes it's preferable to abort the rewriting process in case of such uncertainty.

One of the simplest examples of such markup is the following:

...
<select><xmp><script>"use strict";</script></select>
...

The <xmp> element is not allowed inside the <select> element, so in a browser the start tag for <xmp> will be ignored and following <script> element will be parsed and executed.

On the other hand, the <select> element itself can be also ignored depending on the context in which it was parsed. In this case, the <xmp> element will not be ignored and the <script> element along with its content will be parsed as a simple text inside it.

So, in this case the parser needs an ability to backtrace the DOM-tree to figure out the correct parsing context.

Trait Implementations

impl Debug for ParsingAmbiguityError

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

Formats the value using the given formatter.

impl Display for ParsingAmbiguityError

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

Formats the value using the given formatter.

impl Error for ParsingAmbiguityError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

Deprecated since 1.41.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl PartialEq<ParsingAmbiguityError> for ParsingAmbiguityError

fn eq(&self, other: &ParsingAmbiguityError) -> bool

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

fn ne(&self, other: &ParsingAmbiguityError) -> bool

This method tests for !=.

impl StructuralPartialEq for ParsingAmbiguityError