185

I have a script I am requiring from a Node.js script, which I want to keep JavaScript engine independent.

For example, I want to do exports.x = y; only if it’s running under Node.js. How can I perform this test?


When posting this question, I didn’t know the Node.js modules feature is based on CommonJS.

For the specific example I gave, a more accurate question would’ve been:

How can a script tell whether it has been required as a CommonJS module?

8
  • 3
    I've no idea why you are trying to do this, but as a rule of thumb you should be using feature detection rather then engine detection. quirksmode.org/js/support.html
    – Quentin
    Nov 19, 2010 at 11:44
  • 4
    This is actually a request on how to implement feature detection, but the question poorly describes itself.
    – monokrome
    Jan 23, 2013 at 21:30
  • published a library for my own use, help this will help npmjs.com/package/detect-is-node Jul 31, 2016 at 6:07
  • See stackoverflow.com/questions/17575790/…
    – brillout
    Oct 14, 2018 at 17:48
  • One problem with the question, and most of the answers, is the assumption that there are only two possibilities: Browser or Node.js. There is a possibility that it is neither browser nor Node.js, such as the case with Oracle Java Nashorn. If the JDK is installed, the jjs command lets you run scripts. But there are many differences between Nashorn and Node.js so you can't make any assumption. And who knows what options the future may bring? Feature detection is needed.
    – user2895783
    Mar 1, 2019 at 21:47

24 Answers 24

125

Well there's no reliable way to detect running in Node.js since every website could easily declare the same variables, yet, since there's no window object in Node.js by default you can go the other way around and check whether you're running inside a Browser.

This is what I use for libs that should work both in a Browser and under Node.js:

if (typeof window === 'undefined') {
    exports.foo = {};

} else {
    window.foo = {};
}

It might still explode in case that window is defined in Node.js but there's no good reason for someone do this, since you would explicitly need to leave out var or set the property on the global object.

EDIT

For detecting whether your script has been required as a CommonJS module, that's again not easy. Only thing commonJS specifies is that A: The modules will be included via a call to the function require and B: The modules exports things via properties on the exports object. Now how that is implement is left to the underlying system. Node.js wraps the module's content in an anonymous function:

function (exports, require, module, __filename, __dirname) { 

See: https://github.com/ry/node/blob/master/src/node.js#L325

But don't try to detect that via some crazy arguments.callee.toString() stuff, instead just use my example code above which checks for the Browser. Node.js is a way cleaner environment so it's unlikely that window will be declared there.

10
  • 3
    About "Node.js is a way cleaner environment so it's unlikely that window will be declared there.": well, I just came here looking for a way to find out whether my script was running in a browser emulated by node.js + JSDOM or in a plain browser... The reason is that I have an infinite loop using setTimeout to check the URL location, which is fine in a browser, but keeps the node.js script running forever... So there might be a window in a node.js script after all :) Feb 1, 2011 at 18:18
  • 2
    @Eric I highly doubt it will be there in the global scope, so unless you import something as window in the first line of your module you should not have any problems. You could also run an anonymous function and check the [[Class]] of this inside it (works only in non-strict mode) See "Class" under: bonsaiden.github.com/JavaScript-Garden/#typeof
    – Ivo Wetzel
    Feb 1, 2011 at 18:28
  • 1
    My issue differs slightly from the OP's: I am not requiring the script, it is loaded by JSDOM with the emulated window as global context... It is still run by node.js + V8, just in a different context than usual modules. Feb 1, 2011 at 20:01
  • 1
    Probably... I went another direction: 1) detect support for onhashchange ("onhashchange" in window) to avoid creating the infinite loop 2) simulate support by setting the onhashchange property on emulated window in main node.js script. Feb 1, 2011 at 22:00
  • 1
    typeof self === 'object' might be safer since typeof window === 'undefined' fails on web workers scope.
    – Lewis
    May 16, 2015 at 10:16
82

By looking for CommonJS support, this is how the Underscore.js library does it:

