Skip to content

Commit

Permalink
doc: add ESM examples in module API doc page
Browse files Browse the repository at this point in the history
PR-URL: #34875
Reviewed-By: Myles Borins <[email protected]>
Reviewed-By: Guy Bedford <[email protected]>
  • Loading branch information
aduh95 authored and richardlau committed Sep 7, 2020
1 parent 0ac7d54 commit 1a9ca52
Showing 1 changed file with 23 additions and 4 deletions.
27 changes: 23 additions & 4 deletions doc/api/module.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@
* {Object}

Provides general utility methods when interacting with instances of
`Module`, the `module` variable often seen in file modules. Accessed
via `require('module')`.
`Module`, the [`module`][] variable often seen in [CommonJS][] modules. Accessed
via `import 'module'` or `require('module')`.

### `module.builtinModules`
<!-- YAML
Expand All @@ -27,6 +27,14 @@ if a module is maintained by a third party or not.
by the [module wrapper][]. To access it, require the `Module` module:

```js
// module.mjs
// In an ECMAScript module
import { builtinModules as builtin } from 'module';
```

```js
// module.cjs
// In a CommonJS module
const builtin = require('module').builtinModules;
```

Expand Down Expand Up @@ -74,8 +82,8 @@ added: v12.12.0
-->
The `module.syncBuiltinESMExports()` method updates all the live bindings for
builtin ES Modules to match the properties of the CommonJS exports. It does
not add or remove exported names from the ES Modules.
builtin [ES Modules][] to match the properties of the [CommonJS][] exports. It
does not add or remove exported names from the [ES Modules][].
```js
const fs = require('fs');
Expand Down Expand Up @@ -116,6 +124,14 @@ To enable source map parsing, Node.js must be run with the flag
[`NODE_V8_COVERAGE=dir`][].
```js
// module.mjs
// In an ECMAScript module
import { findSourceMap, SourceMap } from 'module';
```
```js
// module.cjs
// In a CommonJS module
const { findSourceMap, SourceMap } = require('module');
```
Expand Down Expand Up @@ -192,3 +208,6 @@ consists of the following keys:
[`createRequire()`]: #module_module_createrequire_filename
[module wrapper]: modules_cjs.html#modules_cjs_the_module_wrapper
[source map include directives]: https://sourcemaps.info/spec.html#h.lmz475t4mvbx
[`module`]: modules.html#modules_the_module_object
[CommonJS]: modules.html
[ES Modules]: esm.html

0 comments on commit 1a9ca52

Please sign in to comment.