工具

Chrome 给 Coding Agent 补课:别再手写 2019 JavaScript

Chrome 开源 modern-web-guidance,用平台规则引导 Coding Agent 优先使用 CSS.highlights、<dialog> 和 field-sizing,减少手写状态与依赖。

字号

Chrome 开源了 modern-web-guidance,用浏览器平台规则引导 Coding Agent 少写 JavaScript,少装依赖。这对你的直接关系是:Agent 生成前端代码时,可能少复制旧版弹窗、高亮和表单逻辑。

模型知道 CSS.highlights、<dialog>、showModal() 这些名字。

但让它改一个文本高亮、一个弹窗、一个自动增高的输入框,它仍可能写出一大段 JavaScript,再顺手加一个依赖。

这不是模型不会 API。

更像是训练数据里的旧习惯太重。

Google Chrome 团队开源了 modern-web-guidance,目标就是给 Coding Agent 补充现代 Web 平台知识。项目摘要写得很直接:

“We started an effort in Chrome to supplement coding agents with this key domain knowledge.”

它不是新框架,也不是新的运行时。它更像一层面向 Agent 的领域规则:先告诉 Agent 哪些事情浏览器已经能做,再让它生成代码。

模型知道 API,却不用

Coding Agent 的常见路径不是“不知道”,而是“知道但不用”。

项目观察到,模型即使知道一些现代 API 的名称,也经常不选择平台原生方案,而偏向既有的 JavaScript 模式。

这和人类开发者的惯性很像。

2019 年处理文本选中样式,常见做法是监听 selectionchange,遍历 DOM 节点,再手动维护高亮状态。2026 年,浏览器已经有 CSS.highlights,但旧代码仍然占训练数据的大多数。

模型做代码补全时,最容易延续的不是“最佳实践”,而是“出现频率最高的模式”。

于是我们看到一种很具体的浪费:

  • 文本高亮逻辑散落在多个 JavaScript 回调里;
  • 模态框自己管理遮罩、关闭按钮和焦点;
  • textarea 高度靠监听 input、读取 scrollHeight、再写回 style.height;
  • 为这些小功能引入 Popper、Headless UI 或其他依赖。

生成结果能跑。

但代码更重,状态更多,浏览器兼容边界也更多。

Chrome 正在补领域知识

modern-web-guidance 的定位很克制:它不替 Agent 写应用,而是补充浏览器平台这一块领域知识。

这点很重要。

通用模型会写 React、Vue、Node.js,也知道大量 JavaScript 惯用法。但一个模型如果缺少足够明确的平台规则,就容易把“能调 API”和“应该优先用 API”混为一谈。

这个项目采用结构化指南。目录按领域和具体能力组织,Agent 可以在写代码前读取对应规则,而不是把一整本 API 文档塞进上下文。

它解决的不是上下文长度问题。

恰恰相反,它试图改变上下文的内容和优先级。

过去,给 Agent 追加 API 文档,常见效果是让它多知道一些选项。现在 Chrome 团队尝试把“默认选择”写清楚:遇到文本范围高亮,先看 CSS.highlights;遇到模态对话框,先看 <dialog> 与 showModal();遇到输入框自适应高度,先看 field-sizing。

规则比示例更接近约束。

示例告诉 Agent“可以这样写”;规则告诉 Agent“优先这样写”。

三个能力,三份代码

下面这组例子来自项目列出的能力方向。它们不是完整框架代码,但足以说明“交给浏览器”和“自己维护状态”的差别。

1. 文本范围高亮

旧模式通常需要自己监听选择变化、计算范围、应用样式,再处理清除。

现代方案使用 CSS.highlights,并通过 Highlight 注册文本范围:

const highlight = new Highlight();
CSS.highlights.set('search-results', highlight);

const range = document.createRange();
range.selectNodeContents(document.querySelector('#result'));
highlight.add(range);

项目对这项能力的描述是:用 CSS.highlights 做文本范围高亮,不必再把相同逻辑散落到各处 JavaScript。

浏览器负责维护高亮集合。JavaScript 只需要提供范围,样式则可以放在 CSS 中:

