Данные и состояние

Методы этой страницы работают с уже созданными данными проекта. Они не создают парсер, динамическую переменную или настройку по имени: сначала объявите нужный элемент в Студии, затем обращайтесь к нему из JavaScript.

Карта данных

Два разных правила индексов

Индексы нельзя переносить между этими группами без пересчёта:

const firstParser = PK.getPars(1);
const firstInputPart = PK.getInputValue(0);

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

Каждый рабочий поток имеет собственные результаты парсеров. Перед обработкой входной строки ячейки 1…101 получают служебную строку |NOT USED|; действие разбора или метод записи заменяет значение выбранной ячейки. Позднее действие с тем же номером может заменить его снова.

Подробные различия обычного разбора и регулярного выражения показаны в общей справке по разбору текста.

const rawProfile = PK.getPars(1);
const profile = JSON.parse(rawProfile);
const userId = profile.user.id;

const normalizedLogin = PK.login.trim().toLowerCase();
PK.setPars(1, normalizedLogin);

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

PK.getInputValue(index)

Возвращает часть исходной строки после разделения по маске входа проекта. В отличие от парсеров, здесь используется нумерация с нуля.

Для маски из трёх значений:

const login = PK.getInputValue(0);
const password = PK.getInputValue(1);
const recoveryEmail = PK.getInputValue(2);

if (login !== PK.login || password !== PK.pwd) {
  throw new Error("Входные значения не совпали");
}

Первые две части совпадают с PK.login и PK.pwd. Третья и последующие доступны только по номеру.

Динамические переменные

Имя динамической переменной сравнивается точно и с учётом регистра. Переменная должна быть объявлена в проекте заранее. Её область — локальная или глобальная — задаётся в Студии и не меняется методом PK.

Области, начальные значения и сохранение в сессии подробно разобраны в справке по состоянию выполнения.

PK.getDV(name)

Ищет объявленную динамическую переменную по точному имени и возвращает её текущее значение.

const currentPage = PK.getDV("CurrentPage");

Если имя не найдено, исполнитель возвращает точную строку no such dynamic variable. Она неотличима от такого же настоящего значения, поэтому правильный способ избежать двусмысленности — объявить переменную и использовать одно точное имя, а не разбирать диагностический текст.

PK.setDV(name, value)

Находит объявленную динамическую переменную и немедленно заменяет её значение.

const page = 7;
PK.setDV("CurrentPage", String(page));

Если имя не найдено, метод молча ничего не меняет. Он не создаёт новую переменную, поэтому ошибка в регистре, например currentPage вместо CurrentPage, оставит старое состояние без отдельного сообщения.

Динамические настройки

PK.getDS(name)

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

const apiBaseUrl = PK.getDS("ApiBaseUrl");

Если имя не найдено, исполнитель возвращает точную строку no such dynamic setting. Она может совпасть с настоящим содержимым, поэтому имя настройки должно задаваться проектом однозначно; не используйте этот текст как надёжный признак отсутствия.

Критическая секция

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

PK.enterCriticalSection()

Ожидает освобождения общей секции проекта и входит в неё. После успешного входа остальные потоки, которым нужна эта же секция, ждут вызова PK.leaveCriticalSection().

PK.leaveCriticalSection()

Освобождает секцию, в которую текущий поток ранее успешно вошёл. Вызывайте метод только из finally: тогда ошибка преобразования или записи не оставит остальные потоки заблокированными.

Безопасное увеличение общего счётчика

До запуска создайте глобальную динамическую переменную Processed с начальным значением 0.

PK.enterCriticalSection();

try {
  const currentText = PK.getDV("Processed");
  const current = Number(currentText);

  if (!Number.isInteger(current)) {
    throw new Error("Processed должен содержать целое число");
  }

  PK.setDV("Processed", String(current + 1));
} finally {
  PK.leaveCriticalSection();
}

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

Та же последовательность для Скрипт-бокса показана в справке in-Line Kit.