Объект PK

Что такое объект PK

PK — встроенный объект, через который JavaScript-код Скрипт-бокса получает данные текущего запуска Private Keeper и вызывает операции программы. Например, PK.login читает первое входное значение, PK.getPars(4) возвращает четвёртый результат обычного парсера, а PK.md5(text) вычисляет MD5 строки.

Объект создаёт сама программа и помещает его в глобальную область выполнения. Это не класс и не конструктор: обращайтесь к готовой переменной PK, не пишите new PK().

Первый рабочий пример

Пример вычисляет MD5 строки test и сохраняет результат в динамическую переменную Digest.

const digest = PK.md5("test");
PK.setDV("Digest", digest);

Здесь PK.md5(...) возвращает строку, а PK.setDV(...) выполняет отдельное действие и ничего не возвращает. Поэтому результат сначала помещён в переменную digest, а затем явно записан в состояние проекта.

Правила среды QuickJS

JavaScript выполняется движком QuickJS в глобальном контексте Скрипт-бокса. Код из руководств для браузера или Node.js подходит только тогда, когда он не зависит от возможностей отсутствующей среды.

Например, эти записи решают разные задачи:

// Готовый объект Private Keeper: подключение не требуется.
const digest = PK.md5("test");

// Глобальный объект установленной библиотеки, если она его предоставляет.
const helper = globalThis.SomeLibrary;

Следующая запись для Скрипт-бокса неверна, потому что он выполняет глобальный сценарий, а не модуль ES6:

import helper from "some-library";

Порядок изучения