如何在 Selenium 中使用 sendKeys() 向文本框输入多行内容

聖光之護 2026-01-15 00:00:00 次阅读

本文详解如何在 selenium webdriver（java）中通过 sendkeys() 方法向单行文本框或可编辑区域插入换行内容，核心是组合使用 keys.shift + keys.enter 实现软换行，适用于需逐行输入 csv 格式数据等场景。

在 Web 自动化测试中，常需向或支持多行输入的 <input type="text">（如某些富文本编辑器或启用 white-space: pre-wrap 的输入框）批量注入带换行符的数据。但需注意：标准 HTML <input type="text"> 默认<strong>不支持换行</strong>，若目标元素实际为 <textarea> 或具备多行渲染能力的富文本容器（如 contenteditable="true" 元素），则可通过 Keys.SHIFT + Keys.ENTER 模拟“软换行”（即插入 \n 对应的视觉换行，而非表单提交行为）。

✅ 正确做法（推荐）：

WebElement textbox = driver.findElement(By.id("myTextBox"));
textbox.clear();
textbox.sendKeys(
    "13456,Teena" + Keys.SHIFT + Keys.ENTER +
    "12378,Tesa"  + Keys.SHIFT + Keys.ENTER +
    "130987,Jhon"
);

⚠️ 关键说明：

Keys.ENTER 单独使用会触发表单提交或焦点跳转，不适用于多行输入；
Keys.SHIFT + Keys.ENTER 是多数现代浏览器（Chrome、Edge、Firefox）中公认的“插入换行符”快捷键，等效于手动按 ⇧+↵；
若目标元素为，也可直接使用 "\n" 字符（更简洁）：<pre class="brush:php;toolbar:false;">textbox.sendKeys("13456,Teena\n12378,Tesa\n130987,Jhon");</pre><p>但该方式在部分富文本编辑器中可能被过滤或忽略，因此 Keys.SHIFT + Keys.ENTER 兼容性更广。</p>

? 扩展提示：

Keys 枚举还支持 TAB、ARROW_DOWN、SPACE、ESCAPE 等常用功能键，可用于模拟复杂用户交互；
使用前务必确认目标元素已加载、可交互且未被遮挡（建议配合 WebDriverWait 显式等待）；
若输入后未显示换行，请检查 CSS 属性（如 white-space: nowrap）或 JavaScript 拦截逻辑——此时需结合 executeScript() 注入原生值并
触发 input 事件。