متد $.get

متد get یک تابع کمکی در jQuery برای ارسال درخواست HTTP از نوع GET است. این متد معمولاً برای خواندن داده‌هایی مانند متن، اطلاعات یک محصول یا محتوای یک صفحه به کار می‌رود. پاسخ سرور می‌تواند بدون تازه‌سازی کل صفحه در اختیار کد JavaScript قرار بگیرد.

درخواست GET برای دریافت داده طراحی شده است؛ بنابراین بهتر است از آن برای عملیاتی که اطلاعات را تغییر می‌دهند استفاده نکنید. برای نمونه، خواندن فهرست خبرها مناسب است، اما ثبت سفارش یا حذف یک رکورد باید با روش و سازوکار مناسب دیگری انجام شود.

در نمونه‌های این مقاله، نشانی‌هایی مانند test.php یا demo_test.asp فرضی هستند. برای اجرا باید نشانی را با مسیر واقعی فایل یا سرویس سمت سرور خود جایگزین کنید.

پارامتر نخست، نشانی یا URL منبعی است که درخواست به آن ارسال می‌شود و وجود آن ضروری است. نشانی می‌تواند نسبی باشد، مانند /api/products، یا در شرایط لازم به یک نشانی کامل اشاره کند. مسیر نادرست یا تفاوت میان مسیر نسبی و مطلق می‌تواند باعث خطای پیدا نشدن منبع شود.

برای مثال، اگر صفحه در مسیر /shop/ قرار دارد و درخواست را به products می‌فرستید، مرورگر ممکن است مسیر /shop/products را درخواست کند. پیش از بررسی کدهای دیگر، نشانی نهایی را در ابزار توسعه مرورگر کنترل کنید.

پارامتر data اختیاری است و داده‌های مورد نیاز سرور را همراه درخواست می‌فرستد. jQuery معمولاً مقادیر یک شیء را به پارامترهای پرس‌وجوی URL تبدیل می‌کند. این روش برای فیلتر، جست‌وجو یا صفحه‌بندی داده‌ها کاربرد دارد.

فرض کنید کاربر می‌خواهد محصول‌های یک دسته را ببیند. می‌توانید نام دسته را به صورت داده ارسال کنید و سرور فقط نتایج مرتبط را برگرداند. داده‌های حساس را در URL قرار ندهید؛ پارامترهای GET ممکن است در سابقه مرورگر، گزارش سرور یا نشانی قابل مشاهده باشند.

تابع موفقیت زمانی اجرا می‌شود که پاسخ درخواست با موفقیت دریافت شود. داده پاسخ معمولاً نخستین آرگومان تابع است. در صورت نیاز می‌توانید وضعیت پاسخ و شیء درخواست را نیز دریافت کنید؛ اما نام‌گذاری پارامترها را دقیق و روشن نگه دارید تا خواندن کد آسان باشد.

برای نمونه، می‌توانید متن پاسخ را در کنسول ببینید یا محتوای یک بخش از صفحه را به‌روزرسانی کنید. اگر پاسخ HTML است، پیش از قراردادن آن در صفحه به منبع و محتوای آن اعتماد داشته باشید و از واردکردن داده نامطمئن به DOM خودداری کنید.

نوع داده پاسخ را می‌توان با پارامتر اختیاری dataType مشخص کرد. اگر این پارامتر تعیین نشود، jQuery با توجه به نوع پاسخ تلاش می‌کند قالب آن را تشخیص دهد. مشخص‌کردن نوع داده در مواردی که قالب پاسخ معلوم است، رفتار برنامه را قابل پیش‌بینی‌تر می‌کند.

در عمل، درخواست ممکن است به علت نشانی اشتباه، پاسخ نامعتبر یا مشکل شبکه شکست بخورد. برای نمونه، اگر سرویس JSON برمی‌گرداند اما پاسخ ناقص یا نامعتبر باشد، بررسی خطا کمک می‌کند به جای نمایش نتیجه اشتباه، پیام مناسبی به کاربر نشان دهید.

درخواست GET برای دریافت داده‌ای مناسب است که قرار نیست با همان درخواست تغییر کند. از این متد می‌توانید برای جست‌وجو، دریافت جزئیات یا بارگذاری یک فهرست استفاده کنید. بهتر است درخواست را در زمان مناسب و در پاسخ به اقدام کاربر بفرستید تا تماس‌های غیرضروری با سرور کاهش یابد.

برای مثال، در یک صفحه محصولات می‌توان پس از انتخاب فیلتر، نتایج تازه را از سرور دریافت کرد. اگر کاربر با هر تغییر کوچک چند درخواست پیاپی ایجاد می‌کند، مدیریت زمان ارسال درخواست و جلوگیری از درخواست‌های تکراری تجربه بهتری فراهم می‌کند.

