跳到主要内容
FormFlow

用“读取我的页面”检查你的表单所安装的页面

“读取我的页面”会抓取你指定的那一个公开页面,仅一次,并按你的表单设置检查页面上的表单:严格模式会拒绝的字段、页面漏掉的必填字段,或你的允许列表会拒绝的来源。

本文由机器翻译。 阅读英文原文

A dark plate titled 'Check the page your Form is installed on with Read my page', listing that it reads the one https page you name once, and reports a field your strict schema refuses, a required field the page leaves out and an origin your allowlist turns away.

表单在 FormFlow 里可能是对的,却在向它提交数据的页面上出错:页面 HTML 里改了字段名,必填字段被删掉,或者你的允许列表没有列出这个站点。“读取我的页面”会在访客发现之前替你查出这些问题。它抓取你指定的那一个公开页面,仅一次,找到页面上提交到这个表单的表单,并按表单的设置对它做判定。它随 v1.43.0 版本发布。

它读取什么

  • 一个页面,一次。对话框说得很明白:FormFlow 只抓取你指定的那一个页面,仅一次,绝不读取你没有指定的页面。

  • 公共互联网上的 https 地址。托管页面无法读取,因为它由 FormFlow 自己提供;请指定你自己站点提供的页面。

  • 第一个 action 路径以 /v1/f/ 加此表单令牌结尾的表单。只比较路径,从不比较主机。

  • 页面按原样提供的 HTML。不执行 JavaScript,也不跟随重定向。不是 HTML 的响应会被拒绝,等待最长 10 秒,页面最大 1 MB。

请求以用户代理 FormFlow-PageRead 表明身份,因此屏蔽自动访客的站点可以放行它。每个团队每分钟可抓取十个页面,FormFlow 中所有替你抓取页面的功能合计,抓取失败也算一次。

运行它

  1. 在编辑器中打开表单,依次选择“工具”和“读取我的页面”。

  2. 在“安装页面地址”中输入页面的完整地址,按你希望被读取的形式。如果 FormFlow 见过该表单从某个站点加载,字段下的提示会写出那个来源;它只是提示,在你按下按钮之前不会抓取任何内容。

  3. 按“读取页面”。结果会显示在同一个对话框里。

按下“读取页面”还会把该地址保存到表单上作为它的安装页面,无论读取是否成功。任何能编辑该表单的人都可以运行它。

四种结果

已判定

FormFlow 找到了表单,并向它提出与接收提交时相同的问题:决定真实提交的判定中的字段结构阶段,以及允许的来源列表。没有需要报告的内容时,你会看到“未发现问题”。否则,对话框会说明来自该页面的提交会被拒绝,并为每项发现列出一句话:

  • 你的页面发送了“字段”,而此表单的严格模式会拒绝它。页面发送了表单从未声明的字段。

  • 你的页面从未发送“字段”,而此表单要求提供它。

  • 你的允许列表拒绝了主机,也就是此页面所在的主机。页面自己的主机不在表单“安全”标签页的“允许的来源”中。

未找到表单

FormFlow 在该页面上没有找到提交到此表单的表单。措辞刻意谨慎:用 JavaScript 构建的表单从这里看与没有表单一模一样,因此这并不表示表单缺失。

实时渲染

该页面上的表单从 FormFlow 获取其字段,因此未检查其字段。这种情况下什么都不会被判定,包括来源。

无法读取

页面无法读取,会用一句话告诉你原因。原因是一个封闭列表:

  • 地址不在公共互联网上。这也包括不是 https 的地址。

  • 页面拒绝了请求。如果你的站点屏蔽自动访客,请放行上面提到的用户代理。

  • 页面在 10 秒内没有响应,或 FormFlow 无法连接到它。

  • 该地址响应的不是 HTML。

  • 页面大于 1 MB。

  • 该地址会重定向。FormFlow 会指出它指向哪里,并提供“使用此地址”按钮,只有你按下时才会读取那个地址。

如果你的团队已用完当前这一分钟的十次抓取,则不会抓取任何内容,对话框会告诉你需要等待多少秒。

它看不到什么

  • 它只报告接收时会被拒绝的内容。关闭“根据字段列表验证提交”后,多余的字段不算发现,因为没有什么会拒绝它。

  • 它为每个控件提交一个占位值。它检查页面发送了哪些名称,而不是某个值能否通过,所以错误的值不会被报告。

  • 某条路线会跳过的步骤上的必填字段不会被报告,因为页面无法知道填写者会给出什么答案。

  • 文件输入、按钮和已禁用的控件会被忽略。

  • 它报告页面当下的行为。它不打分,不属于表单健康,也从不通过邮件发送。

  • 发现只指出字段或主机,别无其他。它不会链接到用来修复问题的控件。

修复后再读一次

对于未声明的字段,要么把字段加到表单里,要么从页面上删除。对于漏掉的必填字段,把它加到页面上,或改为可选。对于被拒绝的来源,把页面的主机加入“允许的来源”。然后再按一次“读取页面”;对话框会保留你已保存的地址。

这不能决定什么

它不能证明页面一定能正常工作:页面可以通过检查,却仍因某个值、某项验证或已关闭的表单而失败。关于第一项发现背后的严格模式,请参阅用严格模式让表单架构成为权威。要对你自己页面发出的实时请求做同样的判定,请参阅在发送之前用预检拦下不合格的提交。要先把表单放到页面上,请参阅用生成的组件把表单嵌入你自己的网站。