diff --git a/README.md b/README.md index 11e8f83..2cddec4 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,4 @@ +**Note:** This version of the BrowserStack API has been deprecated. Please use [BrowserStack API v4.0](https://github.com/browserstack/api) # API Overview The following denotes the HTTP-based API for [BrowserStack](http://www.browserstack.com). It provides browser-as-a-service for automated cross-browser testing. The goal is to provide a simple service which can easily be used by any browser testing framework. @@ -69,83 +70,59 @@ Fetches all available browsers. { 'Windows': { - '7': + '10': [ - { - browser: 'ie', - browser_version: 8.0, - }, - { - browser: 'firefox', - browser_version: 2.0, - }, - { - browser: 'chrome', - browser_version: 14.0, - } ... - ], - 'XP': - [ - { - browser: 'ie', - browser_version: 7.0, - }, - { - browser: 'firefox', - browser_version: 10.0, - }, - { - browser: 'chrome', - browser_version: 14.0, - } ... + { + "browser": "chrome", + "browser_version": "83.0" + }, + { + "browser": "chrome", + "browser_version": "84.0" + }, + { + "browser": "chrome", + "browser_version": "85.0 beta" + }, + { + "browser": "ie", + "browser_version": "11.0" + }, + { + "browser": "edge", + "browser_version": "insider preview" + }... ], }, 'OS X': { - 'Snow Leopard': - [ - { - browser: 'firefox', - browser_version: 11.0, - }, - { - browser: 'chrome', - browser_version: 14.0, - }, ... - ], - 'Lion': - [ - { - browser: 'firefox', - browser_version: 11.0, - }, - { - browser: 'chrome', - browser_version: 14.0, - } ... - ], - }, - 'ios': - { - '4.0': + 'Catalina': [ - { - browser: "Mobile Safari", - browser_version: null, - devices: ["iPhone 4"], - } + { + "browser": "chrome", + "browser_version": "85.0 beta" + }, + { + "browser": "edge", + "browser_version": "85.0 beta" + }, + { + "browser": "safari", + "browser_version": "13.1" + }, + { + "browser": "firefox", + "browser_version": "79.0" + }, + { + "browser": "firefox", + "browser_version": "80.0 beta" + }... ], - '6.0': - [ - { - browser: "Mobile Safari", - browser_version: null, - devices: ["iPhone 4S (6.0)", "iPhone 5", "iPad 3rd (6.0)"], - } - ] + }... }, } -``` +``` A flat parameter can also be passed to get browsers in a flat structure @@ -153,98 +130,63 @@ A flat parameter can also be passed to get browsers in a flat structure ### Output -```javascript -[ -{ - device: null, - os_version: "8", - os: "Windows", - browser_version: "5.1", - browser: "safari" -}, -{ - device: null, - os_version: "8", - os: "Windows", - browser_version: "16.0", - browser: "firefox" -}, -{ - device: null, - os_version: "8", - os: "Windows", - browser_version: "17.0", - browser: "firefox" -}, -{ - device: null, - os_version: "8", - os: "Windows", - browser_version: "18.0", - browser: "firefox" -}, -{ - device: null, - os_version: "8", - os: "Windows", - browser_version: "10.0", - browser: "ie" -}.... -``` - -You can get beta/dev versions of browsers by using "all" parameter: - - GET /browsers?all=true - -### Output - ```javascript { 'Windows': { - 'XP': + '10': [ - { - browser: 'ie', - browser_version: 7.0, - }, - { - browser: 'firefox', - browser_version: '28.0 beta', - }, - { - browser: 'chrome', - browser_version: 14.0, - } ... + { + "browser": "chrome", + "browser_version": "83.0" + }, + { + "browser": "chrome", + "browser_version": "84.0" + }, + { + "browser": "chrome", + "browser_version": "85.0 beta" + }, + { + "browser": "ie", + "browser_version": "11.0" + }, + { + "browser": "edge", + "browser_version": "insider preview" + }... ], }, 'OS X': { - 'Snow Leopard': + 'Catalina': [ - { - browser: 'firefox', - browser_version: 11.0, - }, - { - browser: 'chrome', - browser_version: '27.0 beta', - }, ... - ], - 'Lion': - [ - { - browser: 'firefox', - browser_version: 11.0, - }, - { - browser: 'chrome', - browser_version: 14.0, - } ... + { + "browser": "chrome", + "browser_version": "85.0 beta" + }, + { + "browser": "edge", + "browser_version": "85.0 beta" + }, + { + "browser": "safari", + "browser_version": "13.1" + }, + { + "browser": "firefox", + "browser_version": "79.0" + }, + { + "browser": "firefox", + "browser_version": "80.0 beta" + }... ], + }... }, } -``` +``` ## Create a New Browser Worker A browser worker is simply a new browser instance. A user can start multiple browser worker at a time. All browser workers when created are pushed in a queue and they run when their turn comes. We make sure that your browser worker starts running as soon as possible. Your testing time is calculated from the time when browser worker starts running. @@ -292,6 +234,9 @@ Optional name of the build the session is running under. #### (project) Optional name of the project the build is under. +#### (browserstack.video) +Optional flag to enable video recording in your test. + ### Response The response will be returned when the worker has been setup and initialized. This involves loading the HTML data or navigating to the url given depending on the setup parameters. Use the id returned to perform any further communications etc.