CdpClient
Типизированные команды, события и завершение соединения.
connect()send()on()once()onClose()onError()close()@swarmmachina/swm-cdp v0.1.1
Chrome DevTools Protocol
Типизированный ESM-клиент Chrome DevTools Protocol без runtime-зависимостей. Команды, события и flattened sessions с явным владением процессом Chrome.
Используйте для browser smoke tests, диагностики и управления локальным Chrome на уровне протокола. Пакет экспериментальный; высокоуровневые локаторы и автоматическое ожидание элементов остаются за пределами API.
npm install @swarmmachina/swm-cdpimport { spawnChrome } from '@swarmmachina/swm-cdp'
const browser = spawnChrome({ headless: true, transport: 'pipe' })
try {
const cdp = await browser.attach()
const target = await cdp.send('Target.createTarget', { url: 'about:blank' })
const { sessionId } = await cdp.send('Target.attachToTarget', {
flatten: true,
targetId: target.targetId
})
await cdp.send('Runtime.enable', undefined, sessionId)
const result = await cdp.send(
'Runtime.evaluate',
{ expression: 'document.title', returnByValue: true },
sessionId
)
console.log(result.result.value)
} finally {
await browser.close()
}| Среда | Статус | Примечание |
|---|---|---|
| Node.js ^22.13.0 / 24.x | Поддерживается | Native ESM и встроенный WebSocket; Node.js 26 не входит в engines. |
| Локальный Chrome / Chromium | Нужен отдельно | Браузер не включён в npm-пакет. |
| 127.0.0.1 / [::1] | WebSocket endpoint | connect() принимает browser-level endpoint только на literal loopback IP; localhost и удалённые адреса отклоняются. |
Типизированные команды, события и завершение соединения.
connect()send()on()once()onClose()onError()close()Явный владелец процесса Chrome и временного профиля.
spawnChrome()attach()close()kill()waitForExit()stateОтдельные subpath exports для поиска и HTTP discovery.
list()version()createTarget()closeTarget()findChrome()ChromeFinderПолные сигнатуры, типы и примеры находятся в README и TypeScript declarations исходного репозитория.
Разделяйте время жизни protocol client и принадлежащего приложению процесса браузера.
Для spawnChrome() используйте browser.close(). Для connect() cdp.close() закрывает только клиент, сохраняя отдельно запущенный Chrome.
on() передаёт sessionId вторым аргументом и возвращает unsubscribe. Вызывайте его, когда подписка больше не нужна.
send() принимает AbortSignal и timeout; protocolTimeout по умолчанию 180 секунд, maxPendingRequests и maxQueueDepth равны 10 000.
Remote endpoints и DNS-имена отклоняются намеренно. Не публикуйте debugging endpoint браузера во внешнюю сеть.
Если Chrome уже запущен с debugging endpoint на loopback, connect() создаёт только клиентское соединение. Владелец внешнего процесса отвечает за его остановку.
import connect from '@swarmmachina/swm-cdp'
const cdp = await connect({ host: '127.0.0.1', port: 9222 })
try {
console.log(await cdp.send('Browser.getVersion'))
} finally {
await cdp.close()
}