جلب البيانات ومشروع قائمة المهام
في هذا الفصل الأخير تتصل صفحتك بالعالم الخارجي: تجلب بيانات من API، وتحفظ بيانات في المتصفح، ثم تجمع كل ما تعلمته في مشروعك الأول: قائمة مهام.
fetch و async/await
fetch يرسل طلبًا إلى عنوان ويعيد الرد. ولأن الرد يأخذ وقتًا، نستعمل async و await لننتظره بطريقة مقروءة:
async function loadUsers() {
try {
const response = await fetch("https://jsonplaceholder.typicode.com/users");
if (!response.ok) throw new Error(`خطأ ${response.status}`);
const users = await response.json();
console.log(users);
} catch (error) {
console.error("تعذّر جلب البيانات:", error.message);
}
}
loadUsers();
awaitلا تُستعمل إلا داخل دالة عليهاasync.tryوcatchيلتقطان الخطأ إذا انقطع الإنترنت أو رد الخادم بخطأ، فلا يتوقف البرنامج كله.- JSONPlaceholder خدمة مجانية تعطي بيانات تجريبية، ممتازة للتدرب.
قراءة JSON وعرضه في الصفحة
JSON صيغة نصية لتبادل البيانات تشبه كائنات JavaScript. response.json() يحوّلها إلى كائنات تستعملها مباشرة:
const list = document.querySelector("#users");
for (const user of users) {
const item = document.createElement("li");
item.textContent = `${user.name}: ${user.email}`;
list.append(item);
}
حفظ البيانات في localStorage
localStorage يحفظ نصوصًا في متصفح الزائر، وتبقى بعد إغلاق الصفحة. لحفظ مصفوفة أو كائن حوّله إلى نص بـ JSON.stringify ثم أعده بـ JSON.parse:
const tasks = [{ text: "تصميم الصفحة", done: false }];
localStorage.setItem("tasks", JSON.stringify(tasks));
const saved = JSON.parse(localStorage.getItem("tasks") ?? "[]");
لا تحفظ فيه كلمات مرور أو بيانات حساسة؛ أي كود يعمل في الصفحة يستطيع قراءته.
المشروع: قائمة مهام تضيف وتحذف وتحفظ
<form id="task-form">
<input id="task-input" placeholder="مهمة جديدة" required>
<button type="submit">أضف</button>
</form>
<ul id="task-list"></ul>
const form = document.querySelector("#task-form");
const input = document.querySelector("#task-input");
const list = document.querySelector("#task-list");
let tasks = JSON.parse(localStorage.getItem("tasks") ?? "[]");
function save() {
localStorage.setItem("tasks", JSON.stringify(tasks));
}
function render() {
list.innerHTML = ""; // تفريغ القائمة، ثم إعادة بنائها
tasks.forEach((task, index) => {
const item = document.createElement("li");
item.classList.toggle("done", task.done);
const text = document.createElement("span");
text.textContent = task.text;
text.addEventListener("click", () => {
tasks[index].done = !tasks[index].done;
save();
render();
});
const remove = document.createElement("button");
remove.textContent = "حذف";
remove.addEventListener("click", () => {
tasks = tasks.filter((_, i) => i !== index);
save();
render();
});
item.append(text, remove);
list.append(item);
});
}
form.addEventListener("submit", (event) => {
event.preventDefault();
const text = input.value.trim();
if (!text) return;
tasks.push({ text, done: false });
input.value = "";
save();
render();
});
render();
لاحظ النمط: البيانات في مصفوفة tasks، وكل تغيير يعدّل المصفوفة ثم يحفظها ثم يعيد رسم القائمة بـ render(). هذا النمط نفسه ستجده في React بشكل أكثر تنظيمًا.
مهمتك
طوّر قائمة المهام: أضف ثلاثة أزرار تصفية (الكل، المنجزة، الباقية)، وعدّادًا يعرض عدد المهام الباقية، وزرًا يحذف كل المهام المنجزة. ثم انشرها على Netlify وأضفها إلى معرض أعمالك.