CodeKitHub
أدوات النصوص

فاحص الأقواس والقوسين

آخر تحديث:

الصق شيفرة أو نصًا، وستقوم هذه الأداة بفحص كل زوج من ( ) [ ] { }، مع الإبلاغ بدقة عن أي الأقواس غير مغلقة أو غير مفتوحة أو غير متطابقة — مع رقم السطر والعمود لكل مشكلة.

ما هي هذه الأداة؟

تفحص أداة فحص الأقواس النص حرفًا حرفًا، وتتتبع كل قوس فتح ( [ { في مكدس (stack) وتطابقه مع قوس الإغلاق التالي ) ] } الذي تصادفه. إذا لم يتطابق قوس الإغلاق مع آخر قوس فتح غير مغلق، أو إذا لم يُغلق قوس فتح أبدًا، أو إذا ظهر قوس إغلاق دون أن يبقى شيء لإغلاقه، يُصنّف ذلك كمشكلة مع موقعها الدقيق.

هذا فحص بسيط بالمسح، وليس محلل لغة كامل — يعمل بنفس الطريقة سواء كان المحتوى الملصق شيفرة JavaScript أو Python أو JSON أو مجرد نص عادي، مما يجعله مفيدًا في أي لغة أو تنسيق يستخدم الأقواس.

لماذا تستخدمها؟

  • يُبلغ عن السطر والعمود الدقيقين لكل قوس غير متطابق أو غير مطابق.
  • يعمل مع أي لغة أو نص — غير مقيد بصيغة نحوية معينة.
  • يميز بين ثلاثة أنواع من المشاكل: قوس فتح غير مغلق، قوس إغلاق غير متطابق، وعدم تطابق نوع القوس.
  • معالجة فورية ومحلية — لا يُرفع أي شيء.
  • مجانية، بدون تسجيل، بدون حد لحجم النص.

كيفية الاستخدام

  1. الصق شيفرتك أو نصك في مربع الإدخال.
  2. اضغط «فحص الأقواس».
  3. راجع قائمة المشاكل، كل منها مع رقم السطر والعمود الخاص بها، أو شاهد تأكيدًا بأن كل شيء متطابق.

مثال

الإدخال

function foo() {
  return [1, 2, (3];
}

الناتج

نوع قوس غير متطابق: ] في السطر 2، العمود 18؛ نوع قوس غير متطابق: } في السطر 3، العمود 1؛ قوس فتح غير مغلق: { في السطر 1، العمود 17

كان من المفترض أن يُغلق ] في السطر 2 القوس ( المفتوح في العمود 15، وليس [ السابق — وهذا بالضبط نوع الخطأ (قوس إغلاق من النوع الخاطئ) الذي يسهل تفويته بالعين في ملف طويل.

استخدامات شائعة

  • تصحيح خطأ «Unexpected token» أو «Unexpected end of input» في JavaScript أو JSON أو Python دون الحاجة لإعادة قراءة الملف بأكمله بعناية.
  • فحص مقطع JSON مكتوب يدويًا بحثًا عن قوس معقوف زائد أو ناقص قبل لصقه في ملف إعدادات.
  • التحقق من الأقواس المتداخلة في معادلة أو صيغة رياضية طويلة.
  • اكتشاف قوس عرضي متبقٍ من تعديل نسخ ولصق أثناء مراجعة الشيفرة.

الأسئلة الشائعة

هل تفحص هذه الأداة علامات الاقتباس أو الوسوم أيضًا، أم الأقواس فقط؟

أزواج الأقواس الثلاثة فقط: الأقواس ( )، والأقواس المربعة [ ]، والأقواس المعقوفة { }. لا يتم تتبع علامات الاقتباس أو وسوم HTML/XML.

ما الفرق بين أنواع المشاكل الثلاثة؟

«قوس فتح غير مغلق» يعني أن قوس فتح لم يُغلق أبدًا حتى نهاية النص. «قوس إغلاق غير متطابق» يعني أن قوس إغلاق ظهر دون قوس فتح مقابل قبله. «نوع قوس غير متطابق» يعني أن قوس إغلاق ظهر لكنه من النوع الخاطئ بالنسبة لآخر قوس تم فتحه — مثل إغلاق [ بـ ).

هل تفهم الأداة أن الأقواس داخل سلسلة نصية أو تعليق يجب ألا تُحتسب؟

لا — هذا مسح نصي بسيط، وليس محللاً واعيًا للغة، لذا فهو لا يعرف شيئًا عن السلاسل النصية الحرفية أو التعليقات. يُحتسب حرف القوس داخل سلسلة نصية بين علامتي اقتباس أو داخل تعليق أيضًا. للحصول على نتائج دقيقة تمامًا في ملفات المصدر الحقيقية، أزل السلاسل النصية/التعليقات أولاً أو استخدم ميزة مطابقة الأقواس الواعية بالصيغة النحوية المدمجة في محررك.

هل تُرفع شيفرتي إلى أي مكان؟

لا. يعمل الفحص كشيفرة JavaScript محلية داخل متصفحك؛ ولا يُرسل شيء إلى أي خادم.