Основы языка in-Line

in-Line Kit читает специальные записи непосредственно из полей проекта. Чтобы выражение было предсказуемым, сначала определите источник данных, затем форму переменной и только после этого добавляйте функции или условия.

Порядок обработки

Переменные

У переменных есть три основные формы записи.

Правило 1. Номер пишется в квадратных скобках

Правило 2. Имя находится внутри одной пары скобок

Правило 3. Значение должно уже существовать

Результаты парсеров и циклов

• |PARS|[n] — результат обычного парсера с номером n.
• |REGEX|[n] — результат парсера по регулярному выражению с номером n.
• |REGEXCYCLE|[n] — значение с номером n из циклических результатов парсера по регулярному выражению.
• |PARSCYCLE|[n] — результат обычного парсера в циклическом запросе.
• |REGEXCOUNT|[n] — количество строк в результате парсера по регулярному выражению с номером n.
• |REGEXGLUE|[1, | ,2, \ ,3] — склеивает результаты нескольких регулярных выражений, помещая указанные разделители между ними.
• |SIMPLEGLUE|[1, Пароль - |PWD|] — склеивает результат обычного парсера с указанным текстом или переменной.
• |CYCLE|[1-9] — создаёт циклический запрос по целому диапазону от 1 до 9.
• |CUSTOMCYCLE|[...] — создаёт цикл по значениям, введённым пользователем в динамической настройке.
• |CUSTOMCYCLEVALUE| — текущее значение активной итерации |CUSTOMCYCLE|; доступно в адресе, заголовках, данных запроса и Скрипт-боксе.

Пример пользовательского цикла с запятой как разделителем:

https://example.test/?item=|CUSTOMCYCLE|[|DYNAMICSTR|(Список значений)|DL|(разделитель для значений),]

Здесь |DYNAMICSTR| выбирает настройку «Список значений», а |DL| задаёт запятую как разделитель. При значении настройки one,two цикл выполнит две итерации; |CUSTOMCYCLEVALUE| вернёт сначала one, затем two.

Входная строка

Пусть первое входное значение равно [email protected], а второе — secret:

• |VALUE|[1] — первая часть строки после применения маски;
• |VALUE|[2] — вторая часть строки после применения маски;
• |LOGIN| — [email protected];
• |PWD| — secret;
• |LOGIN|D| — доменная часть логина, example.com;
• |LOGIN|ND| — логин без доменной части, alice.

|VALUE|[n] описывает положение в маске, а |LOGIN| и |PWD| обозначают назначение первых входных значений. Используйте |VALUE|[n], когда строка содержит больше двух частей или её поля имеют другое назначение.

Прокси и сетевой запрос

• |IP| — адрес текущего прокси-сервера.
• |PORT| — порт текущего прокси-сервера.
• |PROXYTYPE| — тип соединения с прокси-сервером.
• |PROXY| — полная строка ip:port:user:password|type.
• |PROXYLOGIN| — имя пользователя прокси-сервера.
• |PROXYPWD| — пароль прокси-сервера.
• |PROXYURI| — строка вида protocol://user:password@ip:port.
• |REDIRECT| — адрес последнего перехода, выполненного запросом.
• |REDIRECTHISTORY|[1] — исходный адрес запроса; [2] — первый выполненный переход, далее номера идут по порядку.
• |USERAGENT| — текущая строка пользовательского агента.

История переходов является многострочным списком. Если код находится в Скрипт-боксе JavaScript, то же состояние доступно как массив PK.redirectHistory.

Данные проекта

• |RANDOMSTRING|[n] — результат с номером n, ранее созданный функцией |RANDOM|.
• |DV|[name] — значение существующей динамической переменной name.
• |SB|[name] — содержимое динамической переменной name, которое нужно выполнить как часть кода Скрипт-бокса.

Маска входной строки

Маска определяет, как одна входная строка делится на |VALUE|[1], |VALUE|[2] и последующие части.

