JSON والنصوص والتواريخ: اللغة اللي الـ backend بيتكلم بيها

أهلًا بيك. لما المتصفح يبعت للـ backend، أو الـ backend يرد، البيانات بتسافر كنص. والشكل المتفق عليه للنص ده اسمه JSON. JSON dot stringify: بتحوّل object لنص. JSON dot parse: بترجّع النص object. و stringify بـ null و two بتطبعه مترتب بمسافات، علشان القراية. نشغّل.

const user = { id: 7, name: "مُنى", tags: ["node"], active: true };

const text = JSON.stringify(user);
console.log(text, typeof text);

const back = JSON.parse(text);
console.log(back.name, typeof back);

console.log(JSON.stringify(user, null, 2));

$ node main.js
{"id":7,"name":"مُنى","tags":["node"],"active":true} string
مُنى object
{
  "id": 7,
  "name": "مُنى",
  "tags": [
    "node"
  ],
  "active": true
}

أول سطر: نص، والـ keys كلها بين double quotes، ودي قاعدة في JSON. parse رجّعته object وقرينا منه الاسم. وتحت الشكل المترتب. في كل درس Express قدام، الـ response هيتحوّل JSON بالشكل ده بالزبط. بس JSON ليها حدود، ولازم تعرفها. object فيه: تاريخ، و undefined، و function، ورقم كبير جدًّا من نوع BigInt. ونجرّب كمان parse على نص مش JSON صح: key من غير quotes، و single quotes. نشغّل.

// حاجات JSON ما بتعرفهاش
const odd = {
  when: new Date("2026-10-16T10:00:00Z"),
  nothing: undefined,
  fn: () => 1,
  big: 2n ** 64n,
};

try {
  console.log(JSON.stringify(odd));
} catch (err) {
  console.log("error:", err.message);
}
delete odd.big;
console.log(JSON.stringify(odd));

try {
  JSON.parse("{ name: 'mona' }");
} catch (err) {
  console.log("parse error:", err.name);
}

$ node main.js
error: Do not know how to serialize a BigInt
{"when":"2026-10-16T10:00:00.000Z"}
parse error: SyntaxError

stringify وقعت مع الـ BigInt: Do not know how to serialize a BigInt. بعد ما شلناه: التاريخ اتحوّل string بشكل ISO. و undefined والـ function اختفوا خالص، من غير أي error! و parse على النص الغلط رمت SyntaxError. يعني أي JSON جاي من برة لازم يتلف بـ try و catch، وإلا الـ server هيقع من request واحد بايز. النصوص. إيميل جاي من form فيه مسافات وحروف كبيرة. trim بتشيل المسافات من الأول والآخر. toLowerCase بتصغّر. ولو ما عملتش كده، نفس الشخص هيتسجل مرتين بإيميلين شكلهم مختلف. وبعدين includes و startsWith و split و padStart و replace. وآخر سطر مهم: طول اسم مُنى بالحروف، وبعدد الـ characters الحقيقية، وبالـ bytes. نشغّل.

const raw = "  [email protected]  ";
const email = raw.trim().toLowerCase();
console.log(`[${email}]`);

console.log(email.includes("@"), email.startsWith("mona"), email.split("@"));
console.log("ab".padStart(5, "0"), "order-7".replace("order-", ""));

const arabic = "مُنى";
console.log(arabic.length, [...arabic].length, Buffer.byteLength(arabic));

$ node main.js
[[email protected]]
true true [ 'mona', 'example.com' ]
000ab 7
4 4 8

الإيميل نضيف بين الـ square brackets اللي حطيناها، من غير مسافات. والأدوات طلعت زي ما متوقع. بس آخر سطر: length قالت أربعة، والـ spread كمان أربعة، مع إن الاسم تلات حروف! لأن الضمة على الميم بتتعد character لوحدها. و Buffer dot byteLength قالت تمانية، لأن كل حرف عربي في UTF eight بياخد اتنين bytes. وده مهم جدًّا لما تحط حد أقصى: الـ database بتحسب حروف، والشبكة بتحسب bytes. التواريخ. القاعدة الدهبية: خزّن وابعت دايمًا بالـ UTC، بشكل ISO، وحوّل للوقت المحلي عند العرض بس. toISOString بتطبع ISO. getTime بتطبع عدد الـ milliseconds من سنة ألف تسعمية وسبعين. بعد ساعتين: نضيف milliseconds. ونفس الوقت بالزبط بتوقيت القاهرة وطوكيو. نشغّل.

const d = new Date("2026-10-16T10:00:00Z");

console.log(d.toISOString());
console.log(d.getTime());

// بعد ساعتين
const later = new Date(d.getTime() + 2 * 60 * 60 * 1000);
console.log(later.toISOString());

// نفس اللحظة بتوقيت القاهرة وطوكيو
console.log(d.toLocaleString("en-GB", { timeZone: "Africa/Cairo" }));
console.log(d.toLocaleString("en-GB", { timeZone: "Asia/Tokyo" }));

$ node main.js
2026-10-16T10:00:00.000Z
1792144800000
2026-10-16T12:00:00.000Z
16/10/2026, 13:00:00
16/10/2026, 19:00:00

الـ Z في الآخر معناها UTC. الرقم الكبير ده هو نفس الوقت كرقم، وأسهل حاجة للحساب. بعد ساعتين: الساعة اتناشر. ونفس الوقت: في القاهرة الساعة واحدة الضهر، وفي طوكيو سبعة بالليل. وقت واحد، وساعات مختلفة. علشان كده الـ server ما يخزنش أبدًا وقت محلي. وفيه درس كامل للـ timezones قدام. التحدي: نضّف الـ body. function اسمها parseUser، بتعمل parse جُوّه try. لو بايز ترجّع null. تنضّف الإيميل. وتحسب تاريخ انتهاء بعد يوم كامل. الشروط وشكل الناتج بالزبط في الكومنت.

الحل. DAY فوق، constant بعدد الـ milliseconds في اليوم. parse جُوّه try، ولو فشل return null. الإيميل trim و toLowerCase. والتاريخ: Date من createdAt، و getTime زايد DAY، و toISOString في الرد. نشغّل.

// ده body جاي من الـ client كـ نص
const body = '{"email":"  [email protected] ","name":"عمر","createdAt":"2026-10-16T08:30:00Z"}';
const broken = '{"email": omar}';

const DAY = 24 * 60 * 60 * 1000;

function parseUser(text) {
  let data;
  try {
    data = JSON.parse(text);
  } catch {
    return null;
  }
  const email = data.email.trim().toLowerCase();
  const expiresAt = new Date(new Date(data.createdAt).getTime() + DAY);
  return { email, name: data.name, expiresAt: expiresAt.toISOString() };
}

console.log(parseUser(body));
console.log(parseUser(broken));

$ node main.js
{
  email: '[email protected]',
  name: 'عمر',
  expiresAt: '2026-10-17T08:30:00.000Z'
}
null

الأول نضيف وتاريخه بعد يوم بالزبط، والتاني null من غير ما البرنامج يقع. الدرس الجاي: الـ callbacks والـ closures، ودول الأساس لفهم Node كله.