Edit: to your updated question:

(function () {

    // Establish the root object, `window` in the browser, or `global` on the server.
    var root = this; 

    // Create a reference to this
    var _ = new Object();

    var isNode = false;

    // Export the Underscore object for **CommonJS**, with backwards-compatibility
    // for the old `require()` API. If we're not in CommonJS, add `_` to the
    // global object.
    if (typeof module !== 'undefined' && module.exports) {
            module.exports = _;
            root._ = _;
            isNode = true;
    } else {
            root._ = _;
    }
})();

Example here retains the Module pattern.

10
  • 49
    This detects CommonJS support, which browsers may support. Dec 24, 2012 at 14:05
  • 8
    There is a problem here and nailer "nailed it". I'm trying CommonJS in the browser, and the module loader I'm using defines module.exports, so this solution would incorrectly tell me I'm in node. Dec 31, 2012 at 23:02
  • 1
    @MarkMelville arguably, this is exactly what the OP is asking so therefore not a problem.
    – Ross
    Jan 1, 2013 at 17:37
  • 13
    Poor wording on my part. I mean there is a problem with this solution. The OP may have accepted it, but I do not. Jan 3, 2013 at 23:40
  • 7
    This is most certainly NOT the best answer given. Nov 29, 2014 at 17:53
60

I currently stumbled over a wrong detection of Node which is not aware of the Node-environment in Electron due to a misleading feature-detection. The following solutions identify the process-environment explicitly.


Identify Node.js only

(typeof process !== 'undefined') && (process.release.name === 'node')

This will discover if you're running in a Node-process, since process.release contains the "metadata related to the current [Node-]release".

After the spawn of io.js (which was discontinued a long time ago) the value of process.release.name may also have become io.js.

Bun aims for full Node.js compatibility and therefore mimics Node-behaviour.

To proper detect a Node-ready environment i guess you should check as follows:

Identify Node (>= 3.0.0), Bun or io.js

(typeof process !== 'undefined') &&
(process.release.name.search(/node|io.js/) !== -1)

This statement was tested (at the time of the initial post) with Node 5.5.0, Electron 0.36.9 (with Node 5.1.1) and Chrome 48.0.2564.116.

Identify Node (>= 0.10.0), Bun or io.js

(typeof process !== 'undefined') &&
(typeof process.versions.node !== 'undefined')

@daluege's comment inspired me to think about a more general proof. This should working from Node.js >= 0.10. I didn't find a unique identifier for prior versions.

Explicitly identify Bun (>= 1.0.3)

(typeof process !== 'undefined') && process.versions.bun)

Bun recently added support for the process object, this detection method is taken from Bun's detect bun guide.

Explicitly identify Bun (< 1.0.3)

(typeof process !== 'undefined') && process.isBun)

P.s.: I am posting that answer here since the question lead me here, although the OP was searching for an answer to a different question.

13
  • 2
    This seems to be by far the most reliable approach, thank you. Though only working for version >= 3.0.0.
    – filip
    Oct 28, 2016 at 10:38
  • @daluege -- thanks for inspiration. I unfortunately didn't find a proof for lower than 0.10. Oct 28, 2016 at 14:09
  • 4
    I found using react webpack, process and process.version exists within the bundle, so I added an extra check for process.version where process.release.node is undefined on client side but has a node version as a value on server side
    – Aaron
    Feb 19, 2017 at 1:49
  • 2
    One-liner and safer: function isNodejs() { return typeof "process" !== "undefined" && process && process.versions && process.versions.node; }
    – brillout
    Oct 14, 2018 at 17:49
  • 1
    Bun now implements process.release.name github.com/oven-sh/bun/issues/1404. Alternatively, typeof Bun !== "undefined" is a very concise test that also makes TypeScript happy if you use "types": ["bun-types"]
    – pzmarzly
    Sep 23, 2023 at 15:52
25

