DOMParser: метод parseFromString()

Метод parseFromString() интерфейса DOMParser анализирует строку, содержащую HTML или XML, возвращая HTMLDocument или XMLDocument.

string

Строка для анализа. Она должна содержать документ HTML, XML, XHTML или SVG.

mimeType

Строка. Эта строка определяет, какой анализатор (XML или HTML) будет использован для анализа строки. Допустимые значения:

• text/html
• text/xml
• application/xml
• application/xhtml+xml
• image/svg+xml

Значение text/html вызовет HTML-парсер, и метод вернёт HTMLDocument. Любой элемент <script> будет помечен как неисполняемый, а содержимое элемента <noscript> будет обработано как разметка.

Другие допустимые значения (text/xml, application/xml, application/xhtml+xml, и image/svg+xml) функционально эквивалентны. Все они вызывают XML-парсер и метод вернёт XMLDocument.

Любое другое значение недопустимо и приведёт к исключению TypeError.

HTMLDocument или XMLDocument, в зависимости от аргумента mimeType.

Обратите внимание, что MIME-тип text/html вызовет HTML-парсер, а любой другой допустимый MIME-тип вызовет XML-парсер. MIME-типы application/xml и image/svg+xml в примере ниже функционально идентичны — последний не включает никаких правил парсинга, специфичных для SVG. Различие между ними служит только для уточнения намерений кода.

const parser = new DOMParser();

const xmlString = "<warning>Beware of the tiger</warning>";
const doc1 = parser.parseFromString(xmlString, "application/xml");
// XMLDocument

const svgString = '<circle cx="50" cy="50" r="50"/>';
const doc2 = parser.parseFromString(svgString, "image/svg+xml");
// XMLDocument

const htmlString = "<strong>Beware of the leopard</strong>";
const doc3 = parser.parseFromString(htmlString, "text/html");
// HTMLDocument

console.log(doc1.documentElement.textContent);
// "Beware of the tiger"

console.log(doc2.firstChild.tagName);
// "circle"

console.log(doc3.body.firstChild.textContent);
// "Beware of the leopard"

При использовании XML-парсера со строкой, которая не представляет собой правильно сформированный XML, возвращаемый XMLDocument объектом parseFromString будет содержать узел <parsererror>, описывающий природу ошибки парсинга.

const parser = new DOMParser();

const xmlString = "<warning>Beware of the missing closing tag";
const doc = parser.parseFromString(xmlString, "application/xml");
const errorNode = doc.querySelector("parsererror");
if (errorNode) {
  // parsing failed
} else {
  // parsing succeeded
}

Кроме того, об ошибке парсинга может быть сообщено в консоли JavaScript браузера.

• XMLSerializer
• JSON.parse() - аналог для документов JSON.