# Hoppscotch JavaScript Sandbox ALPHA
This package deals with providing a JavaScript sandbox for executing various security sensitive external scripts.
## Usage
Install the [npm package](https://www.npmjs.com/package/@hoppscotch/js-sandbox).
```
npm install --save @hoppscotch/js-sandbox
```
## How does this work?
This package makes use of [quickjs-empscripten](https://www.npmjs.com/package/quickjs-emscripten) for building sandboxes for running external code on Hoppscotch.
Currently implemented sandboxes:
- Hoppscotch Test Scripts
## Development
1. Clone the repository
```
git clone https://github.com/hoppscotch/hopp-js-sandbox
```
2. Install the package dependencies
```
npm install
```
3. Try out the demo [`src/demo.ts`](https://github.com/hoppscotch/hopp-js-sandbox/blob/main/src/demo.ts) using:
```
npm run demo
```
## Versioning
This project follows [Semantic Versioning](https://semver.org/) but as the project is still pre-1.0. The code and the public exposed API should not be considered to be fixed and stable. Things can change at any time!
## License
This project is licensed under the [MIT License](https://opensource.org/licenses/MIT) - see [`LICENSE`](https://github.com/hoppscotch/hopp-js-sandbox/blob/main/LICENSE) for more details.
###### built with ❤︎ by the [Hoppscotch Team](https://github.com/hoppscotch) and [contributors](https://github.com/AndrewBastin/hopp-js-sandbox/graphs/contributors).
