functions-sandbox is the engine behind Backstage Functions and executes code in isolation (a sandbox). It could be used for both running code in production as well as testing the deployed functions (before they are deployed, hopefully).
$ npm install @globocom/functions-sandbox
Example of usage
const Sandbox = require('backstage-functions-sandbox');
const mySandbox = new Sandbox({
env: {
MY_VAR: 'TRUE', // environment variable will be available on Backstage.env.MY_VAR
},
globalModules: [ 'path' ], // put all available modules that will allow to import
asyncTimeout: 10000,
syncTimeout: 300,
});
const myCode = mySandbox.compileCode('test.js', `
async function main(req, res) {
const result = req.body.x * req.body.y;
const name = Backstage.env.MY_VAR;
// you could call await here
return { name, result };
}
`);
// express.Request compatible
const req = {
headers: {},
query: {},
body: { x: 10, y: 10}
};
mySandbox.runScript(myCode, req).then(({status, body}) => {
console.info('Result:', status, body);
}, (err) => {
console.error('Error:', err);
});
