Chrome DevTools for coding agents
docs(input): note that press_key cannot drive native <select> popups on macOS (#3288)
Yuri (IURII) Trukhin8e79bd096326
diff --git a/docs/tool-reference.md b/docs/tool-reference.mdindex 72837b92..a485b764 100644--- a/docs/tool-reference.md+++ b/docs/tool-reference.md@@ -155,7 +155,7 @@### `press_key`-**Description:** Press a key or key combination. Use this when other input methods like [`fill`](#fill)() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).+**Description:** Press a key or key combination. Use this when other input methods like [`fill`](#fill)() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations). Note: On macOS, native <select> elements cannot be operated with ArrowDown/Enter via [`press_key`](#press_key); use [`fill`](#fill)() on the combobox or [`click`](#click)() on the option instead.**Parameters:**diff --git a/src/config/cli-options.ts b/src/config/cli-options.tsindex dfd98861..52a20a91 100644--- a/src/config/cli-options.ts+++ b/src/config/cli-options.ts@@ -1679,7 +1679,7 @@ export const commands: Commands = {},press_key: {description:- 'Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).',+ 'Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations). Note: On macOS, native <select> elements cannot be operated with ArrowDown/Enter via press_key; use fill() on the combobox or click() on the option instead.',category: 'Input automation',args: {pageId: {diff --git a/src/tools/input.ts b/src/tools/input.tsindex 91bf5ee9..76c8d1f9 100644--- a/src/tools/input.ts+++ b/src/tools/input.ts@@ -634,7 +634,7 @@ export const uploadFile: PageToolFactory = definePageTool(() => ({export const pressKey: PageToolFactory = definePageTool(() => ({name: 'press_key',- description: `Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).`,+ description: `Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations). Note: On macOS, native <select> elements cannot be operated with ArrowDown/Enter via press_key; use fill() on the combobox or click() on the option instead.`,annotations: {category: ToolCategory.INPUT,readOnlyHint: false,