Unexpected token '<' ترجمتها الحرفية «رمز غير متوقع: <»، و is not valid JSON يعني «مو JSON صالح». المعنى كامل: الكود طلب بيانات وكان ينتظر JSON، ووصلته صفحة HTML بدالها. والحرف < هو أول حرف في <!DOCTYPE html>، بداية أي صفحة ويب.
الترجمة كلمة بكلمة
| الرسالة | الترجمة | إيش تعني |
|---|---|---|
SyntaxError | خطأ في الصياغة | الكود حاول يقرأ نص بصيغة معيّنة وما قدر |
Unexpected token '<' | رمز غير متوقع: < | أول حرف في الرد كان < بدل { أو [ |
"<!DOCTYPE "... is not valid JSON | «<!DOCTYPE» مو JSON صالح | الرد صفحة HTML، مو بيانات |
JSON.parse: unexpected character at line 1 column 1 | حرف غير متوقع في السطر 1، العمود 1 | نفس الخطأ، بس في Firefox |
وين تشوفها، وليش ما تطلع بالعربي
تطلع في Console (اضغط F12) لما صفحة في منتجك ما تعرض بياناتها. وحتى لو لغة Chrome عربي، بتشوفها بالإنجليزي، لأنها رسالة من JavaScript، والمتصفح ما يترجم رسائل JavaScript.
الرسالة نفسها عرَض، مو سبب. هي تقول إن الرد غلط، وما تقول ليش. الجواب في الصفحة اللي رجعت بدل البيانات.
مشكلتك ولا مشكلة الموقع؟
- إذا أنت زائر: المشكلة في الموقع، مو في جهازك. الصفحة ممكن تطلع فاضية أو ناقصة. جرّب بعد شوي، أو بلّغ صاحب الموقع.
- إذا الموقع موقعك: افتح F12 ثم Network، واختار الطلب اللي يجيب البيانات، وشوف تبويب Response. إذا فيه صفحة موقعك نفسه، أو صفحة 404 من الاستضافة، أو صفحة تسجيل دخول، كل وحدة تدلّك على سبب مختلف.
علامة سريعة: إذا الخطأ يطلع على الموقع المنشور فقط، وعلى جهازك كل شي تمام، السبب غالبًا إن الطلب صار يروح لموقعك بدل سيرفرك بعد النشر، أو إن رابط السيرفر ناقص في إعدادات النشر.
إيش تكتب لـ Lovable أو Bolt أو Cursor
أشهر اقتراح من الأدوات هنا إنها تلف الكود بـ try/catch وترجّع قائمة فاضية. الخطأ يختفي، وعميلك يشوف صفحة فاضية كأن ما عنده بيانات. أعطها الرد الحقيقي أول: رابط الطلب، ورقم الحالة، وأول سطرين من Response. بعدها انسخ هذا:
I get "SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON" on <page>.
Network tab: the request to <Request URL> returns status <status>,
and the response starts with: <first lines of the HTML>.
Explain why an HTML page comes back instead of JSON and fix that cause.
Do not wrap the call in try/catch to return empty data, and do not hide the error.الحل خطوة بخطوة
كيف تشوف الرد الحقيقي، والأسباب الخمسة الأشهر بعد النشر وعلامة كل واحد، في درس Unexpected token '<' ... is not valid JSON: إيش يعني؟. وإذا الطلب ما يوصل أصلًا ويطلع خطأ ثاني، شوف معنى Failed to fetch.
وإذا شفت الرد ومو واضح لك من وين جا، هذا النوع ينحل أسرع لما نتتبّع الطلب معك من المتصفح حتى السيرفر في استشارة تقنية.