//! The errors of `angular-html-parser`, with their messages.
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
pub(crate) enum ErrorKind {
UnexpectedCharacter,
UnknownEntity,
DecimalEntityWithoutSemicolon,
HexadecimalEntityWithoutSemicolon,
UnclosedBlock,
IcuWithoutClosingBrace,
IcuWithoutOpeningBrace,
SelfClosed,
OpeningTagNotTerminated,
EndTagOfVoidElement,
UnexpectedClosingTag,
UnexpectedClosingBlock,
IncompleteBlock,
LetWithoutValue,
LetNotTerminated,
IncompleteLet,
/// Not one of the parser's errors. Its `$EOF` is 0, so a NUL between tags ends the text, and Prettier drops
/// everything after it.
TextAfterNul,
/// Not one of the parser's errors: Prettier itself fails on the parsed tree.
Other,
}
impl ErrorKind {
/// True for the lexer's errors, which are reported before the parser's.
pub(crate) fn is_lexer_error(self) -> bool {
matches!(
self,
ErrorKind::UnexpectedCharacter
| ErrorKind::UnknownEntity
| ErrorKind::DecimalEntityWithoutSemicolon
| ErrorKind::HexadecimalEntityWithoutSemicolon
)
}
}
#[derive(Debug, Copy, Clone)]
pub(crate) struct SyntaxError<'a> {
/// The start of its span.
pub(crate) at: u32,
pub(crate) kind: ErrorKind,
/// The namespace of `name`, if that's an element's name.
pub(crate) prefix: &'a [u8],
/// The name quoted in the message. For a character, it's the text starting at that character.
pub(crate) name: &'a [u8],
/// `_isInExpansionForm()`, when it was thrown by the lexer.
pub(crate) is_in_expansion_form: bool,
}
impl<'a> SyntaxError<'a> {
pub(crate) fn new(at: u32, kind: ErrorKind, name: &'a [u8]) -> SyntaxError<'a> {
SyntaxError { at, kind, prefix: b"", name, is_in_expansion_form: false }
}
/// `error.msg`
pub(crate) fn message(&self) -> Vec {
use ErrorKind::*;
let name = match self.prefix {
b"" => self.name.to_vec(),
prefix => [&b":"[..], prefix, b":", self.name].concat(),
};
let (before, after): (&str, &str) = match self.kind {
UnexpectedCharacter => ("Unexpected character \"", "\""),
UnknownEntity => {
("Unknown entity \"", "\" - use the \";\" or \";\" syntax")
}
DecimalEntityWithoutSemicolon => (
"Unable to parse entity \"",
"\" - decimal character reference entities must end with \";\"",
),
HexadecimalEntityWithoutSemicolon => (
"Unable to parse entity \"",
"\" - hexadecimal character reference entities must end with \";\"",
),
UnclosedBlock => ("Unclosed block \"", "\""),
IcuWithoutClosingBrace => ("Invalid ICU message. Missing '}'.", ""),
IcuWithoutOpeningBrace => ("Invalid ICU message. Missing '{'.", ""),
SelfClosed => ("Only void, custom and foreign elements can be self closed \"", "\""),
OpeningTagNotTerminated => ("Opening tag \"", "\" not terminated."),
EndTagOfVoidElement => ("Void elements do not have end tags \"", "\""),
UnexpectedClosingTag => (
"Unexpected closing tag \"",
"\". It may happen when the tag has already been closed by another tag. For more info see https://www.w3.org/TR/html5/syntax.html#closing-elements-that-have-implied-end-tags",
),
UnexpectedClosingBlock if name.is_empty() => (
"Unexpected closing block. The block may have been closed earlier. If you meant to write the `}` character, you should use the \"}\" HTML entity instead.",
"",
),
UnexpectedClosingBlock => (
"Unexpected closing block. The block may have been closed earlier. Did you forget to close the <",
"> element? If you meant to write the `}` character, you should use the \"}\" HTML entity instead.",
),
IncompleteBlock => (
"Incomplete block \"",
"\". If you meant to write the @ character, you should use the \"@\" HTML entity instead.",
),
LetWithoutValue => ("Invalid @let declaration \"", "\". Declaration must have a value."),
LetNotTerminated => {
("Unterminated @let declaration \"", "\". Declaration must be terminated with a semicolon.")
}
IncompleteLet if name.is_empty() => (
"Incomplete @let declaration. @let declarations must be written as `@let = ;`",
"",
),
IncompleteLet => (
"Incomplete @let declaration \"",
"\". @let declarations must be written as `@let = ;`",
),
TextAfterNul => ("Unexpected NUL character", ""),
Other => ("Unexpected token", ""),
};
let name: &[u8] = match (self.kind, &name[..]) {
(UnexpectedCharacter, [] | [0, ..]) => b"EOF",
(UnexpectedCharacter, text) => {
let len = match text[0] {
0xF0.. => 4,
0xE0.. => 3,
0xC0.. => 2,
_ => 1,
};
text.get(..len).unwrap_or(text)
}
(IcuWithoutClosingBrace | IcuWithoutOpeningBrace | Other, _) => b"",
(_, name) => name,
};
let hint: &str = match self.is_in_expansion_form {
true => {
" (Do you have an unescaped \"{\" in your template? Use \"{{ '{' }}\") to escape it.)"
}
false => "",
};
[before.as_bytes(), name, after.as_bytes(), hint.as_bytes()].concat()
}
}