# node:module

> How Elide supports Node's `module` helpers: createRequire, isBuiltin and builtinModules, with source-map lookups stubbed and loader hooks unsupported.

`node:module` exports `createRequire`, `isBuiltin`, `builtinModules`, and the rest of
[Node's module helpers](https://nodejs.org/api/module.html).

## Example

```js
// module.mjs
import { builtinModules, createRequire, isBuiltin } from "node:module";

const require = createRequire(import.meta.url);
const { basename } = require("node:path");
console.log(basename("/srv/app/main.js"));
console.log(isBuiltin("node:fs"), isBuiltin("fs/promises"), isBuiltin("left-pad"));
console.log(builtinModules.includes("worker_threads"));
```

`elide run module.mjs` prints:

```text
main.js
true true false
true
```

## Differences from Node

- `createRequire` returns the realm's `require`; relative paths do not resolve against the filename passed to it.
- `syncBuiltinESMExports()` is a no-op.
- `findSourceMap()` returns `undefined`; `getSourceMapsSupport()` reports source maps disabled.
- Loader customization hooks (`register`) are not supported.
- `require.resolve()` returns the specifier unchanged for built-ins.

<!-- api-reference:start 8bff62175485 -->
## Reference

**Status:** Partial · 45 of 52 suite tests pass (86.5%)

### `module` exports

`Module`, `builtinModules`, `createRequire`, `findSourceMap`, `getSourceMapsSupport`, `globalPaths`, `isBuiltin`, `runMain`, `setSourceMapsSupport`, `syncBuiltinESMExports`, `wrap`, `wrapper`

### Not implemented

`SourceMap`, `constants`, `enableCompileCache`, `findPackageJSON`, `flushCompileCache`, `getCompileCacheDir`, `register`, `registerHooks`, `stripTypeScriptTypes`.

**Tests:** [node-api `node:module-loading`](https://github.com/elide-dev/testsuite/blob/main/reports/1.6.0%2B6e718933f/4cbcae6c33a8/node-api/node-api.md): 45 pass, 7 fail, 0 error, 5 skipped. Failing: `test-module-loading-globalpaths.js`, `test-module-main-fail.js`, `test-module-main-preserve-symlinks-fail.js`, `test-module-prototype-mutation.js`, `test-module-run-main-monkey-patch.js`, `test-require-package-map.js`, `test-require-symlink.js`.
<!-- api-reference:end -->