تجنّب تعارض المعرِّفات

العَرَض

يكتمل البناء دون مشكلات، لكن المتصفح يرمي خطأً أثناء التحليل، قبل أن يبدأ التطبيق:

لمعرفة عدد الأجزاء التي تصرّح بالاسم الوارد في الخطأ، عُدّ الملفات التي تحتوي على تصريح به:

يسرد -l كل ملف مطابق مرة واحدة، ويطابق -w الكلمات الكاملة فقط، فلا يُحتسب vmdX. وقد استُبعد var لأن تكرار تصريح var ليس خطأً في حد ذاته. والنتيجة الأكبر من 1 تعني أن الاسم مُصرَّح به في أكثر من جزء. استبدل vmd بالاسم الوارد في رسالة الخطأ لديك.

لا يكون لتعارض المعرِّفات أثر إلا عندما تتشارك التصريحات النطاق نفسه. فتكرار الاسم نفسه في وحدات أو دوال مغلقة منفصلة ليس دليلًا على وجود تعارض؛ أما خطأ التحليل أعلاه فهو الدليل.

لماذا يحدث ذلك

تستخدم إعدادات VM المسبقة مولِّد أسماء المعرِّفات mangled-shuffled. فهو يمرّ على أبجدية صغيرة بترتيب مخلوط، وفي تشويش VM يحصل كل متغير عام أُعيدت تسميته على البادئة vm (القيمة الافتراضية لـ identifiersPrefix). ويُخزَّن الترتيب المخلوط مؤقتًا لكل عملية، لذا فإن الملفات المشوَّشة في العملية نفسها، أو بقيمة seed ثابتة نفسها، تستمد أسماءها من التسلسل نفسه، فيحمل أول متغير عام في كل ملف الاسم نفسه، والثاني اسمًا مشتركًا آخر، وهكذا.

يُشوَّش كل ملف على حدة، ويبدأ المولِّد من أول تسلسله من جديد لكل ملف. وعندما ينتهي ملفان في النطاق نفسه، تتعارض الأسماء. فيقع تصريحان const vmd = … في المستوى الأعلى ضمن النطاق نفسه، ويرفض المحلِّل التصريح الثاني.

الخيارات التي تُدخل مزيدًا من المعرِّفات في المستوى الأعلى تزيد احتمالات وصول ملفين إلى الاسم المولَّد نفسه. وvmWrapTopLevelInitializers أحدها، وكل إعدادات VM المسبقة تفعّله أصلًا؛ أما خيارات مثل vmDynamicOpcodes أو vmBytecodeEncoding فتضيف المزيد.

الحلول

يُفضَّل التحزيم أولًا، ثم تشويش الحزمة مرة واحدة. وإذا شوّشت الملفات منفصلةً وكانت السكربتات تتشارك نطاقًا عامًا واحدًا، فاختر أحد الحلول التالية:

• فعّل randomIdentifiersPrefix (موصى به)

  تحصل كل عملية تشويش على بادئة عشوائية تُضاف إلى بداية كل معرِّف عام (وفي تشويش VM تحلّ محل البادئة الافتراضية vm). فلا تعود الأسماء من الملفات المختلفة تتشارك نطاق أسماء واحدًا، وتختفي التعارضات دون أن تضطر إلى تنسيق البادئات يدويًا.

• اضبط identifiersPrefix فريدًا لكل ملف

  مرِّر يدويًا بادئة مختلفة عند تشويش كل ملف (مثل identifiersPrefix: 'auth_' لملف، وcheckout_ لآخر). هذا فعّال، لكنه عرضة للأخطاء إذا كانت لديك ملفات كثيرة، لذا يُفضَّل الخيار العشوائي أعلاه.

  JavaScript

• بدّل identifierNamesGenerator إلى hexadecimal

  تستخدم الأسماء الست عشرية فضاء مفاتيح أكبر بكثير، فيقلّ كثيرًا احتمال أن يُنتج ملفان المعرِّف نفسه، لكن التفرّد غير مضمون. المقابل: المعرِّفات أطول من ناتج mangled-shuffled، فتصبح الحزمة أكبر قليلًا.

• استخدم واجهة الدفعات متعددة الملفات، أو تحقّق من إضافة المجمِّع لديك

  تضيف لوحة التحكم بادئة مميزة لكل ملف عند استخدام تشويش الدفعات متعددة الملفات، وهو متاح في الخطط المدفوعة. وإذا كنت تستخدم إضافة للمجمِّع، فتحقّق من سلوكها بدلًا من افتراض أنها تفعل الشيء نفسه. وإذا كنت تربط التشويش يدويًا عبر واجهة npm البرمجية، فعليك تفعيل البادئة بنفسك.

للتحقق من الإصلاح، أعد البناء وأعد تحميل التطبيق المُجمَّع وتأكّد من اختفاء SyntaxError. يجب ألا يعود الاسم الوارد في رسالة الخطأ القديمة مُصرَّحًا به في أكثر من جزء؛ فالبادئة تغيّر كل اسم مولَّد، لذا فإن أمر grep أعلاه لا يخبرك إلا عن ذلك الاسم بعينه، لا عن الأسماء الجديدة.

خيارات ذات صلة

• randomIdentifiersPrefix: بادئة عشوائية لكل بناء (موصى به)
• identifiersPrefix: نص بادئة صريح
• identifierNamesGenerator: شكل الأسماء (mangled وhexadecimal و…)