Project Icon

run

轻量级库实现Web Worker中安全执行用户代码

Run是一个微型JavaScript库,专门用于在Web Worker中安全执行用户提供的代码。该库主要用于数据转换,通过接收代码字符串和数据负载,在隔离环境中执行并返回结果。Run禁用了某些全局功能,确保代码无法访问DOM和主应用程序的域上下文,适合在低代码应用中安全运行用户代码片段。这个开源项目将应用于即将发布的仪表板SDK项目Slashd中。

运行

Run 是一个小型库,可以在 Web Worker 中运行用户提供的代码。 其主要目的是通过代码片段实现数据转换,因此某些全局功能被禁用。

该库接收一段 JavaScript 代码(以字符串形式)和一个数据载荷,并返回其执行结果。

它尽可能安全地运行"不受信任"的代码,因为:

  • Web Worker 无法访问 DOM
  • Web Worker 无法访问主应用程序的域上下文
  • Web Worker 在单独的线程中运行,不会阻塞 UI
  • Web Worker 不应能进行网络操作(仍在调查中)

主要用例是在低代码应用程序中,用户可以运行代码片段(不一定由同一用户创建)来完成各种任务。

Run 将在我们即将推出的开源仪表板 SDK 项目 Slashd 中使用。

这里有一个小型沙盒应用 here 供您试用。

安装

使用 UnPkg CDN

<script src="https://unpkg.com/@slashd/run"></script>

使用 SkyPack CDN

<script type="module">
import SlashdRun from 'https://cdn.skypack.dev/@slashd/run'
// 你的代码
</script>

使用包管理器:

npm install @slashd/run

然后,在浏览器中引入:

<script src="node_modules/@slashd/run/dist/slashd-run.min.js"></script>

或在使用打包工具的模块中通过 ES6 引入:

import SlashdRun from '@slashd/run'

如何使用

您可以创建一个或多个任务(独立的 worker):

import SlashdRun from '@slashd/run'

const task = new SlashdRun()

exe 方法返回一个 promise,因此您可以使用 await

const myCode = `return Math.random() * param`

const res = await task.exe(myCode, {param:20})

// res 可能是 12.345657676

您可以通过以下方式捕获代码错误:

const myCode = `return MathRandom * param`

try{
    const res = await task.exe(myCode, {param:20})
}catch(e){
    console.log(e)
}

// ReferenceError: MathRandom is not defined

感谢 @rob-gordon,您可以使用异步代码:

const myCode = `return new Promise((resolve, reject) => {
	setTimeout(() => {
	  resolve(Math.random())
	}, 2000)
})`

const res = await task.exe(myCode, {param:20})

// res 可能是 12.345657676

或者,使用 restrict:false 选项:

const myCode = `return await fetch('https://jsonplaceholder.typicode.com/todos').then(res => res.json())`

const res = await task.exe(myCode, {param:20})

// 200 [{...}, ...]

配置

您可以通过在设置中添加 deps 属性作为外部路径数组,指定在 worker 中加载外部库:

const task = new SlashdRun({deps:['https://unpkg.com/lodash', 'https://www.example.com/mylibrary.js']})

使用上述设置,可以在提供的代码中使用 lodash

const myCode = `_.difference(arr1, arr2);`

const res = await task.exe(myCode, {arr1:[2, 1], arr2:[2, 3]})

// => [1]

默认情况下,该库尝试阻止 Web Worker 的某些功能,如网络函数。 如果您想禁用此行为并保留所有标准 Web Worker 功能,请添加 restrict 属性并将其设置为 false

const task = new SlashdRun({restrict:false})

使用此选项,用户提供的代码可以进行网络操作,如 fetch()

您还可以使用特定的 init 静态方法全局配置库。这样,所有任务都将使用相同的设置:

import { init } from '@slashd/run'

init({deps:['https://unpkg.com/lodash'], restrict:false})

要终止 worker,您可以使用:

task.destroy()

使用 worker 池

如果您需要从预定义的可用 worker 池中获取任务(以限制 worker 的创建),可以使用这个静态方法代替 new SlashdRun 方式:

import { init, getFromPool } from '@slashd/run'

init({maxWorkers:3}) // 必需!

const task = getFromPool() 

在这种情况下,库配置需要使用 init 方法完成。此外,maxWorkers 是必需的,且必须至少为 1 或更大。请注意,浏览器对可以运行的并发 worker 数量有硬性限制。根据我们的经验,3/4 是一个较好的安全最大数量。通常,一个 worker 就足够了。

要释放池及其 worker,请使用以下方法:

import { disposePool } from '@slashd/run'

disposePool()

贡献

安装依赖:

npm i

启动监视器:

npm start 
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号