ServerJS/Modules/SecurableModules: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(→‎Unit Tests: added a link to Ash Berlin's unit test mirror)
(moved to CommonJS wiki)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
This specification addresses how modules should be written in order to be interoperable among a class of module systems that can be both client and server side, secure or insecure, implemented today or supported by future systems with syntax extensions.  These modules are offered privacy of their top scope, facility for importing singleton objects from other modules, and exporting their own API.  By implication, this specification defines the minimum features that a module system must provide in order to support interoperable modules.
This specification has moved to the [http://wiki.commonjs.org/wiki/Modules/1.0 CommonJS wiki].
 
== Contract ==
 
=== Module Context ===
 
# A module receives a "require" function.
## The "require" function accepts a module identifier.
## "require" returns an object containing the exported API of the foreign module.
## If there is a dependency cycle, the foreign module may not have finished executing at the time it is required by one of its transitive dependencies; in this case, the object returned by "require" must contain at least the exports that the foreign module has prepared before the call to require that led to the current module's execution.
## If the requested module cannot be returned, "require" must throw an error.
# A module receives an "exports" object that it may add its exported API to as it executes.
# modules must use the "exports" object as the only means of exporting.
 
=== Module Identifiers ===
 
# A module identifier is a String of "terms" delimited by forward slashes.
# A term must be a camelCase identifier, ".", or "..".
# Module identifiers may not have file-name extensions like ".js".
# Module identifiers may be "relative" or "top-level".  A module identifier is "relative" if the first term is "." or "..".
# Top-level identifiers are resolved off the conceptual module name space root.
# Relative identifiers are resolved relative to the identifier of the module in which "require" is written and called.
 
=== Unspecified ===
 
This specification leaves the following important points of interoperability unspecified:
 
# Whether modules are stored with a database, file system, or factory functions, or are interchangeable with link libraries.
# Whether a PATH is supported by the module loader for resolving module identifiers.
 
== Unit Tests ==
 
* [http://code.google.com/p/interoperablejs/ Unit Tests at Google Code] by Kris Kowal
* [http://github.com/ashb/interoperablejs/tree/master Unit Tests Git Mirror] by Ash Berlin
 
== Sample Code ==
 
math.js:
exports.add = function() {
  var sum = arguments[0];
  for (var i=1; i<arguments.length; i++) {
    sum += arguments[i];
  }
  return sum;
};
increment.js:
var add = require('math').add;
exports.increment = function(val) {
  return add(val, 1);
};
program.js:
var inc = require('increment').increment;
var a = 1;
inc(a); // 2
 
== Notes ==
 
* [[ServerJS/Modules/Secure|Secure Modules]]
* [[ServerJS/Modules/CompiledModules|Notes on compiling modules for browsers]]
* [[ServerJS/Modules/ScriptModules|On writing modules that also work as <script>s]]
 
== Amendment Proposals ==
 
# [[ServerJS/System|System Variable]] (only an amendment to the module system if the "system" is a free variable and not a module)
# [[ServerJS/Modules/Loaders|Module Loaders]]
 
== Implementations ==
 
Passing all compliance tests:
* Ondrej Zara's v8cgi for V8 http://code.google.com/p/v8cgi/
* Tom Robinson's narwhal for Rhino http://github.com/tlrobinson/narwhal/
* Wes Garland's GPSEE for Spidermonkey http://kenai.com/projects/gpsee/pages/Home
* Kris Kowal's chiron for browsers http://github.com/kriskowal/chiron/
* Hannes Wallnoefer's Helma NG for Rhino at http://github.com/hns/helma-ng/tree/master
 
Fully implemented:
* Kris Zyp's Persevere for Rhino at http://www.persvr.org/
 
In development:
* nathan smith is implementing this for JScript and ASP at http://github.com/smith/interoperablejscript/tree/master
* mob is implementing this in Ejscript http://www.ejscript.org
* pmuellr posted a sample loader http://wiki.github.com/pmuellr/modjewel

Latest revision as of 00:26, 3 November 2009

This specification has moved to the CommonJS wiki.

Retrieved from "https://wiki.mozilla.org/index.php?title=ServerJS/Modules/SecurableModules&oldid=180180"