الإكمال السطري والمحادثة

طريقان إلى نفس الفكرة

المتطلبات قبل البداية

المفاهيم الأساسية

هذان الوضعان هما ما ستستخدمه كل يوم. المهمة الثانية تجعلك تجرّبهما على كود واحد، وتحتها درس أعمق مما يبدو.

1الإكمال السطري: اقتراح صامت

تكتب، فيظهر نص رمادي باهت أمام المؤشر يكمل ما بدأته. تضغط Tab فيُقبل، أو تواصل الكتابة فيختفي. ليس فيه نقاش ولا تفسير، اقتراح صامت.

ما يجيده: الاستيرادات، هياكل الدوال، الحلقات المعتادة، الأسماء المتوقّعة. وما يخطئ فيه: أي شيء يعتمد على نيّتك أنت. النموذج يخمّن من النمط لا من الفهم.

2المحادثة: وضع الفهم

اللوحة الجانبية تختلف جوهريًا: هنا تسأل وتقرأ وتناقش. وهي ترى الملف المفتوح، فسؤالك «أعد كتابة هذه الدالة لتكون أسهل قراءة» له سياق.

والفرق العملي: الإكمال يكتب، والمحادثة تشرح. واستخدامك للمحادثة بسؤال «لماذا؟» بعد كل اقتراح هو ما يحوّل الأداة من مُنجِز إلى مُعلِّم.

3التمرين: الدالة المتداخلة

المشروع يعطيك هذه الدالة ويطلب منك أن تسأل المحادثة إعادة كتابتها «بلا تغيير ما تفعله». والعبارة الأخيرة هي بيت القصيد.

// snippet.js - a small function that needs cleanup
function checkUser(u) {
  if (u.age > 18) {
    if (u.subscribed == true) {
      if (u.country != "FR") {
        return true;
      } else {
        return false;
      }
    }
  }
  return false;
}

مشاكلها ظاهرة: ثلاثة مستويات تداخل، وelse { return false; } زائدة، وu لا يشرح نفسه. والنموذج سيقترح شيئًا قريبًا من هذا:

// what the AI typically suggests: flat, readable, named
function isEligible(user) {
  const isAdult = user.age > 18;
  const hasSubscription = Boolean(user.subscribed);
  const isOutsideFrance = user.country !== "FR";
  return isAdult && hasSubscription && isOutsideFrance;
}

أوضح بكثير: مسطّحة، والشروط لها أسماء، والمنطق في سطر واحد. لكن هل تفعل نفس الشي؟

4الاختبار الذي يكشف الفرق

على الحالات الطبيعية: نعم، متطابقة تمامًا.

$ node snippet.js
{"age":30,"subscribed":true,"country":"SA"} -> true | true same
{"age":30,"subscribed":true,"country":"FR"} -> false | false same
{"age":17,"subscribed":true,"country":"SA"} -> false | false same
{"age":30,"subscribed":false,"country":"SA"} -> false | false same
{"age":19,"subscribed":1,"country":"US"} -> true | true same
{"age":18,"subscribed":true,"country":"US"} -> false | false same
behaviour identical: true

وعلى حالات أغرب، وهي تحصل في بيانات حقيقية، لا:

$ node edge-cases.js
{"age":30,"subscribed":"yes","country":"SA"} checkUser: false | Boolean(): true DIFFERENT
{"age":30,"subscribed":2,"country":"SA"}     checkUser: false | Boolean(): true DIFFERENT
{"age":30,"subscribed":"1","country":"SA"}   checkUser: true  | Boolean(): true same

"yes" == true   ->  false
2 == true       ->  false
Boolean("yes")  ->  true
Boolean(2)      ->  true

السبب: x == true في جافاسكربت ليست «هل القيمة صادقة؟». إنها تحوّل الطرفين إلى أرقام، فـtrue تصير 1 و"yes" تصير NaN فلا يتساويان. بينما Boolean(x) تسأل «هل القيمة صادقة؟» فتقبل أي نص غير فارغ وأي رقم غير صفر.

5إعادة الكتابة الأمينة

لو كان المطلوب «بلا تغيير ما تفعله» حرفيًا، فالنسخة الصحيحة تحتفظ بالمقارنة كما هي:

// the faithful rewrite: same shape, same behaviour
function isEligible(user) {
  const isAdult = user.age > 18;
  const hasSubscription = user.subscribed == true;   // kept on purpose, not a typo
  const isOutsideFrance = user.country != "FR";
  return isAdult && hasSubscription && isOutsideFrance;
}

التعليق ليس زينة: بدونه سيأتي مَن «يصلح» == إلى === ويعيد الخطأ من جديد. الكود الغريب عمدًا يحتاج سطرًا يشرح لماذا.

كيف يعمل؟

شكلان: اختيار الوضع ومخاطره، ثم مقارنة سلوك النسختين على القيم نفسها.

شكل 5، متى تستخدم كل وضع، وأين تدخل الأخطاء: القبول بلا قراءة، والمضي بلا فهم.

شكل 6، نفس المدخلات على النسختين: تتفق على الحالات المعتادة وتفترق على القيم «الصادقة» التي ليست true.

ما المطلوب منك بالضبط

اعتقاد شائع × الحقيقة

جرّب بنفسك

بطاقات مراجعة سريعة

تحقّق من فهمك