Update formatting

Author: gernberg

docs/tool-reference.md

@@ -152,6 +152,7 @@
 - **timeout** (integer) _(optional)_: Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
 - **type** (enum: "url", "back", "forward", "reload") _(optional)_: Navigate the page by URL, back or forward in history, or reload.
 - **url** (string) _(optional)_: Target URL (only type=url)
+- **initScript** (string) _(optional)_: Script to execute whenever a page is navigated to.
 
 ---
 

src/tools/pages.ts

@@ -116,9 +116,12 @@ export const navigatePage = defineTool({
       .boolean()
       .optional()
       .describe('Whether to ignore cache on reload.'),
-    initScript: zod.string().optional().describe(
-      `(optional) A JavaScript function to be executed by the tool on new document for every page load before any other scripts.
-      `),
+    initScript: zod
+      .string()
+      .optional()
+      .describe(
+        '(optional) A JavaScript function to be executed by the tool on new document for every page load before any other scripts.',
+      ),
     ...timeoutSchema,
   },
   handler: async (request, response, context) => {
@@ -135,8 +138,8 @@ export const navigatePage = defineTool({
       request.params.type = 'url';
     }
 
-    if(request.params.initScript){
-      page.evaluateOnNewDocument(request.params.initScript);
+    if (request.params.initScript) {
+      await page.evaluateOnNewDocument(request.params.initScript);
     }
 
     await context.waitForEventsAfterAction(async () => {

tests/tools/pages.test.ts

@@ -196,14 +196,21 @@ describe('pages', () => {
     it('navigates to correct page with initScript', async () => {
       await withBrowser(async (response, context) => {
         await navigatePage.handler(
-          {params: {url: 'data:text/html,<div>Hello MCP</div>', initScript: 'window.initScript = "completed"'}},
+          {
+            params: {
+              url: 'data:text/html,<div>Hello MCP</div>',
+              initScript: 'window.initScript = "completed"',
+            },
+          },
           response,
           context,
         );
         const page = context.getSelectedPage();
 
         // wait for up to 1s for the global variable to set by the initScript to exist
-        await page.waitForFunction("window.initScript==='completed'", {timeout: 1000});
+        await page.waitForFunction("window.initScript==='completed'", {
+          timeout: 1000,
+        });
 
         assert.ok(response.includePages);
       });