ساده‌ترین حالت، درخواست از یک فایل و نادیده‌گرفتن مقدار پاسخ است. این نمونه برای آشنایی با شکل فراخوانی مناسب است؛ در کد واقعی معمولاً پاسخ را پردازش می‌کنید یا برای خطاها رفتار مشخصی در نظر می‌گیرید.

$.get("test.php");

می‌توانید داده‌های متنی را هم همراه درخواست ارسال کنید. jQuery آن‌ها را به پارامترهای URL تبدیل می‌کند. در این مثال، سرور می‌تواند مقدار نام و شهر را دریافت کند؛ البته نام پارامترها باید با انتظارات برنامه سمت سرور هماهنگ باشد.

$.get("test.php", {
  name: "Ali",
  town: "1jQuery"
});

اگر لازم است چند مقدار برای یک کلید بفرستید، می‌توانید آرایه‌ای از مقادیر را در داده‌ها قرار دهید. شکل نهایی پارامترها به شیوه پردازش سمت سرور نیز وابسته است؛ پس پس از ارسال، درخواست واقعی را در ابزار شبکه مرورگر بررسی کنید.

$.get("test.php", {
  "colors[]": ["Red", "Green", "Blue"]
});

برای دریافت و استفاده از پاسخ، تابع موفقیت را به درخواست اضافه کنید. در این نمونه، پاسخ در پنجره هشدار نمایش داده می‌شود؛ در یک برنامه واقعی می‌توانید آن را در بخش مشخصی از صفحه قرار دهید یا برای پردازش بیشتر به تابع دیگری بفرستید.

$.get("test.php", function(data) {
  alert("Data: " + data);
});

شکل رایج فراخوانی متد get به صورت زیر است. در نسخه‌های جدید jQuery، تابع موفقیت و نوع داده را می‌توان مطابق نیاز تعیین کرد. پارامترهای اختیاری را فقط زمانی اضافه کنید که در برنامه کاربرد دارند.

$.get(url, data, success, dataType);

پارامترهای مهم این متد را می‌توان به شکل زیر خلاصه کرد. توجه کنید که ترتیب و نوع آرگومان‌ها مهم است؛ اگر فقط تابع موفقیت را لازم دارید، می‌توانید آن را بعد از URL قرار دهید و از ارسال داده اضافی خودداری کنید.

• url: آدرس منبعی که درخواست به آن فرستاده می‌شود. این پارامتر اجباری است.
• data: اطلاعات اختیاری برای ارسال همراه درخواست، مانند عبارت جست‌وجو یا شناسه دسته.
• success: تابعی که پس از دریافت پاسخ موفق اجرا می‌شود و می‌تواند داده پاسخ را دریافت کند.
• dataType: نوع مورد انتظار پاسخ، مانند JSON یا متن. اگر تعیین نشود، jQuery برای تشخیص آن تلاش می‌کند.

در تابع موفقیت، داده دریافت‌شده از سرور در اختیار شما قرار می‌گیرد. در برخی امضاها، وضعیت درخواست و شیء درخواست نیز قابل دسترسی است. برای نوشتن کد خوانا، از نام‌های معنادار استفاده کنید و رفتار برنامه را به نمایش پیام‌های موقت محدود نکنید.

در نمونه زیر، داده و وضعیت در کنسول ثبت می‌شوند. اگر سرویس پاسخ JSON می‌دهد، نوع داده را مشخص کنید تا jQuery پاسخ را به شکل مناسب در اختیار تابع قرار دهد. پاسخ واقعی سرویس باید با قالب اعلام‌شده هماهنگ باشد.

$.get("demo_test.asp", function(data, status) {
  console.log("Data:", data);
  console.log("Status:", status);
}, "text");

برای مدیریت شکست درخواست می‌توانید از متد fail() روی شیء بازگشتی استفاده کنید. در این حالت، پیام خطا را متناسب با موقعیت نمایش دهید و جزئیات فنی را برای بررسی در کنسول یا سامانه ثبت خطا نگه دارید.

$.get("/api/products")
  .done(function(data) {
    console.log("داده دریافت شد:", data);
  })
  .fail(function(jqXHR, textStatus, errorThrown) {
    console.error("درخواست ناموفق بود:", textStatus, errorThrown);
  });

وضعیت‌هایی مانند success، notmodified، error، timeout و parsererror به تشخیص نتیجه درخواست کمک می‌کنند. نام وضعیت دقیق به نتیجه و نسخه jQuery وابسته است؛ در کد، از رفتار مستندشده برای نسخه مورد استفاده خود پیروی کنید.

