الوضع الوكيل: من اقتراح إلى تنفيذ

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

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

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

كيف يعمل؟

شكل 1، ثلاثة أوضاع، ثلاثة مخرجات مختلفة تمامًا

شكل 2، حلقة الوكيل: لاحظ أن السهم يعود إلى «الخطة» مرتين، عند رفضك وعند فشل الأمر

التمرين: دع الوكيل يبني، ثم اختبر اختباره

الطلب الذي كتبناه للوكيل كان جملة واحدة: «أنشئ مشروع نرد صغير فيه دالة ترجع رقمًا عشوائيًا من ١ إلى عدد الأوجه، مع اختبار وملف README». خلال ثوانٍ أنشأ ثلاثة ملفات. هذا أول ملف، وهو ممتاز:

// dice.js - a single die roll
function roll(sides) {
  if (!Number.isInteger(sides) || sides < 1) {
    throw new RangeError("sides must be a positive integer");
  }
  return Math.floor(Math.random() * sides) + 1;
}

module.exports = { roll };

ثم أنشأ ملفًا سمّاه «اختبارًا». وهنا المفاجأة:

// dice.test.js - what the agent called a test
const { roll } = require("./dice");

for (let i = 0; i < 5; i++) {
  console.log("roll(6) ->", roll(6));
}

$ node dice.test.js
roll(6) -> 6
roll(6) -> 2
roll(6) -> 4
roll(6) -> 4
roll(6) -> 6
$ echo $?
0

  // one character changed: floor -> round
- return Math.floor(Math.random() * sides) + 1;
+ return Math.round(Math.random() * sides) + 1;

$ node dice.test.js
roll(6) -> 2
roll(6) -> 2
roll(6) -> 7      <-- a seven, on a six-sided die
roll(6) -> 2
roll(6) -> 3
$ echo $?
0                 <-- still "success"

هنا الدرس كله في سطر: ملف يُشغَّل بنجاح ليس اختبارًا. الاختبار شيء يستطيع أن يفشل. هذا هو الاختبار الذي كتبناه بأنفسنا:

// dice.spec.js - a test that can actually fail
const assert = require("assert");
const { roll } = require("./dice");

check("every roll(6) is an integer in 1..6", () => {
  for (let i = 0; i < 10000; i++) {
    const v = roll(6);
    assert.ok(Number.isInteger(v), "not an integer: " + v);
    assert.ok(v >= 1 && v <= 6, "out of range: " + v);
  }
});

check("all six faces appear in 10000 rolls", () => {
  const seen = new Set();
  for (let i = 0; i < 10000; i++) seen.add(roll(6));
  assert.strictEqual(seen.size, 6, "faces seen: " + [...seen].sort().join(","));
});

check("roll(0) throws RangeError", () => {
  assert.throws(() => roll(0), RangeError);
});

$ node dice.spec.js            # healthy dice.js
PASS  every roll(6) is an integer in 1..6
PASS  all six faces appear in 10000 rolls
PASS  roll(1) is always 1
PASS  roll(0) throws RangeError
PASS  roll(2.5) throws RangeError
PASS  roll() with no argument throws RangeError

6/6 checks passed
$ echo $?
0

$ node dice.spec.js            # after floor -> round
FAIL  every roll(6) is an integer in 1..6 -> out of range: 7
FAIL  all six faces appear in 10000 rolls -> faces seen: 1,2,3,4,5,6,7
FAIL  roll(1) is always 1 -> Expected values to be strictly equal: 2 !== 1
PASS  roll(0) throws RangeError
PASS  roll(2.5) throws RangeError
PASS  roll() with no argument throws RangeError

3/6 checks passed
$ echo $?
1                 <-- a failure you cannot miss

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

جرّب بنفسك

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

تحقّق من فهمك