富文本编辑功能如何验收

发布时间: 更新时间:
举报

建站项目中的富文本编辑功能,如果验收时只检查“能不能输入文字”,上线后容易出现格式错乱、图片丢失或保存后无法再次编辑的问题。验收应覆盖粘贴、标题层级、图片插入、保存再编辑和安全输出五个方面,并明确允许的格式范围。测试内容与线上发布必须分开,避免在正式环境中留下危险代码。以下提供可复现的测试记录字段与核对方法,适用于定制开发或模板建站项目,具体执行需结合合同附件中的功能描述。

明确允许的格式范围

在验收前,需与开发方确认富文本编辑器允许的格式清单,例如:标题层级(H1至H3)、加粗、斜体、有序/无序列表、链接、图片插入。清单应作为合同附件或需求文档的一部分,注明版本号和日期。

测试时,逐项尝试允许格式之外的样式(如字体颜色、背景色、自定义字号),观察编辑器是否拒绝或自动过滤。记录实际表现与约定是否一致。

核对方法:准备一份包含允许格式和不允许格式的测试文档,在编辑器中粘贴或手动输入,保存后查看前台展示是否仅保留允许格式。记录字段包括:测试项、预期行为、实际行为、是否通过、备注。

粘贴与标题层级的测试

从外部文档(如Word或网页)复制带格式的内容粘贴到编辑器,检查标题层级是否保留、列表是否正常、多余样式是否被清除。测试应覆盖纯文本粘贴和带格式粘贴两种模式。

标题层级测试需确认H1至H3的显示样式与站点设计一致,且保存后再次编辑时层级不丢失。记录字段:粘贴来源类型、粘贴模式、标题层级保留情况、列表结构保留情况、异常描述。

注意:测试内容应使用占位文本,避免使用真实业务数据。测试完成后清理测试内容,不与线上发布内容混用。

图片插入与保存再编辑

图片测试包括本地上传和通过链接插入两种方式。上传后检查图片是否正常显示、尺寸是否适配、保存后再次编辑时图片是否仍然存在且可调整。

保存再编辑测试需模拟完整流程:编辑内容→保存→退出→重新打开编辑→修改→再次保存。记录每次保存后的内容一致性,特别是图片路径和标题层级是否发生变化。

记录字段:图片插入方式、图片显示状态、保存后图片状态、再编辑时图片可操作性、再保存后内容一致性。测试图片应使用小尺寸占位图,避免占用过多存储空间。

安全输出与危险代码隔离

安全输出验收需确认编辑器对脚本标签、内联事件属性等危险代码的处理方式。在隔离的测试环境使用经过授权的安全测试样本,核对服务端过滤、保存后再次编辑以及前台安全渲染;不能只看源代码中是否出现标签,就判断全部输出路径安全。

测试内容必须与线上发布环境分开。建议在测试环境或独立页面进行,测试后立即删除测试内容,避免危险代码残留。记录字段:测试代码类型、输入方式、保存后前台输出表现、是否被过滤或转义、测试环境标识。

核对时在隔离测试环境检查保存、预览和正式渲染等输出路径,结合开发者工具与服务端过滤核查是否安全处理;查看源代码本身不能证明脚本没有执行。若编辑器允许插入HTML源码,需明确约定允许的标签白名单,并逐项核对。

验收记录与遗留项登记

每项测试完成后,将记录字段整理成验收记录表,包含测试项、预期行为、实际行为、是否通过、测试环境、测试时间、测试人。未通过项登记为遗留项,注明责任方和计划处理时间。

验收记录表应作为项目交付文档的一部分,与合同附件中的功能描述对应。若测试中发现约定不明确之处,需以书面形式确认后再继续测试。

测试内容清理后,在记录中注明清理状态。线上发布前,再次核对允许格式清单与安全输出规则,确保测试内容未混入正式内容。