Пресет — це іменований набір трансформацій із відомою ціною в розмірі та часі виконання. Важчий пресет застосовує більше трансформацій; це не виміряне посилення захисту. Одна назва задає цільову складність; розмір результату випливає з цієї цілі. Явне задання complexity перекриває ціль, а значення, задане напряму, завжди застосовується до кожного токена, навіть на light.
Шкала
| Пресет | complexity | Типовий розмір після gzip | Мінімум для рядків | Коли обирати |
|---|---|---|---|---|
minify | 0 | 1.09x–1.17x | вимк. | Без обфускації. Ідентифікатори перейменовано, а код стиснуто; рядкові літерали залишаються читабельними. |
light | 5 | 1.29x–1.60x | увімк. | За замовчуванням. Додає до minify кодування рядків і переписує синтаксис, без структурних шарів. Правильна базова лінія для більшості проєктів. |
medium | 7 | 6.04x–8.33x | увімк. | Продакшн-код, за яким має бути помітно важче стежити. |
hard | 12 | 6.62x–9.23x | увімк. | Код, що має значення: ціноутворення, обмеження доступу, перевірки ліцензій, клієнтська бізнес-логіка. |
extreme | 25 | 8.25x–11.19x | увімк. | Найвища застосовувана складність. Націлюйте його на файл або ділянку, а не на весь бандл. |
Розмір результату після gzip виміряно проти того самого вже мініфікованого файлу, на п'яти реальних мініфікованих продакшн-бандлах, з AfterPack 0.2.6, 16 жовтня 2026 року; метод описано на сторінці Продуктивність.
Мінімальне кодування рядків увімкнене для будь-якого додатного цільового значення.
За замовчуванням діє light
Запустіть npx afterpack@latest dist/ без --preset або встановіть плагін і нічого не налаштовуйте, і ви отримаєте light.
$ npx afterpack@latest dist/npx afterpack@latest dist/ --preset=hard # step upПрапорці приєднують значення через =. Значення, відокремлене пробілом, відхиляється як невідомий прапорець.
light є базовим рівнем без конфігурації. Кожен рядковий літерал, який він може переписати, проходить через декодер під час виконання. Він перейменовує ідентифікатори й переписує синтаксис, а структурних шарів не додає. Починаючи з рушія 0.2.3, на minify і light цикли більше не переписуються в допоміжні функції зі зворотним викликом, що усуває сповільнення у 2-5 разів, яке ці функції спричиняли в гарячих циклах. На light імена властивостей і глобальні імена й далі проходять через закодовані константи, що має певну ціну в дуже гарячому коді. Деякі рядки залишаються читабельними на будь-якому пресеті: прологи директив, операнди порівняння з typeof, імена властивостей, потрібні рантайму, та імена експортів. Protection Map перелічує їх, а рушій повідомляє їхню кількість і сумарний розмір у байтах на кожній збірці. Підвищення пресету до medium або вище додає структурну роботу над кожним токеном: роздування, перебудову потоку керування, а також прив'язку рядків і цілих чисел до спільного значення під час виконання. Читабельність рядків воно не змінює: вона вже на своєму мінімумі.
minify є єдиним рівнем, який вимикає це мінімальне кодування. Починаючи з рушія 0.2.3, він лише перейменовує ідентифікатори й стискає код, без жодної обфускації. Рушій 0.2.2 на minify також переписував синтаксис.
Бюджет розміру
Кожен результат містить фіксований рантайм рушія (декодери та інтерпретатор цілочислових виразів), тож файл на кілька сотень байтів виходить пропорційно більшим, ніж передбачають ці діапазони. Читайте співвідношення на реальному бандлі, а не на маленькому файлі.
inflation.max незаданий за замовчуванням, тож цільова складність сама вирішує розмір результату. Задавайте його самостійно лише тоді, коли у вас є реальний бюджет розміру, який краще не перевищити. Досягнення явно заданого значення є помилкою: DIAG_SIZE_CAP_REACHED, без результату, код виходу 3 з CLI, а в плагіні збірка завершується з помилкою. Починаючи з рушія 0.2.3, недостатньо захищений результат ніколи не записується замість нього: із лімітом звіряється готовий файл, а кодування рядків завжди завершується першим. У рушії 0.2.2 тісний ліміт міг перервати кодування рядків і залишити частину рядків читабельними.
Пряме задання цільового значення
complexity є необмеженим невід'ємним числом. --complexity=200 є допустимим перевизначенням на тарифі Free, далеко за межами того, що задає extreme.
npx afterpack@latest dist/ --preset=hard --complexity=40Це hard із цільовою складністю, перевизначеною на 40; решта пресету не змінюється. Передати назву пресету в --complexity є помилкою.
Застосування пресету до однієї ділянки
--preset задає один пресет для всього бандла; це доступно на Free. Зосередити важчий пресет на одній функції чи файлі можна на Pro, через директиву у вихідному коді:
/* @afterpack preset=extreme */
function pricingEngine(plan, region) {
return resolve(plan, region);
}
/* @afterpack end */Директиви пишуться лише як блокові коментарі і зчитуються плагіном із вашого вихідного коду. Граматику та правила тарифів див. у Директивах.
Далі
- Конфігурація: кожен ключ, який зачіпає пресет.
- Довідник CLI: прапорці, що обирають пресет.
- Директиви:
skipабоpreset=<name>для однієї ділянки. - Як працює AfterPack: що насправді дає вище цільове значення проти статичного читача.
- Найкращі практики: що посилювати, а що не чіпати.