Edge 运行时
Next.js Edge 运行时用于中间件,并支持以下 API
网络 API
API | 描述 |
---|---|
Blob | 表示一个 Blob 对象 |
fetch | 获取资源 |
FetchEvent | 表示一个 fetch 事件 |
File | 表示一个文件 |
FormData | 表示表单数据 |
Headers | 表示 HTTP 头部 |
Request | 表示一个 HTTP 请求 |
Response | 表示一个 HTTP 响应 |
URLSearchParams | 表示 URL 搜索参数 |
WebSocket | 表示一个 WebSocket 连接 |
编码 API
API | 描述 |
---|---|
atob | 解码 base-64 编码的字符串 |
btoa | 将字符串编码为 base-64 |
TextDecoder | 将 Uint8Array 解码为字符串 |
TextDecoderStream | 可链式解码器,用于流 |
TextEncoder | 将字符串编码为 Uint8Array |
TextEncoderStream | 用于流的可链式编码器 |
流 API
API | 描述 |
---|---|
ReadableStream | 表示可读流 |
ReadableStreamBYOBReader | 表示 ReadableStream 的读取器 |
ReadableStreamDefaultReader | 表示 ReadableStream 的读取器 |
TransformStream | 表示转换流 |
WritableStream | 表示可写流 |
WritableStreamDefaultWriter | 表示 WritableStream 的写入器 |
加密 API
API | 描述 |
---|---|
crypto | 提供对平台加密功能的访问 |
CryptoKey | 表示加密密钥 |
SubtleCrypto | 提供对常用加密原语的访问,例如散列、签名、加密或解密 |
Web 标准 API
API | 描述 |
---|---|
AbortController | 允许您根据需要中止一个或多个 DOM 请求 |
Array | 表示一系列值 |
ArrayBuffer | 表示通用的、固定长度的原始二进制数据缓冲区 |
Atomics | 提供原子操作作为静态方法 |
BigInt | 表示具有任意精度的整数 |
BigInt64Array | 表示 64 位有符号整数的类型化数组 |
BigUint64Array | 表示 64 位无符号整数的类型化数组 |
Boolean | 表示逻辑实体,可以有两个值:true 和 false |
clearInterval | 取消先前由 setInterval() 调用建立的定时重复操作 |
clearTimeout | 取消先前由 setTimeout() 调用建立的定时重复操作 |
console | 提供对浏览器调试控制台的访问 |
DataView | 表示 ArrayBuffer 的通用视图 |
Date | 表示以平台无关格式表示的单个时间点 |
decodeURI | 解码先前由 encodeURI 或类似例程创建的统一资源标识符 (URI) |
decodeURIComponent | 解码先前由 encodeURIComponent 或类似例程创建的统一资源标识符 (URI) 组件 |
DOMException | 表示在 DOM 中发生的错误 |
encodeURI | 通过将某些字符的每个实例替换为一个、两个、三个或四个转义序列来编码统一资源标识符 (URI),这些转义序列表示该字符的 UTF-8 编码 |
encodeURIComponent | 通过将某些字符的每个实例替换为一个、两个、三个或四个转义序列来编码统一资源标识符 (URI) 组件,这些转义序列表示该字符的 UTF-8 编码 |
Error | 在尝试执行语句或访问属性时表示错误 |
EvalError | 表示关于全局函数 eval() 发生的错误 |
Float32Array | 表示 32 位浮点数的类型化数组 |
Float64Array | 表示一个 64 位浮点数的类型化数组 |
Function | 表示一个函数 |
Infinity | 表示数学上的无穷大值 |
Int8Array | 表示一个 8 位有符号整数的类型化数组 |
Int16Array | 表示一个 16 位有符号整数的类型化数组 |
Int32Array | 表示一个 32 位有符号整数的类型化数组 |
Intl | 提供访问国际化和本地化功能的方法 |
isFinite | 确定一个值是否为有限数 |
isNaN | 确定一个值是否为 NaN |
JSON | 提供将 JavaScript 值转换为 JSON 格式和从 JSON 格式转换回 JavaScript 值的功能 |
Map | 表示一个值的集合,其中每个值只能出现一次 |
Math | 提供访问数学函数和常量的方法 |
Number | 表示一个数值 |
Object | 表示所有 JavaScript 对象的基础对象 |
parseFloat | 解析字符串参数并返回一个浮点数 |
parseInt | 解析字符串参数并返回指定基数的整数 |
Promise | 表示异步操作的最终完成(或失败)及其结果值 |
Proxy | 表示一个用于定义基本操作(例如属性查找、赋值、枚举、函数调用等)自定义行为的对象 |
queueMicrotask | 将一个微任务排队等待执行 |
RangeError | 表示当一个值不在允许值的集合或范围内时发生的错误 |
ReferenceError | 表示引用不存在的变量时发生的错误 |
Reflect | 提供可拦截 JavaScript 操作的方法 |
RegExp | 表示正则表达式,允许你匹配字符组合 |
Set | 表示一个值的集合,其中每个值只能出现一次 |
setInterval | 重复调用一个函数,每次调用之间有固定的时间延迟 |
setTimeout | 在指定毫秒数后调用一个函数或计算一个表达式 |
SharedArrayBuffer | 表示通用的、固定长度的原始二进制数据缓冲区 |
String | 表示一系列字符 |
structuredClone | 创建值的深拷贝 |
Symbol | 表示一个唯一且不可变的数据类型,用作对象属性的键 |
SyntaxError | 表示尝试解释语法无效代码时发生的错误 |
TypeError | 表示当一个值不是预期类型时发生的错误 |
Uint8Array | 表示一个 8 位无符号整数的类型化数组 |
Uint8ClampedArray | 表示一个 8 位无符号整数的类型化数组,限制在 0-255 之间 |
Uint32Array | 表示一个 32 位无符号整数的类型化数组 |
URIError | 表示全局 URI 处理函数以错误方式使用时发生的错误 |
URL | 表示一个对象,提供用于创建对象 URL 的静态方法 |
URLPattern | 表示一个 URL 模式 |
URLSearchParams | 表示键值对的集合 |
WeakMap | 表示一个键值对的集合,其中键是弱引用的 |
WeakSet | 表示一个对象的集合,其中每个对象只能出现一次 |
WebAssembly | 提供对 WebAssembly 的访问 |
Next.js 特定 polyfills
环境变量
您可以使用 process.env
访问 环境变量,适用于 next dev
和 next build
。
不受支持的 API
Edge 运行时有一些限制,包括
- 原生 Node.js API **不受支持**。例如,您无法读取或写入文件系统。
node_modules
*可以* 使用,只要它们实现了 ES 模块并且不使用原生 Node.js API。- 直接调用
require
**不允许**。请改用 ES 模块。
以下 JavaScript 语言功能已禁用,并且**将无法工作**:
API | 描述 |
---|---|
eval | 评估表示为字符串的 JavaScript 代码 |
new Function(evalString) | 使用作为参数提供的代码创建一个新函数 |
WebAssembly.compile | 从缓冲区源编译 WebAssembly 模块 |
WebAssembly.instantiate | 从缓冲区源编译并实例化 WebAssembly 模块 |
在极少数情况下,您的代码可能包含(或导入)一些动态代码评估语句,这些语句*在运行时无法访问*,并且无法通过 tree-shaking 删除。您可以放宽检查以允许使用中间件配置的特定文件
middleware.ts
export const config = {
unstable_allowDynamic: [
// allows a single file
'/lib/utilities.js',
// use a glob to allow anything in the function-bind 3rd party module
'/node_modules/function-bind/**',
],
}
unstable_allowDynamic
是一个 glob,或一个 glob 的数组,忽略特定文件的动态代码评估。glob 相对于您的应用程序根文件夹。
请注意,如果这些语句在 Edge 上执行,*它们将抛出并导致运行时错误*。
这有帮助吗?