Ми часто стикаємося з проєктами, де збирання займає хвилини. esbuild написаний на Go (див. Wikipedia) і працює в 10–100 разів швидше за аналоги на JavaScript. Холодний старт, який Webpack витрачає 30 секунд, esbuild завершує за 300 мс. Це змінює не лише час очікування, а й підхід до розробки: перезбирання на кожному збереженні перестає бути проблемою. За даними офіційного бенчмарку з репозиторію esbuild, esbuild виконує 1000 файлів за 0.1 секунди — проти 6 секунд у Webpack. Наш досвід показує, що впровадження esbuild скорочує час збирання в середньому в 15 разів, а приріст продуктивності розробників досягає 30% завдяки миттєвому зворотному зв'язку. Ми гарантуємо, що після налаштування ви забудете про довгі очікування білда. Типова вартість налаштування esbuild — $600–$1200, що окупається за рахунок прискорення збирання на 85%.
Коли варто використовувати esbuild безпосередньо?
Більшість проєктів використовують esbuild опосередковано — через Vite, який бере його для dev-сервера, або через Jest з esbuild-jest. Пряме використання esbuild виправдане, коли потрібен мінімалістичний пайплайн без фреймворкового оверхеда, збирається сервер на Node.js (Lambda-функції, CLI-утиліти), існуючий білд занадто повільний і потрібна точкова заміна транспілятора, або проєкт у монорепо вимагає кастомного скрипта збирання. Наприклад, для Lambda-функцій, де важлива швидкість деплою, esbuild ідеальний.
Як esbuild прискорює збирання?
Секрет швидкості — у використанні Go замість JavaScript та паралельній обробці без повного AST. esbuild використовує всі ядра процесора, що дає виграш у швидкості. У таблиці нижче — типові показники для середнього проєкту:
| Збирач | Холодний старт (типовий проєкт) | Інкрементальне збирання |
|---|---|---|
| Webpack | 30–60 с | 5–10 с |
| esbuild | 200–400 мс | 10–50 мс |
Чому варто довірити налаштування професіоналам?
Наші інженери мають 10+ років досвіду у веб-розробці та понад 50 успішних проєктів з оптимізації збирання. Ми сертифіковані для роботи з сучасними інструментами та гарантуємо індивідуальний підхід. Кожен кейс унікальний: ми аналізуємо поточний пайплайн, виявляємо вузькі місця та пропонуємо оптимальне рішення.
Встановлення та перший запуск
npm install --save-dev esbuild Мінімальний запуск без конфіг-файла:
./node_modules/.bin/esbuild src/index.ts \ --bundle \ --outfile=dist/bundle.js \ --target=es2020 \ --format=esm \ --sourcemap JavaScript API та конфігурація (esbuild config)
esbuild не має YAML/JSON-конфіга — вся конфігурація через JS API або CLI. JS API дає повний контроль:
import * as esbuild from 'esbuild'; await esbuild.build({ entryPoints: ['src/index.ts'], bundle: true, outdir: 'dist', format: 'esm', target: ['es2020', 'chrome90', 'firefox88', 'safari14'], splitting: true, sourcemap: true, minify: process.env.NODE_ENV === 'production', define: { 'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV), }, external: ['react', 'react-dom'], metafile: true, loader: { '.png': 'file', '.svg': 'dataurl', '.woff2': 'file', }, }); Dev-сервер та плагіни: покрокове налаштування
Крок 1. Ініціалізуйте esbuild контекст:
const ctx = await esbuild.context({...}); Крок 2. Запустіть watch:
await ctx.watch(); Крок 3. Запустіть dev-сервер:
const { host, port } = await ctx.serve({ servedir: 'public', port: 3000 }); Екосистема плагінів менша, ніж у Webpack, але ключові задачі закриті. У таблиці — основні плагіни (esbuild plugin):
| Плагін | Призначення | Приклад використання |
|---|---|---|
| esbuild-sass | Компіляція SCSS/SASS | --loader:.scss=css + плагін |
| esbuild-css-modules | CSS Modules | --loader:.module.css=css |
| esbuild-copy | Копіювання статики | --external:*.png |
| esbuild-plugin-env | Змінні оточення | define у конфігу |
Написати власний плагін нескладно — API простий і складається з хуків onResolve та onLoad.
Збирання для Node.js та аналіз бандла
Lambda-функції, CLI-інструменти, серверні скрипти — esbuild чудово підходить для платформи Node.js:
await esbuild.build({ entryPoints: ['src/handler.ts'], bundle: true, platform: 'node', target: 'node18', format: 'cjs', outfile: 'dist/handler.js', external: ['@aws-sdk/*', 'bcrypt', 'sharp'], minify: true, }); З метафайлом можна аналізувати розміри модулів. Вивантажте JSON та завантажте в інтерактивний аналізатор esbuild — покаже sunburst-діаграму з частками кожного файлу.
Обмеження
esbuild навмисно не реалізує ряд речей: перевірку типів TypeScript (запускайте tsc --noEmit окремо в CI), повноцінні CSS Modules, експериментальний синтаксис декораторів та деякі Babel-трансформи. Якщо потрібні специфічні AST-перетворення, знадобиться плагін або попередня обробка через SWC/Babel.
Що входить у налаштування esbuild (оптимізація збирання)
Ми пропонуємо комплексне налаштування esbuild під ваш проєкт. У типовий пакет входить:
- аудит поточного збірного пайплайну та виявлення вузьких місць
- конфігурація під ваші задачі (TypeScript, JSX, CSS, асети)
- інтеграція з фреймворком (React, Vue, Angular) та налаштування code splitting
- оптимізація: tree shaking, мініфікація, аналіз метафайлу
- документація по скриптах збирання та рекомендації по CI/CD
- навчання команди роботі з esbuild
Типові помилки при переході на esbuild
- Забувають запустити
tsc --noEmit— проєкт втрачає перевірку типів. - Не коригують лоадери для асетів — зображення та шрифти не збираються.
- Використовують платформу
browserзамістьnodeдля серверних скриптів — виникають помилки з модулями. - Не додають
externalдля нативних аддонів — збирання падає.
Терміни
Заміна транспілятора в існуючому проєкті на esbuild (наприклад, Jest → esbuild-jest) займає від 2 до 4 годин. Налаштування повноцінного пайплайну з нуля (dev-сервер, production, CSS, асети) — від 4 до 8 годин. Вартість розраховується індивідуально, типовий діапазон — $600–$1200.
Замовте налаштування esbuild прямо зараз та отримайте консультацію безплатно. Наші інженери зв'яжуться з вами протягом години.