# @emulatorjs/emulatorjs 中文文档

规范地址：https://npmcn.com/package/%40emulatorjs/emulatorjs/

版本：4\.2\.3
npm 元数据更新时间：2025-07-05T19:42:20.201Z
中文译文更新时间：2026-11-13T16:22:04.085Z
软件包许可：GPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40emulatorjs/emulatorjs
原文对照：https://npmcn.com/package/%40emulatorjs/emulatorjs/?lang=original
项目主页：https://emulatorjs.org/
源码仓库：https://github.com/EmulatorJS/EmulatorJS

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2 MB，53 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：8 个
- 首次发布：2024-02-13T16:06:44.267Z
- 最新版本发布：2025-07-05T19:42:19.892Z
- 近 30 天下载量：23711（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 0 个）

## 中文简介

模拟JS是RetroArch在网页浏览器中的前端.

## 安装

```sh
npm install @emulatorjs/emulatorjs
```

也可以使用：`pnpm add @emulatorjs/emulatorjs`、`yarn add @emulatorjs/emulatorjs`、`bun add @emulatorjs/emulatorjs`

## README

![](https://npmcn.com/package/%40emulatorjs/emulatorjs/docs/Logo.png#gh-light-mode-only)  
  

[![Badge License](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge)](https://npmcn.com/package/%40emulatorjs/emulatorjs/LICENSE)

自办 **Javascript** 模拟各种系统.

  

[![Button Website](https://img.shields.io/badge/Website-736e9b?style=for-the-badge)](https://emulatorjs.org/) [![Button Usage](https://img.shields.io/badge/Usage-2478b5?style=for-the-badge)](https://emulatorjs.org/docs/)  
[![Button Configurator](https://img.shields.io/badge/Code%20Generator-992cb3?style=for-the-badge)](https://emulatorjs.org/editor)  
[![Button Demo](https://img.shields.io/badge/Demo-528116?style=for-the-badge)](https://demo.emulatorjs.org/)  
[![Button Contributors](https://img.shields.io/badge/Contributors-54b7dd?style=for-the-badge)](https://npmcn.com/package/%40emulatorjs/emulatorjs/docs/contributors.md)

加入我们的 Discord 服务器 :

[![Join our Discord server!](https://invidget.switchblade.xyz/6akryGkETU)](https://discord.gg/6akryGkETU)

或 Matrix 服务器(#emarojs: matrix.emarojs.org):

[![Chat on Matrix](https://matrix.to/img/matrix-badge.svg)](https://matrix.to/#/#emulatorjs:matrix.emulatorjs.org)

  

> \[注\]  
> **至于"模拟JS"4.0版,这个项目已不再是"模拟"(implorjs.com)项目的倒置版. 它现在是一个完整的重写.**

> \[尖叫声\]  
> 截至4.0.9版本的核心和精密文件不再包含在寄存器中. 你得把它们分开 你可以从 [释放](https://github.com/EmulatorJS/EmulatorJS/releases) 或新CDN(见 [这个](https://npmcn.com/package/%40emulatorjs/emulatorjs/#readme-CDN) 以获得更多信息。 我们还将使用一个新的版本系统。 (读取) [这里](https://npmcn.com/package/%40emulatorjs/emulatorjs/#readme-Versioning) 以获得更多信息.

> \[TIP\] 不再推荐使用克隆存储器。 你应该用 [释放](https://github.com/EmulatorJS/EmulatorJS/releases) 或 [光盘N](https://cdn.emulatorjs.org/) 换句话说.

  

### 广告

_这个项目没有广告._  
_虽然,演示页目前有一个帮助资助这个项目的广告._  
_在演示页上的广告可能会来去去 取决于有多少人_  
_资助这个项目._  

_您可以帮助为这个项目提供资金:_ _**[帕翠欧](https://patreon.com/EmulatorJS)**_

  

### 问题

_如果有什么不起作用,请考虑开张_ _**[问题](https://github.com/ethanaobrien/emulatorjs/issues)**_  
_尽可能多的细节 以及控制台日志._

  

### 第三方项目

模拟JS本身被构建为一个插件,而不是整个网站. 因此,这个项目没有装填容器。 然而,您可以使用多个工程来使用 EmolatorJS !

寻找集成模拟JS的项目吗 ? 检查出来 [https://emaulerjs.org/docs/3rd-party (中文(简体) )](https://emulatorjs.org/docs/3rd-party)

  

### 版本

有三个不同的版本名称需要注意:

1.  **稳定** - 这将是模拟器最稳定的版本 代码和核心都会在发布前测试。 每次在GitHub上发布新版本时都会更新. 这是Demo上的默认版本.
2.  **最新消息** - 这里面会包含最新的代码,但使用稳定的核心。 每次发布时都会更新 _主要_ 分支更新.
3.  **夜来** - 里面有最新的密码和最新的核心 核心会每天被更新,所以这被认为是α.

  

### 光盘N

**模拟 JS 提供 CDN** 时间 `https://cdn.emulatorjs.org/`,允许访问模拟器的任何版本.

要用它,设置 `EJS_pathtodata` 改为 `https://cdn.emulatorjs.org/<version>/data/`替换 `<version>` 与 `stable`, (中文(简体) ), `latest`, (中文(简体) ), `nightly`,或者另一个主释放.

确定还要更新 `loader.js` 路径 : `https://cdn.emulatorjs.org/<version>/data/loader.js`

  

### 发展:

_运行本地服务器 :_

1.  在项目根部打开一个终端.
    
2.  安装依赖性 :
    
    ```sh
    npm i
    ```
    
3.  以 :
    
    ```sh
    node start
    ```
    
4.  打开您的浏览器并前往 `http://localhost:8080/` 查看演示页.
    

  
  

#### 缩小

在将脚本文件推入您制作的服务器之前, 推荐您将脚本文件缩放, 以节省负载时间和带宽 .

读取 [正在缩小](https://npmcn.com/package/%40emulatorjs/emulatorjs/minify/README.md) 需要更多信息的文档.

  

#### 本地化

如果你想帮助本地化,请检查 [本地化](https://npmcn.com/package/%40emulatorjs/emulatorjs/data/localization/README.md) 文档.

  

**\>> 当报告错误时, 请指定您使用的版本**

  
  
  

# 支持的系统

  

### 任天堂

**[游戏男孩进步](https://emulatorjs.org/docs/systems/nintendo-game-boy-advance)**   |  **[Fami通/ NES 系统](https://emulatorjs.org/docs/systems/nes-famicom)**   |  **[虚拟男孩](https://emulatorjs.org/docs/systems/virtual-boy)**

**[游戏男孩](https://emulatorjs.org/docs/systems/nintendo-game-boy)**   |  **[国家](https://emulatorjs.org/docs/systems/snes)**   |  **[副秘书长](https://emulatorjs.org/docs/systems/nintendo-ds)**   |  **[64国道](https://emulatorjs.org/docs/systems/nintendo-64)**

  
  

### 世嘉

**[主系统](https://emulatorjs.org/docs/systems/sega-master-system)**   |  **[巨型驱动器](https://emulatorjs.org/docs/systems/sega-mega-drive)**   |  **[游戏工具](https://emulatorjs.org/docs/systems/sega-game-gear)**

**[土星号](https://emulatorjs.org/docs/systems/sega-saturn)**   |  **[第32X号](https://emulatorjs.org/docs/systems/sega-32x)**   |  **[光盘](https://emulatorjs.org/docs/systems/sega-cd)**

  
  

### 阿塔里语Name

**[2600号](https://emulatorjs.org/docs/systems/atari-2600)**   |  **[5200个](https://emulatorjs.org/docs/systems/atari-5200)**   |  **[7800号](https://emulatorjs.org/docs/systems/atari-7800)**   |  **[林克丝](https://emulatorjs.org/docs/systems/atari-lynx)**   |  **[美洲虎号](https://emulatorjs.org/docs/systems/atari-jaguar)**

  
  

### 准将

**[准将 64](https://emulatorjs.org/docs/systems/commodore-64)** | **[准将128](https://emulatorjs.org/docs/systems/commodore-128)** | **[阿米加准将](https://emulatorjs.org/docs/systems/commodore-amiga)**

**[中将PET](https://emulatorjs.org/docs/systems/commodore-pet)** | **[准将 Plus/4](https://emulatorjs.org/docs/systems/commodore-plus4)** | **[VIC-20中将](https://emulatorjs.org/docs/systems/commodore-vic20)**

  
  

### 其它

**[游戏Station](https://emulatorjs.org/docs/systems/playstation)**   |  **[PlayStation 可移植](https://emulatorjs.org/docs/systems/psp)**   |  **[拱门](https://emulatorjs.org/docs/systems/arcade)**    

**[3DO (三维)](https://emulatorjs.org/docs/systems/3do)** | **[2003年大型海洋生态系统](https://emulatorjs.org/docs/systems/mame-2003)** | **[Colecovision (科莱克) 维基百科中的相关条目: 科莱克](https://emulatorjs.org/docs/systems/colecovision)**

  

## 恒星历史

[![Star History Chart](https://api.star-history.com/svg?repos=EmulatorJS/EmulatorJS&type=Date)](https://star-history.com/#EmulatorJS/EmulatorJS&Date)

## 常见问题

### @emulatorjs/emulatorjs 是什么？

模拟JS是RetroArch在网页浏览器中的前端\.

### 如何安装 @emulatorjs/emulatorjs？

在项目目录运行 npm install @emulatorjs/emulatorjs，或使用 pnpm add / yarn add / bun add。

### @emulatorjs/emulatorjs 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/emulatorjs\_\_emulatorjs 是否存在。

### @emulatorjs/emulatorjs 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @emulatorjs/emulatorjs 可以商用吗？

@emulatorjs/emulatorjs 使用 GPL-3\.0 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @emulatorjs/emulatorjs 的下载量有多少？

根据 npm 官方下载统计，@emulatorjs/emulatorjs 在 2026/10/14 – 2026/11/12 这 30 天内被下载 23,711 次，日均约 790 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @emulatorjs/emulatorjs 还在维护吗？

最新版本 4\.2\.3 发布于 2025/07/06（1\.4 年前）；至今共发布 10 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/02/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。