边缘安全加速平台 EO Functions

一、优势

分布式部署

EdgeOne 拥有 3200+ 边缘节点，边缘函数以分布式部署的方式运行在边缘节点。

超低延迟

客户端请求将自动被调度至靠近你用户最近的边缘节点上，命中触发规则触发边缘函数对请求进行处理并响应结果给客户端，可显著降低客户端的访问时延。

弹性扩容

边缘函数可以根据客户端请求数的突增，由近及远地将请求调度至有充足计算资源的边缘节点处理，你无需担忧突发场景。

Serverless 架构

你无需再关心和维护底层服务器的内存、CPU、网络和其他基础设施资源，可以抽出精力更专注于业务代码的开发。

二、快速开始

在项目的 ./edge-functions/api 目录下新建 hello.js，使用以下示例代码创建你的第一个 Edge Function：

// ./edge-functions/api/hello.jsexport default function onRequest(context) { return new Response('Hello from Edge Functions!');}

三、路由

Edge Functions 基于 /edge-functions 目录结构生成访问路由。你可在项目仓库 /edge-functions 目录下创建任意层级的子目录，参考下述示例。

…edge-functions├── index.js├── hello-pages.js├── helloworld.js├── api ├── users ├── list.js ├── geo.js ├── [id].js ├── visit ├── index.js ├── [[default]].js…

上述目录文件结构，经 EdgeOne Makers 平台构建后将生成以下路由。这些路由将 Makers URL 映射到 /edge-functions 文件，当客户端访问 URL 时将触发对应的文件代码运行：

注意：说明：

动态路由

Edge Functions 支持动态路由，上述示例中一级动态路径 /edge-functions/api/users/[id].js，多级动态路径 /edge-functions/api/[[default]].js。参考下述用法：

四、Function Handlers

使用 Function Handlers 可为 Makers 创建自定义请求处理程序，以及定义 RESTful API 实现全栈应用。支持下述 Handlers 方法：

EventContext 对象描述

context 是传递给 Function Handlers 方法的对象，包含下述属性：

·request：客户端请求对象 Request。

·params：动态路由 /edge-functions/api/users/[id].js 参数值。

export function onRequestGet(context) { return new Response(`User id is ${context.params.id}`);}

·env：Makers 环境变量。

·waitUntil：(task: Promise<any>): void; 用于通知边缘函数等待 Promise 完成，可延长事件处理的生命周期。

五、Runtime APIs

Edge Functions 基于 边缘函数 实现，提供了 EdgeOne 边缘节点的 Serverless 代码执行环境。支持 ES6 语法和标准的 Web Service Worker API。其中大部分 Runtime APIs 可参考 边缘函数 用法，参考下述描述：

注意：说明：

六、使用限制

七、示例模板

获取用户访问地理位置：

预览地址

源码地址

使用 KV 记录页面访问数：

预览地址

源码地址

有关如何使用 KV 存储的详细信息，请参阅 KV 存储。

连接 Supabase 第三方数据库：

预览地址

源码地址