روش‌های FormData برای بازرسی و اصلاح

FormData بهترین دوست کاربر XHR است و در Chrome 50 ارتقا می‌یابد. درحال افزودن روش‌هایی هستیم که به شما امکان می‌دهد اشیای FormData را بازرسی کنید یا آن‌ها را بعداز ایجاد تغییر دهید. اکنون می‌توانید از get()، delete()، و کمک‌کننده‌های تکرار مثل entries، keys، و غیره استفاده کنید. (فهرست کامل را بررسی کنید.)

اگر قبلاً از FormData استفاده نکرده‌اید، این یک API ساده و با پشتیبانی خوب است که به شما امکان می‌دهد به‌صورت برنامه‌نویسی یک فرم مجازی بسازید و آن را بااستفاده از window.fetch() یا XMLHttpRequest.send(formData) به مکانی دور ارسال کنید.

برای دیدن چند نمونه، ادامه مطلب را بخوانید!

تجزیه فرم‌های واقعی مثل یک حرفه‌ای

FormData را می‌توان از فرم HTML واقعی ساخت و از همه مقادیر فعلی آن عکس آنی گرفت. بااین‌حال، این شیء قبلاً کاملاً مات بود. تنها کاری که می‌توانستید انجام دهید این بود که آن را بدون تغییر به سرور ارسال کنید. اکنون می‌توانید آن را بگیرید، اصلاح کنید، تغییر دهید، مشاهده کنید، کوچک کنید، تغییر دهید، و درنهایت، بارگذاری کنید:

function sendRequest(theFormElement) {
    var formData = new FormData(theFormElement);
    formData.delete("secret_user_data"); // don't include this one!
    if (formData.has("include_favorite_color")) {
    formData.set("color", userPrefs.getColor());
    }
    // log all values like <input name="widget">
    console.info("User selected widgets", formData.getAll("widget"));

    window.fetch(url, {method: 'POST', body: formData});
}

همچنین می‌توانید FormData را ازطریق XMLHttpRequest قدیمی‌تر ارسال کنید:

var x = new XMLHttpRequest();
x.open('POST', url);
x.send(formData);

FormData را دور نیندازید

اگر FormData خودتان را از ابتدا می‌سازید، ممکن است از اینکه نمی‌توانید دوباره از آن استفاده کنید ناامید شده باشید - زمان زیادی را صرف آن فیلدها کرده‌اید! ازآنجاکه هر دو روش window.fetch() و XMLHttpRequest.send() عکس آنی از FormData می‌گیرند، اکنون می‌توانید به‌طور ایمن از کارتان دوباره استفاده کنید و آن را اصلاح کنید! این نمونه را بررسی کنید:

// append allows multiple values for the same key
var formData = new FormData();
formData.append("article", "id-123");
formData.append("article", "id-42");

// send like request
formData.set("action", "like");
window.fetch(url, {method: 'POST', body: formData});

// send reshare request
formData.set("action", "reshare");  // overrides previous "action"
window.fetch(url, {method: 'POST', body: formData});