Merge 2c9a970 into 202a0c3

README.md

@@ -84,6 +84,31 @@ sauceBrowsers([
 */
 ```
 
+### Callback variant: `sauceBrowsers([list, ]callback)`
+
+For error-first callback support, use `sauce-browsers/callback`:
+
+```js
+const sauceBrowsers = require('sauce-browsers/callback');
+
+sauceBrowsers([
+  { name: 'firefox', version: 50, platform: 'Mac 10.9'},
+  { name: 'chrome', version: ['oldest', 'latest'] }
+], function (err, browsers) {
+  if (err) throw err;
+  console.log(browsers);
+});
+```
+
+If the `list` argument is omitted, the callback receives all platforms currently supported on Sauce Labs:
+
+```js
+sauceBrowsers(function (err, browsers) {
+  if (err) throw err;
+  console.log(browsers);
+});
+```
+
 ## License
 
 [MIT](LICENSE)

callback.js

@@ -0,0 +1,17 @@
+'use strict';
+
+const sauceBrowsers = require('.');
+
+module.exports = function(wanted, callback) {
+  if (typeof wanted === 'function') {
+    callback = wanted;
+    wanted = undefined;
+  }
+
+  sauceBrowsers(wanted).then((result) => {
+    // Escape promise chain
+    process.nextTick(callback, null, result);
+  }).catch((err) => {
+    process.nextTick(callback, err);
+  });
+};

package.json

@@ -21,7 +21,8 @@
     "node": ">=4.0.0"
   },
   "files": [
-    "index.js"
+    "index.js",
+    "callback.js"
   ],
   "dependencies": {
     "got": "^8.2.0"

test/test.js

@@ -5,6 +5,7 @@ const test = require('tape');
 
 const allBrowsers = require('./fixtures/all-browsers');
 const sauceBrowsers = require('..');
+const sauceBrowsersCallback = require('../callback');
 
 function map(browsers) {
   return browsers.map((el) => [el.os, el.api_name, el.short_version]);
@@ -228,3 +229,38 @@ test('returns an error if the end version in a range is not found', (t) => {
     t.end();
   });
 });
+
+test('supports callback with browser list', (t) => {
+  sauceBrowsersCallback([{
+    name: 'internet explorer',
+    version: [6, '-1..latest']
+  }], function (err, browsers) {
+    t.ifError(err, 'no error');
+    t.deepEqual(map(browsers), [
+      ['Windows 2003', 'internet explorer', '6'],
+      ['Windows 2012', 'internet explorer', '10'],
+      ['Windows 10', 'internet explorer', '11']
+    ]);
+    t.end();
+  });
+});
+
+test('supports callback without browser list', (t) => {
+  sauceBrowsersCallback(function (err, browsers) {
+    t.ifError(err, 'no error');
+    t.deepEqual(browsers, allBrowsers);
+    t.end();
+  });
+});
+
+test('supports callback with an error', (t) => {
+  sauceBrowsersCallback([{
+    version: 'oldest..13',
+    name: 'opera'
+  }], (err, browsers) => {
+    t.equal(err instanceof Error, true);
+    t.equal(err.message, 'Unable to find end version: 13');
+    t.equal(browsers, undefined);
+    t.end();
+  });
+});