عقود الأخطاء والاختبارات ذات المعنى

function parseQuantity(text) {
  if (typeof text !== "string" || !/^\d+$/.test(text.trim())) {
    return { ok: false, error: "quantity format" };
  }
  const value = Number(text.trim());
  return Number.isSafeInteger(value) && value >= 1 && value <= 20
    ? { ok: true, value } : { ok: false, error: "quantity range" };
}
console.log(JSON.stringify(parseQuantity(" 3 ")));
console.log(JSON.stringify(parseQuantity("3x")));

{"ok":true,"value":3}
{"ok":false,"error":"quantity format"}

يمنع فحص الصيغة القبول الجزئي. ويفصل فحص المجال والصحة الآمنة عن الصياغة.

function assertEqual(actual, expected) {
  if (!Object.is(actual, expected)) throw new Error("assertion failed");
}
function double(value) {
  if (!Number.isFinite(value)) throw new TypeError("finite number required");
  return value * 2;
}
assertEqual(double(4), 8);
let rejected = false;
try { double("4"); } catch (error) { rejected = error instanceof TypeError; }
assertEqual(rejected, true);
console.log("2 checks passed");

2 checks passed

تراجع الثمانية المتوقعة مستقلاً، ولا تقبل الحالة السلبية إلا تصنيف TypeError المقصود.