Software Engineer Encyclopedia
0%
Domain 07 · Frontend Engineering with Angular · Topic 7.1

JavaScript للمطور اللي بيبني Frontend متصل بـ ASP.NET Core

JavaScript — Practical Foundations for API-Driven Frontends

من المتغيرات والأنواع والـ arrays والfunctions إلى closures وmodules وPromises وevent loop وfetch وDevTools وnpm؛ تركيز على قراءة وكتابة كود الواجهة الذي يستهلك .NET APIs.

  • Intermediate
  • ~16 min read
  • 17 sections
  • 23 code examples
  • 1 diagrams
  • 6 questions
  • Priority L2 · Essential
  • ECMAScript 2025+ · Node.js 22+ · Browser APIs

المتطلبات قبل ما تبدأ

أساسيات البرمجة. الـ backend مش شرط لكن بيفيد في جزء الـ HTTP.

مستوى التعمق المطلوب

BASICSFocus on reading and integrating frontend code rather than advanced frontend development.

01

ليه Backend Developer محتاج JavaScript؟

Read and integrate the browser side
Deep dive

هدفنا هنا مش تحويلك إلى Frontend specialist؛ الهدف إنك تفهم اللغة اللي بتشتغل داخل browser وتقدر تقرأ Angular code وتكتب integration نظيف مع ASP.NET Core API. المتصفح بيشغّل JavaScript في بيئة مختلفة عن ‎.NET: عندك DOM، events، browser storage، Fetch API، event loop، وقيود أمنية زي Same-Origin Policy. نفس syntax تقريبًا قد يعمل في Node.js لكن APIs المتاحة مختلفة.

افصل بين ثلاثة أشياء: JavaScript language (types, functions, objects, promises)، وBrowser Web APIs (fetch, document, localStorage, AbortController)، وNode.js APIs/tooling (filesystem, npm scripts, build tools). fetch مش جزء من core language؛ هي Web API يوفرها browser وبيئات runtime حديثة. و document غير موجود في Node.js العادي.

خريطة الطلب المعتادة: Angular component يقرأ input → service ينادي API باستخدام HttpClient → response JSON يتحول إلى typed model في TypeScript → UI تتحدث. فهم JavaScript asynchronous behavior والـ object semantics يخليك تشخص مشاكل integration بدل ما تعتبرها «حاجة Frontend».

02

الـ event loop في رسمة

The JavaScript event loop
Basics
Call stackmain()handler()Microtask queuepromise.then, queueMicrotaskMacrotask queuesetTimeout, I/O, eventsRenderbetween tasks
Sync code runs to completion; then ALL microtasks (promises); then one macrotask (timers, I/O), و repeat
03

let و const والأنواع الأساسية

Bindings, primitives and reference values
Deep dive

const يمنع إعادة إسناد binding، لكنه لا يجعل object immutable. let يسمح بإعادة الإسناد. تجنب var في الكود الحديث بسبب function scope و hoisting وسلوك redeclaration الذي يسبب مفاجآت. استخدم const افتراضيًا، و let عندما القيمة ستتغير فعلًا.

JavaScriptBindings are not the same as object immutability
const customer = { id: 7, name: "Mona" };
customer.name = "Mona Ali"; // allowed: the object is mutable
// customer = {};           // TypeError: cannot reassign const

let page = 1;
page += 1;                   // allowed

const tags = ["api", "dotnet"];
tags.push("angular");       // allowed: array contents changed

الـ primitives تشمل string/number/boolean/bigint/symbol/undefined/null. الـ objects تشمل plain objects و arrays و functions و Date وغيرها. JavaScript number floating-point IEEE-754؛ لذلك لا تستخدمه مباشرة لحساب أموال بدقة decimal. خزن المبالغ بوحدة minor units كـ integer أو اعتمد decimal strategy متفق عليها مع الـ API.

JavaScriptFloating point and money
0.1 + 0.2; // 0.30000000000000004

const priceInCents = 1999;
const quantity = 3;
const totalInCents = priceInCents * quantity; // 5997

typeof null ترجع "object" لأسباب تاريخية؛ افحص null صراحة. NaN من نوع number لكنه لا يساوي نفسه، واستخدم Number.isNaN. لا تعتمد على truthiness لتمييز «القيمة غير موجودة» من صفر أو false أو empty string؛ افحص الحالة المطلوبة بوضوح.

