JSNES
github.com
- Free plan
- Linux
- Web
What JSNES is
JSNES is a free JavaScript library for emulating NES games in browsers and Node.js. Its Browser helper handles canvas rendering, audio, keyboard and gamepad input, and frame timing, while the lower-level NES class allows custom rendering and audio handling in Node.js. ROM data can be loaded from a URL or from a string, Uint8Array, or ArrayBuffer. The API runs frames, accepts controller input for either of two players, resets, and provides frame-rate methods. Applications can serialize and restore emulator state with `toJSON()` and `fromJSON()`. The `onBatteryRamWrite` callback lets an application capture battery-backed SRAM writes for persistent saves. Sound emulation is enabled by default, with a default sample rate of 48000 Hz, and an audio callback is available. The README gives npm and unpkg setup options, plus a React embedding example and a fuller React frontend in the repository. Calling `nes.frame()` at 60 fps is suggested, while reliable timing is left to the integrator. Project issues include accuracy and compatibility work involving mapper coverage, graphics, audio, and ROM loading.
Who it suits
JSNES suits developers building browser or Node.js NES emulation into an application. It is also relevant to React developers who want to use the supplied embedding example or repository frontend.
Good to know, and what to watch
- Supports browser and Node.js use.
- Accepts input for two players.
- Can serialize and restore emulator state.
- Provides a callback for battery-backed SRAM writes.
- Licensed under Apache-2.0.
- Reliable frame timing is the integrator’s responsibility.
- Project issues include emulator accuracy and compatibility work.
- No free trial is listed.
Plans
Every plan and priceJSNES
Free plan
Getting started
- Install the package with npm for Node.js or Webpack
- Use the unpkg script for a browser integration
- Load ROM data from a URL or supported data type
- Connect the Browser helper or custom rendering and audio handlers
- Call nes.frame() at 60 fps and provide reliable timing
- Embed it in React using the example or repository frontend
Limits to check
The README places responsibility for reliable 60 fps timing on the integrator. Project issues list ongoing accuracy and compatibility work involving mapper coverage, graphics, audio, and ROM loading.
The verdict
JSNES provides emulator APIs and browser helpers for applications that need NES game support. Developers should account for frame timing and the compatibility issues noted in the project’s open issues.
Questions people ask
Is JSNES free?
Yes. JSNES is free, with a listed plan price of free, and it is licensed under Apache-2.0.
Where can it run?
It supports browsers and Node.js, including Node.js or Webpack installation and browser use through an unpkg script.
Can it save emulator state?
Yes. toJSON() serializes emulator state and fromJSON() restores it.
Does it support persistent game saves?
The onBatteryRamWrite callback reports battery-backed SRAM writes so an application can persist save data.
How are controls handled?
The Browser helper supports keyboard and gamepad input, runtime remapping, two players, and Zapper methods.
Where are bugs and feature requests reported?
The project provides a GitHub Issues tracker for bug reports and feature requests.
What the maker publishes
- Audio
- The API supports an audio callback and has sound emulation enabled by default with a default sample rate of 48000 Hz. source
- Browser frontend
- The Browser helper handles canvas rendering, audio, keyboard input, gamepad input, and frame timing. source
- Browser setup
- The browser interface handles canvas rendering, audio, keyboard and gamepad input, and frame timing. source
- Controllers
- The browser interface supports keyboard and gamepad controls, and exposes remapping for both. source
- Emulation controls
- The NES API includes loading ROM data, running frames, button input, reset, and frame rate methods. source
- Frame rate
- The README says to call nes.frame() at 60 fps and makes reliable timing the integrator's responsibility. source
- Input support
- The Browser helper supports keyboard and gamepad input, and its keyboard bindings can be customized at runtime. source
- Installation
- The README gives `npm install jsnes` for Node.js or Webpack and an unpkg script for browser use. source
- Installation
- The README documents installation with npm install jsnes and browser use through an unpkg script. source
- Known limitations
- Open project issues list emulator accuracy and compatibility work, including mapper coverage, graphics, audio, and ROM loading issues. source
- License
- The repository identifies the software as licensed under Apache-2.0. source
- License
- The repository identifies its license as Apache-2.0. source
- Maintainer
- The package metadata names Ben Firshman as the author. source
- Node integration
- The lower-level NES class supports custom rendering and audio handling and can be used in Node.js. source
- Persistent game saves
- The API calls `onBatteryRamWrite` when battery-backed SRAM is written so applications can persist save data. source
- Purpose
- JSNES is a JavaScript NES emulator library for browsers and Node.js. source
- Purpose
- JSNES is a JavaScript NES emulator library that works in browsers and Node.js. source
- React
- The README includes a React embedding example and says a full-featured React frontend is in the repository's `web/` directory. source
- React
- The README provides a React embedding example and says a full-featured React frontend is in the repository's web directory. source
- ROM loading
- The library can load ROM data from a URL or from a string, Uint8Array, or ArrayBuffer. source
- Save data
- The onBatteryRamWrite callback allows applications to persist battery-backed SRAM data. source
- Save states
- The API exposes `toJSON()` and `fromJSON()` to serialize and restore emulator state. source
- Save states
- The API can serialize emulator state with toJSON() and restore it with fromJSON(). source
- Support channel
- The project provides a GitHub Issues tracker for bug reports and feature requests. source
Checked against the maker's pages on 8 Oct 2026.