Содержание
Начало работы
Установка
Для nlcloud нужен Node.js 20+. Добавьте библиотеку в проект:
npm install nlcloud
Первые шаги
Вот полная программа, которая использует nlcloud.
import { Client } from "nlcloud";
const client = new Client({
path: "flags.yaml",
reloadInterval: 10_000, // ms
});
const ok = await client.enabled("new-checkout", "u_1842");
console.log(ok);
const v = await client.variant("search-ranking", "u_1842");
console.log(v);
Файл флагов
Флаги объявляются в YAML- или JSON-файле. У каждого флага есть значение по умолчанию и упорядоченный список правил; значение определяет первое совпавшее правило.
Храните файл в репозитории и выкатывайте вместе с кодом или укажите nlcloud путь, который обновляет другой процесс.
Вычисление флагов
Передайте имя флага, контекст вычисления и значение по умолчанию. Контекст несёт атрибуты, по которым срабатывают правила, например id пользователя.
Вычисление никогда не падает. Неизвестные флаги и несовпадение типов возвращают значение по умолчанию и сообщаются через хук ошибок.
Раскатки
Процентное правило хэширует имя флага и стабильный атрибут, обычно id пользователя, в корзину от 0 до 99. Увеличение процента только добавляет пользователей — никто не переключается туда-обратно.