Объект Request

  Request - Интерфейс к запросу доступа к ресурсу (например, методом fetch).
  Экземпляр доступен:

  • В выражении

          new Request(URL|Запрос[, Опции])

    где:
    • new - Ключевое слово.
    • Request - Ключевое слово.
    • URL - URL-адрес ресурса, заданный в любом строковом формате.
        В частности URL может ссылаться на серверный скрипт (например, скрипт PHP), который динамически сформирует требуемый ресурс, и может вернуть его в ответ на этот запрос выполненный методом fetch.
    • Запрос - Любой операнд значения со значением экземпляра объекта Request - интерфейса к запросу ресурса, по шаблону которого создаётся новый запрос.
    • , - Оператор группировки. Ключевое слово в этом формате.
    • Опции - Набор опций заданный в любом формате экземпляра объекта.
        Этот экземпляр объекта должен иметь следующие свойства:
      • method – Метод запроса.
          Одно из строковых значений:
        • get - Запрос без передачи информации в запросе (умолчание).
        • post - Запрос с передачей информации в запросе.
      • headers – Заголовки запроса.
          Значение - соответствующий экземпляр объекта Headers, или строка.
          Для post в заголовке надо указать Content-type тела, который должен совпасть с серверными настройками.
          Например headers: {"Content-type": "application/x-www-form-urlencoded; charset=UTF-8" }.
      • body – Тело запроса.
          Только для post.
          Одно из значений:
        • Соответствующий экземпляр объекта Blob.
        • Соответствующий экземпляр BufferSource.
        • Соответствующий экземпляр объекта FormData.
        • Соответствующий экземпляр объекта URLSearchParams.
        • Строка.
      • mode – Режим кросс-доменности запроса.
          Одно из строковых значений:
        • same-origin. - Этот запрос может быть успешно выполнен только если он сделан на ресурс находящийся в рамках той же самой Web-страницы что и документ, создавший этот запрос (origin).
        • cors - Этот запрос может быть успешно выполнен, даже если он кроссдоменный, но при условии, что на него будут получены и CORS заголовки.
        • no-cors - Этот запрос всегда будет возвращать type = opaque.
      • credentials – Отправлять или нет учетные данные (кукисы) с запросом (для post).
          Одно из строковых значений:
        • omit - Не отправлять в любом случае (умолчание).
        • same-origin - Отправлять только в этом домене.
        • include - Пытаться отправлять всегда, даже для кроссдоменного запроса.
      • cache – Режим использования запросом кэш-памяти браузера по протоколу http.
          Одно из строковых значений:
        • default - Браузер должен искать запрошенный ресурс в кэше http.
          • При наличии в кзше нового запрошенного ресурса, он будет взят из кэша.
          • При наличии в кзше не нового запрошенного ресурса, браузер сделает этот запрос на соответствующий ресурс. Если обнаружится, что этот ресурс не был изменен, он будет взят из кэша. В противном случае браузер сделает попытку загрузить запрошенный ресурс в кэш и возьмёт его оттуда.
          • При отсутствии в кзше запрошенного ресурса, браузер сделает попытку загрузить запрошенный ресурс в кэш и возьмёт его оттуда.
        • no-store - Браузер всегда будет делать попытку получить запрошенный ресурс без проверки кэша, и не будет обновлять кэш http.
        • reload - Браузер всегда будет делать попытку получить запрошенный ресурс без проверки кэша, одновременно обновляя кэш http если ресурс будет получен.
        • no-cache - Браузер должен искать соответствующий ресурс в кэше http.
          • При наличии в кзше запрошенного ресурса, браузер сделает этот запрос на соответствующий ресурс. Если обнаружится, что этот ресурс не был изменен, он будет взят из кэша. В противном случае браузер сделает попытку загрузить запрошенный ресурс в кэш и возьмёт его оттуда.
          • При отсутствии в кзше запрошенного ресурса, браузер сделает попытку загрузить запрошенный ресурс в кэш и возьмёт его оттуда.
        • force-cache - Браузер должен искать запрошенный ресурс в кэше http.
          • При наличии в кзше запрошенного ресурса, браузер возьмёт его из кэша.
          • При отсутствии в кзше запрошенного ресурса, браузер сделает попытку загрузить запрошенный ресурс в кэш и вернёт его оттуда.
        • only-if-cached - Браузер должен искать запрошенный ресурс в кэше http.
          • При наличии в кзше запрошенного ресурса, браузер возьмёт его из кэша.
          • При отсутствии в кзше запрошенного ресурса, браузер выдаст ошибку.
            only-if-cached можно использовать только при запросе same-origin. Кроссдоменность должна соблюдаться и в случае редиректа.
      • redirect – Условие перенаправления запроса.
          Одно из строковых значений:
        • follow - При коде - 30x выполнять редирект (умолчание).
        • error - Интерпретировать код - 30x как ошибку.

  • С помощью метода clone.
  Свойства.
  bodyUsed - Содержит значение false если ни один из методов этого экземпляра объекта Request для чтения тела запроса еще не вызывался, и значение true - в противном случае.
  Значение имеет логический формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.bodyUsed

Значения формата записи:

  cache - Содержит значение опции cache.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.cache

Значения формата записи:

  credentials - Содержит значение опции credentials.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.credentials

Значения формата записи:

  headers - Содержит значение опции headers.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.headers

Значения формата записи:

  method - Содержит значение опции method.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.method

Значения формата записи:

  mode - Содержит значение опции mode.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.mode

Значения формата записи:

  redirect - Содержит значение опции redirect.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.credentials

Значения формата записи:

  referrer - Содержит реферер запроса.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.referrer

Значения формата записи:

  referrerPolicy - Содержит реферер политики запроса.
  Значение имееет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.referrerPolicy

Значения формата записи:

  url - Содержит значение URL.
  Значение имеет строковый формат.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.url

Значения формата записи:

  Методы.
  arrayBuffer - Инициирует "обещание" извлечения тела запроса в формате arrayBuffer.
  Возвращает ссылку на соответствующий экземпляр объекта Promise.
  Если "обещание" будет выполнено, то оно возвратит ссылку на соответствующий экземпляр объекта ArrayBuffer.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.arrayBuffer()

Значения формата записи:

  blob - Инициирует "обещание" извлечения тела запроса в формате blob.
  Возвращает ссылку на соответствующий экземпляр объекта Promise.
  Если "обещание" будет выполнено, то оно возвратит ссылку на соответствующий экземпляр объекта Blob.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.blob()

Значения формата записи:

  clone - Создает клон этого экземпляра объекта Request, который полностью идентичен ему.
  Возвращает ссылку на созданный экземпляр объекта Request.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.clone()

Значения формата записи:

  formData - Инициирует "обещание" извлечения тела запроса в формате formData.
  Возвращает ссылку на соответствующий экземпляр объекта Promise.
  Если "обещание" будет выполнено, то оно возвратит ссылку на соответствующий экземпляр объекта FormData.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.formData()

Значения формата записи:

  json - Инициирует "обещание" извлечения тела запроса, содержащего данные в формате JSON.
  Возвращает ссылку на соответствующий экземпляр объекта Promise.
  Если "обещание" будет выполнено, то оно возвратит соответствующую строку тела запроса.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.json()

Значения формата записи:

  text - Инициирует "обещание" извлечения тела запроса в текстовом формате.
  Возвращает ссылку на соответствующий экземпляр объекта Promise.
  Если "обещание" будет выполнено, то оно возвратит строку с телом запроса текстовом формате.
  Исходный текст должен быть в коде UTF_8.

Формат записи в коде скрипта:

  • Экземпляр объекта Request.text()

Значения формата записи: