Edge Runtime

Edge Runtime в Next.js основан на стандартных Web API и поддерживает следующие 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`	Предоставляет доступ к распространённым криптографическим примитивам: хешированию, подписи, шифрованию и дешифрованию

Веб-стандарты API

API	Описание
`AbortController`	Позволяет прерывать один или несколько DOM-запросов по необходимости
`Array`	Представляет массив значений
`ArrayBuffer`	Представляет буфер бинарных данных фиксированной длины
`Atomics`	Предоставляет атомарные операции в виде статических методов
`BigInt`	Представляет целое число произвольной точности
`BigInt64Array`	Представляет типизированный массив 64-битных знаковых целых чисел
`BigUint64Array`	Представляет типизированный массив 64-битных беззнаковых целых чисел
`Boolean`	Представляет логическую сущность и может иметь два значения: `true` и `false`
`clearInterval`	Отменяет повторяющееся действие, установленное вызовом `setInterval()`
`clearTimeout`	Отменяет отложенное действие, установленное вызовом `setTimeout()`
`console`	Предоставляет доступ к консоли отладки браузера
`DataView`	Представляет обобщённое представление `ArrayBuffer`
`Date`	Представляет момент времени в платформонезависимом формате
`decodeURI`	Декодирует URI, ранее созданный `encodeURI` или аналогичной функцией
`decodeURIComponent`	Декодирует компонент URI, ранее созданный `encodeURIComponent` или аналогичной функцией
`DOMException`	Представляет ошибку, возникающую в DOM
`encodeURI`	Кодирует URI, заменяя определённые символы escape-последовательностями UTF-8
`encodeURIComponent`	Кодирует компонент URI, заменяя определённые символы escape-последовательностями UTF-8
`Error`	Представляет ошибку при выполнении оператора или доступе к свойству
`EvalError`	Представляет ошибку, связанную с глобальной функцией `eval()`
`Float32Array`	Представляет типизированный массив 32-битных чисел с плавающей точкой
`Float64Array`	Представляет типизированный массив 64-битных чисел с плавающей точкой
`Function`	Представляет функцию
`Infinity`	Представляет математическое значение бесконечности
`Int8Array`	Представляет типизированный массив 8-битных знаковых целых чисел
`Int16Array`	Представляет типизированный массив 16-битных знаковых целых чисел
`Int32Array`	Представляет типизированный массив 32-битных знаковых целых чисел
`Intl`	Предоставляет функциональность для интернационализации и локализации
`isFinite`	Определяет, является ли значение конечным числом
`isNaN`	Определяет, является ли значение `NaN`
`JSON`	Предоставляет функциональность для преобразования значений JavaScript в формат JSON и обратно
`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

AsyncLocalStorage

Переменные окружения

Вы можете использовать process.env для доступа к Переменным окружения как в next dev, так и в next build.

Неподдерживаемые API

Среда выполнения Edge Runtime имеет некоторые ограничения, включая:

Нативные API Node.js не поддерживаются. Например, вы не можете читать или записывать файлы в файловую систему.
node_modules можно использовать, если они реализуют ES Modules и не используют нативные API Node.js.
Прямой вызов require запрещен. Вместо этого используйте ES Modules.

Следующие возможности JavaScript отключены и не будут работать:

API	Описание
`eval`	Выполняет JavaScript-код, представленный в виде строки
`new Function(evalString)`	Создает новую функцию с кодом, переданным в качестве аргумента
`WebAssembly.compile`	Компилирует модуль WebAssembly из буферного источника
`WebAssembly.instantiate`	Компилирует и инстанцирует модуль WebAssembly из буферного источника

В редких случаях ваш код может содержать (или импортировать) некоторые выражения динамической оценки кода, которые не могут быть достигнуты во время выполнения и не могут быть удалены с помощью tree-shaking.
Вы можете ослабить проверку, разрешив определенные файлы в конфигурации вашего Middleware или Edge API Route:

export const config = {
  runtime: 'edge', // только для Edge API Routes
  unstable_allowDynamic: [
    // разрешает один файл
    '/lib/utilities.js',
    // используйте glob для разрешения всего в стороннем модуле function-bind
    '**/node_modules/function-bind/**',
  ],
}

unstable_allowDynamic — это glob или массив glob-шаблонов, игнорирующих динамическую оценку кода для определенных файлов. Glob-шаблоны указываются относительно корневой папки вашего приложения.

Предупреждение: если эти выражения будут выполнены в Edge Runtime, они вызовут ошибку во время выполнения.

On this page