Fetch API

Fetch API предоставляет интерфейс для получения ресурсов (файлов и любых други данных, например, по сети). Это покажется знакомым любому, кто использовал XMLHttpRequest, но новое API является более мощным и гибким набором функций.

Понятия и использование

Fetch обеспечивает обобщенное определение объектов Request и Response (и других вещей, связанных с сетевыми запросами). Это позволит им использоваться везде, где необходимо в будущем, в том числе и для service workers, Cache API и других подобных технологий, которые обрабатывают или изменяют запросы (requests) и ответы (responses), а так же в любых других случаях, которые могут потребовать от вас генерировать свой собственный ответ программно.

Это так же предоставляет определение в отношение таких понятий, как CORS и семантика заголовоков HTTP origin, заменяя их обособленные определения где бы то ни было.

Чтобы создать запрос и получить данные, используется метод GlobalFetch.fetch. Он реализован во множестве интерфейсов, в том числе в Window и WorkerGlobalScope. Это позволяет использовать их практически в любом контексте для получения данных.

Метод fetch() принимает один обязательный аргумет —  путь к данным, которые вы хотите получить. Он возвращает promise, который ведёт к ответу (Response) на запрос, если все прошло удачно. Вы можете также передать во втором аргументе необязательный объект с указанием опций (см. Request.)

Как только Response выполнится успешно, становятся доступными несколько методов для определения тела контента и, как его содержимое должно быть обработано (см. Body.)

Вы можете создавать запрос и ответ непосредственно, используя конструкторы Request() и Response(), но маловероятно, что в этом есть необходимость. Напротив, Request и Response могут быть переданы как результат работы другого API (например, FetchEvent.respondWith в service workers.)

Fetch интерфейсы

GlobalFetch

Содержит метод fetch(), используемый для получения ресурсов.

Headers

Представляет заголовки запроса/ответа, позовляет запрашивать данные и выполнять различные действия в зависимости от результата.

Request

Запрашивает ресурс.

Response

Представляет ответ на запрос.

Fetch примесь

Body

Предоставляет методы, отсносящиеся к телу запроса/ответа, позволяя вам определять content-type и то, как ответ должен быть обработан.

Спецификации

Браузерная совместимость

Смотрите также

• ServiceWorker API
• HTTP access control (CORS)
• HTTP
• Fetch полифил
• Fetch базовые понятия