JavaScriptSafe value checks
const response = { count: 0, enabled: false, note: "" };

if (response.count !== undefined && response.count !== null) {
  console.log(response.count); // 0 is a valid value
}

if (Number.isNaN(Number("not-a-number"))) {
  console.log("Input is not numeric");
}

في الـ API contracts، لا تفترض إن JSON يفرق بين missing و null بنفس معنى C#‎ nullable property. لازم تحدد هل الحقل required، وهل null مسموح، وهل default يطبق عند omission. استخدم validation في server ولا تعتبر client-side checks حماية.

04

Objects و Arrays وطرق التعامل مع البيانات

Reference semantics and non-mutating transformations
Deep dive

Objects و arrays تتعامل بال reference semantics: نسخ متغير object لا ينسخ البيانات نفسها، بل ينسخ reference. ده مهم جدًا عند تحديث state في واجهة reactive؛ mutation غير المقصودة قد تجعل التغيير غير ظاهر أو تؤثر في component آخر يشارك نفس object.

JavaScriptReference aliasing versus shallow copy
const original = { id: 1, profile: { city: "Alexandria" } };
const alias = original;
alias.profile.city = "Cairo";
console.log(original.profile.city); // Cairo

const copy = { ...original }; // shallow copy
copy.id = 2;
copy.profile.city = "Giza"; // nested object is still shared
console.log(original.profile.city); // Giza

Spread syntax تعمل shallow copy فقط. لو محتاج deep clone لبيانات JSON-compatible، structuredClone مناسب في runtimes الحديثة، لكن لا يستخدم لنسخ functions أو DOM nodes أو كل أنواع objects المخصصة. الأفضل غالبًا تصميم data models immutable وتحديث المسار المتغير فقط.

JavaScriptImmutable update of nested state
const state = {
  customer: { id: 7, address: { city: "Alexandria" } },
  loading: false
};

const nextState = {
  ...state,
  customer: {
    ...state.customer,
    address: { ...state.customer.address, city: "Cairo" }
  }
};

Array methods مهمة: map تحول كل عنصر، filter تختار subset، find ترجع أول match أو undefined، some/every لاختبار predicates، reduce للتجميع، sort لترتيب in-place، و slice لنسخة جزئية. انتبه أن sort يغير array الأصلية؛ استخدم toSorted في runtimes الحديثة أو انسخ قبل الترتيب.

JavaScriptTransform an API response without mutating it
const products = [
  { id: 1, name: "Keyboard", price: 1200, active: true },
  { id: 2, name: "Mouse", price: 500, active: false },
  { id: 3, name: "Monitor", price: 4200, active: true }
];

const view = products
  .filter(product => product.active)
  .toSorted((a, b) => a.price - b.price)
  .map(({ id, name, price }) => ({ id, label: name, price }));

Complexity matters: find/filter/map عادة O(n)، و sort غالبًا O(n log n). لو داخل loop بتعمل find على array أخرى، ممكن تتحول إلى O(n×m). ابني Map أو Set لو عندك lookup متكرر بالمفتاح.

JavaScriptReplace nested search with a Map
const usersById = new Map(users.map(user => [user.id, user]));
const owner = usersById.get(order.ownerId);
05

Functions و Arrow Functions و Scope و Closures

Behavior as values and captured lexical state
Deep dive

Functions في JavaScript values من الدرجة الأولى: تقدر تخزنها في variable، تمررها كـ callback، وترجعها من function أخرى. Function declaration لها hoisting behavior مختلف عن function expression. Arrow functions لها lexical this ولا تملك arguments الخاصة بها؛ لذلك لا تستبدل كل method بـ arrow بلا فهم، خصوصًا عند التعامل مع object methods أو event handlers.

JavaScriptFunction forms and lexical this
function add(a, b) { return a + b; }
const multiply = (a, b) => a * b;

const timer = {
  seconds: 0,
  start() {
    setInterval(() => {
      this.seconds += 1; // arrow captures `this` from start()
    }, 1000);
  }
};

Scope يحدد أين الاسم متاح. let و const block-scoped، أما var function-scoped. Closure تحصل عندما function تحتفظ بإمكانية الوصول إلى lexical environment حتى بعد انتهاء outer function. ده أساس factories، callbacks، و private state، لكنه ممكن يحتفظ بمراجع كبيرة في الذاكرة لو lifetime غير مضبوط.

