Stay organized with collections
Save and categorize content based on your preferences.
blockly > utils > xml > textToDom
utils.xml.textToDom() function
Converts an XML string into a DOM structure.
Control characters should be escaped. (But we will try to best-effort parse unescaped characters.)
Note that even when escaped, U+0000 will be parsed as U+FFFD (the "replacement character") because U+0000 is never a valid XML character (even in XML 1.1). https://www.w3.org/TR/xml11/#charsets
Signature:
export declare function textToDom(text: string): Element;
Parameters
Parameter |
Type |
Description |
text |
string |
An XML string. |
Returns:
Element
A DOM object representing the singular child of the document element.
Exceptions
if the text doesn't parse.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eutils.xml.textToDom()\u003c/code\u003e function transforms an XML string into a DOM structure, facilitating interaction with XML data within Blockly applications.\u003c/p\u003e\n"],["\u003cp\u003eIt prioritizes escaped control characters for optimal parsing but attempts to handle unescaped characters gracefully, with the exception of U+0000 which is always replaced with U+FFFD due to XML standards.\u003c/p\u003e\n"],["\u003cp\u003eThe function accepts an XML string as input and returns a DOM element representing the singular child of the document element, throwing an exception if parsing fails.\u003c/p\u003e\n"]]],[],null,["[blockly](./blockly.md) \\\u003e [utils](./blockly.utils_namespace.md) \\\u003e [xml](./blockly.utils_namespace.xml_namespace.md) \\\u003e [textToDom](./blockly.utils_namespace.xml_namespace.texttodom_1_function.md)\n\nutils.xml.textToDom() function\n------------------------------\n\nConverts an XML string into a DOM structure.\n\nControl characters should be escaped. (But we will try to best-effort parse unescaped characters.)\n\nNote that even when escaped, U+0000 will be parsed as U+FFFD (the \"replacement character\") because U+0000 is never a valid XML character (even in XML 1.1). https://www.w3.org/TR/xml11/#charsets\n\n**Signature:** \n\n export declare function textToDom(text: string): Element;\n\nParameters\n----------\n\n| Parameter | Type | Description |\n|-----------|--------|----------------|\n| text | string | An XML string. |\n\n**Returns:**\n\nElement\n\nA DOM object representing the singular child of the document element.\n\nExceptions\n----------\n\nif the text doesn't parse."]]