`,\n);\n```\n\n`parseDocument` accepts an optional second argument with both parser and [DOM handler options](https://github.com/fb55/domhandler):\n\n```js\nconst dom = htmlparser2.parseDocument(data, {\n // Parser options\n xmlMode: true,\n\n // domhandler options\n withStartIndices: true, // Add `startIndex` to each node\n withEndIndices: true, // Add `endIndex` to each node\n});\n```\n\n### Searching the DOM\n\nThe [`DomUtils`](https://github.com/fb55/domutils) module (re-exported on the main `htmlparser2` export) provides helpers for finding nodes:\n\n```js\nimport * as htmlparser2 from \"htmlparser2\";\n\nconst dom = htmlparser2.parseDocument(`
Hello
`);\n\n// Find elements by ID, tag name, or class\nconst greeting = htmlparser2.DomUtils.getElementById(\"greeting\", dom);\nconst paragraphs = htmlparser2.DomUtils.getElementsByTagName(\"p\", dom);\n\n// Find elements with custom test functions\nconst all = htmlparser2.DomUtils.findAll(\n (el) => el.attribs?.class === \"active\",\n dom,\n);\n\n// Get text content\nhtmlparser2.DomUtils.textContent(greeting); // \"Hello\"\n```\n\nFor CSS selector queries, use [`css-select`](https://github.com/fb55/css-select):\n\n```js\nimport { selectAll, selectOne } from \"css-select\";\n\nconst results = selectAll(\"ul#fruits > li\", dom);\nconst first = selectOne(\"li.apple\", dom);\n```\n\nOr, if you'd prefer a jQuery-like API, use [`cheerio`](https://github.com/cheeriojs/cheerio).\n\n### Modifying and serializing the DOM\n\nUse `DomUtils` to modify the tree, and [`dom-serializer`](https://github.com/cheeriojs/dom-serializer) (also available as `DomUtils.getOuterHTML`) to serialize it back to HTML:\n\n```js\nimport * as htmlparser2 from \"htmlparser2\";\n\nconst dom = htmlparser2.parseDocument(\n `
Apple
Orange
`,\n);\n\n// Remove the first
\nconst items = htmlparser2.DomUtils.getElementsByTagName(\"li\", dom);\nhtmlparser2.DomUtils.removeElement(items[0]);\n\n// Serialize back to HTML\nconst html = htmlparser2.DomUtils.getOuterHTML(dom);\n// \"
Orange
\"\n```\n\nOther manipulation helpers include `appendChild`, `prependChild`, `append`, `prepend`, and `replaceElement` -- see the [`domutils` docs](https://github.com/fb55/domutils) for the full API.\n\n## Parsing feeds\n\n`htmlparser2` makes it easy to parse RSS, RDF and Atom feeds, by providing a `parseFeed` method:\n\n```javascript\nconst feed = htmlparser2.parseFeed(content);\n```\n\nThis returns an object with `type`, `title`, `link`, `description`, `updated`, `author`, and `items` (an array of feed entries), or `null` if the document isn't a recognized feed format.\n\nThe `xmlMode` option is enabled by default for `parseFeed`. If you pass custom options, make sure to include `xmlMode: true`.\n\n## Performance\n\nAfter having some artificial benchmarks for some time, **@AndreasMadsen** published his [`htmlparser-benchmark`](https://github.com/AndreasMadsen/htmlparser-benchmark), which benchmarks HTML parses based on real-world websites.\n\nAt the time of writing, the latest versions of all supported parsers show the following performance characteristics on GitHub Actions (sourced from [here](https://github.com/AndreasMadsen/htmlparser-benchmark/blob/e78cd8fc6c2adac08deedd4f274c33537451186b/stats.txt)):\n\n```\nhtmlparser2 : 2.17215 ms/file ± 3.81587\nnode-html-parser : 2.35983 ms/file ± 1.54487\nhtml5parser : 2.43468 ms/file ± 2.81501\nneutron-html5parser: 2.61356 ms/file ± 1.70324\nhtmlparser2-dom : 3.09034 ms/file ± 4.77033\nhtml-dom-parser : 3.56804 ms/file ± 5.15621\nlibxmljs : 4.07490 ms/file ± 2.99869\nhtmljs-parser : 6.15812 ms/file ± 7.52497\nparse5 : 9.70406 ms/file ± 6.74872\nhtmlparser : 15.0596 ms/file ± 89.0826\nhtml-parser : 28.6282 ms/file ± 22.6652\nsaxes : 45.7921 ms/file ± 128.691\nhtml5 : 120.844 ms/file ± 153.944\n```\n\n## Security contact information\n\nTo report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).\nTidelift will coordinate the fix and disclosure.",
"_attachments": {}
}