用途:为 API 和 Web 应用配置安全的跨域资源共享(CORS),按来源、响应头、预检请求、凭据、方法与测试的流程逐步完成配置。
主要能力:给出 CORS 响应头参考,包括 Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers、Access-Control-Allow-Credentials、Access-Control-Max-Age 和 Access-Control-Expose-Headers;提供 Express、Next.js(中间件与 API 路由)、Fastify 的配置示例;支持路由级 CORS 区分公开、私有与 Webhook 端点;支持基于精确来源、正则模式和子域名的动态来源校验;说明凭据与 Cookie 场景下不能使用通配符来源,必须指定精确来源并设置凭据头;提供与安全头(如 helmet 及若干防护头)配合的写法;并给出使用 supertest 测试 CORS 的示例。
使用方式:按流程先定义允许来源,再设置响应头、处理 OPTIONS 预检、配置凭据、限制允许的方法,最后测试验证;示例中使用 cors、@fastify/cors 等依赖,客户端 fetch 需设置 credentials: 'include',axios 可设置 axios.defaults.withCredentials = true。
适用场景:为前后端分离应用、Next.js API 路由、Express 或 Fastify 服务配置跨域访问,并按开发/生产环境区分来源。
限制:资料未提供具体安装命令、完整代码正文、收费方式、兼容版本与官方文档链接;实际配置需结合所用框架和运行环境调整,本说明仅依据所给资料整理。