دریافت صریح داده‌ها در React – کنترل درخواست‌های API با دکمه تأیید

در پیاده‌سازی اولیه، هر بار که کاربر در فیلد جستجو تایپ می‌کرد، درخواست جدیدی به API ارسال می‌شد. این مقاله نحوهٔ تغییر این رفتار به دریافت صریح داده‌ها را آموزش می‌دهد؛ به‌طوری‌که فقط با کلیک روی دکمهٔ تأیید، درخواست به API ارسال شود. با تعریف دو وضعیت مجزا برای searchTerm و url، و استفاده از useCallback و useEffect، کنترل کامل بر زمان ارسال درخواست فراهم می‌شود.

explicit fetchingsearchTermconfirmation buttonuseCallback

~2 min read · Updated Oct 24, 2025

مقدمه


در نسخه قبلی اپلیکیشن، هر بار که کاربر در فیلد جستجو تایپ می‌کرد، درخواست جدیدی به API ارسال می‌شد. این رفتار می‌تواند منجر به محدودیت نرخ (Rate Limiting) شود. برای جلوگیری از این مشکل، دریافت داده‌ها را به‌صورت صریح انجام می‌دهیم — یعنی فقط زمانی که کاربر روی دکمهٔ تأیید کلیک کند.


افزودن دکمهٔ تأیید


ابتدا یک دکمهٔ جدید برای تأیید جستجو اضافه می‌کنیم:


<button
  type="button"
  disabled={!searchTerm}
  onClick={handleSearchSubmit}
>
  Submit
</button>

تعریف دو وضعیت مجزا


از دو وضعیت استفاده می‌کنیم: یکی برای مقدار جاری فیلد جستجو (searchTerm) و دیگری برای مقدار تأییدشده که منجر به دریافت داده می‌شود (url):


const [searchTerm, setSearchTerm] = useStorageState('search', 'React');
const [url, setUrl] = React.useState(`${API_ENDPOINT}${searchTerm}`);

const handleSearchInput = (event) => {
  setSearchTerm(event.target.value);
};

const handleSearchSubmit = () => {
  setUrl(`${API_ENDPOINT}${searchTerm}`);
};

دریافت داده با useCallback و useEffect


تابع دریافت داده‌ها را با useCallback تعریف می‌کنیم تا فقط هنگام تغییر url اجرا شود:


const handleFetchStories = React.useCallback(() => {
  dispatchStories({ type: 'STORIES_FETCH_INIT' });
  fetch(url)
    .then((response) => response.json())
    .then((result) => {
      dispatchStories({
        type: 'STORIES_FETCH_SUCCESS',
        payload: result.hits,
      });
    })
    .catch(() =>
      dispatchStories({ type: 'STORIES_FETCH_FAILURE' })
    );
}, [url]);

React.useEffect(() => {
  handleFetchStories();
}, [handleFetchStories]);

مزایای دریافت صریح


  • جلوگیری از ارسال درخواست‌های مکرر هنگام تایپ
  • کاهش فشار روی API و جلوگیری از خطای محدودیت نرخ
  • کنترل کامل بر زمان دریافت داده‌ها
  • امکان افزودن debounce یا throttle در مراحل بعدی

جمع‌بندی


با استفاده از دریافت صریح داده‌ها در React، فقط زمانی که کاربر روی دکمهٔ Submit کلیک کند، درخواست به API ارسال می‌شود. این روش باعث افزایش پایداری اپلیکیشن، کاهش خطاهای API و بهبود تجربهٔ کاربری می‌شود.


Written & researched by Dr. Shahin Siami

Related Articles

فرم‌ها در React – ارسال داده با onSubmit و action در فرم‌های جستجو