The problem with trying to figure out what environment your code is running in is that any object can be modified and declared making it close to impossible to figure out which objects are native to the environment, and which have been modified by the program.

However, there are a few tricks we can use to figure out for sure what environment you are in.

Lets start out with the generally accepted solution that's used in the underscore library:

typeof module !== 'undefined' && module.exports

This technique is actually perfectly fine for the server side, as when the require function is called, it resets the this object to an empty object, and redefines module for you again, meaning you don't have to worry about any outside tampering. As long as your code is loaded in with require, you are safe.

However, this falls apart on the browser, as anyone can easily define module to make it seem like it's the object you are looking for. On one hand this might be the behavior you want, but it also dictates what variables the library user can use in the global scope. Maybe someone wants to use a variable with the name module that has exports inside of it for another use. It's unlikely, but who are we to judge what variables someone else can use, just because another environment uses that variable name?

The trick however, is that if we are assuming that your script is being loaded in the global scope (which it will be if it's loaded via a script tag) a variable cannot be reserved in an outer closure, because the browser does not allow that. Now remember in node, the this object is an empty object, yet, the module variable is still available. That is because it's declared in an outer closure. So we can then fix underscore's check by adding an extra check:

this.module !== module

With this, if someone declares module in the global scope in the browser, it will be placed in the this object, which will cause the test to fail, because this.module, will be the same object as module. On node, this.module does not exist, and module exists within an outer closure, so the test will succeed, as they are not equivalent.

Thus, the final test is:

typeof module !== 'undefined' && this.module !== module

Note: While this now allows the module variable to be used freely in the global scope, it is still possible to bypass this on the browser by creating a new closure and declaring module within that, then loading the script within that closure. At that point the user is fully replicating the node environment and hopefully knows what they are doing and is trying to do a node style require. If the code is called in a script tag, it will still be safe from any new outer closures.

2
  • 3
    Wow, thanks for clearly explaining the rationale behind each piece of your one-liner.
    – Jon Coombs
    Apr 6, 2015 at 18:38
  • got Cannot read property 'module' of undefined because this is undefined in mocha tests for example
    – srghma
    Sep 30, 2017 at 20:13
23

The following works in the browser unless intentionally,explicitly sabotaged:

if(typeof process === 'object' && process + '' === '[object process]'){
    // is node
}
else{
    // not node
}

Bam.

6
  • 4
    var process = { toString: function () { return '[object process]'; } }; Dec 29, 2014 at 22:46
  • 1
    Is there some reason why you use process+'' instead of process.toString() ?
    – harmic
    Dec 9, 2015 at 0:58
  • 3
    Almost. Use this instead: Object.prototype.toString.call(process)
    – sospedra
    Jan 24, 2016 at 23:50
  • 2
    This is the best answer to this question. Mar 10, 2016 at 15:18
  • 4
    @harmic: var process = null; would cause the second case to fail. In both Javascript and Java, the expression '' + x produces the same as x.toString() except when x is nasty, the former produces "null" or "undefined" where the latter would throw an error. Jun 29, 2016 at 10:20
17

Here's a pretty cool way to do it as well:

const isBrowser = this.window === this;

This works because in browsers the global 'this' variable has a self reference called 'window'. This self reference is not existent in Node.

  • In the browser 'this' is a reference to the global object, called 'window'.
  • In Node 'this' is a reference to the module.exports object.
    • 'this' is not a reference to the Node global object, called 'global'.
    • 'this' is not a reference to the the module variable declaration space.

To break the above suggested browser check you would have to do something like the following

this.window = this;

before executing the check.

2
  • Why not simply const isBrowser = this.window !== undefined ? And in theory in node I can do this.window = this to fool the solution.
    – Tyler Liu
    May 16, 2020 at 1:24
  • 1
    Great answer, but there is a caveat: this breaks in "use strict" mode.
    – Kithraya
    Oct 20, 2020 at 13:27
13

Yet another environment detection:

(Meaning: most of the answers here are alright.)

function isNode() {
    return typeof global === 'object'
        && String(global) === '[object global]'
        && typeof process === 'object'
        && String(process) === '[object process]'
        && global === global.GLOBAL // circular ref
        // process.release.name cannot be altered, unlike process.title
        && /node|io\.js/.test(process.release.name)
        && typeof setImmediate === 'function'
        && setImmediate.length === 4
        && typeof __dirname === 'string'
        && Should I go on ?..
}

A bit paranoid right? You can make this more verbose by checking for more globals.

But DON'T!.

All these above can be faked/simulated anyway.

For example to fake the global object:

global = {
    toString: function () {
        return '[object global]';
    },
    GLOBAL: global,
    setImmediate: function (a, b, c, d) {}
 };
 setImmediate = function (a, b, c, d) {};
 ...

This won't get attached to the Node's original global object but it will get attached to the window object in a browser. So it'll imply that you're in Node env inside a browser.

Life is short!

Do we care if our environment is faked? It'd happen when some stupid developer declare a global variable called global in the global scope. Or some evil dev injects code in our env somehow.

We may prevent our code from executing when we catch this but lots of other dependencies of our app might get caught into this. So eventually the code will break. If your code is good enough, you should not care for each and every silly mistake that could have been done by others.

So what?

If targeting 2 environments: Browser and Node;
"use strict"; and either simply check for window or global; and clearly indicate that in the docs that your code supports only these environments. That's it!

var isBrowser = typeof window !== 'undefined'
    && ({}).toString.call(window) === '[object Window]';

var isNode = typeof global !== "undefined" 
    && ({}).toString.call(global) === '[object global]';

If possible for your use case; instead of environment detection; do synchronous feature detection within a try/catch block. (these will take a few milliseconds to execute).

e.g.

function isPromiseSupported() {
    var supported = false;
    try {
        var p = new Promise(function (res, rej) {});
        supported = true;
    } catch (e) {}
    return supported;
}
0
12

A one liner can be used in modern JavaScript runtimes.

const runtime = globalThis.process?.release?.name || 'not node'

The runtime value will be either node or not node.

This relies on a few newer JavaScript features. globalThis was finalized in the ECMAScript 2020 spec. Optional chaining/nullish coalescing (the ? part of globalThis.process?.release?.name) is supported in the V8 engine as of version 8.x+ (which shipped in Chrome 80 & Node 14, released on 4/21/2020).

1
  • 4
    This should be the accepted answer! and everyone should use node 14 btw
    – Sceat
    May 4, 2020 at 14:03
8

Most of the proposed solutions can actually be faked. A robust way is to check the internal Class property of the global object using the Object.prototype.toString. The internal class can't be faked in JavaScript:

var isNode = 
    typeof global !== "undefined" && 
    {}.toString.call(global) == '[object global]';
6
  • 2
    This will come back true under browserify.
    – alt
    Jan 2, 2014 at 6:28
  • 1
    Did you test that? I can't see how browserify can change the internal class of an object. This would require changing code in the JavaScript VM or overwriting Object.prototype.toString which is really bad practice. Jan 2, 2014 at 9:54
  • I tested it. Here's what browserify does: var global=typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {};
    – Vanuan
    Jan 30, 2014 at 15:33
  • You see, in Chrome, ({}.toString.call(window)) is equal "[object global]".
    – Vanuan
    Jan 30, 2014 at 15:43
  • 2
    It's strange, because window.toString() produces "[object Window]"
    – Vanuan
    Jan 30, 2014 at 15:45
4

What about using the process object and checking execPath for node?

process.execPath

This is the absolute pathname of the executable that started the process.

Example:

/usr/local/bin/node

1
4

How can a script tell whether it has been required as a commonjs module?

Related: to check whether it has been required as a module vs run directly in node, you can check require.main !== module. http://nodejs.org/docs/latest/api/modules.html#accessing_the_main_module

0
3

Here's my variation on what's above:

(function(publish) {
    "use strict";

    function House(no) {
        this.no = no;
    };

    House.prototype.toString = function() {
        return "House #"+this.no;
    };

    publish(House);

})((typeof module == 'undefined' || (typeof window != 'undefined' && this == window))
    ? function(a) {this["House"] = a;}
    : function(a) {module.exports = a;});

To use it, you modify the "House" on the second last line to be whatever you want the name of the module to be in the browser and publish whatever you want the value of the module to be (usually a constructor or an object literal).

In browsers the global object is window, and it has a reference to itself (there's a window.window which is == window). It seems to me that this is unlikely to occur unless you're in a browser or in an environment that wants you to believe you're in a browser. In all other cases, if there is a global 'module' variable declared, it uses that otherwise it uses the global object.

0
3

I'm using process to check for node.js like so

if (typeof(process) !== 'undefined' && process.version === 'v0.9.9') {
  console.log('You are running Node.js');
} else {
  // check for browser
}

or

if (typeof(process) !== 'undefined' && process.title === 'node') {
  console.log('You are running Node.js');
} else {
  // check for browser
}

Documented here

3
  • 2
    process.title can be changed
    – Ben Barkay
    Apr 18, 2013 at 23:35
  • Then check for the title you changed it to. Or use process.version
    – Chris
    Apr 19, 2013 at 7:12
  • If you're writing for a library (like you should), you will not be able to expect what the title should be
    – Ben Barkay
    Apr 19, 2013 at 15:57
2
const isNode =
  typeof process !== 'undefined' &&
  process.versions != null &&
  process.versions.node != null;
2

From the source of debug package:

const isBrowser = typeof process === 'undefined' || process.type === 'renderer' || process.browser === true || process.__nwjs

https://github.com/visionmedia/debug/blob/master/src/index.js#L6

1

Node.js has process object, so as long as You don't have any other script which create process You can use it to determine if code runs on Node.

var isOnNodeJs = false;
if(typeof process != "undefined") {
  isOnNodeJs = true;
}

if(isOnNodeJs){
  console.log("you are running under node.js");
}
else {
  console.log("you are NOT running under node.js");
}
1

This is a pretty safe and straight-forward way of assuring compatibility between server-side and client-side javascript, that will also work with browserify, RequireJS or CommonJS included client-side:

(function(){

  // `this` now refers to `global` if we're in NodeJS
  // or `window` if we're in the browser.

}).call(function(){
  return (typeof module !== "undefined" &&
    module.exports &&
    typeof window === 'undefined') ?
    global : window;
}())
1

Here is how you can check if the code is running in Node.js

const isNode = ({}).toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]';
2
  • This does not provide an answer to the question. To critique or request clarification from an author, leave a comment below their post. - From Review
    – Emna Ayadi
    Sep 4, 2023 at 20:03
  • @EmnaAyadi have you even read the title of the question?
    – Newbie...
    Sep 5, 2023 at 11:56
0

Edit: Regarding your updated question: "How can a script tell whether it has been required as a commonjs module?" I don't think it can. You can check whether exports is an object (if (typeof exports === "object")), since the spec requires that it be provided to modules, but all that tells you is that ... exports is an object. :-)


Original answer:

I'm sure there's some NodeJS-specific symbol (EventEmitter, perhaps no, you have to use require to get the events module; see below) that you could check for, but as David said, ideally you're better off detecting the feature (rather than environment) if it makes any sense to do so.

Update: Perhaps something like:

if (typeof require === "function"
    && typeof Buffer === "function"
    && typeof Buffer.byteLength === "function"
    && typeof Buffer.prototype !== "undefined"
    && typeof Buffer.prototype.write === "function") {

But that just tells you that you're in an environment with require and something very, very much like NodeJS's Buffer. :-)

7
  • I can still break that by setting up all that stuff in a Website... that's just overkill ;) Checking for being in a Browser is easier since the Node environment is cleaner.
    – Ivo Wetzel
    Nov 19, 2010 at 12:10
  • 1
    @Ivo: Yes, see my last sentence. I can just as easily break your check by defining a window variable within a NodeJS application. :-) Nov 19, 2010 at 12:15
  • 1
    @Ivo: I wouldn't be at all surprised if someone defined window in a NodeJS module, so they could include code that relied on window being the global object and didn't want to modify that code. I wouldn't do it, you wouldn't, but I bet someone has. :-) Or they've just used window to mean something else entirely. Nov 19, 2010 at 12:21
  • 1
    @Ivo: yuiblog.com/blog/2010/04/09/… is one reason why the window object may be defined in node.js
    – slebetman
    Nov 19, 2010 at 14:35
  • 1
    @T.J.Crowder typeof process !== "undefined" && process.title === "node"
    – Raynos
    Apr 17, 2012 at 9:49
