عقود الواجهات والتحقق من المدخلات

function parseCreate(bytes) {
  if (bytes.length > 128) throw new Error('413 body too large');
  let value;
  try { value = JSON.parse(bytes.toString('utf8')); }
  catch { throw new Error('400 malformed JSON'); }
  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('422 expected object');
  if (Object.keys(value).some(key => key !== 'name')) throw new Error('422 unknown field');
  if (typeof value.name !== 'string' || value.name.trim().length < 1 || value.name.trim().length > 40) throw new Error('422 invalid name');
  return { name: value.name.trim() };
}
console.log(JSON.stringify(parseCreate(Buffer.from('{"name":"  Ada  "}'))));
try { parseCreate(Buffer.from('{"name":"Ada","admin":true}')); }
catch (error) { console.log(error.message); }

{"name":"Ada"}
422 unknown field

لا يعبر الحد إلا الحقل المسموح بعد تطبيعه. يستقبل المحلل مخزنا مكتملا محدودا، ولا يجمع جسم الطلب من الشبكة.

function pageLimit(target) {
  const url = new URL(target, 'http://local');
  const values = url.searchParams.getAll('limit');
  if (values.length === 0) return { limit: 20 };
  if (values.length !== 1 || !/^\d+$/.test(values[0])) return { error: 'invalid_limit' };
  const limit = Number(values[0]);
  return Number.isInteger(limit) && limit >= 1 && limit <= 100 ? { limit } : { error: 'invalid_limit' };
}
console.log(JSON.stringify(pageLimit('/items?limit=25')));
console.log(JSON.stringify(pageLimit('/items?limit=1&limit=2')));

{"limit":25}
{"error":"invalid_limit"}

تُرفض المعاملات المكررة عمدا لمنع اختلاف تفسير الوكيل والتطبيق.