surfsky 0.0.2 → 0.0.3

package/README.md

@@ -282,6 +282,10 @@ waits for one of its own and throws `RateLimitError` only if it has none.
 
 ### Reading
 
+`selector` is CSS, or XPath when it starts with `//`, `..` or `xpath=`. XPath
+covers the DOM reads below and `screenshot({ selector })`; `innerText`,
+`allInnerTexts`, `selectOption` and the input methods take CSS only.
+
 | Method                                                       | Description                                                                             |
 | ------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
 | `url()`, `title()`                                           | Current URL and title.                                                                  |

package/dist/index.js

@@ -865,6 +865,9 @@ const WORLD_NAME = "utility";
 /** A dialog is answered after this long, as a person would. */
 const DIALOG_DELAY = [600, 1400];
 const FUNCTION = /^\s*(async\s+)?(function\b|\([^()]*\)\s*=>|[\w$]+\s*=>)/;
+function asXPath(s) {
+	return /^\s*(xpath=|\/\/|\.\.)/.test(s) ? s.trim().replace(/^xpath=/, "") : void 0;
+}
 const SELECT = `(selector, value, label) => {
   const el = document.querySelector(selector);
   if (!el) return null;
@@ -1329,6 +1332,8 @@ var Page = class extends Actions {
 	}
 	async count(selector) {
 		const document = await this.send("DOM.getDocument", { depth: 0 });
+		const xpath = asXPath(selector);
+		if (xpath !== void 0) return (await this.#search(xpath)).length;
 		return ((await this.send("DOM.querySelectorAll", {
 			nodeId: document.root.nodeId,
 			selector
@@ -1371,11 +1376,26 @@ var Page = class extends Actions {
 	}
 	async #nodeId(selector) {
 		const document = await this.send("DOM.getDocument", { depth: 0 });
+		const xpath = asXPath(selector);
+		if (xpath !== void 0) return (await this.#search(xpath))[0];
 		return (await this.send("DOM.querySelector", {
 			nodeId: document.root.nodeId,
 			selector
 		})).nodeId || void 0;
 	}
+	async #search(query) {
+		const { searchId, resultCount = 0 } = await this.send("DOM.performSearch", { query });
+		try {
+			if (!resultCount) return [];
+			return (await this.send("DOM.getSearchResults", {
+				searchId,
+				fromIndex: 0,
+				toIndex: resultCount
+			})).nodeIds ?? [];
+		} finally {
+			await this.send("DOM.discardSearchResults", { searchId }).catch(() => void 0);
+		}
+	}
 	/** Wait until the URL contains the fragment. Returns the URL. */
 	async waitForUrl(fragment, options = {}) {
 		const deadline = new Deadline(options.timeout ?? 3e4, `the page did not reach '${fragment}'`);
@@ -2598,7 +2618,7 @@ var Proxies = class {
 };
 //#endregion
 //#region src/version.ts
-const VERSION = "0.0.2";
+const VERSION = "0.0.3";
 //#endregion
 //#region src/client.ts
 function userAgent() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "surfsky",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "TypeScript SDK for the Surfsky antidetect browser cloud.",
   "keywords": [
     "surfsky",