0

This does not directly answer your question, as you wanted to check for Node.js specifically, however it's useful enough to warrant saying:

Most of the time, if you just want to distinguish between browsers and server-side javascript, it's enough to just check for the existence of a document.

if (typeof document !== 'undefined') {} // do stuff

// This one is overkill, but 100% always works:
if (typeof window !== 'undefined' && window && window.window === window) {
   if (typeof window.document !== 'undefined' && document.documentElement) {

   }
}
0

You can use getters to detect when your module.exports is read and that would mean that it was required.

let required = false;

function myFunction() {
  // your code whatever
  return required;
}

if (typeof module == 'object') {
  Object.defineProperty(module, 'exports', {
    get: () => {
      required = true;
      return myFunction;
    }
  })
}

Tested in my console on Chrome Version 106.0.5249.119 (Official Build) (x86_64) and Node v16.15.0

-1

Very old post, but i just solved it by wrapping the require statements in a try - catch

try {
     var fs = require('fs')
} catch(e) {
     alert('you are not in node !!!')
}
2
  • 3
    That's not true, you can use browserify to use "nodeish" require() calls
    – fat
    Jan 11, 2015 at 21:06
  • also, when requiring a module, node (if it's node) has to look for it in all of the node_modules folders it knows and then open the module file, read it and run it, which can take some time
    – LuisAFK
    Oct 24, 2022 at 14:49
-1

Very old post, but I solved with a combination of the other answers:

var isNode=()=>!("undefined"!=typeof window||"object"!=typeof module||!module.exports||"object"!=typeof process||!process.moduleLoadList);
console.log(isNode()); //=> false

-2

Take the source of node.js and change it to define a variable like runningOnNodeJS. Check for that variable in your code.

If you can't have your own private version of node.js, open a feature request in the project. Ask that they define a variable which gives you the version of node.js that you're running in. Then check for that variable.

5
  • 1
    That again doesn't solve his (basically unsolvable) problem, I can again just create such a variable in the Browser. Better way would be to prevent scripts from creating a window global, guess I gonna file a feature request on that one.
    – Ivo Wetzel
    Nov 19, 2010 at 12:52
  • @Ivo: That's a bad idea that would break code that uses jsdom (github.com/tmpvar/jsdom) to do server side dom manipulation using familiar libraries like YUI and jQuery. And there are code currently in production that does this.
    – slebetman
    Nov 19, 2010 at 14:39
  • @slebetman No it will not break jsdom. I'm speaking of global, like in no var statement global, the example code there uses the var statement, people who just leak it into the global namespace, well they don't get the concept of self-contained modules then
    – Ivo Wetzel
    Nov 19, 2010 at 15:03
  • @Ivo that's kind of violent, it's like saying we should take the ability to eat cakes because people get fat overeating them. You must clutter the global namespace to achieve a library that will work inter-module. Or you could wrap it all up in a single module, but then what's the point?
    – Ben Barkay
    Apr 10, 2013 at 8:13
  • @IvoWetzel Can't you just use strict mode then?
    – Nirvana
    May 21, 2021 at 0:39

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.