cobbler

Cobbler.js

A spy who creates false passports, visas, diplomas and other documents

Mocking Passport OAuth for integration tests

Install

npm install cobbler --save-dev

Usage

var passport = cobbler('passport-github', {..profile..});

var server = app.listen(7331, function() {
  new WalkingDead(url).zombify(zopts)
    .when(function(browser, next) {
      browser.clickLink('[rel="login-with-github"]', next);
    })
    .then(function(browser) {
      assert.equal(browser.text("title"), "Welcome!");
    })
    .end(function() {
      passport.restore();
      server.close();
      done();
   });
});

cobbler mocks the calls to the OAuth service and redirects you to the callback url allowing you to bypass the network connections, but allows you to go through the full (most of it at least) process without mocking key functions in managing sessions, authenticated or initialization of passport.

---

If you want to simulate a successful authentication, the "profile" argument should be an object similar to what you would receive from an OAuth userProfile call. This will hit your Strategy callback and go through the normal chain of events.

var passport = cobbler('passport-github', {
  provider: 'github',
  id: 12345,
  displayName: 'John Doe'
});

To simulate a failed authentication, the "profile" argument should be false.

var passport = cobbler('passport-github', false);

---

You can restore the old functions by calling restore().

var passport = cobbler('passport-github', {..profile..});

// do the test

passport.restore();

---

cobbler can be passed either the npm name eg. 'passport-github' or the exports eg. var passportGithub = require('passport-github'); or the strategy eg. var GithubStrategy = require('passport-github').Strategy;

---

It should be noted that you may need to clear the require.cache of your app between tests.

Notes

• https://github.com/ciaranj/node-oauth/blob/master/lib/oauth2.js#L154
• https://github.com/jaredhanson/passport-oauth2/blob/master/test/oauth2.verify.test.js
• https://github.com/jaredhanson/passport-oauth2/blob/master/lib/strategy.js#L118
• https://github.com/jaredhanson/passport-github/blob/master/lib/strategy.js#L90

TODO

• More test coverage for other Passport OAuth Strategies (only Github at this point)
• Ability to set arguments such as accessToken, refreshToken, params
• Ability to test fail and error calls.
• Ability to set callback url code and error query params

License

MIT