JavaScript свойство XMLHttpRequest.withCredentials

Определение и применение

JavaScript свойство withCredentials объекта XMLHttpRequest соответствует логическому значению, которое определяет необходимость аутентификации при выполнении междоменного CORS запроса (Cross-origin resource sharing, с англ. "совместное использование ресурсов между разными источниками") и необходимость обработки заголовков cookie в CORS ответах.

Обращаю Ваше внимание на то, что установка значения свойства withCredentials не окажет никакого эффекта, если запросы осуществляются на тот же веб-сайт.

Поддержка браузерами

Свойство	Chrome	Firefox	Opera	Safari	IExplorer	Edge
withCredentials	Да	Да	Да	Да	Да	Да

JavaScript синтаксис:

XMLHttpRequest.withCredentials = booleanValue;

booleanValue - Boolean

Cпецификация

Значения параметров

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

Пример ниже демонстрирует получение строкового значения от сервера, содержащее ответ на запрос в виде текста:

let xhr = new XMLHttpRequest(); // инициализируем только что созданный запрос
xhr.open("GET", "http://test.com/"); // определяем параметры для запроса 
xhr.withCredentials = true; //  определяем необходимость аутентификации при выполнении междоменного CORS запроса и необходимость обработки заголовков cookie в CORS ответах
xhr.send(); // отправляем запрос на сервер