Сеть и состояние запроса

Четыре функции cookie изменяют состояние текущей сетевой сессии и влияют на следующие запросы. GENERATEUSERAGENT действует иначе: она только возвращает строку и сама не записывает её в заголовок запроса. Все вызовы используют общую запись функций in-Line.

Что выбрать

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

Где хранятся изменения cookie

Функции работают со списком имя=значение текущего сетевого исполнителя. Изменение не переписывает уже выполненный ответ, но используется при построении последующих HTTP-запросов; определение |COOKIES| показывает сохранённый список.

Правила переноса между проверками описаны в обзоре in-Line Kit.

Полное хранилище браузера различает область действия и защитные свойства. Их назначение определено в описании механизма cookie HTTP; четыре функции этой страницы намеренно работают с более узкой плоской формой.

Форма входных строк

Для добавления, замены и полной установки передавайте по одной записи на строку:

session=7f3a2c
theme=dark
token=abc==

• Первое = отделяет имя от значения, поэтому последующие знаки = остаются частью значения: token=abc== допустима.
• Пробелы в начале и конце всей строки, имени и значения удаляются; пустые строки пропускаются.
• Имя и значение должны быть непустыми. Хотя сетевой стандарт допускает некоторые пустые значения, эти функции их отвергают.
• Не добавляйте Cookie:, точки с запятой и свойства из ответа Set-Cookie: вход уже считается готовым набором плоских пар.

DELETECOOKIES принимает только имена по одному на строку. Запись session=любое_значение также удалит session, потому что часть после первого = при удалении не используется.

Четыре операции с cookie

#beginScript
(|ADDCOOKIES|session=7f3a2c
theme=dark|ADDCOOKIES|)
#endScript

Возвращаемая строка сообщает о вызове, но не содержит новый список. Не присваивайте её переменной как значение cookie; нужное состояние уже изменено побочным действием.

Изменения при ошибке

Обработка не является единым неделимым действием. Строки применяются сверху вниз, а ошибка на поздней строке не отменяет уже сделанное.

(|SETCOOKIES|session=7f3a2c
неверная строка|SETCOOKIES|)

Здесь прежний список уже очищен, session=7f3a2c уже добавлена, а затем функция возвращает обычный текст ошибки о форме второй строки. Исключение не возникает и сделанное не отменяется. ADDCOOKIES и REPLACECOOKIES так же сохраняют успешные ранние изменения. Поэтому сначала проверьте весь подготовленный список и только после этого вызывайте функцию, особенно SETCOOKIES.

GENERATEUSERAGENT

Функция принимает объект JSON, выбирает совместимое сочетание браузера, операционной системы, движка и вида устройства, затем подставляет значения в строку User-Agent. Пустой объект разрешён и означает полностью случайный совместимый выбор.

|DV|[UserAgent]=(|GENERATEUSERAGENT|{}|GENERATEUSERAGENT|)

|DV|[UserAgent] получит готовую строку. Чтобы она повлияла на запрос, укажите |DV|[UserAgent] в поле заголовка User-Agent; сам вызов заголовок не меняет. Назначение этого поля определено в описании HTTP.

Поля входного объекта

Все одиночные поля должны быть строками, а три поля exclude_* — массивами строк. Регистр известных названий не важен: исполнитель находит каноническое написание в действующем наборе.

Как выбирается совместимое сочетание

Действующий набор совместимости приходит вместе с данными авторизации и может обновляться без изменения проекта. Сначала функция отбирает сочетания по заданным полям и исключениям, затем случайно выбирает одно из оставшихся; пропущенные версии и модель тоже выбираются из совместимых значений.

(|GENERATEUSERAGENT|{}|GENERATEUSERAGENT|)

В поставляемом наборе встречаются Chrome, Firefox, Safari, Edge, Opera, Samsung Internet, UC Browser, Vivaldi, YaBrowser и Internet Explorer; Windows, macOS, Linux, Android, iOS и Tizen; Blink, Gecko, WebKit, EdgeHTML и Trident. Это не вечный перечень: источником истины остаётся набор, полученный текущим выпуском программы при авторизации. dtConsole распознаётся как название вида устройства, но в поставляемом наборе для него нет совместимого сочетания.

Свой шаблон

(|GENERATEUSERAGENT|{
  "browser":"Firefox",
  "os":"Linux",
  "user_agent_template":"{browser}/{browser_version} ({platform}; {engine}/{engine_version})"
}|GENERATEUSERAGENT|)

Доступны подстановки {browser}, {browser_version}, {os}, {os_version}, {platform}, {engine}, {engine_version}, {trident_version}, {device_model} и {chrome_version}. Неизвестная подстановка удаляется целиком, после чего повторные пробелы сворачиваются в один и края строки обрезаются.

Ошибки

Ошибка выполнения возникает, если вход не является объектом JSON, одно из известных свойств имеет неверный вид, объект содержит повторное имя свойства, массив исключений содержит не строку или пустую строку, название отсутствует в действующем наборе либо после ограничений не осталось совместимого сочетания.

GENERATEUSERAGENT не превращает такую ошибку в обычный результат: выполнение получает сообщение вида Ошибка: <причина> и отдельную рекомендацию изменить параметры или набор совместимости. Поэтому невозможное сочетание вроде Safari + Windows следует исправлять в исходном объекте, а не обрабатывать как допустимую строку User-Agent.