在浏览器按钮的点击事件中调用 navigator.clipboard.readtext(),可以异步读取剪贴板纯文本。页面需要 https 或 localhost 等安全上下文,并符合浏览器的交互和权限要求。读取可能被拒绝,因此应捕获错误,同时提供手动粘贴入口;不要在页面加载时自动读取。

创建带读取按钮和手动粘贴框的完整页面
保存为 index.html。读取成功后用 textContent 显示内容,避免把剪贴板文字作为 HTML 执行;空字符串会显示“未读到文本”。输入框一直保留,用户可以自行选择使用读取按钮或手动粘贴。
<meta charset="utf-8"><title>读取剪贴板文本</title><button id="read">读取剪贴板文本</button> <p id="status">等待操作</p> <pre class="brush:php;toolbar:false;" id="result"><script> const button = document.querySelector('#read'); const status = document.querySelector('#status'); const result = document.querySelector('#result'); const manual = document.querySelector('#manual'); button.addEventListener('click', async () => { if (!window.isSecureContext || !navigator.clipboard?.readText) { status.textContent = '当前环境不可读取,请在下方手动粘贴'; manual.focus(); return; } try { const text = await navigator.clipboard.readText(); result.textContent = text; status.textContent = text === '' ? '未读到文本' : '读取成功'; } catch (error) { result.textContent = ''; status.textContent = '读取未完成,请在下方手动粘贴'; manual.focus(); } }); manual.addEventListener('input', () => { result.textContent = manual.value; status.textContent = '已使用手动输入内容'; }); </script>
这个页面不会把文本发送到服务器。不要用页面日志记录用户的剪贴板正文。不同浏览器可能需要临时用户激活、权限授权或额外的粘贴确认,按钮点击并不能保证一定读取成功。

通过 localhost 提供页面并检查 API 可用性
在 HTML 所在目录启动本地服务,再访问下面的地址。普通远程 HTTP 站点通常不满足安全上下文要求;本地开发使用 localhost。嵌入 iframe 时还可能受到 Permissions Policy 限制,应在具体部署环境中检查。
python3 -m http.server 8000 # 浏览器打开: # http://localhost:8000/index.html # 在开发者工具中查看环境,不会读取剪贴板正文: # window.isSecureContext # typeof navigator.clipboard?.readText
不必先调用 navigator.permissions.query 来决定是否显示按钮,因为各浏览器对剪贴板权限查询的支持不同。以实际 readText 调用结果处理成功或失败,拒绝后保留手动粘贴即可。
核对正常读取、拒绝读取和手动粘贴
使用一段不含敏感信息的测试文本,按下列步骤核对。手动输入仍走 textContent,像 示例 这样的文本也不会变成加粗元素。测试时保持页面处于前台,避免失焦干扰。
测试步骤 预期结果 复制“中文 clipboard”后点击读取 允许读取时显示相同文本 拒绝本次读取请求 显示手动粘贴提示,不出现未捕获异常 在输入框手动粘贴 <b>示例</b> 结果按原文字显示,不解析 HTML 剪贴板没有可读取的文本 返回空文本时显示“未读到文本” 不支持 readText 的浏览器 可以继续使用手动粘贴框
剪贴板包含图片等内容时,不应假定 readText 能取得文件或图片数据;它针对的是文本。需要读取其他类型时,应单独评估 Clipboard.read 的支持和权限,不能沿用此例直接宣称已支持。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











