Request PDF Drukuj

Atrybuty

  • responseText - odpowiedź z serwera jako tekst
  • responseXML - odpowiedź z serwera w formacie XML
  • responseJSON - odpowiedź z serwera w formacie JSON
  • getJSON - pobranie odpowiedzi z serwera w formacie JSON (wartość domyślna: false)
  • async - asynchroniczne wysyłanie zapytań (wartość domyślna: true)
  • method - metoda wysyłania zapytań ("GET", "POST" lub "HEAD") (wartość domyślna: "GET")
  • encoding - kodowanie znaków wysyłanych metodą POST (wartość domyślna: "utf-8")
  • contentType - typ zawartości (MIME) wysyłanej w zapytaniu (wartość domyślna: "text/plain")
  • username - nazwa użytkownika potrzebna do autoryzacji po stronie serwera (wartość domyślna: "")
  • password - hasło potrzebne do autoryzacji po stronie serwera (wartość domyślna: "")
  • evalScripts - wykonywanie skryptów znajdujących się w odebranej odpowiedzi (wartość domyślna: false)
  • evalResponse - wykonywanie skryptów załadowanych bezpośrednio z pliku .js (wartość domyślna: false)
  • resetForm - resetowanie wartości pól formularza po wysłaniu zapytania (wartość domyślna: true)
  • disableForm - blokowanie pól formularza przy wysyłaniu formularza do czasu otrzymania odpowiedzi (wartość domyślna: true)
  • retryNum - ilość prób ponownego wysłania zapytania podczas problemów z połączeniem (wartość domyślna: 3)
  • timeout - ilość czasu w milisekundach, która musi upłynąć aby ponowić próbę wysłania zapytania (wartość domyślna: 5000)
  • clearParams - czyszczenie parametrów po pomyślnym odebraniu odpowiedzi (wartość domyślna: true)
  • clearHeader - czyszczenie danych w nagłówku po pomyślnym odebraniu odpowiedzi (wartość domyślna: true)
  • status - numer statusu
  • statusText - nazwa statusu
  • OnComplete() - funkcja wywoływana podczas zakończenia pobierania odpowiedzi
  • OnSuccess() - funkcja wywoływana podczas pomyślnego zakończenia obsługi zapytania
  • OnError() - funkcja wywoływana podczas wystąpienia błędu
  • OnAbort() - funkcja wywoływana po przekroczeniu ilości prób wznawiania wysyłania zapytania
  • OnRetry() - funkcja wywoływana podczas wznawiania wysyłania zapytania po przerwaniu
  • OnTimeout() - funkcja wywoływana po przekroczeniu czasu wysyłania zapytania
  • OnStateChange() - funkcja wywoływana podczas zmiany statusu połączenia
  • OnLoading() - funkcja wywoływana podczas ładowania odpowiedzi
  • OnLoaded() - funkcja wywoływana po załadowaniu odpowiedzi
  • OnInteractive() - funkcja wywoływana podczas etapu interaktywnego

Metody

  • Send(url, [target]) - wysyła zapytanie AJAX do serwera
    • url - adres, gdzie wysłane ma zostać zapytanie
    • target - element, do którego załadowana zostanie zawartość odpowiedzi responseText
  • SendForm(form, [url, method]) - wysyła zapytanie AJAX do serwera zawierające wartości wszystkich pól danego formularza
    • form - identyfikator formularza lub element formularza
    • url - adres, gdzie wysłane ma zostać zapytanie (jeśli ten argument zostanie pominięty, pobrana zostanie wartość atrybutu action z elementu formularza)
    • method - metoda wysłania zapytania (jeśli ten argument zostanie pominięty, pobrana zostanie wartość atrybutu method z elementu formularza lub w przypadku jego braku zapytanie zostanie wysłane metodą POST)
  • AddParam(name, value) - dodaje parametr do zapytania
    • name - nazwa parametru
    • value - wartość parametru
  • AddHeader(name, value) - dodaje dane do nagłówka
    • name - nazwa pola
    • value - wartość
  • RemoveParam(name) - usuwa parametr
    • name - nazwa parametru
  • RemoveHeader(name) - usuwa dane z nagłówka
    • name - nazwa pola
  • Set(attr) - ustawia przekazane atrybuty (patrz Uwagi)
    • attr - obiekt zawierający pary "atrybut: wartość"
  • Set(name, value) - ustawia wartość atrybutu
    • name - nazwa atrybutu
    • value - nowa wartość

Opis

Obiekt służący do obsługi zapytań AJAX. 

Uwagi

  • Po ustawieniu atrybutu evalScripts na true wywoływane będą wszystkie skrypty znajdujące się w odpowiedzi pomiędzy tagami <script></script>, zarówno te znajdujące się bezpośrednio w pliku jak i ładowanie z zewnątrz, przykładowo jeśli w odebranej odpowiedzi znajdują się poniższe tagi <script>:

    <script type="text/javascript" src="script.js"></script>
    <script type="text/javascript">

        alert("Dynamicznie załadowany skrypt");

    </script>

    Wywołane zostaną skrypty znajdujące się w pliku script.js oraz funkcja alert.

  • Funkcja Set może zostać wywołana z jednym parametrem będącym obiektem zawierającym pary "atrybut: wartość" do ustawienia w obiekcie Request, funkcja ta przydatna jest przede wszystkim w przypadku korzystania z tych samych ustawień w kilku obiektach Request, przykładowo:

    var config = {
        username : "lorem",
        password : "ipsum",
        encoding : "iso-8859-2",
        evalScripts : true
    }

    mint.Request().Set(config).Send("first_request.php");
    mint.Request().Set(config).Send("second_request.php");
 
następny artykuł »