# Node.js Support

Titanium SDK has full NodeJS support so users can use NPM modules Android and iOS platforms.

# Minor differences

This implementation includes the NodeJS require algorithm with some minor differences:

• SDK doesn't attempt to load *.node files

• SDK doesn't have replacements for Node's core modules

• If the required string doesn't have the prefix of ./, /, or ../, and its not a native module, the SDK will fall back to legacy Titanium behavior of assuming the require is meant as "absolute" inside the app (as in starting at "Resources/")

• The SDK will load JSON files and directories (package.json's main property (look at it, resolve it, and try to load it), index.js, and index.json)

# Algorithm summary

To summarize the algorithm the SDK uses, here are three summaries for requiring a module, loading as file, and loading as directory:

# Require(X) from module at path Y

1. If X is a core module,

   1. return the core module

   2. STOP

2. If X begins with ./, or ../,

   1. LOAD_AS_FILE(Y + X)

   2. LOAD_AS_DIRECTORY(Y + X)

3. If X begins with /,

   1. LOAD_AS_FILE(X)

   2. LOAD_AS_DIRECTORY(X)

4. If X does not contain '/', assume it should try and load CommonJS module first....

   1. LOAD_AS_FILE(X/X.js): try to load "legacy" CommonJS file named module.id/module.id.js.

   2. LOAD_AS_DIRECTORY(X): try to load CommonJS module as a directory

5. WARN user about possible bad require being treated as absolute THROW "not found"

   1. LOAD_AS_FILE(X)

   2. LOAD_AS_DIRECTORY(X)

# LOAD_AS_FILE(X)

1. If X is a file, load X as JavaScript text or JavaScript Object (JSON). STOP

2. If X.js is a file, load X.js as JavaScript text. STOP

3. If X.json is a file, parse X.json to a JavaScript Object. STOP

# LOAD_AS_DIRECTORY(X)

1. If X/package.json is a file, If X/index.js is a file, load X/index.js as JavaScript text. STOP

   1. Parse X/package.json and look for "main" field.

   2. let M = X + (json main field)

   3. LOAD_AS_FILE(M)

2. If X/index.json is a file, parse X/index.json to a JavaScript object. STOP