Failed to load module script ترجمتها «فشل تحميل سكربت الوحدة»، ومعناها: المتصفح طلب ملف JavaScript عشان يرسم صفحتك، والسيرفر أرسل له صفحة HTML بداله، فرفض يشغّله. والنتيجة اللي يشوفها الكل: صفحة بيضاء فاضية.
الترجمة كلمة بكلمة
الرسالة كاملة طويلة، وهذي أجزاؤها:
| الرسالة | الترجمة | إيش تعني |
|---|---|---|
Failed to load module script | فشل تحميل سكربت الوحدة | ملف الكود الأساسي ما اشتغل |
Expected a JavaScript module script | كان المتوقع سكربت JavaScript | المتصفح طلب كود |
Expected a JavaScript-or-Wasm module script | نفس الجملة | صيغة نسخ Chrome الأحدث، نفس الخطأ |
the server responded with a MIME type of "text/html" | السيرفر رد بنوع ملف "text/html" | اللي وصل صفحة ويب، مو كود |
Strict MIME type checking is enforced | فحص نوع الملف صارم | المتصفح ملزم يرفضه، ما يتساهل |
«MIME type» يعني نوع الملف اللي يعلنه السيرفر مع كل رد.
وين تشوفها، وليش ما تطلع بالعربي
الصفحة نفسها بيضاء وما فيها أي رسالة. الخطأ يطلع في Console (اضغط F12)، بالإنجليزي حتى لو لغة Chrome عربي.
مشكلتك ولا مشكلة الموقع؟
- إذا أنت زائر: إذا عندك تبويب مفتوح من فترة، حدّث الصفحة مرة. إذا بقت بيضاء، المشكلة عند الموقع، وما فيه شي تسويه من جهازك.
- إذا الموقع موقعك: النشر نجح، لكن الاستضافة تقدّم الملفات غلط. السؤال الحقيقي: ليش رجع HTML لرابط ينتهي بـ .js؟ غالبًا الملف مو موجود، وقاعدة «رجّع index.html لأي رابط» مسكت الطلب ورجّعت الصفحة بداله. في معاينة Lovable أو Bolt ما تشوفه، يطلع لما تنقل المنتج لاستضافة ثانية.
إيش تكتب لـ Lovable أو Bolt أو Cursor
الحل السريع اللي تقترحه الأدوات: حذف type="module". الرسالة تختفي، ويطلع بدالها Unexpected token '<'، والصفحة باقية بيضاء. أعطها رابط الملف اللي رجع HTML (من تبويب Network) وانسخ هذا:
After deploying to <Vercel / Netlify / my server> the page is white.
Console: "Failed to load module script ... MIME type of "text/html"".
Network tab: <URL of the .js file> returns status <status> with HTML content.
Check the build output folder in the deploy settings, the Vite base setting,
and the rewrite rules. Do not remove type="module" from index.html.الحل خطوة بخطوة
كيف تعرف أي ملف رجع HTML، والأسباب الأربعة، والحل لكل واحد، في درس Failed to load module script: صفحة بيضاء بعد النشر، كيف تحلها؟. والخطأ القريب منه مع البيانات بدل الكود: Unexpected token '<' ... is not valid JSON.
وإذا موقعك أبيض الحين وعملاؤك ما يشوفون شي، حل مشاكل تطبيقك يبدأ بتشخيص مكتوب قبل أي تعديل.