lib/vm.js

   1 // Copyright Joyent, Inc. and other Node contributors.
   2 //
   3 // Permission is hereby granted, free of charge, to any person obtaining a
   4 // copy of this software and associated documentation files (the
   5 // "Software"), to deal in the Software without restriction, including
   6 // without limitation the rights to use, copy, modify, merge, publish,
   7 // distribute, sublicense, and/or sell copies of the Software, and to permit
   8 // persons to whom the Software is furnished to do so, subject to the
   9 // following conditions:
  10 //
  11 // The above copyright notice and this permission notice shall be included
  12 // in all copies or substantial portions of the Software.
  13 //
  14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  15 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  16 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
  17 // NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
  18 // DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  19 // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  20 // USE OR OTHER DEALINGS IN THE SOFTWARE.
  21
  22 var binding = process.binding('contextify');
  23 var Script = binding.ContextifyScript;
  24 var util = require('util');
  25
  26 // The binding provides a few useful primitives:
  27 // - ContextifyScript(code, { filename = "evalmachine.anonymous",
  28 //                            displayErrors = true } = {})
  29 //   with methods:
  30 //   - runInThisContext({ displayErrors = true } = {})
  31 //   - runInContext(sandbox, { displayErrors = true, timeout = undefined } = {})
  32 // - makeContext(sandbox)
  33 // - isContext(sandbox)
  34 // From this we build the entire documented API.
  35
  36 Script.prototype.runInNewContext = function(sandbox, options) {
  37   var context = exports.createContext(sandbox);
  38   return this.runInContext(context, options);
  39 };
  40
  41 exports.Script = Script;
  42
  43 exports.createScript = function(code, options) {
  44   return new Script(code, options);
  45 };
  46
  47 exports.createContext = function(sandbox) {
  48   if (util.isUndefined(sandbox)) {
  49     sandbox = {};
  50   } else if (binding.isContext(sandbox)) {
  51     return sandbox;
  52   }
  53
  54   binding.makeContext(sandbox);
  55   return sandbox;
  56 };
  57
  58 exports.runInDebugContext = function(code) {
  59   return binding.runInDebugContext(code);
  60 };
  61
  62 exports.runInContext = function(code, contextifiedSandbox, options) {
  63   var script = new Script(code, options);
  64   return script.runInContext(contextifiedSandbox, options);
  65 };
  66
  67 exports.runInNewContext = function(code, sandbox, options) {
  68   var script = new Script(code, options);
  69   return script.runInNewContext(sandbox, options);
  70 };
  71
  72 exports.runInThisContext = function(code, options) {
  73   var script = new Script(code, options);
  74   return script.runInThisContext(options);
  75 };
  76
  77 exports.isContext = binding.isContext;