使用指南
内置浏览器
访问容器内 HTTP 服务与外部网页
内置浏览器
浏览器应用(dev.jsos.browser)主要用于访问 WebContainer 内部的 HTTP 服务,也可以打开外部网站。
打开方式
- 点击桌面上的浏览器图标
- 应用页面里的
target="_blank"链接或window.open会被自动拦截,改为在浏览器窗口中打开 - 终端中启动的未注册 HTTP 服务(端口 ≥ 3000)被检测到时,会自动在新浏览器窗口打开对应地址(同一端口只自动打开一次;可点击 toast 的「打开」重新打开)
- CLI:
jsos browser open <url> - JSOS API:
window.JSOS.openBrowser(url)
起始页
起始页列出当前运行中的内部服务:
- 应用图标、名称、端口
- 每 3 秒自动刷新
- 自动过滤 Daemon 端口(1993)、浏览器自身的服务,以及已停止的端口(容器内
net.connect探活)
点击服务卡片即可打开对应页面。
地址栏
| 输入 | 行为 |
|---|---|
127.0.0.1:4000 | 解析为容器内对应端口的服务地址 |
dev.jsos.settings | 按应用 ID 查找并打开 |
设置 | 按应用名称查找并打开 |
https://example.com | 打开外部网站 |
导航
- 后退 / 前进 / 刷新按钮
- 快捷键:
Ctrl/Cmd + L聚焦地址栏,Ctrl/Cmd + R刷新,Alt + ←/→后退 / 前进 - 页面内的跳转(含 hash 路由)会同步地址栏与历史记录
打开外部网站
外部网站通过 <iframe credentialless> 嵌入——WebContainer 提供的页面带 COEP require-corp,普通 iframe 会被浏览器阻止。
限制:
- 站点自身的
X-Frame-Options/ CSPframe-ancestors仍可能阻止嵌入 - 嵌入页面处于临时上下文(无 Cookie / localStorage)
- 外部网站是次要场景,主要用途仍是访问容器内服务
多个窗口
每次打开新链接都会创建新的浏览器窗口,不会替换当前页面。
CLI 与 API
jsos browser open 127.0.0.1:4000
jsos browser listconst { servers } = await window.JSOS.listServers();
await window.JSOS.openBrowser('127.0.0.1:4000');详见 JSOS API - 内置浏览器。