News for hackers. Stuff that matters.
Re:Your first Node.js module by tferris on Monday May 28, 2012 @02:56AM (#4032290)
Slightly OT: does anyone have a good explanation for module.exports vs exports and for the expression 'exports = module.exports = someFunction' often found in modules?
Re:Your first Node.js module by tgasson on Monday May 28, 2012 @07:42AM (#4032922)
Every module will have a `module` variable available to it.

    `module` defaults to {
        id: ...
        exports: {}
        parent:...
        filename:...
        loaded:...
        exited:...
        children:...
        paths:...
    }
Whatever module.exports is at the end of the module is passed to the require statement.

Every file essentially has two lines at the top.

    this = module.exports;
    var exports = module.exports;
The first helps lazy developers by allowing exporting without explicitly saying so. Because of this, the following alone is a valid module that exports {foo:'bar'}

    foo = 'bar'; // can also be written as this.foo = 'bar';
And the second matches the CommonJS standard. So the following CommonJS module will work:

    exports.foo = 'bar';
If you assign module.exports at any time after using `this` or `exports`, module.exports will point to the new object, and anything on the original module.exports object wont be passed to the `require` call.
Re:Your first Node.js module by strager on Monday May 28, 2012 @03:02AM (#4032300)
Reassigning the `exports` variable does not change the return value of `require`.

The return value of `require` is `module.exports`, which may be reassigned.

Initially, the global `exports` variable is set to the same value as `module.exports`. Writing `exports = module.exports = ...` ensures they have the same value as you would expect.

Re:Your first Node.js module by tferris on Monday May 28, 2012 @04:14AM (#4032449)
> Writing `exports = module.exports = ...` ensures they have the same value as you would expect.

But where should they have the same value? I thought require returns just module.exports if it exists and ignores exports.

Re:Your first Node.js module by secoif on Monday May 28, 2012 @08:24AM (#4033009)
'this' is also the same as exports. Initially, they all have the same value, they all point at the same object. If you assign module.exports to a new object (vs simply adding properties to the existing object) it will ignore the value of exports and this.

It's incredibly confusing and they should have just picked one way to export data, instead of three.

Re:Your first Node.js module by smagch on Monday May 28, 2012 @03:48AM (#4032389)
=== hoge.js ===

module.exports = exports = { hello: 'hello', world: 'world' };

exports.yetAnother = 'yet another exports key';

===

and this yield

require('./hoge') -> {

   hello: 'hello',

   world: 'world',

   yetAnother: 'yet another exports key'

 }
But, when hoge.js is

=== hoge.js ===

module.exports = { hello: 'hello', world: 'world' };

exports.yetAnother = 'yet another exports key';

===

require('./hoge') -> // { hello: 'hello', world: 'world' }

or

=== hoge.js ===

exports = { hello: 'hello', world: 'world' };

exports.yetAnother = 'yet another exports key';

===

require('./hoge') -> // {}

Re:Your first Node.js module by tferris on Monday May 28, 2012 @04:11AM (#4032441)
So you reassigned module.exports to exports in order to get all objects assigned to both module.exports and exports otherwise objects assigned to module.exports would override those assigned to exports which would stay ignored, right?

But: to get all objects do I have to assign module.exports to exports (so change the order from your first example)?:

exports = module.exports = { hello: 'hello', world: 'world' };

Re:Your first Node.js module by smagch on Monday May 28, 2012 @04:57AM (#4032545)
I usually use just `module.export = {...}` in the bottom line when I want to export object by object literal.

To be honest, I'm not quite sure about commonJS require implementation of nodeJS. But as long as I'm understand,

1. Use `module.exports` if you want to assign exports by object literal

2. Use `exports.[key]` if you want to assign exports brick by brick.

3. Use `exports = module.exports = {...}` or `module.exports = exports` if you want to ensure both functionality; you can assign `exports.[key] after assign exports by object literal.

Re:Your first Node.js module by mattyb on Monday May 28, 2012 @03:00AM (#4032293)
According to the documentation, they are the same:

http://nodejs.org/docs/v0.6.18/api/modules.html#modules_the_...

Re:Your first Node.js module by radagaisus on Monday May 28, 2012 @04:09AM (#4032433)
Also, `this` is exported in modules.
Re:Your first Node.js module by zeekay on Monday May 28, 2012 @05:40AM (#4032662)
I've noticed that, and have been taking advantage of it. Any downside to using `this`, besides potential scoping issues?
Re:Your first Node.js module by radagaisus on Monday May 28, 2012 @07:10AM (#4032859)
Not that I've experienced. Another cool trick: modules make sense when you use packages, but they feel like PHP 4 when you just try to divide your code to several files.

https://gist.github.com/2692091

This fixes part of the problem, but what happens when you reference './models/user.js' from the file 'auth.js' but then auth grows in size and you decide to divide it and put it in auth/facebook.js, auth/twitter.js, etc. -- well, now you are fucked.

Re:Your first Node.js module by secoif on Monday May 28, 2012 @08:31AM (#4033028)
You shouldn't require using the extension.

This gives you the flexibility to transparently change the file into a folder + index.*, then break functionality up into pieces that live inside that folder.

Re:Your first Node.js module by radagaisus on Monday May 28, 2012 @09:35AM (#4033246)
Still, currently you need to require everything with a relative path unless it's inside node_modules.