useEffect وجلب البيانات
بعض الأعمال لا علاقة لها بالرسم: جلب بيانات من الخادم، أو حفظ شيء في localStorage، أو تشغيل مؤقت. هذه «تأثيرات جانبية»، ومكانها useEffect.
متى تستعمل useEffect
useEffect لمزامنة مكونك مع شيء خارج React: خادم، أو localStorage، أو document.title، أو مؤقت.
import { useEffect } from "react";
function PageTitle({ remaining }) {
useEffect(() => {
document.title = `(${remaining}) لوحة المهام`;
}, [remaining]);
return null;
}
المصفوفة في آخر useEffect هي «التبعيات»: يُعاد تنفيذ التأثير كلما تغيّرت قيمة فيها. مصفوفة فارغة [] تعني مرة واحدة عند ظهور المكون.
جلب البيانات وحالات التحميل والخطأ
import { useEffect, useState } from "react";
export function Users() {
const [users, setUsers] = useState([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState("");
useEffect(() => {
const controller = new AbortController();
fetch("https://jsonplaceholder.typicode.com/users", { signal: controller.signal })
.then((response) => {
if (!response.ok) throw new Error(`خطأ ${response.status}`);
return response.json();
})
.then((data) => setUsers(data))
.catch((err) => {
if (err.name !== "AbortError") setError("تعذّر تحميل المستخدمين");
})
.finally(() => setLoading(false));
return () => controller.abort();
}, []);
if (loading) return <p>جارٍ التحميل…</p>;
if (error) return <p role="alert">{error}</p>;
return (
<ul>
{users.map((user) => (
<li key={user.id}>{user.name}</li>
))}
</ul>
);
}
ثلاث حالات لكل جلب بيانات: تحميل، وخطأ، ونجاح. لا تنسَ أيًّا منها؛ المستخدم يجب أن يعرف دائمًا ما يحدث.
تنظيف التأثيرات
الدالة التي يعيدها التأثير (return () => controller.abort()) هي «التنظيف»: تُنفَّذ قبل إعادة التأثير، وعند اختفاء المكون. استعملها لإيقاف ما بدأته: إلغاء طلب، أو إيقاف مؤقت بـ clearInterval، أو إزالة مستمع حدث.
في وضع التطوير، تشغّل React كل تأثير مرتين عمدًا لتكشف التأثيرات التي تنقصها دالة تنظيف. لا تقلق إذا رأيت الطلب يُرسَل مرتين أثناء التطوير؛ هذا لا يحدث في النسخة المنشورة.
أخطاء شائعة
- حلقة لا تنتهي: تأثير يغيّر حالة موجودة في تبعياته فيعيد نفسه بلا نهاية.
- نسيان التبعيات: إذا استعملت متغيرًا داخل التأثير فأضفه إلى المصفوفة. إضافة ESLint التي تأتي مع Vite تنبّهك.
- تأثير لما لا يحتاج تأثيرًا: إذا كانت القيمة تُحسب من الحالة أو props (مثل عدد المهام الباقية)، احسبها مباشرة أثناء الرسم.
مهمتك
احفظ المهام في localStorage بـ useEffect كلما تغيرت، وحمّلها منه عند أول تشغيل (تلميح: useState(() => JSON.parse(localStorage.getItem("tasks") ?? "[]"))). ثم أضف صفحة صغيرة تعرض أسماء المستخدمين من JSONPlaceholder مع حالتي التحميل والخطأ.