Запрос

Интерфейс Request API Fetch представляет запрос на ресурс.

Вы можете создать новый объект Request с помощью конструктора Request(), но вам, скорее всего, встретится объект Request в результате другой операции API, например, операции FetchEvent.request в обработчике сервиса.

Request()

Создаёт новый объект Request.

Request.body Только для чтения

Поток ReadableStream содержимого тела.

Request.bodyUsed Только для чтения

Содержит true или false для указания того, использовалось ли тело в запросе.

Request.cache Только для чтения

Содержит режим кэширования запроса (например, default, reload, no-cache).

Request.credentials Только для чтения

Содержит данные аутентификации запроса (например, omit, same-origin, include). По умолчанию same-origin.

Request.destination Только для чтения

Строка, описывающая тип запрашиваемого содержимого.

Request.headers Только для чтения

Содержит связанный объект Headers запроса.

Request.integrity Только для чтения

Содержит значение целостности подресурса subresource integrity запроса (например, sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=).

Request.isHistoryNavigation Только для чтения

Логическое значение, указывающее, является ли запрос навигацией по истории.

Request.keepalive Только для чтения

Содержит параметр keepalive запроса (true или false), который указывает, сохранит ли браузер связанный запрос открытым, если страница, которая его инициировала, будет закрыта до завершения запроса.

Request.method Только для чтения

Содержит метод запроса (GET, POST, и т. д.).

Request.mode Только для чтения

Содержит режим запроса (например, cors, no-cors, same-origin, navigate).

Request.redirect Только для чтения

Содержит режим обработки перенаправлений. Может быть одним из follow, error, или manual.

Request.referrer Только для чтения

Содержит ссылку на отправителя запроса (например, client).

Request.referrerPolicy Только для чтения

Содержит политику ссылки на отправителя запроса (например, no-referrer).

Request.signal Только для чтения

Возвращает связанный с запросом AbortSignal.

Request.url Только для чтения

Содержит URL запроса.

Request.arrayBuffer()

Возвращает промис, который разрешается представлением тела запроса в формате ArrayBuffer.

Request.blob()

Возвращает промис, который разрешается представлением тела запроса в формате Blob.

Request.bytes()

Возвращает промис, который разрешается представлением тела запроса в формате Uint8Array.

Request.clone()

Создаёт копию текущего объекта Request.

Request.formData()

Возвращает промис, который разрешается представлением тела запроса в формате FormData.

Request.json()

Возвращает промис, который разрешается результатом парсинга тела запроса как JSON.

Request.text()

Возвращает промис, который разрешается текстовым представлением тела запроса.

В следующем фрагменте мы создаём новый запрос с помощью конструктора Request() (для файла изображения в том же каталоге, что и скрипт), а затем возвращаем некоторые свойства запроса:

const request = new Request("https://www.mozilla.org/favicon.ico");

const url = request.url;
const method = request.method;
const credentials = request.credentials;

Затем вы можете выполнить запрос с помощью объекта Request как параметра вызова fetch(), например:

fetch(request)
  .then((response) => response.blob())
  .then((blob) => {
    image.src = URL.createObjectURL(blob);
  });

В следующем фрагменте мы создаём новый запрос с помощью конструктора Request() с некоторыми начальными данными и содержимым тела для запроса API, которому требуется тело с данными:

const request = new Request("https://example.com", {
  method: "POST",
  body: '{"foo": "bar"}',
});

const url = request.url;
const method = request.method;
const credentials = request.credentials;
const bodyUsed = request.bodyUsed;

Вы можете выполнить запрос к API, передав объект Request в качестве параметра вызова fetch(), например, и получить ответ:

fetch(request)
  .then((response) => {
    if (response.status === 200) {
      return response.json();
    } else {
      throw new Error("Something went wrong on API server!");
    }
  })
  .then((response) => {
    console.debug(response);
    // …
  })
  .catch((error) => {
    console.error(error);
  });

• API сервисных рабочих процессов
• Управление доступом к ресурсам (CORS)
• HTTP