add options example

README.md

@@ -58,6 +58,35 @@ console.log(result);
 await browser.close();
 ```
 
+Run basic test scenarios with path and other options.
+
+```js
+/* basic working example for a UI test with macOS specific path
+ * deno test -A ./page-content-test.js
+ * see also https://docs.deno.com/runtime/fundamentals/testing/
+ * */
+import { launch } from "jsr:@astral/astral";
+import { assert } from "jsr:@std/assert";
+
+const browser = await launch({
+  // macOS specific path option
+  path: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+  args: ['--remote-debugging-port=9222', '--headless=new', '--no-first-run', '--password-store=basic', '--use-mock-keychain', '--hide-scrollbars', '--no-sandbox']
+});
+
+const page = await browser.newPage("https://deno.com");
+
+// Run code in the context of the browser
+const text = await page.evaluate(() => {
+	return document.body.querySelector('main h1')?.textContent ?? '';
+});
+
+assert(text.includes('JavaScript'), 'has JavaScript');
+
+await browser.close();
+
+```
+
 You can navigate to a page and interact with it.
 
 ```ts

examples/page-content-test.js

@@ -0,0 +1,23 @@
+/* basic working example for a UI test with macOS specific path
+ * deno test -A ./page-content-test.js
+ * see also https://docs.deno.com/runtime/fundamentals/testing/
+ * */
+import { launch } from "jsr:@astral/astral";
+import { assert } from "jsr:@std/assert";
+
+const browser = await launch({
+  // macOS specific path option
+  path: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+  args: ['--remote-debugging-port=9222', '--headless=new', '--no-first-run', '--password-store=basic', '--use-mock-keychain', '--hide-scrollbars', '--no-sandbox']
+});
+
+const page = await browser.newPage("https://deno.com");
+
+// Run code in the context of the browser
+const text = await page.evaluate(() => {
+  return document.body.querySelector('main h1')?.textContent ?? '';
+});
+
+assert(text.includes('JavaScript'), 'has JavaScript');
+
+await browser.close();