本条目是一份现代 Web 开发最佳实践参考文档,内容围绕 Lighthouse 最佳实践审计所关注的维度展开,按主题给出「反例 / 正例」代码对照与检查清单。资料本身是规范指引,未说明存在可安装的软件包或自动化脚本,以下为其内容结构。
用途:供开发者在前端开发、代码审查或安全自查时,对照检查页面在安全性、兼容性、代码质量与性能方面的常见问题,并参考示例改写代码。
主要能力(按资料覆盖的主题):
- 安全性:要求全站 HTTPS、避免混合内容;给出 HSTS 响应头示例;介绍通过 meta 标签或 HTTP 头配置内容安全策略(CSP),包括使用 nonce 允许内联脚本;列出 X-Frame-Options、X-Content-Type-Options、X-XSS-Protection、Referrer-Policy、Permissions-Policy 等安全响应头;提示用 npm audit、yarn audit 检查依赖漏洞并给出 package.json 脚本示例;警示原型污染风险与输入净化(如 textContent、DOMPurify);给出安全 Cookie 属性(Secure、HttpOnly、SameSite)。
- 浏览器兼容性:正确声明 HTML5 doctype、在 head 首位声明字符集、添加 viewport meta;用特性检测(如 IntersectionObserver、CSS @supports)替代浏览器嗅探;按需加载 polyfill;避免 document.write、同步 XHR、Application Cache 等废弃 API,改用动态脚本加载与 Service Worker;为 touch/wheel 事件使用 passive 监听。
- 代码质量与错误处理:避免生产环境 console 报错,使用 try/catch、React Error Boundary、全局 error 与 unhandledrejection 监听;生产环境使用 hidden-source-map 或不暴露 Source Map;避免阻塞式脚本与 CSS @import,使用 defer 与 link 并行加载;用事件委托减少监听器;组件卸载时清理监听器或使用 AbortController;保证 HTML 合法(无重复 ID、合法嵌套)、使用语义化标签、保持图片宽高比。
- 权限与隐私:权限申请应在用户操作上下文中发起并给出说明,可用 Permissions-Policy 限制地理位置、摄像头、麦克风等能力。
- 附带的审计清单与工具清单:涵盖安全性、兼容性、代码质量、UX 四类核对项,以及 npm audit、SecurityHeaders.com、W3C Validator、Lighthouse、Observatory 等工具的用途说明。
使用方式:资料未提供安装命令或自动化调用方式;从内容看,它以文档形式供人工阅读与对照,在开发或审查时逐项核对并参照示例修改代码。
适用场景:前端页面开发、代码评审、上线前安全与质量自查、团队编码规范参考。
限制:资料为一般性规范建议,未说明针对特定框架或项目的适配方式,也未提供可直接执行的工具或脚本;具体实施需结合项目实际情况。