SuperAPI AI 工具集

netlify-edge-functions

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:在 Netlify 边缘(Deno 运行时)用 TypeScript/JavaScript 编写、配置和部署 Edge Functions,用于请求/响应改写、地理定位逻辑、鉴权检查与重定向、A/B 个性化等低延迟场景。

主要能力:默认导出处理函数 (request, context),可返回 Response(直接响应)、URL(同站改写)或 undefined(继续链路);支持 context.next() 中间件转换、读取请求体、条件请求、geo/cookies/params/ip/waitUntil 等上下文;通过内联 config 导出或 netlify.toml 配置 path、excludedPath、method、header、cache、onError;支持手动响应缓存、Deno 模块与 node: 内置模块、npm 包(beta)、.tsx 边缘 SSR。

使用方式:文件默认放在 YOUR_BASE_DIRECTORY/netlify/edge-functions,可用 netlify.toml 的 [build] edge_functions 自定义目录。本地运行:npm install netlify-cli -g 后执行 netlify dev(:8888),可用 --geo=mock 模拟地理信息,--edge-inspect 调试。环境变量用 Netlify.env.get(name) 读取。

限制:无路由声明的函数会静默不执行;path 应尽量收窄,避免 /* 拦截静态资源;缓存需 cache:"manual" 与响应头同时设置;CPU 每请求 50ms、内存 512MB、代码 20MB 压缩;启用 Split Testing 时边缘函数不运行;自定义 Headers 与预渲染不适用于边缘函数;不属于 HIPAA 合规范围。框架适配器已生成的中间件不要重复手写。