该资源是一份现代 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、npm audit fix、npm ls lodash,并提供 package.json 脚本示例;避免原型污染模式;输入净化(textContent 或 DOMPurify);安全 Cookie 属性(Secure、HttpOnly、SameSite)。
- 浏览器兼容性:HTML5 doctype;charset 置于 head 首位;viewport meta;特性检测而非浏览器检测,含 @supports;按需加载 polyfill;避免 document.write、同步 XHR、Application Cache 等已弃用 API;对 touch/wheel 使用 passive 事件监听。
- 代码质量与错误处理:避免生产环境 console 错误;React 错误边界类示例;全局 error 与 unhandledrejection 监听;生产环境使用 hidden-source-map 或不生成 source map。
- 性能:使用 defer 脚本、用 link 替代 @import、事件委托、移除事件监听并用 AbortController 清理。
- 代码质量细节:有效 HTML 与语义化标签、图片宽高比、权限与隐私(在用户操作上下文中请求权限、Permissions-Policy)。
使用方式:资料以对比示例(错误写法与推荐写法)和审计清单形式组织,包含安全、兼容、代码质量、UX 等检查项,并列出工具:npm audit、SecurityHeaders.com、W3C Validator、Lighthouse、Observatory,以及 MDN Web Security、OWASP Top 10 等参考。
限制:资料未提供具体安装命令、版本要求或费用信息;部分示例涉及第三方库(如 DOMPurify)与具体构建工具配置,是否适用需依据实际项目环境判断。