# gobrowser

**Repository Path**: xiaoa7/gobrowser

## Basic Information

- **Project Name**: gobrowser
- **Description**: gobrowser
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GoBrowser - Go 语言虚拟浏览器

纯 Go 实现的后端虚拟浏览器，支持资源下载、DOM 解析、JS 执行，完整兼容 Chrome DevTools Protocol (CDP)。

## ✨ 快速开始

### 编译启动

```bash
# 编译
go build -o gobrowser.exe ./cmd/gobrowser/main.go

# 启动（默认端口 9223）
./gobrowser.exe

# 或指定端口
./gobrowser.exe :9999
```

### 验证运行

```bash
# 检查服务
curl http://localhost:9223/json/version

# 运行集成测试
go test -v ./tests/integration/...
```

## 🎯 项目目标

替代真实 Chrome 浏览器实例，大幅降低内存占用，支持高并发，同时保持 CDP 协议兼容，实现平滑切换。

## ✅ 已实现功能

| 功能 | 状态 | 说明 |
|------|------|------|
| CDP WebSocket 服务 | ✅ | 完整的 WebSocket 服务框架 |
| Page.navigate | ✅ | 页面导航（真实 HTTP 加载，自动解码 Unicode 转义） |
| Runtime.evaluate | ✅ | JavaScript 执行（goja 引擎，作用域隔离） |
| DOM.getDocument | ✅ | 获取 DOM 文档树 |
| DOM.querySelector | ✅ | CSS 选择器查询（支持复合选择器、多类名选择器） |
| DOM.querySelectorAll | ✅ | CSS 选择器查询多个 |
| DOM.resolveNode | ✅ | 节点解析为远程对象 |
| Runtime.callFunctionOn | ✅ | 调用对象方法（支持 OuterHTML） |
| chromedp.WaitReady | ✅ | 节点就绪等待（ByQuery） |
| chromedp.OuterHTML | ✅ | 获取 HTML 内容 |
| Network.enable | ✅ | 网络域启用 |
| Cookie 管理 | ✅ | 完整 Cookie 支持 |

## 核心特性

- 🚀 **纯 Go 实现** - 部署简单，性能优异
- 💾 **内存高效** - 单会话 < 50MB（对比 Chrome 的 500MB）
- 🔄 **CDP 兼容** - 与真实 Chrome 接口一致，现有代码无需修改
- 📊 **高并发** - 支持 1000+ 同时在线会话
- ⚙️ **渐进式** - 分阶段实现，快速验证
- 🎯 **Crawl Agent 兼容** - 完整支持 Crawl Agent browser_get_html / browser_exec_js

## 🔧 DOM / JS 特性

- **作用域隔离** - 连续 `Runtime.evaluate` 调用互不干扰（无 `let/const` 重复声明错误）
- **复合选择器支持** - `.List2 ul li` 层级查询
- **多类名选择器** - `span.Gray.Right` 匹配
- **绝对 URL 转换** - `a.href` 自动转换为完整绝对路径
- **innerText 支持** - 与 textContent 行为一致
- **Unicode 转义解码** - URL 中的 `&` 自动解码为 `&`

## 技术栈

| 组件 | 技术方案 |
|-----|---------|
| JS 引擎 | [goja](https://github.com/dop251/goja) |
| DOM 解析 | net/html |
| WebSocket | [gorilla/websocket](https://github.com/gorilla/websocket) |
| 网络层 | net/http |
| 存储 | 内存存储 |

## 项目状态

✅ **核心功能完成** - Crawl Agent 集成验证通过，可投入使用！

## 🧪 与 Crawl Agent 集成

1. 启动 GoBrowser 服务（端口 9223）
2. 配置 Crawl Agent 使用远程浏览器：`ws://localhost:9223`
3. 运行 Crawl Agent 测试或爬虫

**browser_get_html 和 browser_exec_js 全部兼容！**

## 运行测试

```bash
# 运行所有单元测试
go test ./internal/...

# 运行集成测试
go test ./tests/integration/...
```

## 目录结构

```
gobrowser/
├── cmd/
│   └── gobrowser/    # 主程序入口
├── internal/
│   ├── cdp/         # CDP 协议处理
│   ├── dom/         # DOM 解析与查询
│   ├── js/          # JS 引擎与 Web API 绑定
│   ├── network/     # 网络与 Cookie 管理
│   ├── page/        # 页面加载
│   ├── session/     # 会话与 frame 管理
│   └── types/       # 类型定义
└── tests/
    └── integration/ # 集成测试
```

## 许可证

MIT