JSOS
使用指南

内置浏览器

访问容器内 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 / CSP frame-ancestors 仍可能阻止嵌入
  • 嵌入页面处于临时上下文(无 Cookie / localStorage)
  • 外部网站是次要场景,主要用途仍是访问容器内服务

多个窗口

每次打开新链接都会创建新的浏览器窗口,不会替换当前页面。

CLI 与 API

jsos browser open 127.0.0.1:4000
jsos browser list
const { servers } = await window.JSOS.listServers();
await window.JSOS.openBrowser('127.0.0.1:4000');

详见 JSOS API - 内置浏览器。

On this page