可以在浏览器页面运行 node 代码了!webContainer 发布 1.0

简介: 可以在浏览器页面运行 node 代码了!webContainer 发布 1.0

2021年5月12日, stackblitz 团队在 谷歌 I/O 上提到了一下的内容:

几年前,我们就能感觉到,web 开发正在走向一个关键的拐点。

WebAssembly 和新的 capabilities API 的出现,使得编写一个基于 WebAssembly 的操作系统似乎成为可能,该操作系统功能强大到可以完全在浏览器中运行 Node.js。 它提供一个比本地环境更快、更安全、更一致的卓越开发环境,以实现无缝代码协作,而无需设置本地环境,这个目标似乎离 Web 开发人员越来越近了。

这项技术在 StackBlitz 中的在线 IDE 中可以体验到,其性能可以碾压同类的 web IDE

如今,这项技术终于对公众开放。

1686403304749.png

在2021年,我们宣布了 WebContainer,这是一个完全新颖的基于 WebAssembly 的操作系统,它使Node.js能够完全在浏览器内部运行。在过去的两年中,数以百万计的开发人员每月在 Stackblitz 编辑中使用 WebContainers。

今天,我们很高兴发布 WebContainer API供公众使用,我们邀请整个JavaScript和Node.js社区与我们一起在WebContainers上构建您自己的应用程序!我们构建了Stackblitz经典编辑器,CodeFlow IDE和Web Publisher:我们迫不及待地想看看您的想法!

我们可以直接在 webContainer 官网在线体验这项技术

1686403292818.png

WebContainer 是什么


官方文档中的定义

WebContainers 是一个基于浏览器的运行时用于执行 Node.js 应用程序和操作系统命令,它完全运行在您的浏览器页面中。

我的理解,webContainer 就是一个可以运行在浏览器页面中的微型操作系统,提供了文件系统运行进程的能力,同时内置了 nodejs、npm/yarn/pnpm 等包管理器


主要特性


  • 能够在浏览器中运行 node.js 及其工具链(如:webpack、vite 等)
  • 灵活:在 WebContainers 支持下,编码体验将会大幅提升
  • 安全:所有内容都运行在浏览器页面中,非常安全
  • 快速:毫秒级启动整个开发环境
  • 始终开源免费

对于服务提供方(例如在线 IDE)来说,与在云端虚拟机上运行命令相比,有以下好处:

  • 无与伦比的用户体验。没有延迟。比本地主机快。离线工作。
  • 成本效益。计算是在本地完成的。不购买云服务器。
  • 可以扩大用户规模。以前受限于云服务器的规模,如今直接运行在客户端,使用客户端的算力
  • 服务器安全,代码运行在客户侧,不担心服务器运行恶意逻辑,例如挖矿

快速开始


启动 webContainer


在代码中,找个地方调用以下代码即可


import { WebContainer } from '@webcontainer/api';
// Call only once
const webcontainerInstance = await WebContainer.boot();
启动 webContainer,相当于电脑开机,启动完才能用

设置跨域隔离


WebContainers 需要使用 SharedArrayBuffer 这个 API(这个 API 有安全需求)。因此,您需要设置Coop/COEP标头:


# 保护源站免受侵害
Cross-Origin-Embedder-Policy: require-corp
# 保护源站免受攻击
Cross-Origin-Opener-Policy: same-origin

另外,网站必须要使用 https,本地开发时使用 localhost 也行,否则 SharedArrayBuffer 是不安全的,会被禁用。


挂载文件


使用 mount API 进行挂载文件和目录


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 读取文件:


const file = await webcontainerInstance.fs.readFile('/package.json');

目前 webContainer 的 fs 支持以下几种文件操作:

运行进程


可以在 webContainer 中运行命令,例如 npm install


webcontainerInstance.spawn('npm', ['install']);

spawn  方法接受三个参数:

  1. 字符串,为命令名称,例如 npm
  2. 数组:命令的选项
  3. 非必须,spawn  的参数(例如指定环境变量,禁止输出等)

安装依赖


下面是一个封装好的安装依赖的函数


async function installDependencies() {
  const installProcess = await webcontainerInstance.spawn('npm', ['install']);
  return installProcess.exit;
}

读取进程的输出


调用 Spawn 函数返回 WebContainerProcess。它的 output 属性是一个可读流readableStream <string> ,它接收所有的输出,包括 stdout and stderr,下面代码可已经进程的输出,打印出来


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 事件


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 长这样:https://localhost5173-3ca0-2jv4wvy8--3111.local-corp.webcontainer.io/

1686403181762.png

这个请求实际上没有请求到外部,而是在 Service Worker 中直接返回了,通过这样的方式,达到了与平时访问  http://localhost:8080 一样的效果


总结