نوع پاسخ به داده‌ای بستگی دارد که سرور برمی‌گرداند. قالب را هم در سمت سرور و هم در کد فرانت‌اند هماهنگ نگه دارید؛ ناسازگاری میان پاسخ واقعی و نوع مورد انتظار می‌تواند باعث خطای پردازش شود.

• json: داده ساخت‌یافته‌ای که برای دریافت اطلاعاتی مانند فهرست محصولات مناسب است.
• xml: داده‌ای با قالب XML که در سرویس‌های مبتنی بر این استاندارد به کار می‌رود.
• html: محتوای HTML که ممکن است برای جایگزینی یا افزودن بخشی از صفحه استفاده شود.
• text: رشته‌ای ساده که برای پیام یا محتوای متنی مناسب است.
• script: محتوایی که به عنوان اسکریپت ارزیابی می‌شود؛ استفاده از آن باید با دقت و توجه به امنیت انجام شود.

برای مثال، اگر پاسخ سرویس یک شیء JSON است، مشخص‌کردن نوع داده به‌صورت json به روشن‌ترشدن قرارداد میان کلاینت و سرور کمک می‌کند. برای پاسخ HTML نیز محتوای دریافتی را تنها زمانی وارد صفحه کنید که منبع آن قابل اعتماد باشد.

در نمونه زیر، با کلیک روی دکمه درخواست ارسال می‌شود و داده و وضعیت پاسخ در پنجره هشدار نمایش داده می‌شوند. فایل مقصد باید در دسترس باشد و پاسخ آن با انتظارات کد مطابقت داشته باشد. اگر صفحه از HTTPS استفاده می‌کند، سرویس مقصد نیز باید با شرایط امنیتی سازگار باشد.

$("button").click(function() {
  $.get("demo_test.asp", function(data, status) {
    alert("Data: " + data + "\nStatus: " + status);
  });
});

برای تجربه بهتر، معمولاً بهتر است به جای پنجره هشدار، نتیجه را در بخشی از صفحه نمایش دهید. همچنین می‌توانید هنگام ارسال درخواست نشانه بارگذاری نشان دهید و در صورت شکست، پیام ساده‌ای ارائه کنید. این کار به کاربر کمک می‌کند بداند درخواست در حال انجام است یا به مشکلی برخورده است.

درخواست GET برای دریافت داده است و نباید تنها سازوکار اجرای عملیات تغییردهنده باشد. به‌خصوص عملیاتی مانند حذف، ثبت یا ویرایش اطلاعات را با طراحی مناسب سمت سرور و روش درخواست متناسب پیاده کنید. مخفی‌کردن یک دکمه یا استفاده از Ajax به تنهایی جایگزین کنترل دسترسی و اعتبارسنجی نیست.

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

اگر کد انتظار JSON دارد اما سرور HTML یا متن برمی‌گرداند، پردازش پاسخ ممکن است شکست بخورد. قرارداد پاسخ را در هر دو سمت مشخص کنید و در ابزار شبکه مرورگر، محتوای دریافتی و کد وضعیت HTTP را بررسی کنید.

خیر. پارامتر داده اختیاری است و فقط زمانی به کار می‌رود که لازم باشد اطلاعاتی مانند عبارت جست‌وجو یا شناسه دسته همراه درخواست فرستاده شود. در درخواست ساده، می‌توانید URL را به تنهایی ارسال کنید و پاسخ را در تابع موفقیت دریافت کنید.

اگر داده‌ای می‌فرستید، مطمئن شوید نام پارامترها با چیزی که سرور انتظار دارد هماهنگ است. برای اطلاعات حساس از پارامترهای URL استفاده نکنید و در صورت نیاز، روش درخواست و سازوکار امنیتی متناسب را در سمت سرور انتخاب کنید.

نوع پاسخ را می‌توانید با پارامتر اختیاری dataType مشخص کنید. برای نمونه، اگر سرور JSON برمی‌گرداند، تعیین این قالب باعث می‌شود انتظار کد روشن باشد. اگر نوع داده را مشخص نکنید، jQuery تلاش می‌کند پاسخ را بر اساس اطلاعات دریافتی تشخیص دهد.

مهم است پاسخ واقعی سرور با نوع مورد انتظار هماهنگ باشد. اگر سرویس خطای HTML برگرداند اما کد انتظار JSON داشته باشد، باید شکست را به شکل مناسب مدیریت کنید و محتوای پاسخ را برای یافتن علت بررسی کنید.