فرم‌ها بخش جدایی‌ناپذیر هر اپلیکیشن مدرن هستند. در این مقاله، نحوهٔ ساخت فرم جستجو در React را بررسی می‌کنیم. ابتدا از onSubmit برای مدیریت ارسال فرم استفاده می‌کنیم و سپس با معرفی ویژگی action، فرم را به رفتار بومی HTML نزدیک‌تر می‌کنیم. این ساختار باعث افزایش خوانایی، قابلیت استفاده با صفحه‌کلید، و آمادگی برای نسخه‌های آیندهٔ React می‌شود.

Continue

کتابخانه‌های شخص ثالث در React – استفاده از axios و async/await برای دریافت داده‌ها

در این مقاله، نحوهٔ جایگزینی fetch با کتابخانهٔ axios برای دریافت داده‌ها از API در React را بررسی می‌کنیم. سپس با استفاده از async/await و بلوک try/catch، کد دریافت داده‌ها را خواناتر و قابل مدیریت‌تر می‌کنیم. این روش‌ها باعث افزایش سازگاری با مرورگرهای قدیمی، بهبود تست‌پذیری، و کاهش پیچیدگی کد می‌شوند.

Continue

وضعیت‌های غیرممکن در React – مدیریت پیش‌بینی‌پذیر وضعیت با useReducer

استفاده هم‌زمان از چند useState برای مدیریت وضعیت‌های مرتبط می‌تواند منجر به وضعیت‌های غیرممکن و باگ‌های پنهان شود. این مقاله نشان می‌دهد چگونه با ترکیب وضعیت‌های مرتبط در یک useReducer واحد، می‌توان از بروز چنین مشکلاتی جلوگیری کرد. با تعریف یک ساختار وضعیت پیچیده شامل داده، بارگذاری و خطا، و استفاده از اکشن‌های مشخص، مدیریت وضعیت در React پیش‌بینی‌پذیرتر و قابل اطمینان‌تر می‌شود.

Continue

مدیریت پیشرفته وضعیت در React – استفاده از useReducer برای انتقال‌های پیچیده

در حالی که useState برای مدیریت وضعیت‌های ساده مناسب است، هوک useReducer در React راه‌حلی مقیاس‌پذیر برای مدیریت وضعیت‌های پیچیده و وابسته ارائه می‌دهد. این مقاله نحوهٔ مهاجرت وضعیت لیست داستان‌ها از useState به useReducer را بررسی می‌کند، و نشان می‌دهد چگونه با تعریف اکشن‌هایی مانند SET_STORIES و REMOVE_STORY می‌توان منطق وضعیت را به‌صورت متمرکز و خوانا مدیریت کرد.

Continue

رندر شرطی در React – نمایش وضعیت بارگذاری و خطا هنگام دریافت داده‌های غیرهمزمان

در React، رندر شرطی ابزاری قدرتمند برای کنترل نمایش رابط کاربری بر اساس وضعیت‌های مختلف است. این مقاله نحوهٔ نمایش پیام «در حال بارگذاری…» هنگام دریافت داده‌های غیرهمزمان، و پیام خطا در صورت شکست دریافت داده را بررسی می‌کند. با استفاده از useState و useEffect، وضعیت‌های isLoading و isError را مدیریت کرده و با استفاده از عملگرهای منطقی و ternary، رندر شرطی را پیاده‌سازی می‌کنیم.

Continue

داده‌های غیرهمزمان در React – شبیه‌سازی دریافت داده از API با useEffect و Promise

در React، داده‌ها معمولاً از منابع خارجی به‌صورت غیرهمزمان دریافت می‌شوند. این مقاله نحوهٔ شبیه‌سازی دریافت داده از API با استفاده از Promise و useEffect را بررسی می‌کند. ابتدا داده‌های نمونه را به‌صورت غیرهمزمان بارگذاری می‌کنیم، سپس با تأخیر ۲ ثانیه‌ای، رفتار واقعی‌تری از دریافت داده را پیاده‌سازی می‌کنیم. این گام نخست برای اتصال به API واقعی در آینده است.

Continue