إصلاح · Node وnpm والبناء

Unexpected token '<' in JSON (جاءتني صفحة ويب بدل البيانات)

ما قد تراه

يفشل fetch أو JSON.parse مع Unexpected token <
يقول "is not valid JSON"

السبب الأرجح

رد العنوان بصفحة HTML (غالباً خطأ أو صفحة دخول) بدل JSON، أو بلا شيء.

افحص أولاً (نحو دقيقتين)

افتح العنوان نفسه في تبويب: هل ترى JSON أم صفحة ويب؟
في تبويب الشبكة اقرأ رمز حالة ذلك الطلب.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

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

المشكلة
Unexpected token '<' in JSON (جاءتني صفحة ويب بدل البيانات)

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
رد العنوان بصفحة HTML (غالباً خطأ أو صفحة دخول) بدل JSON، أو بلا شيء.

نفّذ هذه الخطوات بهذا الترتيب
1. اعرض استدعاء fetch وعنوانه. تحقق أن العنوان صحيح (/api ناقصة أو نطاق خاطئ أو http مقابل https).
2. اقرأ الحالة الحقيقية والمحتوى أولاً (response.status وresponse.text()) قبل التحليل.
3. أصلح السبب (عنوان خاطئ أو 404 أو تحويل إلى تسجيل الدخول أو انهيار في المسار) وأضف رسالة خطأ واضحة للردود غير 200.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يرجع العنوان JSON بحالة 200 وتعرض الصفحة بياناتها.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تغلّف التحليل بـ try/catch فارغ.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

اعرض استدعاء fetch وعنوانه. تحقق أن العنوان صحيح (/api ناقصة أو نطاق خاطئ أو http مقابل https).
اقرأ الحالة الحقيقية والمحتوى أولاً (response.status وresponse.text()) قبل التحليل.
أصلح السبب (عنوان خاطئ أو 404 أو تحويل إلى تسجيل الدخول أو انهيار في المسار) وأضف رسالة خطأ واضحة للردود غير 200.

لا تفعل هذا

لا تخمّن: اقرأ محتوى الاستجابة.
لا تغلّف التحليل بـ try/catch فارغ.