jQuery.ajaxSetup()

jQuery.ajaxSetup( options ) Dönen Değer : Düz JavaScript Nesnesi

Açıklama : Daha sonra yapılacak Ajax istekleri için default değerleri belirler. Kullanılması tavsiye edilmez.

jQuery.ajaxSetup( options )

options
Tip : Düz JavaScript NEsnesi
Default Ajax isteği opsiyonlarını belirleyen key/value şeklinde veri seti.

$.ajaxSetup() metodunun olası seçenekleri için $.ajax() metoduna bakınız.

Daha sonra gelen ve herhangi bir fonksiyon ile yapılan tüm Ajax istekleri , bir diğer metod tarafından değiştirilmediği müddetçe $.ajaxSetup() tarafından belirtilen opsiyonları kullanır.

Not : Burada belirtilen tüm ayarlar, $.ajax ya da örneğin $.get() gibi Ajax temelli türevler tarafından yapılan istekleri etkiler. Bu diğer normal default değerleri kullanan mesela plug-in içinde yapılacak istekleri de etkiler. Bu yüzden bu metodun kullanılmamasını tavsiye ediyoruz.

Örneğin server'a defalarca ping atılmak isteniyorsa aşağıdaki kod ile url parametresi default değeri ayarlanabilir.

$.ajaxSetup({
  url: "ping.php"
});

Artık her Ajax isteği yapıldığında url değeri "ping.php" olarak otomatik gelecektir.

$.ajax({
  // url burada verilmemiş; ping.php değeri kullanılır
  data: { "name": "Dan" }
});

Not : Ajax olayları için global callback fonksiyonları .on() metodu ile iliştirilmelidir -- $.ajaxSetup() metodundaki options değeri tercih edilmemelidir.

Örnekler :

Ajax istekleri için default url değerini "/xmlhttp/" yapar, global Ajax callback fonksiyonlarını engeller ve isteği yaparken GET yerine POST kullanımını default yapar. Daha sonra yapılacak Ajax istekleri bu değerleri vermeden direk server'a veri gönderebilir.

$.ajaxSetup({
  url: "/xmlhttp/",
  global: false,
  type: "POST"
});
$.ajax({ data: myData });