JavaScriptClosure for a small private counter
function createCounter() {
  let value = 0;
  return {
    next() { value += 1; return value; },
    current() { return value; }
  };
}

const counter = createCounter();
console.log(counter.next());    // 1
console.log(counter.next());    // 2
console.log(counter.current()); // 2

مشكلة شائعة: callback داخل loop مع var يقرأ نفس binding بعد انتهاء loop؛ let ينشئ binding لكل iteration. في Angular غالبًا هتستخدم arrow callbacks، لكن لازم تفهم closure عشان ما تحتفظش بـ stale state أو references غير لازمة.

06

Destructuring و Spread و Modules و JSON

Shape data and separate code safely
Practical

Destructuring تسحب properties أو array positions في variables. Default values تطبق على undefined، مش null. Rest يجمع الباقي. Modules تقسم البرنامج إلى files؛ export يحدد public API و import يستهلكه. تجنب circular dependencies بين modules لأنها تجعل initialization والسلوك أصعب في الفهم.

JavaScriptDestructure an API DTO
const order = {
  id: "ORD-100",
  total: 1250,
  customer: { id: 7, name: "Mona" },
  status: "Pending"
};

const {
  id: orderId,
  total,
  customer: { name: customerName },
  status = "Unknown"
} = order;
JavaScriptES modules
// money.js
export function formatMoney(amount, currency = "EGP") {
  return new Intl.NumberFormat("en-EG", {
    style: "currency", currency
  }).format(amount);
}

// order-view.js
import { formatMoney } from "./money.js";
console.log(formatMoney(1250));

JSON صيغة نقل بيانات وليست JavaScript object literal. JSON.stringify لا يحفظ functions أو undefined object properties، و Date يتحول إلى string عبر toJSON. JSON.parse قد يرمي SyntaxError؛ تعامل مع input غير الموثوق على أنه غير صالح. لا تستخدم eval لتحويل JSON أو تنفيذ response نصي.

JavaScriptValidate JSON parsing
function tryParseJson(text) {
  try {
    return { ok: true, value: JSON.parse(text) };
  } catch (error) {
    if (error instanceof SyntaxError) {
      return { ok: false, reason: "Malformed JSON" };
    }
    throw error;
  }
}
07

Promises و async/await و Event Loop

Asynchronous work without blocking the UI
Deep dive

JavaScript في browser غالبًا ينفذ synchronous code على main thread؛ لو شغلت computation طويلة، الواجهة تتجمد لأن rendering و input events تنتظر. Async I/O لا يعني أن كل شيء يعمل في thread منفصل؛ runtime يدير عمليات الشبكة والجدولة ثم يضع callbacks لاستكمال التنفيذ. Web Workers مناسبة لبعض CPU-heavy work، لكنها لا تشارك DOM مباشرة.

Promise تمثل نتيجة مستقبلية: pending ثم fulfilled أو rejected. then و catch و finally تنشئ promise chain جديدة. async function ترجع Promise دائمًا؛ await يوقف continuation الخاصة بالـ async function حتى settle، لكنه لا يحجب main thread. الأخطاء تنتقل كـ rejected promise ويمكن التقاطها بـ try/catch حول await.

JavaScriptSequential versus parallel requests
async function loadDashboard() {
  const [profileResponse, ordersResponse] = await Promise.all([
    fetch("/api/profile"),
    fetch("/api/orders")
  ]);

  if (!profileResponse.ok || !ordersResponse.ok) {
    throw new Error("Dashboard request failed");
  }

  return {
    profile: await profileResponse.json(),
    orders: await ordersResponse.json()
  };
}

Promise.all يرفض بمجرد أول rejection لكنه لا يلغي تلقائيًا باقي العمليات. استخدم Promise.allSettled لو كل نتيجة مستقلة وتريد تقرير نجاح/فشل لكل واحدة. لا تعمل await داخل loop لو العمليات مستقلة ويمكن تنفيذها بالتوازي؛ لكن ضع concurrency limit لو عدد الطلبات كبير حتى لا تغرق server أو browser connections.

