jQuery ajaxSetup() paraméter function táblázat.
Az ajaxSetup() metódus, alapértelmezett értékeket állít be a jövőbeli AJAX kérésekhez.
Alkalmazni, vagy tesztelni, SZERVEREN lehetséges.
https://www.w3schools.com/jquery/ajax_ajaxsetup.asp ajánlatainak fordítása.
|
jQuery ajaxSetup() módszerek. AJAX kérés beállításhoz megadható, egy vagy több paraméter, name/value, azaz, név / érték párosítással. Lehetséges neveket / értékeket az alábbi táblázat tartalmazza. | |
|---|---|
Name (Neve) | Value (Érték / leírás) |
| async | Logikai érték, amely jelzi, hogy a kérelmet kezelni kell úgy, hogy aszinkron vagy sem. Alapértelmezett értéke: true. Értéke: logikai (true vagy false) Alapértelmezésben minden elküldött kérelem esetében aszinkron (azaz. alapértelmezett beállítása true ). Ha szüksége van szinkron kérésre, beállíthatja false értékre. Domain kérelmek és dataType: "jsonp" kérések nem támogatják a szinkron működését. A szinkronkérések ideiglenesen zárolhatják a böngészőt, és letilthatják a műveleteket, miközben a kérés aktív. Mivel a jQuery 1.8, használata async: false, a jqXHR ( $.Deferred ) elavult; akkor használni kell a siker / hiba / teljes visszahívási lehetőség helyett, a megfelelő módszereket, a jqXHR tárgyat, például jqXHR.done() |
| beforeSend(xhr) | A függvény lefut, a kérés előtt. Function típus: (jqXHR, PlainObject beállítások) Előzetes kérés visszahívási funkció, amely a jqXHR (jQuery 1.4.x, XMLHTTPRequest) objektum módosításához használható, a küldés előtt. Ezzel beállíthatja az egyéni fejléceket, stb. Az jqXHR és a beállításobjektumok argumentumként kerülnek átadásra. Ez egy Ajax Event ( Esemény). Ha visszatérve false, a beforeSend funkció törli a kérést. Mivel a jQuery 1.5, a beforeSend lehetőség független lesz, az úgynevezett kérelem típusától. |
| cache | Logikai érték, amely jelzi, hogy a böngésző melyik kért oldalakat gyorsítótárazza (cache). Alapértéke: true, azaz, igaz. cache (alapértelmezett: true. De false a dataType 'script' és 'jsonp' esetén. ) Típus: logikai Ha az értéke false , akkor kényszeríti kért oldalakat, hogy nem lehet cache a böngésző. Megjegyzés: Beállítás cache hamis, csak akkor működik, ha a fej és a GET kérések megfelelőek. Úgy működik, hogy hozzáadja a "_ = {timestamp}" értéket, a GET paraméterekhez. A paraméternek más típusú kérésekre nincs szüksége, kivéve az IE8-at, ha POST-t küldünk egy olyan URL-re, amelyet egy GET már igényelt. |
| complete(xhr,status) | A függvény lefut, ha a kérés befejeződött. (miután a success, siker és az error, hiba funkciók lefutottak.) Function típus: (jqXHR, string textStatus) Függvény a kérelem lezárásához (miután success és error visszahívások végrehajtódnak ). A funkcióhoz kerül át, két érv: A jqXHR (a jQuery 1.4.x, XMLHttpRequest) objektum, és egy sor kategorizálási állapot a kérelmhez: "success", "notmodified", "nocontent", "error", "timeout", "abort" , vagy "parsererror". Mivel a jQuery 1.5, a complete beállításnál el tud fogadni egy sor funkciót. Minden funkció egymás után hívódik. Ez egy Ajax Event (Esemény). |
| contents | Tartalom Típus: PlainObject (Sima objektum), Szöveg / szabályos kifejezés párok tárgya, amelyek meghatározzák, hogy a jQuery hogyan fogja elemezni a választ, tekintve annak tartalmát. (verzió hozzá: 1,5 ) |
| contentType | A tartalom típusa. Ha adatokat küld a szerverre. Alapértelmezett az "application / x-www-form-urlencoded" contentType (alapértelmezett: 'application/x-www-form-urlencoded; charset=UTF-8' ) Típus: logikai vagy karakterlánc Amikor adatokat küld a kiszolgálónak, használja ezt a tartalomtípust. Az alapértelmezett "application / x-www-form-urlencoded; charset = UTF-8", ami a legtöbb esetben rendben van. Ha kifejezetten átmegy egy tartalom-típusú $.ajax(), akkor mindig küld értéket a szerver (akkor is, ha nem küld adatokat). Mivel a jQuery 1.6 false értéket ad, akkor jQuery sem állíthat tartalom típusú fejlécet. Megjegyzés: A W3C XMLHttpRequest előírás szerint a charset mindig UTF-8; Egy másik karakterlánc megadása nem kényszeríti a böngészőt, a kódolás megváltoztatására. Domain kéréseket, amelyben a tartalom típusát semmi más, mint application/x-www-form-urlencoded, multipart/form-data, vagy text/plain elindítja a böngészőt, hogy küldjön egy elővizsgálati OPTIONS kérést a szerver. |
| context | Megadja a "this" értéket az összes AJAX-szal kapcsolatos visszahívási funkcióhoz. Típusa: PlainObject (Sima objektum) Ez az objektum lesz az összes Ajaxhoz kapcsolódó visszahívás kontextusa. Alapértelmezésben, az összefüggésben egy olyan objektum, amely képviseli az Ajax beállításokat használó hívást. ( $.ajaxSettings összeolvadt a beállításokon át $.ajax ). Például, megadásával DOM elem keretébe teszi, hogy az összefüggésben a complete visszahívási kérelem legyen, valahogy így:
$.ajax({
url: "test.html",
context: document.body
}).done(function() { // done jelentése: kész.
$( this ).addClass( "done" );
});
Eredeti leírást, lásd itt: http://api.jquery.com/jquery.ajax/ |
| convertes | Átalakító.Alapértelmezett átalakítók:
{ "* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML }
Típusa: PlainObject (Sima objektum)Az objectType-nek-DataType átalakítót tartalmazó objektum. Minden átalakító értéke olyan függvény, amely a válasz átalakított értékét adja vissza. (verzió hozzá: 1,5 ) |
| crossDomain | crossDomain: kereszt vagy átívelő domain. Alapértelmezett értékek: - False, azaz, hamis az azonos tartományra vonatkozó kéréseknél. - True, azaz, igaz a tartományok közötti kéréseknél. Típus: logikai Ha szeretne erős crossDomain kérelmet (például jsonp) ugyanazon a domainen, a crossDomain értéke legyen true. Ez lehetővé teszi például a szerveroldali átirányítást egy másik tartományhoz. (verzió hozzá: 1,5 ) |
| data | Meghatározza a szervernek küldendő adatokat. Ez a "data" a GET kérésekhez tartozó URL-hez tartozik. Típus: PlainObject (Sima objektum) vagy karakterlánc vagy Array A szerverre küldendő adatok, egy lekérdezési karakterlánccá alakulnak, ha nem is tartalmaz egy karakterláncot. Lásd processData opciót, hogy megakadályozza az automatikus feldolgozást. Az objektumnak Key / Value párnak kell lennie. Ha az érték egy tömb, jQuery szerializál, sorozatba állít több értéket ugyanazon kulcs értéke alapján, traditional beállítás. (lásd alább). |
| dataFilter(data,type) | Az XMLHttpRequest nyers válaszadatainak kezelésére használt függvény DataFilter: Adatszűrő. Típus: Funkció ( karakterlánc adatok, karakterlánc típus ) => Bármi Az XMLHttpRequest nyers válaszadatainak kezelésére használható funkció. Mi az XMLHttpRequest? Kattints ide! Ez egy előszűrési funkció, amely tisztítja a reakciót. Vissza kell adnia, a fertőtlenített adatokat. A függvény két argumentumot fogad el: A kiszolgálótól kapott nyers adatot és a "dataType" paramétert. |
| dataType | A szerver válaszától elvárt adattípus. Példa: $.ajax({url: "valami_script.js", dataType: "script"}); Adattípus (alapértelmezett: Intelligens találgatás (xml, json, script, vagy html) ) Típusa: Karakterlánc. A kiszolgálótól elvárható adatok típusa. Ha nincs megadva semmi, a jQuery megpróbálja következtetni a válasz MIME típusára alapozva. ( Egy XML MIME-típus XML-t hoz létre, az 1.4 JSON-ban JavaScript-objektumot generál, az 1.4-es szkript végrehajtja a szkriptet, és bármi más is, stringként visszaküldi). A rendelkezésre álló típusok (és az eredmény a sikeres visszahívás első argumentumaként) a következők: "xml" : XML dokumentum, amelyet feldolgozhat jQuery. "html" : HTML szöveges formában; A szkript tag-eket, a DOM-ba beillesztve értékeli. "script" : Értékeli válaszadást a JavaScript, és visszaadja a sima szöveget. Letiltja a cache appending lekérdezési paramétert, _=[TIMESTAMP], URL-t kivéve, ha a cache opció, true értékre van beállítva. "json" : Értékeli válaszadást a JSON, és visszaad egy JavaScript Domainek objektumot. "json" kéréseket alakítjuk "jsonp", kivéve, ha a kérelem tartalmazza "jsonp: false" a kérelemben lehetőségeket. A JSON adatok szigorúan értelmezhetők; Minden rosszul formázott JSON-t elutasítanak, és elemzési hibát dobnak. A jQuery 1.9-től a üres válasz is elutasításra kerül; (Lásd json.org további információkat megfelelő JSON formázást.) "jsonp" : Rengeteg a JSON blokkot kezel jsonp. Hozzátesz extra "?callback=?" -ot a visszahívás megadásához, URL-cím végéig. Letiltja a cache appending lekérdezési paramétert, "_=[TIMESTAMP]", az URL-t kivéve, ha a cache opció, true értékre van beállítva. "text" : Egy sima szöveg. Több, a térben elválasztott érték: Mint a jQuery 1.5, jQuery tud alakítani egy adattípust, amit kapott a Content-Type fejléc, amire szükség van. Például, ha azt szeretnénk, szöveges választ kell kezelni, mint az XML, használja "text xml" adattípust. Akkor is, ha egy jsonp kérelem szöveget kapja, és értelmezi jQuery, mint az XML: "jsonp text xml". Hasonlóképpen, egy rövidített karakterlánc, például "jsonp xml" először próbálja átalakítani, a jsonp az xml, és ennek hiányában, átalakítja jsonp a szöveget, majd a szöveg XML. |
| error(xhr,status,error) | A kérés sikertelensége esetén futtatandó függvény. error: hiba. Function típus: ( jqXHR, string textStatus, karakterlánc errorThrown) -------- errorThrown: hiba Dobva Ha a kérés sikertelen, hívni kell. A függvény három argumentumot kap: - A jqXHR (a jQuery 1.4.x, XMLHttpRequest) objektumban egy sor, amely leírja a hiba típusát és egy opcionális kivétel objektumot, ha hiba történt. - Lehetséges második argumentum értékek: (amellett, null ) a "timeout" , "error" , "abort" , és "parsererror". - Harmadik, ha egy HTTP-hiba lép fel, errorThrown megkapja HTTP állapot szöveges részét, mint a "Not Found" vagy "Internal Server Error". A jQuery 1.5, error beállítása el tud fogadni, egy sor funkció meghívást. Minden funkció egymás után meghívódik. Megjegyzés: Ez nem hívja be a domainek forgatókönyvét és domainek jsonp kéréseket. Ez egy Ajax Event, azaz esemény. |
| global | Logikai érték, amely megadja, hogy a kérelemhez globális AJAX eseménykezelőket kell-e indítani. Az alapértelmezett érték true, azaz, igaz. Típus: logikai Akkor is, ha globális Ajax eseménykezelőket indítanak ehhez a kéréshez, alapértelmezett érték true. Állítsa false értékre, hogy megakadályozza a globális rakódásokat, mint ajaxStart vagy ajaxStop-ra váltásokat. Ezt fel lehet használni, hogy ellenőrizzék a különböző Ajax eseményeket. |
| headers (default:{}) | Fejlécek (alapértelmezett: {} ) Típus: PlainObject -- (Sima objektum) További fejléc kulcs / érték párok objektuma az XMLHttpRequest transzfer használatával történő elküldéshez. A fejléc X-Requested-With: mindig XMLHttpRequest, de az alapértelmezett XMLHttpRequest érték módosítható. A headers beállítási értékek is felülírhatók, beforeSend funkción belül. (verzió hozzá: 1,5 ) Mi az XMLHttpRequest? Kattints ide! |
| ifModified | Logikai érték, amely megadja, hogy egy kérés sikeres-e, csak akkor, ha a válasz megváltozott az utolsó kérés óta. Alapértelmezett értéke: false (hamis). Típus: logikai A kérés csak akkor sikeres, ha a válasz az utolsó kérés óta megváltozott. Ezt az utolsó módosított fejléc ellenőrzésével végezheti el. Az alapértelmezett érték false , figyelmen kívül hagyva a fejlécet. A jQuery 1.4-ben ez a technika ellenőrzi a kiszolgáló által meghatározott "etag"-ot is, hogy megváltoztassa a nem módosított adatokat. |
| isLocal | isLocal (alapértelmezése: az aktuális helymeghatározási protokolltól függ.) Típus: logikai Engedélyezze, hogy az aktuális környezet "helyi" legyen (pl. A fájlrendszer), még akkor is, ha a jQuery alapértelmezésként nem ismeri fel. A következő protokollok jelenleg elismertek, helyi: file , *-extension , és widget. Ha isLocal beállítást igényel, ezt egyszer $.ajaxSetup() módszerrel történő módosítást javasoljuk. (version ki: 1.5.1 ) |
| jsonp | Egy karakterlánc, amely felülbírálja a visszahívási függvényt egy jsonp-kérésben. Típus: Karakterlánc vagy logikai A visszahívási függvény nevének felülbírálása JSONP kérésben. Ezt az értéket fogja használni a "callback" helyett a "callback =?" Az URL-ben található lekérdezési karakterlánc része. Tehát {jsonp:'onJSONPLoad'} vezetne 'onJSONPLoad=?' át a szerverre. Mivel a jQuery 1.5, amelyben a jsonp opciót false megakadályozza jQuery hozzátéve, a "? Visszahívás" string az URL vagy próbál használni "=?" Az átalakításhoz. Ebben az esetben, a jsonpCallback beállítást kell megadni. Például, { jsonp: false, jsonpCallback: "callbackName" }. Ha nem bízik a célban az Ajax kérésnél, fontolja meg a jsonp tulajdonságot false értékre állítani biztonsági okokból. |
| jsonpCallback | Megadja a visszahívási függvény nevét, a jsonp kérésben. Típus: Karakterlánc vagy Function () Megadja a JSONP kérés visszahívási funkciójának nevét. Ez az érték a jQuery által automatikusan generált véletlen név helyett használható. Előnyös, ha a jQuery egyedi nevet generál, mivel megkönnyíti a kérések kezelését, visszahívásokat és hibakezelést. Lehet, hogy megadja a visszahívást, ha engedélyezni szeretné a GET kéréseknek, jobb böngésző gyorsítótárazását. Mivel a jQuery 1.5, akkor is használhatja a funkció beállítást, amely esetben az értéke jsonpCallback van beállítva, hogy a visszatérési értéke, a funkció. |
| method | módszer (alapértelmezett a 'GET' ) Típus: Karakterlánc A HTTP módszert alkalmazza a kérelmhez (pl: "POST" , "GET" , "PUT" ). (version ki: 1.9.0 ) |
| mimeType | MimeType Típus: Karakterlánc A MIME típus, hogy felülbírálja a XHR MIME-típus. (version ki: 1.5.1 ) |
| password | Megadja a HTTP-hozzáférési hitelesítési kérésben használandó jelszót. Típus: Karakterlánc Az XMLHttpRequest segítségével HTTP-hozzáférés-hitelesítési kérésre választható, jelszó. Mi az XMLHttpRequest? Kattints ide! |
| processData | Logikai érték, amely megadja, hogy a kéréssel együtt elküldött adatokat lekérdezési karakterláncokká kell-e alakítani vagy sem. Az alapértelmezett érték true, azaz, igaz. Típus: logikai Felszerelése az alapértelmezett tartalom-típusú "application / x-www-form-urlencoded". Ha azt szeretné, hogy küldjön egy DOM Document, vagy más, nem-feldolgozott adatokat, állítsa be ezt az opciót, false értékre. |
| scriptCharset | Megadja a kérés karakterkészletét. Típus: Karakterlánc Csak akkor alkalmazható, ha a "szkript" közlekedést használják (pl. A "jsonp" vagy a "script" dataType és a "GET" típusú domainek között). Beállítja a charset attribútumot, melyet a script a kérésben használ. Használja akkor, ha a helyi oldalon a karakterkészlet nem egyezik meg, a távoli szkriptben szereplő karakterekkel. $.ajax({ method:"get", url:"/ajax/", scriptCharset: "utf-8" , |
| statusCode | statusCode (alapértelmezett: {} ) Típus: PlainObject Numerikus HTTP kódok és függvények objektuma, ha a válasznak megfelelő kódot kell tartalmaznia. Például az alábbiak figyelmeztetnek, ha a válaszállapot 404:
$.ajax({
statusCode: { 404: function()
{
alert( "az oldal nem található" );
}
}
});
Ha a kérés sikeres, az állapotkód funkciói megegyeznek a sikeres visszahívási paraméterekkel; Ha hibát eredményez: (beleértve 3xx átirányításokat), ezek a paraméterek azonosak az error visszahívással. Http átirányítások, állapotüzenetek. Kattints ide! (verzió hozzá: 1,5 ) |
| success(result,status,xhr) | A kérés sikeressége esetén futtatandó függvény. Típus: Function (result: Bármilyen adat, status: karakterlánc textStatus, xhr: jqXHR) Ha a kérés sikeres, akkor kell hívni. A funkció átad három érvet: A result, adatokat a szerver visszaadja, megfelelően formázott dataType paraméter vagy dataFilter visszahívási funkció, ha meg van adva; Státusz, amely leírja az állapotot; jqXHR (a jQuery 1.4.x, XMLHttpRequest) objektumot. Mi az XMLHttpRequest? Kattints ide! A jQuery 1.5, a siker beállításnál el tud fogadni egy sor funkciót. Minden funkció egymás után meghívódik. Ez egy Ajax Event (Esemény). |
| timeout | A kérelem helyi időtúllépése (ezredmásodpercben). Típus: szám. Állítsa be a kérés időtúllépését (milliszekundumban). A 0 érték azt jelenti, hogy nincs időkorlát. Ezzel a beállítással, $.ajaxSetup() felülbírálja, a globális timeout készletet. A megadott időtartamnál kezdődik, a $.ajax hívás. Ha több, más kérelem is folyamatban van, és a böngészőnek nincs elérhető kapcsolata, akkor lehetősége legyen, hogy a kéréstől idő előtt elállhasson, mielőtt az elküldhető lenne. A jQuery 1.4.x és alatt, az XMLHttpRequest objektum lesz érvénytelen állapotban, ha a kérés időtúllépés; Bármely objektum tagjának elérése kivételt tehet. A Firefox 3.0+ nál, csak script és jsonp kéréseknél, nem lehet törölni a timeout-ot; A szkript akkor is fut, ha az idő eltelte után érkezik. |
| traditional | Logikai érték, amely megadja, hogy a paraméterek sorozásának hagyományos stílusát kell-e használni vagy sem (serialization) Típus: logikai Állítsa ezt true értékre , ha szeretné használni a hagyományos stílust a param serialization-nál. |
| type | Meghatározza a kérés típusát. (GET vagy POST) Alapértelmezett a: 'GET' Típus: Karakterlánc jQuery 1.9.0. változatai előtt, érdemes használni type meghatározást. |
| url | Megadja a kérés elküldésének URL-címét. Alapértelmezett az aktuális oldal. Típus: Karakterlánc. A lekérdezés URL-címét tartalmazó, karakterlánc. |
| username | Megadja a HTTP-hozzáférési hitelesítési kérésben használandó felhasználónevet. Típus: Karakterlánc Az XMLHttpRequest alkalmazással használható felhasználónév, a HTTP hozzáférés hitelesítési kérelemre adott válaszként. Mi az XMLHttpRequest? Kattints ide! |
| xhr | Az XMLHttpRequest objektum létrehozására használt függvény. Minden modern böngészőnek (Chrome, IE7 +, Firefox, Safari és Opera) van egy beépített XMLHttpRequest objektuma.
xhr.status ---------- Kiírathatjuk a hiba számát.
xhr.statusText -- Kiírathatjuk a hibaszámhoz tartozó szöveget.
Példa:
error: function(xhr) { alert("Hiba lépett fel: " + xhr.status + " " + xhr.statusText); }
Alapértelmezett a: ActiveXObject, ha elérhető (IE), ellenkező esetben az XMLHttpRequest. Típus: Function () Visszahívás az XMLHttpRequest objektum létrehozásához. Mi az XMLHttpRequest? Kattints ide! |
| xhrFields | XhrFields Típus: PlainObject A FIELDNAME-fieldValue pár, beállítani a natív XHR objektumot. Például, akkor kell beállítania withCredentials true értékre, ha szükséges a domain kérelmekhez.
$.ajax({
url: a_cross_domain_url, // Domain, Tartományok közötti, URL cím.
xhrFields: { withCredentials: true } // withCredentials jelentése: hitelesítő adatokkal
});
Részletesen lásd itt: http://api.jquery.com/jquery.ajax/ |
Teszteléshez, a valami.txt fájlnak létezni kell DOMAIN tárhelyünkön (Szerveren), vagy a
saját számítógépünkre telepített APACHE szerver htdocs mappájában.
<html>
<head>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<script>
$(document).ready(function(){
// Állítsa be az alapértelmezett URL-t és a success, azaz, sikerfüggvényt az összes AJAX-kéréshez:
$("#btn1").click(function(){
$.ajaxSetup({url:"valami.txt", success: function(result){ $("#divid").html(result);} });
// Eddig, meghatároztuk mi történjen az ajax kérésnél.
// Most, meghívjuk az ajax metódust.
$.ajax();
});
});
</script>
</head>
<body>
<div id="divid"> <h2>Az AJAX, módosítsítani fogja ezt a tartalmat / szöveget.</h2> </div>
<button id="btn1"> Tartalom módosítása. Katt ide!</button>
</body>
</html>