QuickJS：在WebAssembly沙箱中安全执行JavaScript和TypeScript

QuickJS：在WebAssembly沙箱中安全执行JavaScript和TypeScript

quickjs A typescript package to execute JavaScript and TypeScript code in a webassembly quickjs sandbox 项目地址: https://gitcode.com/gh_mirrors/quickjs2/quickjs

项目核心功能/场景

在WebAssembly沙箱中安全执行JavaScript和TypeScript代码。

项目介绍

QuickJS是一个TypeScript包，它允许开发者在WebAssembly沙箱中使用QuickJS引擎安全地执行JavaScript和TypeScript代码。该项目非常适合在隔离环境中运行不可信代码，利用轻量级且高效的QuickJS引擎编译为WebAssembly，提供了代码执行的健壮环境。

QuickJS不仅为开发者提供了高性能的代码执行环境，还支持标准Node.js模块、虚拟文件系统以及自定义Node模块等特性，使其在多种场景下都能发挥重要作用。

项目技术分析

QuickJS基于以下技术构建：

• QuickJS引擎：一个轻量级、高效的JavaScript引擎，能够编译为WebAssembly，为代码执行提供高性能的环境。
• TypeScript：使得代码更加健壮、易于维护，同时提供了类型安全。
• WebAssembly：一种可以在各种环境中运行的低级语言，提供了接近原生代码的执行速度。

QuickJS通过以下方式确保代码执行的安全性：

• 沙箱环境：代码在隔离的沙箱中运行，防止对宿主系统造成影响。
• 模块化支持：仅提供必要的Node.js模块，减少潜在的攻击面。
• 环境变量控制：允许设置环境变量，进一步限制代码行为。

项目及技术应用场景

QuickJS的应用场景广泛，以下是一些典型的使用案例：

• 代码审计：在不影响主系统的情况下，安全地执行第三方代码。
• 沙箱测试：为JavaScript和TypeScript代码提供一个安全的测试环境。
• Web应用：在Web应用中嵌入QuickJS沙箱，执行用户提供的代码。
• 云函数：作为云函数运行时，为无服务器架构提供沙箱环境。

项目特点

以下是QuickJS的主要特点：

• 安全性：在隔离的环境中运行不可信代码，确保系统安全。
• Node.js模块支持：提供基本的Node.js模块，满足常见需求。
• 虚拟文件系统：支持挂载虚拟文件系统，模拟文件操作。
• 自定义Node模块：允许挂载自定义Node模块，扩展功能。
• Fetch客户端：提供HTTP(s)请求能力，便于网络通信。
• 测试运行器：内置测试运行器和Chai基础期望库，方便测试。
• 性能：利用QuickJS引擎的轻量级和高效特性，提升执行速度。
• 通用性：易于集成到现有的TypeScript项目中。
• 简洁性：提供了用户友好的API，简化了JavaScript和TypeScript代码在沙箱中的执行和管理。

使用示例

以下是QuickJS的基本使用示例：

import { type SandboxOptions, loadQuickJs } from '@sebastianwessel/quickjs'

const { runSandboxed } = await loadQuickJs()

const options: SandboxOptions = {
  allowFetch: true,
  allowFs: true,
  env: {
    MY_ENV_VAR: 'env var value',
  },
}

const code = `
import { join } from 'path'

const fn = async ()=>{
  console.log(join('src','dist'))
  console.log(env.MY_ENV_VAR)
  const url = new URL('https://example.com')
  const f = await fetch(url)
  return f.text()
}
  
export default await fn()
`

const result = await runSandboxed(async ({ evalCode }) => evalCode(code), options)

console.log(result)

QuickJS为开发者提供了一个强大的工具，用于在TypeScript应用中安全执行JavaScript和TypeScript代码，同时保证了性能和安全性。无论是代码审计、沙箱测试还是Web应用开发，QuickJS都展现了其卓越的灵活性和实用性，值得开发者关注和尝试。

quickjs A typescript package to execute JavaScript and TypeScript code in a webassembly quickjs sandbox 项目地址: https://gitcode.com/gh_mirrors/quickjs2/quickjs