jQuery.getScript()

> >

Содержание:

jQuery.getScript( url [, success ] )Возвращает: jqXHR

Описание: Загружает JavaScript файл с сервера при помощи GET HTTP запроса и затем исполняет его.

  • Добавлен в версии: 1.0jQuery.getScript( url [, success ] )

    • url
      Тип: String
      Строка с URL адресом, на который будет отправлен запрос.
    • success
      Тип: Function( String script, String textStatus, jqXHR jqXHR )
      Функция, которая вызывается если запрос будет успешно выполнен.

Это сокращенная функция Ajax эквивалентна коду:

1
2
3
4
5
 
$.ajax({
  url: url,
  dataType: "script",
  success: success
});

Скрипт выполняется в глобальном контексте, поэтому он может ссылаться на другие переменные и использовать функции JQuery. Подключенный сценарий может иметь определенное влияние на текущую страницу.

Успешная функция обратного вызова

Функция обратного вызова исполняется после того как он будет загружен, но необязательно до выполнения.

Скрипты подключаются и выполняются по имени файла:

1
2
3
4
5
6
 
$.getScript( "ajax/test.js", function( data, textStatus, jqxhr ) {
  console.log( data ); // Данные с сервера
  console.log( textStatus ); // Success
  console.log( jqxhr.status ); // 200
  console.log( "Загрузка была выполнена." );
});

Обработка ошибок

Начиная с jQuery 1.5, Вы можете использовать .fail() для учета ошибок:

1
2
3
4
5
6
7
 
$.getScript( "ajax/test.js" )
  .done(function( script, textStatus ) {
    console.log( textStatus );
  })
  .fail(function( jqxhr, settings, exception ) {
    $( "div.log" ).text( "Triggered ajaxError handler." );
});

До версии jQuery 1.5, только глобальный обработчик ошибок Ajax запросов .ajaxError() можно использовать для обработки ошибок метода $.getScript():

1
2
3
4
5
 
$( "div.log" ).ajaxError(function( e, jqxhr, settings, exception ) {
  if ( settings.dataType == "script" ) {
    $( this ).text( "Triggered ajaxError handler." );
  }
});

Кэширование ответа

По умолчанию, $.getScript() устанавливает настройку cache в значение false. Это добавит метку времени к строке запроса в URL адрес для гарантированного предотвращения кэширования браузером. Вы можете переопределить это поведение, при помощи глобального метода $.ajaxSetup():

1
2
3
 
$.ajaxSetup({
  cache: true
});

В качестве альтернативы, Вы можете определить новый более гибкий метод, при помощи $.ajax().

Примеры использования