可以在浏览器页面运行 node 代码了!webContainer 发布 1.0
2021年5月12日, stackblitz 团队在 谷歌 I/O 上提到了一下的内容:
几年前,我们就能感觉到,web 开发正在走向一个关键的拐点。
WebAssembly 和新的 capabilities API 的出现,使得编写一个基于 WebAssembly 的操作系统似乎成为可能,该操作系统功能强大到可以完全在浏览器中运行 Node.js。 它提供一个比本地环境更快、更安全、更一致的卓越开发环境,以实现无缝代码协作,而无需设置本地环境,这个目标似乎离 Web 开发人员越来越近了。
这项技术在 StackBlitz
中的在线 IDE 中可以体验到,其性能可以碾压同类的 web IDE。
如今,这项技术终于对公众开放。
在2021年,我们宣布了 WebContainer,这是一个完全新颖的基于 WebAssembly 的操作系统,它使Node.js能够完全在浏览器内部运行。在过去的两年中,数以百万计的开发人员每月在 Stackblitz 编辑中使用 WebContainers。
今天,我们很高兴发布 WebContainer API供公众使用,我们邀请整个JavaScript和Node.js社区与我们一起在WebContainers上构建您自己的应用程序!我们构建了Stackblitz经典编辑器,CodeFlow IDE和Web Publisher:我们迫不及待地想看看您的想法!
我们可以直接在 webContainer 官网在线体验这项技术
WebContainer 是什么
WebContainers 是一个基于浏览器的运行时,用于执行 Node.js 应用程序和操作系统命令,它完全运行在您的浏览器页面中。
我的理解,webContainer 就是一个可以运行在浏览器页面中的微型操作系统,提供了文件系统、运行进程的能力,同时内置了 nodejs、npm/yarn/pnpm 等包管理器。
主要特性
- 能够在浏览器中运行 node.js 及其工具链(如:webpack、vite 等)
- 灵活:在 WebContainers 支持下,编码体验将会大幅提升
- 安全:所有内容都运行在浏览器页面中,非常安全
- 快速:毫秒级启动整个开发环境
- 始终开源免费
对于服务提供方(例如在线 IDE)来说,与在云端虚拟机上运行命令相比,有以下好处:
- 无与伦比的用户体验。没有延迟。比本地主机快。离线工作。
- 成本效益。计算是在本地完成的。不购买云服务器。
- 可以扩大用户规模。以前受限于云服务器的规模,如今直接运行在客户端,使用客户端的算力
- 服务器安全,代码运行在客户侧,不担心服务器运行恶意逻辑,例如挖矿
快速开始
启动 webContainer
在代码中,找个地方调用以下代码即可
```javascript import { WebContainer } from '@webcontainer/api';
// Call only once const webcontainerInstance = await WebContainer.boot(); ```
启动 webContainer,相当于电脑开机,启动完才能用
设置跨域隔离
WebContainers 需要使用 SharedArrayBuffer 这个 API(这个 API 有安全需求)。因此,您需要设置Coop/COEP标头:
```yaml
保护源站免受侵害
Cross-Origin-Embedder-Policy: require-corp
保护源站免受攻击
Cross-Origin-Opener-Policy: same-origin ```
另外,网站必须要使用 https,本地开发时使用 localhost 也行,否则 SharedArrayBuffer 是不安全的,会被禁用。
挂载文件
使用 mount API 进行挂载文件和目录
``javascript
const files = {
// 这是一个文件,package.json 是文件名
'package.json': {
file: {
contents:
{
"name": "vite-starter",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
},
"devDependencies": {
"vite": "^4.0.4"
}
},
},
},
// 这是一个目录,src 是目录名
src: {
// 目录下会有 directory 的属性
directory: {
// 这是一个文件,叫 mian.js
'main.js': {
// 文件下有 file 的属性
file: {
contents:
console.log('Hello from WebContainers!')
`,
},
},
},
},
};
await webcontainerInstance.mount(files); ```
然后就可以通过 readFile 读取文件:
javascript
const file = await webcontainerInstance.fs.readFile('/package.json');
目前 webContainer 的 fs 支持以下几种文件操作:
运行进程
可以在 webContainer 中运行命令,例如 npm install
javascript
webcontainerInstance.spawn('npm', ['install']);
spawn 方法接受三个参数:
- 字符串,为命令名称,例如
npm
- 数组:命令的选项
- 非必须,spawn 的参数(例如指定环境变量,禁止输出等)
安装依赖
下面是一个封装好的安装依赖的函数
javascript
async function installDependencies() {
const installProcess = await webcontainerInstance.spawn('npm', ['install']);
return installProcess.exit;
}
读取进程的输出
调用 Spawn 函数返回 WebContainerProcess。它的 output 属性是一个可读流 readableStream <string>
,它接收所有的输出,包括 stdout
and stderr
,下面代码可已经进程的输出,打印出来
```javascript const installProcess = await webcontainerInstance.spawn('npm', ['install']);
installProcess.output.pipeTo(new WritableStream({ write(data) { console.log(data); } })); ```
运行 dev Server
有些命令可以启动 dev Server,例如 npm run start
启动一个 vite/express Server。
这时候,可以用过 on
监听到 server-ready
事件
``javascript
async function startDevServer() {
// 执行
npm run start` 启动 Express app
await webcontainerInstance.spawn('npm', ['run', 'start']);
// 等待 server-ready
事件
webcontainerInstance.on('server-ready', (port, url) => {
// 通过这个 url,就能访问 server
window.open(url)
});
}
```
我们平时启动的 dev Server,会通过类似 http://localhost:8080
的方式进行访问,但如果在网页中运行 dev Server就不行了,因为由于安全限制,网页没有足够的权限绑定端口。
因此 webContainer 会提供一个 url,代替 http://localhost:8080
去访问,这也就是 server-ready
事件,会在回调参数中传 url 的原因
url
长这样:http://localhost5173-3ca0-2jv4wvy8--3111.local-corp.webcontainer.io/
这个请求实际上没有请求到外部,而是在 Service Worker 中直接返回了,通过这样的方式,达到了与平时访问 http://localhost:8080
一样的效果
总结
webContainer 非常适合交互式编码体验,它可以用在生产级IDE,编程教程,下一代文档等应用上。虽然看起来功能十分有限,但这其实是一个很有意义的尝,是一个从 0 到 1 的突破,尝试在浏览器端运行一个微型的操作系统,相信不久的未来,不仅仅是 nodejs,其他的语言,例如 python、Java,或者运行其他更多的程序。
如果这篇文章对您有所帮助,可以点赞加收藏👍,您的鼓励是我创作路上的最大的动力。也可以关注我的公众号订阅后续的文章:Candy 的修仙秘籍(点击可跳转)