JavaScriptEvent loop: synchronous, microtask, timer
console.log("A");
setTimeout(() => console.log("timer"), 0);
Promise.resolve().then(() => console.log("promise"));
console.log("B");
// A, B, promise, timer

بعد انتهاء current task، event loop ينفذ microtasks مثل Promise reactions قبل الانتقال غالبًا إلى task لاحقة مثل timer. setTimeout(fn, 0) لا يعني «نفّذ الآن»؛ يعني eligible بعد delay minimum والجدولة. لا تعتمد على ترتيب دقيق بين APIs غير محدد رسميًا.

Unhandled promise rejection خطأ حقيقي؛ لا تترك void someAsyncCall() بلا error handling لمجرد إخفاء lint warning. في UI اعرض loading/error/empty/success states بوضوح، وتأكد أن stale response لا يستبدل نتيجة بحث أحدث.

08

Fetch API: استهلاك ASP.NET Core API بأمان

HTTP, status codes, JSON and cancellation
Deep dive

fetch لا تعتبر HTTP 400 أو 500 exception؛ هي ترجع Response عادي، لذلك لازم تفحص response.ok أو status. Promise ترفض عادة لأخطاء network/abort، وليس لكل non-2xx. كذلك قراءة body عملية asynchronous، والـ body stream لا يمكن استهلاكه مرتين بدون clone.

JavaScriptA small API client with explicit error handling
async function apiGet(path, { signal } = {}) {
  const response = await fetch(`/api${path}`, {
    method: "GET",
    headers: { Accept: "application/json" },
    credentials: "same-origin",
    signal
  });

  if (!response.ok) {
    const body = await response.json().catch(() => null);
    throw new ApiError(response.status, body);
  }

  if (response.status === 204) return null;
  return response.json();
}

class ApiError extends Error {
  constructor(status, body) {
    super(`API request failed with ${status}`);
    this.status = status;
    this.body = body;
  }
}

لو API تستخدم cookie authentication مع cross-origin request، تحتاج credentials: "include" مع CORS credentials policy مضبوط من السيرفر، و CSRF protection المناسبة. لا تضع access token أو refresh token في localStorage بشكل تلقائي؛ قرار تخزين tokens له threat model، و HttpOnly Secure SameSite cookies تقلل exposure أمام JavaScript لكن لا تلغي CSRF considerations. راجع درس JWT/CORS قبل تصميم auth flow.

AbortController يسمح بإلغاء request عند تغيير الصفحة أو بدء بحث جديد. الإلغاء لا يضمن أن server لم يبدأ processing؛ هو يوقف انتظار العميل/النقل حيثما أمكن. لذلك العمليات الحساسة تحتاج idempotency على الخادم ولا تعتمد على client abort كـ rollback.

JavaScriptCancel stale search request
let activeController;

async function searchOrders(term) {
  activeController?.abort();
  activeController = new AbortController();

  try {
    const response = await fetch(
      `/api/orders?search=${encodeURIComponent(term)}`,
      { signal: activeController.signal }
    );
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    return await response.json();
  } catch (error) {
    if (error.name === "AbortError") return null;
    throw error;
  }
}

استخدم URL و URLSearchParams بدل concatenation غير آمن لل query string. لا تثق في browser validation وحده، ولا تعرض raw exception أو stack trace للمستخدم. تعامل مع timeout، offline، unauthorized، forbidden، validation errors و server errors كحالات مختلفة.

Fetch API بعمق: HTTP Errors و Cancellation و JSON Contracts

Fetch Promise لا تعمل reject لمجرد أن السيرفر رجّع 404 أو 500؛ هي ترفض عادةً في network-level failures أو abort. لذلك لازم تفحص response.ok أو status بنفسك. كمان response body stream يستهلك مرة واحدة؛ لا تنادي json ثم text على نفس response. لا تفترض أن كل response JSON: 204 No Content وملفات download و HTML error pages تحتاج معالجة مختلفة.

JavaScriptA safe JSON request helper
async function getJson(url, { signal } = {}) {
  const response = await fetch(url, {
    headers: { Accept: "application/json" },
    signal,
  });
  if (response.status === 204) return null;
  const contentType = response.headers.get("content-type") ?? "";
  if (!response.ok) {
    const detail = contentType.includes("application/json")
      ? await response.json().catch(() => null)
      : await response.text().catch(() => "");
    throw new Error(`HTTP ${response.status}: ${String(detail).slice(0, 300)}`);
  }
  if (!contentType.includes("application/json")) {
    throw new TypeError("Expected a JSON response");
  }
  return response.json();
}

