wdio -> browserstack session info

startNewSession.js

/**
 * Resets the browser for the next set of tests and sets the test name
 * for Browserstack organization
 *
 * @param {object} mochaTest The Mocha 'test' object (should be `this` in your tests)
 * @param {object} [viewportSize]
 * @param {number} [viewportSize.width] - Viewport width; defaults to 1280
 * @param {number} [viewportSize.height] - Viewport height, defaults to 960
 * @example
 * browser.startNewSession(this);
 * @example
 * browser.startNewSession(this, { width: 1000, height: 1000 });
 */
browser.addCommand("startNewSession", function(mochaTest, viewportSize) {
	if (!viewportSize) {
		viewportSize = { width: 1280, height: 960 };
	}

	var capabilities = {};
	if (mochaTest) {
		var test = mochaTest.currentTest || mochaTest.test;

		capabilities.name = test.fullTitle();
	}

	return browser
		.end()
		.init(capabilities)
		.setViewportSize(viewportSize)
	;
});

test.js

describe("main navigation #smoke", function() {
	beforeEach(function() {
		return browser
			.startNewSession(this)
			.url("/");
	});
	
	it("should correctly navigate to a page", function() {
		return browser
			.doSomething();
	});
});

wdio.config.js

var _ = require("lodash");
var getRequestedBrowsers = require("./getRequestedBrowsers.js");
var config = require("./config.js");

capabilities = getRequestedBrowsers(config.browsers);

// set up browserstack "project" and "build" settings for better test organization
var extraCapabilities = {
	project: process.env.npm_package_name
};

if (process.env.BUILD_NUMBER) {
	extraCapabilities.build = "Jenkins #" + process.env.BUILD_NUMBER;
} else {
	extraCapabilities.build = config.user + " " + timestamp();
}

capabilities = _.map(capabilities, function(browserCapabilities) {
	return _.merge(browserCapabilities, extraCapabilities);
});

## lots more config stuff here

Example browserstack output: