Skip to content

Commit

Permalink
doc: clarify fallback behavior of module require
Browse files Browse the repository at this point in the history
PR-URL: #22494
Fixes: #22464
Reviewed-By: Anna Henningsen <[email protected]>
Reviewed-By: George Adams <[email protected]>
  • Loading branch information
TomCoded authored and addaleax committed Sep 2, 2018
1 parent 208022c commit 594dd42
Showing 1 changed file with 9 additions and 9 deletions.
18 changes: 9 additions & 9 deletions doc/api/modules.md
Original file line number Diff line number Diff line change
Expand Up @@ -352,22 +352,22 @@ If this was in a folder at `./some-library`, then

This is the extent of Node.js's awareness of `package.json` files.

If the file specified by the `'main'` entry of `package.json` is missing and
can not be resolved, Node.js will report the entire module as missing with the
default error:

```txt
Error: Cannot find module 'some-library'
```

If there is no `package.json` file present in the directory, then Node.js
If there is no `package.json` file present in the directory, or if the
`'main'` entry is missing or cannot be resolved, then Node.js
will attempt to load an `index.js` or `index.node` file out of that
directory. For example, if there was no `package.json` file in the above
example, then `require('./some-library')` would attempt to load:

* `./some-library/index.js`
* `./some-library/index.node`

If these attempts fail, then Node.js will report the entire module as missing
with the default error:

```txt
Error: Cannot find module 'some-library'
```

## Loading from `node_modules` Folders

<!--type=misc-->
Expand Down

0 comments on commit 594dd42

Please sign in to comment.