Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Node.js, require.main === module

Tags:

node.js

In Node.JS document, I found a sentence said

When a file is run directly from Node.js, require.main is set to its module. That means that it is possible to determine whether a file has been run directly by testing require.main === module.'

I want to ask what is the main here, I can not find definition of this main in source code, can anyone help, thanks!

like image 743
phaneven Avatar asked Jul 17 '17 05:07

phaneven


People also ask

What is require main === module?

When a file is run directly from Node. js, require. main is set to its module. That means that it is possible to determine whether a file has been run directly by testing require. main === module .

Why is require () used in NodeJS?

In NodeJS, require() is a built-in function to include external modules that exist in separate files. require() statement basically reads a JavaScript file, executes it, and then proceeds to return the export object.

What is main module in NodeJS?

Main module is the module that spins up your Node application, e.g if we write node app. js in the terminal, then app. js is the main module.

Where does require look for modules?

The require function will look for files in the following order. NPM Modules. It will look in the node_modules folder. Local Modules.


3 Answers

require is a function. .main is a property on that function so you can reference require.main. That part of the doc you are referring to says that you can write code like this:

if (require.main === module) {
     // this module was run directly from the command line as in node xxx.js
} else {
     // this module was not run directly from the command line and probably loaded by something else
}

module in that above code is a variable that is passed to all modules that are loaded by node.js so that code basically says that if require.main is the current module, then the current module is what was loaded from the command line.

The code for setting that property is here: https://github.com/nodejs/node/blob/master/lib/internal/modules/cjs/helpers.js#L44.

like image 66
jfriend00 Avatar answered Oct 21 '22 10:10

jfriend00


When running ECMAScript Modules with Node.js, require.main is not available. As of Node 13.9.0, there is not a succinct way to determine whether a module was run directly or imported by another module. It is possible that an import.meta.main value will allow for such a check in the future (comment on the modules issue if you think this makes sense).

As a workaround, it is possible to check if the current ES module was run directly by comparing the import.meta.url value to process.argv[1]. For example:

import { fileURLToPath } from 'url';
import process from 'process';

if (process.argv[1] === fileURLToPath(import.meta.url)) {
  // The script was run directly.
}

This does not handle the case where the script is called without the .js extension (e.g. node script instead of node script.js). To handle this case, any extension could be trimmed from both import.meta.url and process.argv[1].

The es-main package (caveat: I am the author) provides a way to check if an ES module is run directly, accounting for the different ways it can be run (with or without an extension).

import esMain from 'es-main';

if (esMain(import.meta)) {
  // The script was run directly.
}
like image 54
Tim Schaub Avatar answered Oct 21 '22 10:10

Tim Schaub


Quite late me answer, but i leave it here for reference.

  1. When a file is the entry point of a program, it's the main module. e.g. node index.js OR npm start, ​the index.js is the main module & the entry point of our application.

  2. But we might need to run it just as a module, and NOT as a main module. This can happen if we require the index.js like so:

node -e "require('./index.js')(5,6)"

We can check if a file is the main module in 2 ways.

  1. require.main === module
  2. module.parent === null

Lets say that we have a simple index.js file, that it either console.log() ,when it is the main module, or it exports a sum function, when it is not the main module:

if(require.main === module) {
 // it is the main entry point of the application
 // do some stuff here
 console.log('i m the entry point of the app')
} else{
 // its not the entry point of the app, and it behaves as 
 // a module
 module.exports = (num1, num2) => {
   console.log('--sum is:',num1+num2)
  }
 }

Ways to check the above condition:

  1. node index.js --> will print i m the entry point of the app
  2. node -e "require('./index.js')(5,6)" --> will print --sum is: 11
like image 5
Theo Itzaris Avatar answered Oct 21 '22 11:10

Theo Itzaris