Маска:   |VALUE|[ || ]|VALUE|
Строка:  [email protected] || password123

Результат:
|VALUE|[1] = [email protected]
|VALUE|[2] = password123

Правило 1. Составной разделитель заключается в скобки

Всё внутри [...] считается одним точным разделителем.

Правило 2. Скобки принадлежат маске, а не входной строке

Правило 3. Пробелы являются частью разделителя

Правило 4. Односимвольный разделитель можно записать двумя способами

Определения

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

• |RESPONSE| — тело ответа сервера.
• |HEADERS| — заголовки ответа сервера.
• |COOKIES| — сохранённые cookie.
• |NETWORKOUTCOME| — результат попытки: not_run, success или transport_error.
• |NETWORKERRORKIND| — вид ошибки: none, dns_failure, timeout, connection_reset, connection_refused, tls_failure или other.
• |NETWORKERRORCODE| — числовой код сетевой библиотеки.
• |NETWORKERRORMESSAGE| — техническое сообщение сетевой библиотеки.
• |ALLOTHER| — все ответы, которые не совпали с остальными правилами; применяется только в определении плохого запроса.
• |ID|name| — идентификатор определения, например |ID|blocked-response|.

При not_run и success вид ошибки равен none, код — 0, а сообщение пустое. При transport_error вид принимает одно из шести значений ошибки, код сохраняет исходную диагностику сетевой библиотеки, а сообщение содержит технический текст.

Полный пример сохраняет диагностику только при транспортной ошибке:

#beginScript
|||NETWORKOUTCOME||=|transport_error
|DV|[NetworkFailure] = |NETWORKERRORKIND| (|NETWORKERRORCODE|): |NETWORKERRORMESSAGE|
||END
#endScript

Динамическая переменная NetworkFailure должна существовать в проекте до выполнения этого кода.

Логические операторы

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

Сравнение

• |>|, |<|, |>=|, |<=| — числовые сравнения.
• |=| — равенство чисел или строк.
• |<>| — неравенство чисел или строк.
• |pos>0| — левая подстрока найдена в правой строке.
• |pos=0| — левая подстрока не найдена в правой строке.

Соединение условий

• |AND| возвращает истину, только если истинны оба соседних блока.
• |OR| возвращает истину, если истинен хотя бы один соседний блок.

Группировка и буквальные скобки

Обычные круглые скобки задают порядок вычисления сложного условия. Если скобка должна стать частью текста внутри функции, используйте |LFNC| для ( и |RFNC| для ).

Условный вывод

|DOLOGIC|условие|ENDLOGIC|текст|DOLOGIC| добавляет текст в результат только при истинном условии.

|DOLOGIC|Чекер|pos>0||METHOD||ENDLOGIC|Баланс - |PARS|[1]|DOLOGIC|

Если динамическая настройка |METHOD| содержит подстроку Чекер, в результат добавляется Баланс - и значение первого парсера.

История результатов

• |LLR|[n] возвращает сохранённый логический результат с номером n как True или False.
• |LNS| запрещает сохранять результат текущего выражения в историю.
• |THIS| возвращает текущий парсер внутри логического правила парсера.
• |DV|[logicField] может содержать целое логическое выражение; интерпретатор рекурсивно выполнит его как условие.

Определения не добавляют результаты в |LLR|.

Логические блоки

В выражении 1|>|2|OR|2|>|1 находятся два логических блока: 1|>|2 и 2|>|1. Оператор |OR| соединяет их, но каждый блок остаётся самостоятельным сравнением.

В определениях доступны две дополнительные команды:

• |USEAG| указывает, что при совпадении проверяемого значения нужно использовать модуль распознавания капчи;
• |AGREPORT| указывает, что при неверно распознанной капче нужно отправить жалобу в выбранную службу.

Линейный блок Скрипт-бокса начинается с || и заканчивается ||END. Его порядок выполнения, присваивание и вложенные условия подробно разобраны на странице Скрипт-бокс.