Incomplete documentation require()

[soulne4ny]

Incomplete documentation at https://nodejs.org/dist/latest-v8.x/docs/api/modules.html#modules_require
It states no use cases.

require() is widely used for reading .json files.
Is it safe to apply require() over .json? Are there any guarantees that .json file is allowed to contain single JSON object only? Are there any guarantees require()ing a .json file containing valid JS code will never lead to interpreting the code?

[mscdex]

The complete process for resolving modules describes what happens: https://nodejs.org/dist/latest-v8.x/docs/api/modules.html#modules_all_together

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

The code for the module loader verifies this behavior.

[Fishrock123]

As noted above, this behavior is specified. That being said, just "To require modules." is practically not even documentation. it should be expanded in some way regardless.

[Trott]

Docs were expanded in #23605.

[soulne4ny]

Thanks a lot!