::highlight(search-results) {
  background-color: #fde68a;
  color: #111827;
}

对于 Coding Agent,这是很具体的默认项切换:不是把原来的状态管理改写得更漂亮,而是尽量删除状态管理。

2. 模态对话框

手写弹层时,遮罩、滚动锁定、焦点移动和关闭后的焦点恢复,很容易变成项目里的隐形基础设施。

HTML 原生方案是 <dialog> 配合 showModal():

<dialog id="settings-dialog">
  <form method="dialog">
    <h2>Settings</h2>
    <button value="close">Close</button>
  </form>
</dialog>
const dialog = document.querySelector('#settings-dialog');

openButton.addEventListener('click', () => {
  dialog.showModal();
});

项目对它的说明包括两个具体收益:原生 backdrop,以及更理想的焦点管理。

也就是说,遮罩不再需要额外 div;焦点进入弹窗、限制在模态上下文中,以及关闭后的恢复,都有浏览器语义可承接。

Agent 如果能在遇到“模态框”时默认选择 <dialog>,一个小型交互组件就可能从几十行 JavaScript 变成几行调用。

3. 自动增高的 textarea

旧代码很熟悉:监听 input,读取 scrollHeight,设置高度。

现代 Web 平台提供了 field-sizing:

<textarea rows="3" field-sizing="content"></textarea>

用户输入时,textarea 会自动增高。

项目把这项能力概括为:让 textarea 随用户输入自动增高。

没有 resize 监听,没有高度缓存,也不需要在框架状态里保存一个派生值。

这个例子最能说明这类指南的价值。它未必让 Agent 学会一种全新架构,只是让它别再复制一段存在了多年的样板代码。

Agent 的缺口不是上下文

很多人看到 Coding Agent 写得很保守,第一反应是“再塞一些现代 JavaScript 教程进去”。

这通常不够。

因为问题不是 API 说明缺失,而是默认选择被旧代码压住。

模型见过大量 GitHub 项目:这些项目有历史包袱,有兼容需求,也有作者个人偏好。模型从统计上复现这些代码很正常。

但如果任务是“实现一个现代 Web 交互”,最佳答案不一定是复现最常见的旧实现。

modern-web-guidance 试图在生成前加入浏览器团队维护的领域约束。约束的对象不是语法,而是选型:

  • 平台有原生能力时,优先不用 JavaScript 重做;
  • 原生元素能覆盖语义时,优先使用语义元素;
  • 平台已经处理焦点、尺寸或高亮时,不再维护重复状态。

这类规则还有一个工程上的好处:它们比“请遵循最佳实践”更容易验收。

你可以检查生成的代码里有没有手写 textarea 拉伸,有没有用 div 模拟 dialog,有没有为简单高亮引入依赖。

编辑思考

这件事重要,不是因为 Chrome 又开源了一个仓库,而是因为平台团队开始直接维护“给 Coding Agent 的约束层”。过去,框架团队靠文档、示例和 lint 规则影响生成代码;现在,浏览器团队也可以把自己的能力边界编码成 Agent 可读取的指南。

我的判断是,未来有效的 Agent 规则不会主要来自更大模型,而会来自更靠近运行平台的约束。模型负责写代码,平台团队负责规定什么不该重写。

它和过去不同的地方在于:RAG 通常负责补充事实,指南则要改变默认动作。事实回答“field-sizing 是什么”,约束要回答“什么时候必须优先用它”。

不过,效果还不能只看规则写得多漂亮。浏览器版本支持、项目兼容范围、框架水合行为,以及真实代码库里的历史约束,都会影响结论。尤其是 dialog、Popover API 和 field-sizing 的兼容情况,不能用一个新浏览器演示代替生产验证。我会关注两件事:生成代码的依赖是否真的下降,以及指南进入 Agent 工作流后是否会被项目级规则覆盖。约束是否有用,最终要看它是否减少了代码,而不只增加了知识。

来源

https://github.com/GoogleChrome/modern-web-guidance

来源: https://github.com/GoogleChrome/modern-web-guidance