Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
@hola.org/benv
Advanced tools
Readme
Stub a browser environment and test your client-side code in node.js.
Example using mocha and should.
Given some client-side code
./client/app.js
$(function() {
$('body').html('Wat!?');
});
Setup, declare global dependencies, and test in node.js.
./test/client/app.js
var benv = require('benv');
beforeEach(function(done) {
benv.setup(function() {
benv.expose({
$: benv.require('../client/vendor/zepto.js', 'Zepto')
});
done();
});
});
afterEach(function() {
benv.teardown();
});
describe('app.js', function() {
it('renders Wat', function() {
require('../client/app.js');
$('body').html().should.include('Wat!?');
});
});
Unit testing client side code in a browser is slow and hard to setup with CI. Wouldn't it be nice if we could just run it along-side our server-side tests? Benv is a library of test helpers that make it easy to require your client-side code in node.js and test it like any other node module.
See this blog post for details & inspiration.
Exposes a stubbed browser API into the node.js global namespace so the current process can act like a browser environment. The optional options are passed to jsdom.env. In particular, if your code makes ajax requests then you must pass {url:'http://hostname:port'}
to avoid CORS errors.
Pass in a hash of common global client-side dependencies. For instance you may have a Backbone app that has a global App
namespace and uses jQuery. This should be run after benv.setup
b/c a lot of libraries assume the window
object is already global.
benv.expose({
_: require('underscore'),
jQuery: require('jquery'),
$: require('jquery'),
Backbone: require('backbone'),
App: {}
})
```
### benv.teardown(clearDOM = false)
Clean up the globals exposed by `setup` and `expose` so other tests can run without being harmed.
Use `benv.teardown(true)` to remove references to `window`, `document`, and other DOM globals. This isn't enabled by default because a lot of libraries cache references to DOM globals and don't work so nicely when trying to clear globals and re-require these libs.
### benv.require(filename, globalVarName)
For non-commonjs wrapped libraries, benv.require will export the global variable that is generally attached to window. For instance [zepto](https://github.com/madrobby/zepto) doesn't adopt any module pattern but it does create a global `Zepto` variable.
e.g.
````javascript
var $ = benv.require('./client/vendor/zepto.js', 'Zepto');
Renders the html in a body tag of a template. Pass in the template's filename along with any data passed into the template. Benv is backed by jsdom and benv.render
will remove any script tags so as to not accidentally run external javascript.
e.g.
benv.render('./views/artwork.jade', {
artwork: new Artwork({ title: 'Andy Warhol, Flowers' })
}, function() {
$('body').html().should.include('Andy Warhol, Flowers');
});
Currently only supports .jade and .pug templates, but please contribute others :)
For those using jadeify when requiring client-side code that uses jadeify it will throw an error because require('template.jade')
isn't valid node code.
If you defer your jade requires to run time e.g. var artworkTemplate = function() { return require('foo.jade').apply(this, arguments); }
and use benv.requireWithJadeify('../client/artwork.js', ['artworkTemplate'])
you can avoid this error and test the jadeified templates in node again.
For those using pugify when requiring client-side code that uses pugify it will throw an error because require('template.pug')
isn't valid node code.
If you defer your pug requires to run time e.g. var artworkTemplate = function() { return require('foo.pug').apply(this, arguments); }
and use benv.requireWithPugify('../client/artwork.js', ['artworkTemplate'])
you can avoid this error and test the pugified templates in node again.
Please fork the project and submit a pull request with tests. Install node modules npm install
and run tests with npm test
.
MIT
FAQs
Stub a browser environment and test your client-side code in node.js.
The npm package @hola.org/benv receives a total of 0 weekly downloads. As such, @hola.org/benv popularity was classified as not popular.
We found that @hola.org/benv demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.