![](\"https://cloud.shopback.com/raw/upload/static/images/navbar/sb-logo.png\"){kind=logo}
\nnodes[1]: ![](\"https://cloud.shopback.com/raw/upload/static/images/navbar/desktop/icon-raf.svg\"){kind=icon}
\n```\n\n\n\n\n\n### `fromNode(xhtml).findElement(expression)`\n\n> Select an element against an XHTML format.
\n> Similar to [`fromPageSource(html).findElement(expression)`](#frompagesourcehtmlfindelementexpression),\n> but it is for a subset of an `html` page this time.\n\n**Arguments:**\n\n| Name | Type | Description |\n| ------------ | ------------------ | ------------------------------------------------------------------------------------- |\n| `xhtml` | `Node` or `string` | Either a **returned node** from a query
or an **xhtml string** with a good shape |\n| `expression` | `string` | The given XPath expression |\n\n**Returns:** `Node`\n\n**Notes:**\n\n- The input `xhtml` must have a namespace of `xmlns=\"http://www.w3.org/1999/xhtml\"`
\n e.g. `
Made with love by
`\n\n**Example**:\n\n\n\n\n```js\nconst fs = require(\"fs\");\nconst xpath = require(\"xpath-html\");\n\nconst html = fs.readFileSync(`${__dirname}/shopback.html`, \"utf8\");\nconst group = xpath.fromPageSource(html).findElement(\"//div[@class='ui-store-group']\");\n\nconst node = xpath.fromNode(group).findElement(\"//a[@href='/aliexpress']\");\n\nconsole.log(node.toString());\n```\n\n\n\n**Result**:\n\n\n\n\n```txt\n![\"AliExpress](\"https://cloud.shopback.com/t_sd_250_pad,f_auto,fl_lossy,q_auto/sg-store/49/49_logo_86958e96.png\"){kind=logo}
\n```\n\n\n\n\n\n### `fromNode(xhtml).findElements(expression)`\n\n> Select multiple elements against an XHTML format.
\n> Same as [`fromPageSource(html).findElements(expression)`](#frompagesourcehtmlfindelementsexpression),\n> however it is being used for querying from a part of an `html`.\n\n**Arguments:**\n\n| Name | Type | Description |\n| ------------ | ------------------ | ------------------------------------------------------------------------------------- |\n| `xhtml` | `Node` or `string` | Either a **returned node** from a query
or an **xhtml string** with a good shape |\n| `expression` | `string` | The given XPath expression |\n\n**Returns:** `Array
\n e.g. `
Made with love by
`\n\n**Example**:\n\n\n\n\n```js\nconst fs = require(\"fs\");\nconst xpath = require(\"xpath-html\");\n\nconst html = fs.readFileSync(`${__dirname}/shopback.html`, \"utf8\");\nconst group = xpath.fromPageSource(html).findElement(\"//div[@class='ui-store-group']\");\n\nconst nodes = xpath.fromNode(group).findElements(\"//img[contains(@src,'shopily')]\");\n\nconsole.log(\"Number of nodes found:\", nodes.length);\nconsole.log(\"nodes[0]:\", nodes[0].toString());\nconsole.log(\"nodes[1]:\", nodes[1].toString());\n```\n\n\n\n**Result**:\n\n\n\n\n```txt\nNumber of nodes found: 2\nnodes[0]: ![\"zChocolat](\"https://shopily-sg.s3.amazonaws.com/uploads/stores/504/504_logo_200c4121.png\"){kind=logo}
\nnodes[1]: ![\"Bed](\"https://shopily-sg.s3.amazonaws.com/uploads/stores/2498/2498_logo_81f0a24d.png\"){kind=logo}
\n```\n\n\n\n\n\n### `node.getTagName()`\n\n> Retrieve the node's tag name.\n\n**Arguments:** None\n\n**Returns:** `string`\n\n**Example**:\n\n\n\n\n```js\nconst fs = require(\"fs\");\nconst xpath = require(\"xpath-html\");\n\nconst html = fs.readFileSync(`${__dirname}/shopback.html`, \"utf8\");\nconst node = xpath.fromPageSource(html).findElement(\"//*[text()='Made with love by']\");\n\nconsole.log(\"Single node's tag name:\", node.getTagName());\n\nconst nodes = xpath\n .fromPageSource(html)\n .findElements(\"//img[starts-with(@src, 'https://cloud.shopback.com')]\");\n\nconsole.log(\"First nodes[0] tag name:\", nodes[0].getTagName());\nconsole.log(\"Second nodes[1] tag name:\", nodes[1].getTagName());\n```\n\n\n\n**Result**:\n\n\n\n\n```txt\nSingle node's tag name: div\nFirst nodes[0] tag name: img\nSecond nodes[1] tag name: img\n```\n\n\n\n
\n\n### `node.getText()`\n\n> Get the visible **innerText** of the node.\n\n**Arguments:** None\n\n**Returns:** `string`\n\n**Example**:\n\n\n\n\n```js\nconst fs = require(\"fs\");\nconst xpath = require(\"xpath-html\");\n\nconst html = fs.readFileSync(`${__dirname}/shopback.html`, \"utf8\");\nconst node = xpath.fromPageSource(html).findElement(\"//*[text()='Made with love by']\");\n\nconsole.log(\"Text of the node:\", node.getText());\n\nconst nodes = xpath\n .fromPageSource(html)\n .findElements(\"//div[@id='home-page-container']//*[@class='title-text']\");\n\nconsole.log(\"Text of nodes[0]:\", nodes[0].getText());\nconsole.log(\"Text of nodes[1]:\", nodes[1].getText());\n```\n\n\n\n**Result**:\n\n\n\n\n```txt\nText of the node: Made with love by\nText of nodes[0]: Up to 10.0% Cash Rewards\nText of nodes[1]: Up to 7.0% Cashback\n```\n\n\n\n
\n\n### `node.getAttribute(name)`\n\n> Retrieve the current value of the given attribute of this node.\n\n**Arguments:**\n\n| Name | Type | Description |\n| ------ | -------- | ---------------------------------- |\n| `name` | `string` | The name of the attribute to query |\n\n**Returns:** `string`\n\n**Example**:\n\n\n\n\n```js\nconst fs = require(\"fs\");\nconst xpath = require(\"xpath-html\");\n\nconst html = fs.readFileSync(`${__dirname}/shopback.html`, \"utf8\");\nconst node = xpath.fromPageSource(html).findElement(\"//a[text()='View All Popular Stores']\");\n\nconsole.log(\"The href value:\", node.getAttribute(\"href\"));\n```\n\n\n\n**Result**:\n\n\n\n\n```txt\nThe href value: /all-stores\n```\n\n\n\n## Dependencies\n\nSpecial thanks to all contributors of these libraries\nwhich are the foundation of what `xpath-html` was built upon.\n\n1. [xpath](https://github.com/goto100/xpath)\n1. [xmldom](https://github.com/jindw/xmldom)\n1. [xmlserializer](https://github.com/cburgmer/xmlserializer)\n1. [parse5](https://github.com/inikulin/parse5)\n\n## License\n\nMIT\n\nMade with ❤ from [ShopBack](https://www.shopback.com/).\n","readmeFilename":"README.md","homepage":"https://github.com/hieuvp/xpath-html#readme","keywords":["xpath-html","xpath","html","dom"],"repository":{"type":"git","url":"git+https://github.com/hieuvp/xpath-html.git"},"bugs":{"url":"https://github.com/hieuvp/xpath-html/issues"}}