webContainer 非常适合交互式编码体验,它可以用在生产级IDE,编程教程,下一代文档等应用上。虽然看起来功能十分有限,但这其实是一个很有意义的尝,是一个从 0 到 1 的突破,尝试在浏览器端运行一个微型的操作系统,相信不久的未来,不仅仅是 nodejs,其他的语言,例如 python、Java,或者运行其他更多的程序。

如果这篇文章对您有所帮助,可以点赞加收藏👍,您的鼓励是我创作路上的最大的动力。也可以关注我的公众号订阅后续的文章:Candy 的修仙秘籍(点击可跳转)



目录
相关文章
|
1月前
|
Web App开发 JavaScript 前端开发
添加浮动按钮点击滚动到网页底部的纯JavaScript演示代码 IE9、11,Maxthon 1.6.7,Firefox30、31,360极速浏览器7.5.3.308下测试正常
添加浮动按钮点击滚动到网页底部的纯JavaScript演示代码 IE9、11,Maxthon 1.6.7,Firefox30、31,360极速浏览器7.5.3.308下测试正常
|
1月前
|
存储 JavaScript 前端开发
webSocket+Node+Js实现在线聊天(包含所有代码)
文章介绍了如何使用WebSocket、Node.js和JavaScript实现在线聊天功能,包括完整的前端和后端代码示例。
102 0
|
2月前
|
消息中间件 JavaScript 中间件
函数计算产品使用问题之WebIDE编写的Node.js代码是否会自动进行打包部署
函数计算产品作为一种事件驱动的全托管计算服务,让用户能够专注于业务逻辑的编写,而无需关心底层服务器的管理与运维。你可以有效地利用函数计算产品来支撑各类应用场景,从简单的数据处理到复杂的业务逻辑,实现快速、高效、低成本的云上部署与运维。以下是一些关于使用函数计算产品的合集和要点,帮助你更好地理解和应用这一服务。
|
4月前
|
前端开发 安全 UED
【项目实战】从终端到浏览器:实现 ANSI 字体在前端页面的彩色展示
在学习和工作中,我们经常需要使用日志来记录程序的运行状态和调试信息。而为了更好地区分不同的日志等级,我们可以使用不同的颜色来呈现,使其更加醒目和易于阅读。 在下图运行结果中,我们使用了 colorlog 库来实现彩色日志输出。通过定义不同日志等级对应的颜色,我们可以在控制台中以彩色的方式显示日志信息。例如,DEBUG 级别的日志使用白色,INFO 级别的日志使用绿色,WARNING 级别的日志使用黄色,ERROR 级别的日志使用红色,CRITICAL 级别的日志使用蓝色。
|
3月前
|
JavaScript 前端开发 开发工具
TypeScript的介绍,let age:number = xxx,可以直接看出数据类型,Type由微软开发,可以在任何浏览器和系统中运行,比较适合大型项目,TypeScript的安装
TypeScript的介绍,let age:number = xxx,可以直接看出数据类型,Type由微软开发,可以在任何浏览器和系统中运行,比较适合大型项目,TypeScript的安装
|
4月前
|
Web App开发 XML 开发框架
技术心得记录:在IE浏览器中的奇怪页面表现
技术心得记录:在IE浏览器中的奇怪页面表现
49 0
|
3月前
|
缓存 JavaScript API
NodeJS代理配置指南:详细步骤和代码示例
**Node.js 代理配置:解决HTTP请求转发与CORS挑战** 在现代开发环境中,Node.js以其高效和灵活性深受青睐,但正确配置代理以处理跨域请求和API调用仍是复杂任务。本文提供全面指南,从基础到高级设置,教授如何在Node.js中使用代理,覆盖httpOptions、npm代理及第三方库的运用,以增强API调用灵活性。
NodeJS代理配置指南:详细步骤和代码示例
|
2月前
|
监控 JavaScript Linux
[译] 在生产环境运行 PM2 & Node.js
[译] 在生产环境运行 PM2 & Node.js
|
2月前
|
Rust 安全 JavaScript
Rust 和 WebAssembly 搞大事啦!代码在浏览器中运行,这波操作简直逆天!
【8月更文挑战第31天】《Rust 与 WebAssembly:将 Rust 代码运行在浏览器中》介绍了 Rust 和 WebAssembly 的强大结合。Rust 是一门安全高效的编程语言,而 WebAssembly 则是新兴的网页技术标准,两者结合使得 Rust 代码能在浏览器中运行,带来更高的性能和安全性。文章通过示例代码展示了如何将 Rust 函数编译为 WebAssembly 格式并在网页中调用,从而实现复杂高效的应用程序,同时确保了内存安全性和跨平台兼容性,为开发者提供了全新的可能性。
104 0
|
2月前
|
Kubernetes 容器 Perl
Kubernetes(K8S) Node NotReady 节点资源不足 Pod无法运行
Kubernetes(K8S) Node NotReady 节点资源不足 Pod无法运行
49 0