عرض مصدر Next.js/edge runtime

<noinclude>{{DISPLAYTITLE:المُشغل المتقدم Edge Runtime في Next.js }}</noinclude>
يعتمد المُشغل الآني المتقدم Edge Runtime في Next.js على واجهات الويب البرمجية Web API التي تُستخدم من قبل [[Next.js/middleware|البرمجيات الوسيطة]] أو [[Next.js/api routes|وجهات API المتقدمة]].

== الواجهة البرمجية للشبكة ==
*[https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener <code>addEventListener</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API <code>Fetch</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent <code>FetchEvent</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Headers <code>Headers</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Request <code>Request</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Response <code>Response</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams <code>URLSearchParams</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/FormData <code>FormData</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/File <code>File</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Blob <code>Blob</code>]
== الواجهة البرمجية للتشفير ==
*[https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder <code>TextDecoder</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/TextEncoder <code>TextEncoder</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WindowBase64/atob <code>atob</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WindowBase64/btoa <code>btoa</code>]
== الواجهة البرمجية لنقل البيانات عبر ويب ==
*[https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream <code>ReadableStream</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamBYOBReader <code>ReadableStreamBYOBReader</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader <code>ReadableStreamDefaultReader</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/TransformStream <code>TransformStream</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WritableStream <code>WritableStream</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultWriter <code>WritableStreamDefaultWriter</code>]
== واجهة ويب البرمجية Crypto ==
*[https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API <code>crypto</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/CryptoKey <code>CryptoKey</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto <code>SubtleCrypto</code>]
== واجهة ويب البرمجية المعيارية ==
*[https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm <code>structuredClone</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/URLPattern <code>URLPattern</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Cache <code>Web Cache</code>]
== أساسيات المحرّك V8 ==
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array <code>Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer <code>ArrayBuffer</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics <code>Atomics</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt <code>BigInt</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt64Array <code>BigInt64Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigUint64Array <code>BigUint64Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean <code>Boolean</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/clearInterval <code>clearInterval</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/clearTimeout <code>clearTimeout</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/Console <code>console</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView <code>DataView</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date <code>Date</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURI <code>decodeURI</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent <code>decodeURIComponent</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURI <code>encodeURI</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent <code>encodeURIComponent</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error <code>Error</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError <code>EvalError</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array <code>Float32Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float64Array <code>Float64Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function <code>Function</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Infinity <code>Infinity</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Int8Array <code>Int8Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Int16Array <code>Int16Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Int32Array <code>Int32Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl <code>Intl</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/isFinite <code>isFinite</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/isNaN <code>isNaN</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON <code>JSON</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map <code>Map</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math <code>Math</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number <code>Number</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object <code>Object</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseFloat <code>parseFloat</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseInt <code>parseInt</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise <code>Promise</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy <code>Proxy</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError <code>RangeError</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError <code>ReferenceError</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect <code>Reflect</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp <code>RegExp</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set <code>Set</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/setInterval <code>setInterval</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/WindowTimers/setTimeout <code>setTimeout</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer <code>SharedArrayBuffer</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String <code>String</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol <code>Symbol</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError <code>SyntaxError</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder <code>TextDecoder</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/TextEncoder <code>TextEncoder</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError <code>TypeError</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array <code>Uint8Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray <code>Uint8ClampedArray</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array <code>Uint16Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array <code>Uint32Array</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError <code>URIError</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/URL <code>URL</code>]
*[https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams <code>URLSearchParams</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap <code>WeakMap</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet <code>WeakSet</code>]
*[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly <code>WebAssembly</code>]
== متغيرات البيئة ==
بإمكانك استخدام الملف <code>process.env</code> للوصول إلى [[Next.js/environment variables|متغيرات البيئة]] عبر <code>next dev</code> و <code>next build</code>. إنّ تنفيذ التعليمة <code>console.log</code> على <code>process.env</code> لن يعرض جميع متغيرات البيئة، وعليك ان تصل إلى المتغيرات مباشرة كالتالي:<syntaxhighlight lang="javascript">
console.log(process.env)
// { NEXT_RUNTIME: 'edge' }
console.log(process.env.TEST_VARIABLE)
// { NEXT_RUNTIME: 'edge', TEST_VARIABLE: 'value' }
</syntaxhighlight>

== الواجهات البرمجية غير المدعومة ==

* لا تُدعم الواجهة البرمجية الأصلية لبيئة Node.js، فلن تتمكن من القراءة أو الكتابة إلى نظام الملفات.
* يمكن استخدام <code>node_modules</code> طالما أنها تُنجز باستخدام وحدات ES ولا تستخدم واجهة Node.js البرمجية الأصلية.
* لا يُسمح باستدعاء <code>require</code> مباشرة، لا بد من استخدام وحدات ES بدلًا منه.
* عُطلت ميزات لغة JavaScript التالية:
**<code>eval</code>: تقييم شيفرة JavaScript المُمثَّلة كنص.
** <code>new Function(evalString)</code>: إنشاء دالة جديدة من خلال شيفرة قُدمّت كوسيط argument.
** <code>WebAssembly.compile</code>
** <code>WebAssembly.instantiate</code> مع [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/instantiate#primary_overload_%E2%80%94_taking_wasm_binary_code معامل مخزن مؤقت buffer].
قد تحوي شيفرتك في حالات نادرة تعليمات تقييم ديناميكية لا يمكن الوصول إليها وقت التنفيذ ولا يمكن حذفها أثناء عملية treeshaking ويمكنك تسهيل التحقق بالسماح بملفات محددة مع الضبط المُصدَّر مع البرمجيات الوسيطة Middleware أو وجهة الواجهة البرمجية المتقدمة Edge API Route:<syntaxhighlight lang="javascript">
export const config = {
  runtime: 'edge', // for Edge API Routes only
  unstable_allowDynamic: [
    '/lib/utilities.js', // allows a single file
    '/node_modules/function-bind/**', // use a glob to allow anything in the function-bind 3rd party module
  ],
}
</syntaxhighlight><code>unstable_allowDynamic</code> هو من نوع [https://github.com/micromatch/micromatch#matching-features glop] أو مصفوفة من أنواع glop يؤدي إلى تجاهل تقييم الشيفرة الديناميكية لملفات محددة ويكون نسبةً إلى المجلد الجذر لتطبيقك.

انتبه، إذ إن نُفِّذت هذه التعليمات في المُشغل المتقدم Edge فتتسبب بخطأ وقت التنفيذ. 

== المصادر ==

* الصفحة [https://nextjs.org/docs/api-reference/edge-runtime Edge Runtime] من توثيق Next.js الرسمي.