Merge branch 'main' into main

Author: mithun50

.github/ISSUE_TEMPLATE/01-bug.yml

@@ -1,8 +1,7 @@
 name: Bug report
 description: File a bug report for chrome-devtools-mcp
 title: '<short description of the bug>'
-labels:
-  - 'bug'
+type: 'Bug'
 body:
   - id: description
     type: textarea

README.md

@@ -336,5 +336,5 @@ Some MCP clients allow sandboxing the MCP server using macOS Seatbelt or Linux
 containers. If sandboxes are enabled, `chrome-devtools-mcp` is not able to start
 Chrome that requires permissions to create its own sandboxes. As a workaround,
 either disable sandboxing for `chrome-devtools-mcp` in your MCP client or use
-`--connect-url` to connect to a Chrome instance that you start manually outside
+`--browser-url` to connect to a Chrome instance that you start manually outside
 of the MCP client sandbox.

docs/tool-reference.md

@@ -200,11 +200,11 @@
 
 ### `emulate_network`
 
-**Description:** Emulates network conditions such as throttling on the selected page.
+**Description:** Emulates network conditions such as throttling or offline mode on the selected page.
 
 **Parameters:**
 
-- **throttlingOption** (enum: "No emulation", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") **(required)**: The network throttling option to emulate. Available throttling options are: No emulation, Slow 3G, Fast 3G, Slow 4G, Fast 4G. Set to "No emulation" to disable.
+- **throttlingOption** (enum: "No emulation", "Offline", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") **(required)**: The network throttling option to emulate. Available throttling options are: No emulation, Offline, Slow 3G, Fast 3G, Slow 4G, Fast 4G. Set to "No emulation" to disable. Set to "Offline" to simulate offline network conditions.
 
 ---
 

package-lock.json

@@ -40,8 +40,9 @@
     "@modelcontextprotocol/sdk": "1.19.1",
     "core-js": "3.45.1",
     "debug": "4.4.3",
-    "puppeteer-core": "24.23.0",
-    "yargs": "18.0.0"
+    "puppeteer-core": "^24.23.0",
+    "yargs": "18.0.0",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@eslint/js": "^9.35.0",

package.json

@@ -12,12 +12,13 @@ import {defineTool} from './ToolDefinition.js';
 
 const throttlingOptions: [string, ...string[]] = [
   'No emulation',
+  'Offline',
   ...Object.keys(PredefinedNetworkConditions),
 ];
 
 export const emulateNetwork = defineTool({
   name: 'emulate_network',
-  description: `Emulates network conditions such as throttling on the selected page.`,
+  description: `Emulates network conditions such as throttling or offline mode on the selected page.`,
   annotations: {
     category: ToolCategories.EMULATION,
     readOnlyHint: false,
@@ -26,7 +27,7 @@ export const emulateNetwork = defineTool({
     throttlingOption: z
       .enum(throttlingOptions)
       .describe(
-        `The network throttling option to emulate. Available throttling options are: ${throttlingOptions.join(', ')}. Set to "No emulation" to disable.`,
+        `The network throttling option to emulate. Available throttling options are: ${throttlingOptions.join(', ')}. Set to "No emulation" to disable. Set to "Offline" to simulate offline network conditions.`,
       ),
   },
   handler: async (request, _response, context) => {
@@ -39,6 +40,17 @@ export const emulateNetwork = defineTool({
       return;
     }
 
+    if (conditions === 'Offline') {
+      await page.emulateNetworkConditions({
+        offline: true,
+        download: 0,
+        upload: 0,
+        latency: 0,
+      });
+      context.setNetworkConditions('Offline');
+      return;
+    }
+
     if (conditions in PredefinedNetworkConditions) {
       const networkCondition =
         PredefinedNetworkConditions[

src/tools/emulation.ts

@@ -11,6 +11,21 @@ import {withBrowser} from '../utils.js';
 
 describe('emulation', () => {
   describe('network', () => {
+    it('emulates offline network conditions', async () => {
+      await withBrowser(async (response, context) => {
+        await emulateNetwork.handler(
+          {
+            params: {
+              throttlingOption: 'Offline',
+            },
+          },
+          response,
+          context,
+        );
+
+        assert.strictEqual(context.getNetworkConditions(), 'Offline');
+      });
+    });
     it('emulates network throttling when the throttling option is valid ', async () => {
       await withBrowser(async (response, context) => {
         await emulateNetwork.handler(