Spec-Zone.ru › Web APIs

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

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

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

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

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

Чтение-только свойство credentials интерфейса Request отражает значение, заданное в конструкторе Request() в опции credentials. Оно определяет, отправляет ли браузер данные аутентификации вместе с запросом, а также учитывает заголовки ответа Set-Cookie.

Данные аутентификации включают cookie, клиентские сертификаты TLS или заголовки аутентификации, содержащие имя пользователя и пароль.

Дополнительные сведения см. в разделе Включение данных аутентификации.

Значение

Строка с одним из следующих значений:

omit

Никогда не отправлять данные аутентификации в запросе или включать их в ответ.

same-origin

Отправлять и включать данные аутентификации только для запросов с тем же происхождением.

include

Всегда включать данные аутентификации, даже для запросов с другим происхождением.

Примеры

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

const request = new Request("flowers.jpg");
const credentials = request.credentials; // returns "same-origin" by default

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

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

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
credentials 40 14 39 27 10.1 40 39 27 10.3 4.0 40
default_same-origin 72 18 61 55 12.1 72 61 Нет 12.2 11.0 72

См. также

  • API для Service Worker
  • Управление доступом к ресурсам (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/credentials

Spec-Zone.ru

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