لا تعرض تفاصيل server exception للمستخدم؛ حوّل الأخطاء إلى UI message آمنة وسجل correlation ID عند الحاجة. استخدم AbortController لإلغاء search request قديم عندما يكتب المستخدم حرفًا جديدًا. الإلغاء لا يعني أن السيرفر لم ينفذ أي side effect؛ لا تعتمد على abort كـ transaction rollback.

Fetch API: HTTP Errors ليست Network Errors

fetch() يرفض Promise عند network failure أو abort غالبًا، لكنه لا يرفض لمجرد HTTP 404/500؛ لذلك افحص response.ok أو status صراحة. response.json() نفسها asynchronous وقد تفشل إذا body ليس JSON صالحًا. لا تفترض أن كل response لها body؛ 204 No Content حالة شائعة. ضع parsing و status handling في API client موحد بدل تكراره في كل component.

09

npm و package.json و Browser DevTools

Tooling, dependency hygiene and API debugging
Practical

npm package manager و registry ecosystem. package.json يعرّف metadata/scripts/dependencies، و lockfile مثل package-lock.json يثبت dependency graph الفعلي. npm install قد يحدث lockfile، بينما npm ci في CI يثبت بالاعتماد على lockfile ويزيل node_modules قبل التثبيت. لا ترفع node_modules إلى Git؛ ارفع manifest و lockfile.

JSONpackage.json essentials
{
  "name": "hotel-admin-ui",
  "private": true,
  "scripts": {
    "start": "ng serve",
    "build": "ng build",
    "test": "ng test"
  },
  "engines": { "node": ">=22" }
}

افحص dependency قبل تثبيتها: هل package maintained؟ هل لها transitive dependencies كثيرة؟ هل تطلب postinstall scripts؟ هل license مناسب؟ راقب advisories، استخدم lockfile، حدّث بانتظام، ولا تنفذ install scripts من package غير موثوقة. npm audit إشارة للمراجعة وليس ضمانًا أن التطبيق آمن.

في Chrome/Edge DevTools: Console للأخطاء، Network لعنوان request و method و status و headers و payload و timing، Application لل cookies/storage، Sources لل breakpoints، Performance لل main-thread bottlenecks. ابدأ من Network عندما UI لا تعرض بيانات API: هل request خرج؟ هل URL صحيح؟ هل preflight فشل؟ هل رجع 401/403/404/500؟ هل JSON shape مطابق؟

TextNetwork tab diagnostic checklist
1. Request URL and HTTP method
2. Request headers: Authorization / Content-Type / Origin
3. Status: 2xx, 3xx, 401, 403, 404, 409, 422, 429, 5xx
4. Response body and content type
5. Timing: DNS, connection, waiting, download
6. CORS preflight OPTIONS and response headers
7. Cookies: blocked? SameSite? Secure? Domain/Path?

لا تشارك HAR files أو screenshots قبل إزالة cookies و Authorization headers والبيانات الشخصية. DevTools قد يعرض tokens و PII. Debugging artifact نفسه يحتاج sanitization.

10

جسر عملي بين JavaScript و ASP.NET Core

The client contract is part of the system
Deep dive

الـ frontend لا يتعامل مع C#‎ entity مباشرة؛ هو يستهلك HTTP contract. لو endpoint ترجع PascalCase أو camelCase، راجع System.Text.Json configuration. لا تفترض إن enum representation أو DateTime timezone أو decimal precision متطابقين تلقائيًا. اتفق على ISO 8601 timestamps مع UTC semantics، وعلى error contract ثابت مثل Problem Details.

JavaScriptConsume a Problem Details response
async function createReservation(payload) {
  const response = await fetch("/api/reservations", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(payload)
  });

  if (response.status === 400 || response.status === 422) {
    const problem = await response.json();
    return { ok: false, validation: problem.errors ?? {} };
  }

  if (!response.ok) {
    throw new Error(`Unexpected HTTP ${response.status}`);
  }

  return { ok: true, value: await response.json() };
}

