فهم خطأ "تصدير رمز مميز غير متوقع" في ES6

عند محاولة استخدام كود ES6 داخل مشروع، قد تواجه خطأ "تصدير رمز مميز غير متوقع". ينشأ هذا الخطأ بسبب عدم التوافق بين دعم JavaScript في بيئتك وبناء جملة ES6.

سبب تصدير الرمز المميز غير المتوقع

قدم ES6 مفهوم وحدات EcmaScript (ESM) ، يُشار إليه بالكلمة الأساسية للتصدير. ومع ذلك، ستفسر البيئات التي لا تدعم ESM بناء الجملة هذا كرمز مميز غير متوقع. من الجدير بالذكر أن الإصدارات الأقدم من NodeJS (قبل الإصدار 14.13.0) تستخدم وحدات CommonJS، التي تستخدم بناء جملة الخاصية Module.exports. حتى في إصدارات NodeJS الأحدث التي تدعم ESM، يجب تمكينها بشكل صريح.

حلول لحل مشكلة تصدير الرموز غير المتوقعة

هناك طرق مختلفة لمعالجة هذه المشكلة:

• تمكين ESM في الإصدار 14.13.0 من NodeJS أو الأحدث: لتنشيط دعم ESM، قم بتعديل ملف package.json الخاص بمشروعك عن طريق تعيين "type": "module."
• إعادة البناء باستخدام بناء جملة وحدة CommonJS: بالنسبة لإصدارات NodeJS الأقدم، أعد كتابة التعليمات البرمجية الخاصة بك باستخدام بناء جملة وحدة CommonJS.
• استخدم TypeScript مع ts-node/ts-node-dev: من خلال استخدام TypeScript وحزم ts-node أو ts-node-dev npm، يمكنك تحويل ملفات TypeScript إلى تعليمات برمجية JavaScript متوافقة مع بيئتك.
• تحويل ESM إلى CommonJS باستخدام esbuild: استخدم حزمة esbuild لنقل كود ES6 الخاص بك إلى CommonJS JavaScript، مما يضمن التوافق مع بيئتك. (ملاحظة: لم يعد استخدام بابل موصى به.)