@ -398,24 +398,33 @@ The module circle\.js has exported the functions area() and circumference()\. To
.sp
The module path is relative to the file calling require()\. That is, circle\.js must be in the same directory as foo\.js for require() to find it\.
.sp
HTTP URLs can also be used to load modules\. For example,
Like require() the function include() also loads a module\. Instead of returning a namespace object, include() will add the module\(cqs exports into the global namespace\. For example:
.sp
.sp
.RS4
.nf
var circle = require("http://tinyclouds\.org/node/circle\.js");
include("circle\.js");
puts("The area of a cirlce of radius 4 is " + area(4));
.fi
.RE
Like require() the function include() also loads a module\. Instead of returning a namespace object, include() will add the module\(cqs exports into the global namespace\. For example:
When an absolute path is given to require() or include(), like require("/mjsunit\.js") the module is searched for in the node\.libraryPaths array\. node\.libraryPaths on my system looks like this:
.sp
.sp
.RS4
.nf
include("circle\.js");
puts("The area of a cirlce of radius 4 is " + area(4));
[ "/home/ryan/\.node_libraries"
, "/home/ryan/local/node/lib/node_libraries"
, "/"
]
.fi
.RE
Functions require_async() and include_async() also exist\.
That is, first Node looks for "/home/ryan/\.node_libraries/mjsunit\.js" and then for "/home/ryan/local/node/lib/node_libraries/mjsunit\.js"\. If not found, it finally looks for "/mjsunit\.js" (in the root directory)\.
.sp
node\.libraryPaths can be modified at runtime by simply unshifting new paths on to it and at startup with the NODE_LIBRARY_PATHS environmental variable (which should be a list of paths, colon separated)\.
.sp
Node comes with several libraries which are installed when "make install" is run\. These are currently undocumented, but do look them up in your system\.
.sp
(Functions require_async() and include_async() also exist\.)
Ryan Dahl
16 years ago