المتصفح untrusted client. المستخدم يقدر يغير JavaScript أو request payload من DevTools. authorization و ownership validation و business invariants لازم تتطبق server-side. إخفاء زر Delete ليس authorization. كذلك لا تعتبر TypeScript type ضمان runtime؛ response القادمة من network تحتاج runtime validation لو العقد حساس أو متغير.

11

اختبر فهمك

Knowledge check
Practical
هل const يجعل object immutable؟
لا؛ يمنع إعادة إسناد المتغير فقط، لكن properties/array items يمكن تعديلها ما لم تطبق immutability.
ما الفرق بين Promise.all و Promise.allSettled؟
الأول يرفض عند أول rejection؛ الثاني ينتظر كل النتائج ويعيد status لكل عملية.
هل fetch يرمي exception عند HTTP 404؟
لا؛ افحص response.ok أو status. الرفض يكون عادة network/abort errors.
لماذا shallow copy لا تكفي دائمًا؟
لأن nested objects تظل references مشتركة، فتعديلها قد يغير original state.
لماذا client-side authorization غير كافٍ؟
لأن المستخدم يستطيع تعديل client وإرسال HTTP requests مباشرة؛ الخادم هو مصدر قرار الوصول.
ما فائدة lockfile؟
تثبيت dependency graph والإصدارات المتعدية لضمان reproducible installs.
12

Event Loop و Microtasks: افهم ترتيب التنفيذ

Synchronous stack, microtask queue and task queue
Deep dive

JavaScript في browser غالبًا ينفذ JavaScript على main thread واحدة لكل realm، مع browser APIs تعمل خارج call stack. بعد انتهاء synchronous stack، تُفرّغ microtask queue مثل Promise callbacks قبل الانتقال إلى task تالية مثل timer/message event، مع تفاصيل scheduling يحددها host. لذلك setTimeout(fn, 0) لا يعني تنفيذًا فوريًا، و Promise.then غالبًا يسبق timer جاهزًا في نفس الدورة.

JavaScriptPredict the order
console.log("A");
setTimeout(() => console.log("timer"), 0);
Promise.resolve().then(() => console.log("promise"));
queueMicrotask(() => console.log("microtask"));
console.log("B");
// A, B, promise, microtask, timer

لو عندك loop ثقيلة، لا تتوقع أن Promise.resolve().then وحدها تجعل browser يرسم frame قبل استمرار العمل؛ microtask chain الطويلة قد تجوّع rendering. قسّم الحسابات، استخدم Web Worker للأعمال CPU-heavy، وراقب Performance panel. لا تستخدم setTimeout كحل عشوائي لكل race condition.

13

JavaScript Memory و Garbage Collection و Leaks

References, reachability and long-lived listeners
Deep dive

JavaScript values objects/arrays/functions تُدار بال references؛ عندما لا يعود object reachable من roots مثل global scope أو active stack أو closures أو DOM references، يصبح مرشحًا للـ garbage collection. لا تتحكم في توقيت GC. Memory leak يحدث عندما يحتفظ التطبيق بمرجع لم يعد يحتاجه: event listener لم يُزل، timer مستمر، cache بلا حد، closure تحتفظ بشجرة بيانات ضخمة، أو detached DOM node.

استخدم Chrome/Edge DevTools Memory snapshots و Allocation timeline للمقارنة قبل وبعد التفاعل. راقب retained size و retainers لا shallow size فقط. في SPA، route navigation المتكرر اختبار جيد لاكتشاف listeners/timers التي لا تُنظف. WeakMap مفيد للبيانات المرتبطة بعمر object دون منع جمعه، لكنه ليس بديلًا عن lifecycle واضح.

14

Async JavaScript: Race Conditions و Cancellation و Stale Results

Control overlapping asynchronous work
Deep dive

أكثر bug شائع في search UI: المستخدم يكتب ca ثم cat، لكن response الأولى تتأخر وتصل بعد الثانية فتستبدل النتيجة الأحدث. الحل ليس فقط debounce؛ تحتاج request identity أو cancellation. مع Fetch يمكن استخدام AbortController، ومع RxJS في Angular switchMap يعبّر عن latest-wins. في عمليات mutation لا تلغِ request لمجرد أن المستخدم انتقل؛ server قد يكون نفذها بالفعل.

