🔧
better-eval
An alternative to eval() in JavaScript that is customizable and safer!
The eval function sucks, and there lacks alternatives that provide the same simplicity of the original eval function. better-eval solves this problem by adressing the security and speed issues, while delivering a sensible API.
Why Better-Eval?
-
🕊 Small and Lightweight. -
⚡ A simple and easy to use API. -
🛠️ Easily customizable for your needs. -
✅ Tested and Mantained.
Installation
npm install better-eval
Usage
First, import the package:
const betterEval = require("better-eval");
Then call the function with something you want to be evaluated:
betterEval("1+1"); // returns 2
And its as simple as that! Any code will not be able to access variables you define unless explicitly passed.
Passing Variables
Include any variables as part of an object which you pass in as the second parameter:
const name = "Sam";
betterEval("`Hey ${name}`", { name }); // returns 'Hey Sam'
You can also pass functions as a part of the second parameter, and evaluate them in your code:
const returnName = () => "Bob";
betterEval("`Hey ${returnName()}`", { returnName }); // returns 'Hey Bob'
Blacklist
For your safety, any of these global variables on the blacklist will not be added to your variables:
globalprocessmodulerequiredocumentwindowWindowevalFunction
Here is how they will be handled:
betterEval("`Sum is ${eval('1+1')}`", { eval }); // eval is null!
Remember: never use better-eval blindly with user-code. These checks are precautions for your own usage, but any user with maltious intent could find a way to get through them. Thus, use this package with caution.
Configuring the VM
If you want to have more control over the VM that runs your code, you can pass in an vmOptions parameter:
betterEval(
"1+1", {},
{
fileName: "counting",
lineOffset: 1,
}
);
A complete list of options can be found here.
License
better-eval is MIT-licensed open-source software created by Bharadwaj Duggaraju.
.png)
22 Aug 21, 2022
4 Sep 22, 2022
7 Aug 15, 2022
70 Aug 13, 2023
6 Jan 20, 2022
5 Mar 29, 2022
5 Dec 20, 2022
1 Jan 2, 2022
2 Jan 17, 2022
35 Sep 20, 2022