Add xpath application example

javascript-sdk/application-examples/xpath/README.md

@@ -0,0 +1,23 @@
+# Example script: get XPath of elements fetched with AgentQL
+
+This example demonstrates how to get XPath of an element that was fetched with AgentQL.
+
+## Run the script
+
+- [Install AgentQL SDK](https://docs.agentql.com/javascript-sdk/installation)
+- [Install Playwright Dompath](https://www.npmjs.com/package/playwright-dompath) with the following command:
+
+```bash
+npm install playwright-dompath
+```
+
+- Save this Javascript file locally as **xpath.js**
+- Run the following command from the project's folder:
+
+```bash
+node xpath.js
+```
+
+## Play with the query
+
+Install the [AgentQL Debugger Chrome extension](https://docs.agentql.com/installation/chrome-extension-installation) to play with the AgentQL query. [Learn more about the AgentQL query language](https://docs.agentql.com/agentql-query/query-intro)

javascript-sdk/application-examples/xpath/xpath.js

@@ -0,0 +1,37 @@
+/* This example demonstrates how to get XPath of an element that was fetched with AgentQL */
+
+const { wrap } = require('agentql');
+const { chromium } = require('playwright');
+
+// Import the xPath function from the playwright-dompath package.
+const { xPath } = require('playwright-dompath');
+
+// Define the URL of the page to scrape.
+const URL = 'https://scrapeme.live/shop/';
+
+// Define the query to locate the search box.
+const QUERY = `
+{
+    search_products_box
+}
+`;
+
+async function main() {
+  // Launch a headless browser using Playwright.
+  const browser = await chromium.launch({ headless: false });
+
+  // Create a new page in the browser and wrap it to get access to the AgentQL's querying API
+  const page = await wrap(await browser.newPage());
+  await page.goto(URL);
+
+  // Use queryElements() method to locate the search box from the page.
+  const response = await page.queryElements(QUERY);
+
+  // Get the XPath of the search box element.
+  console.log('XPath:', await xPath(response.search_products_box));
+
+  // Close the browser.
+  await browser.close();
+}
+
+main();

javascript-sdk/package.json

@@ -19,6 +19,7 @@
   },
   "dependencies": {
     "agentql": "^0.0.1",
-    "playwright": "^1.48.2"
+    "playwright": "^1.48.2",
+    "playwright-dompath": "^0.0.7"
   }
 }