ليه Backend Developer محتاج JavaScript؟
هدفنا هنا مش تحويلك إلى 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».
الـ event loop في رسمة
let و const والأنواع الأساسية
const يمنع إعادة إسناد binding، لكنه لا يجعل object immutable. let يسمح بإعادة الإسناد. تجنب var في الكود الحديث بسبب function scope و hoisting وسلوك redeclaration الذي يسبب مفاجآت. استخدم const افتراضيًا، و let عندما القيمة ستتغير فعلًا.
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.
0.1 + 0.2; // 0.30000000000000004
const priceInCents = 1999;
const quantity = 3;
const totalInCents = priceInCents * quantity; // 5997typeof null ترجع "object" لأسباب تاريخية؛ افحص null صراحة. NaN من نوع number لكنه لا يساوي نفسه، واستخدم Number.isNaN. لا تعتمد على truthiness لتمييز «القيمة غير موجودة» من صفر أو false أو empty string؛ افحص الحالة المطلوبة بوضوح.
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 حماية.
Objects و Arrays وطرق التعامل مع البيانات
Objects و arrays تتعامل بال reference semantics: نسخ متغير object لا ينسخ البيانات نفسها، بل ينسخ reference. ده مهم جدًا عند تحديث state في واجهة reactive؛ mutation غير المقصودة قد تجعل التغيير غير ظاهر أو تؤثر في component آخر يشارك نفس object.
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); // GizaSpread syntax تعمل shallow copy فقط. لو محتاج deep clone لبيانات JSON-compatible، structuredClone مناسب في runtimes الحديثة، لكن لا يستخدم لنسخ functions أو DOM nodes أو كل أنواع objects المخصصة. الأفضل غالبًا تصميم data models immutable وتحديث المسار المتغير فقط.
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 الحديثة أو انسخ قبل الترتيب.
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 متكرر بالمفتاح.
const usersById = new Map(users.map(user => [user.id, user]));
const owner = usersById.get(order.ownerId);Functions و Arrow Functions و Scope و Closures
Functions في JavaScript values من الدرجة الأولى: تقدر تخزنها في variable، تمررها كـ callback، وترجعها من function أخرى. Function declaration لها hoisting behavior مختلف عن function expression. Arrow functions لها lexical this ولا تملك arguments الخاصة بها؛ لذلك لا تستبدل كل method بـ arrow بلا فهم، خصوصًا عند التعامل مع object methods أو event handlers.
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 غير مضبوط.
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 غير لازمة.
Destructuring و Spread و Modules و JSON
Destructuring تسحب properties أو array positions في variables. Default values تطبق على undefined، مش null. Rest يجمع الباقي. Modules تقسم البرنامج إلى files؛ export يحدد public API و import يستهلكه. تجنب circular dependencies بين modules لأنها تجعل initialization والسلوك أصعب في الفهم.
const order = {
id: "ORD-100",
total: 1250,
customer: { id: 7, name: "Mona" },
status: "Pending"
};
const {
id: orderId,
total,
customer: { name: customerName },
status = "Unknown"
} = order;// 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 نصي.
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;
}
}Promises و async/await و Event Loop
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.
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.
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 لا يستبدل نتيجة بحث أحدث.
Fetch API: استهلاك ASP.NET Core API بأمان
fetch لا تعتبر HTTP 400 أو 500 exception؛ هي ترجع Response عادي، لذلك لازم تفحص response.ok أو status. Promise ترفض عادة لأخطاء network/abort، وليس لكل non-2xx. كذلك قراءة body عملية asynchronous، والـ body stream لا يمكن استهلاكه مرتين بدون clone.
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.
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 تحتاج معالجة مختلفة.
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.
npm و package.json و Browser DevTools
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.
{
"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 مطابق؟
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.
جسر عملي بين JavaScript و ASP.NET Core
الـ 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.
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 لو العقد حساس أو متغير.
اختبر فهمك
هل const يجعل object immutable؟
ما الفرق بين Promise.all و Promise.allSettled؟
هل fetch يرمي exception عند HTTP 404؟
لماذا shallow copy لا تكفي دائمًا؟
لماذا client-side authorization غير كافٍ؟
ما فائدة lockfile؟
Event Loop و Microtasks: افهم ترتيب التنفيذ
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 جاهزًا في نفس الدورة.
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.
JavaScript Memory و Garbage Collection و Leaks
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 واضح.
Async JavaScript: Race Conditions و Cancellation و Stale Results
أكثر bug شائع في search UI: المستخدم يكتب ca ثم cat، لكن response الأولى تتأخر وتصل بعد الثانية فتستبدل النتيجة الأحدث. الحل ليس فقط debounce؛ تحتاج request identity أو cancellation. مع Fetch يمكن استخدام AbortController، ومع RxJS في Angular switchMap يعبّر عن latest-wins. في عمليات mutation لا تلغِ request لمجرد أن المستخدم انتقل؛ server قد يكون نفذها بالفعل.
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.
ES Modules و Module Boundaries
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.
Event Loop بعمق: Tasks و Microtasks و Rendering
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 متاحًا.
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.
API Client Checklist
اجعل 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.
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
مصادر تعليمية ومتقدمة — Third-party & advanced reading
خريطة التغطية: 16 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.