$.get() یک روش کمکی و مختصر برای درخواست GET است. متد $.ajax() تنظیمات گسترده‌تری در اختیار می‌گذارد و زمانی مفید است که به کنترل دقیق‌تر گزینه‌های درخواست نیاز دارید.

برای دریافت معمولی داده، شکل کوتاه‌تر خوانا و کاربردی است. اگر لازم است گزینه‌های بیشتری مانند تنظیمات سفارشی درخواست را کنترل کنید، مستندات نسخه jQuery پروژه را ببینید و روش مناسب را انتخاب کنید.

دلایل متداول شامل URL نادرست، در دسترس نبودن فایل مقصد، مشکل شبکه یا محدودیت‌های دسترسی میان دامنه‌ها است. برای تشخیص، بخش Network ابزار توسعه مرورگر را باز کنید و نشانی درخواست، کد وضعیت HTTP و پاسخ دریافتی را بررسی کنید.

همچنین مطمئن شوید کتابخانه jQuery بارگذاری شده و کد پس از آماده‌شدن عناصر صفحه اجرا می‌شود. اگر درخواست به دامنه دیگری فرستاده می‌شود، تنظیمات سرور مقصد نیز باید اجازه چنین درخواستی را بدهد.

بله، سرور می‌تواند محتوای HTML برگرداند و برنامه آن را دریافت کند. با این حال، پیش از قراردادن محتوا در صفحه، منبع آن را بررسی کنید؛ واردکردن HTML نامطمئن می‌تواند خطر امنیتی ایجاد کند.

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

از fail() برای مشخص‌کردن رفتاری استفاده کنید که هنگام ناموفق‌بودن درخواست اجرا می‌شود. در این بخش می‌توانید پیام مناسب نشان دهید، وضعیت درخواست را ثبت کنید و از نمایش داده ناقص به کاربر جلوگیری کنید.

پیام کاربر را ساده و قابل فهم نگه دارید و جزئیات فنی را جداگانه برای عیب‌یابی ثبت کنید. در محیط واقعی، اطلاعات حساس یا جزئیات داخلی سرور را در پیام خطای قابل مشاهده برای همه قرار ندهید.

کاربرد اصلی GET دریافت داده است و بهتر است درخواست آن تغییر پایدار در سرور ایجاد نکند. اگر عملیاتی قرار است اطلاعاتی را ثبت یا تغییر دهد، از روش مناسب و کنترل‌های امنیتی لازم استفاده کنید.

این تفکیک باعث می‌شود رفتار برنامه قابل پیش‌بینی‌تر باشد و ابزارها، کش مرورگر و کاربران برداشت درستی از درخواست داشته باشند. اعتبارسنجی و کنترل مجوز نیز باید در سمت سرور انجام شود، نه فقط در کد مرورگر.

می‌توانید آرایه را در شیء داده قرار دهید؛ برای نمونه، کلیدی مانند colors[] را با چند مقدار ارسال کنید. jQuery داده‌ها را برای درخواست آماده می‌کند، اما شیوه دریافت و تفسیر آن باید با زبان و چارچوب سمت سرور هماهنگ باشد.

پس از ارسال، پارامترهای واقعی درخواست را در ابزار شبکه مرورگر ببینید. اگر سرور آرایه را به شکل مورد انتظار دریافت نمی‌کند، قالب نام کلید یا روش سریال‌سازی را با مستندات محیط سمت سرور تطبیق دهید.

بله. می‌توانید رویداد کلیک دکمه را به ارسال درخواست GET متصل کنید. بهتر است هنگام اجرا از ارسال ناخواسته درخواست‌های تکراری جلوگیری کنید و نتیجه موفق یا ناموفق را به شکلی روشن به کاربر نمایش دهید.

اگر درخواست باید پس از آماده‌شدن صفحه تنظیم شود، کد رویداد را زمانی اجرا کنید که عناصر مورد نظر در DOM وجود دارند. در پروژه‌های جدید نیز می‌توانید بر اساس ساختار برنامه، از الگوی مدیریت رویداد مناسب استفاده کنید.

بله. این متد بخشی از jQuery است و بدون بارگذاری نسخه سازگار این کتابخانه در صفحه در دسترس نخواهد بود. ترتیب بارگذاری اسکریپت‌ها را بررسی کنید تا jQuery پیش از کدی که از $.get() استفاده می‌کند اجرا شده باشد.

در صورت نبودن کتابخانه، معمولاً خطایی درباره تعریف‌نشدن $ یا jQuery در کنسول دیده می‌شود. بررسی ترتیب اسکریپت‌ها و نشانی فایل کتابخانه، گام نخست برای رفع این مشکل است.