Spec-Zone.ru › Web APIs

Запрос: свойство destination

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в рабочих потоках.

Чтение только свойство destination интерфейса Request возвращает строку, описывающую тип запрашиваемого содержимого.

Строка должна быть одной из audio, audioworklet, document, embed, fencedframe, font, frame, iframe, image, json, manifest, object, paintworklet, report, script, sharedworker, style, track, video, worker или xslt строк, или пустой строкой, что является значением по умолчанию.

destination используется агентом пользователя destination для, например, определения набора правил для CORS или обработки сложных путей кода, влияющих на обработку определённых типов запросов.

Эти назначения существенно различаются по своему функционированию. Некоторые из них являются контейнерами данных, где полученные данные хранятся для последующей обработки. Другие основаны на сценариях, в этом случае полученные данные передаются скрипту путём вызова и передачи данных. Скриптовые назначения включают элементы <script>, а также любые назначения на основе Worklet (включая подклассы, такие как AudioWorklet), и назначения на основе Worker, включая ServiceWorker и SharedWorker.

Значение

Строка, указывающая тип содержимого, запрашиваемого запросом. Этот тип намного шире, чем обычные типы документов (такие как "document" или "manifest"), и может включать контекстные указания, такие как "image" или "worker" или "audioworklet".

Возможные значения:

""

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

  • <a ping>
  • <area ping>
  • Cache
  • EventSource
  • fetch()
  • navigator.sendBeacon()
  • WebSocket
  • XMLHttpRequest
"audio"

Целью является аудиоданные.

"audioworklet"

Целью являются данные, полученные для использования аудио-ворклетом.

"document"

Целью является документ (HTML или XML).

"embed"

Целью является встроенное содержимое.

"fencedframe"

Целью является отделенный кадр.

"font"

Целью является шрифт.

"image"

Целью является изображение.

"json"

Целью является файл JSON.

"manifest"

Целью является манифест.

"object"

Целью является объект.

"paintworklet"

Целью является paint worklet.

"report"

Целью является отчёт.

"script"

Целью является скрипт.

"serviceworker"

Целью является сервис-воркер.

"sharedworker"

Целью является общий рабочий поток.

"style"

Целью является стиль

"track"

Целью является элемент HTML <track>.

"video"

Целью является видеоданные.

"worker"

Целью является рабочий поток.

"xslt"

Целью является преобразование XSLT.

Примеры

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

const myRequest = new Request("flowers.jpg");
const myDestination = myRequest.destination; // returns the empty string by default

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

Спецификация
Fetch
# ref-for-dom-request-destination①

Совместимость браузеров

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
destination 65 14 61 52 10.1 65 61 47 10.3 9.0 65

См. также

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Request/destination

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API