JavaScriptAbort previous search request
let activeController;
async function search(query) {
  activeController?.abort();
  const controller = new AbortController();
  activeController = controller;
  try {
    const response = await fetch(`/api/search?q=${encodeURIComponent(query)}`, {
      signal: controller.signal
    });
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    return await response.json();
  } catch (error) {
    if (error.name === 'AbortError') return null;
    throw error;
  }
}

Promise لا تدعم cancellation بذاتها؛ الإلغاء يكون عبر API مثل AbortSignal أو عبر تجاهل النتيجة. تعامل مع abort كمسار متوقع، لا كـ server error. اختبر responses بترتيب عكسي، abort أثناء pending، component unmount، و network failure. لا تستخدم isMounted flag كحل عام إذا كان بالإمكان إلغاء subscription/request.

15

ES Modules و Module Boundaries

Organize browser code with explicit imports and exports
Deep dive

ES Modules تستخدم export و import، وكل module لها scope خاص و strict mode افتراضيًا. Static imports قابلة للتحليل وقت build وتساعد bundlers على tree-shaking، بينما dynamic import() مناسبة للتحميل عند الحاجة مثل route chunks. تجنب الاعتماد على global variables لأنها تخفي dependencies وتسبب collisions.

افصل pure business functions عن DOM/network adapters؛ pure function أسهل في الاختبار لأنها لا تعتمد على browser state. لا تجعل module تنفذ side effects كبيرة بمجرد import، لأن ذلك يصعّب الاختبار و lazy loading. راجع circular imports؛ قد تؤدي إلى partially initialized bindings أو runtime surprises.

16

Event Loop بعمق: Tasks و Microtasks و Rendering

Predict ordering across timers, promises and browser paint
Deep dive

Browser event loop لا يعني أن JavaScript لا يمكنها التسبب في concurrency bugs؛ هي غالبًا single-threaded execution للـ main thread لكن asynchronous operations تتداخل زمنيًا. بعد task مثل click handler، يتم تفريغ microtask queue (Promises/queueMicrotask) قبل rendering opportunity وفق event loop model. كثرة microtasks المتواصلة قد تؤخر paint وتسبب jank. setTimeout(fn, 0) لا يعني التنفيذ فورًا؛ هو scheduling task بعد الحد الأدنى المسموح وعندما يصبح event loop متاحًا.

JavaScriptObserve task and microtask order
console.log('A');
setTimeout(() => console.log('timer'), 0);
Promise.resolve().then(() => console.log('promise'));
queueMicrotask(() => console.log('microtask'));
console.log('B');
// Typical order: A, B, promise, microtask, timer

الـ rendering timing يتأثر بالمتصفح والـ frame budget، فلا تعتمد على ordering تفصيلي غير مضمون بين APIs. استخدم requestAnimationFrame لتحديثات مرتبطة بالرسم، و Web Workers للحسابات CPU-heavy، و requestIdleCallback للأعمال منخفضة الأولوية عند دعمه. لا تحجب main thread بتحليل JSON ضخم أو loops طويلة؛ قس Long Tasks.

17

API Client Checklist

Keep browser networking predictable
Practical

اجعل API client مسؤولًا عن base URL و headers و JSON parsing و status mapping و timeouts/cancellation. لا تكرر fetch logic في components، ولا تخلط retry مع business actions. تعامل مع 204 و401 و403 و409 و429 و5xx بشكل مختلف، واحتفظ بـ correlation ID لتتبع المشكلة بين browser و API.

↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

مصادر تعليمية ومتقدمة — Third-party & advanced reading

خريطة التغطية: 16 عنصر من الـ Roadmap ومكان شرحه في الدرس
Roadmaplet, const, and Variables§01
RoadmapPrimitive Types and Objects§01
RoadmapArrays and Array Methods§01
RoadmapFunctions and Arrow Functions§01
RoadmapScope and Closures Basics§01
RoadmapDestructuring and Spread Operator§01
RoadmapModules§01
RoadmapPromises§01
Roadmapasync / await§01
RoadmapEvent Loop Basics§01
RoadmapJSON§01
RoadmapFetch API§01
RoadmapError Handling§01
RoadmapBrowser Developer Tools§01
Suggestednpm / pnpm and package.json§01
SuggestedReading the browser Network tab to debug your API§01

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس