Skip to content

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.md
index 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 &lt;select&gt; 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.ts
index 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.ts
index 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,