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.
digdug
Advanced tools
Readme
ディグダグ
Dig Dug is a simple abstraction library for downloading and launching WebDriver service tunnels and interacting with the REST APIs of these services.
Dig Dug can run a local Selenium server, and it supports the following cloud testing services:
In many cases, the only configuration you'll need to do to create a tunnel is provide authentication data. This can be provided by setting properties on tunnels or via environment variables. The tunnels use the following environment variables:
Tunnel class | Environment variables |
---|---|
BrowserStackTunnel | BROWSERSTACK_USERNAME , BROWSERSTACK_ACCESS_KEY |
CrossBrowserTestingTunnel | CBT_USERNAME , CBT_APIKEY |
SauceLabsTunnel | SAUCE_USERNAME , SAUCE_ACCESS_KEY |
TestingBotTunnel | TESTINGBOT_KEY , TESTINGBOT_SECRET |
Other properties, such as the local port the tunnel should serve on or the URL of a proxy server the tunnel should go through, can be passed to a tunnel constructor or set on a tunnel instance. See the pages for Tunnel and the tunnel subclasses for available properties.
To create a new tunnel, import the desired tunnel class, create a new instance, and call its start
method. start
returns a Promise that resolves when the tunnel has successfully started. For example, to create a new Sauce Labs tunnel:
var SauceLabsTunnel = require('digdug/SauceLabsTunnel');
var tunnel = new SauceLabsTunnel();
tunnel.start().then(function () {
// interact with the WebDriver server at tunnel.clientUrl
});
Once a tunnel has been started, a test runner interacts with it as described in the service's documentation. The Sauce Labs and TestingBot executables start a WebDriver server on localhost that the test client communicates with. To interact with BrowserStack, a test client will connect to hub.browserstack.com
after the tunnel has started.
The tunnel classes also provide a sendJobState
convenience method to let the remote service know whether a test session passed or failed. This method accepts a session ID and an object containing service-specific data, and it returns a Promise that resolves if the job state was successfully updated.
tunnel.sendJobState(sessionId, { success: true });
When testing is finished, call the tunnel's stop
method to cleanly shut it down. This method returns a Promise that is resolved when the service tunnel executable has exited.
tunnel.stop().then(function () {
// the tunnel has been shut down
});
Dig Dug includes a utility script, digdugEnvironmnents
. After the digdug package has been installed, run this script to get a list of environments provided by a particular testing service.
$ ./node_modules/.bin/digdugEnvironments SauceLabsTunnel
{"platform":"OS X 10.9","browserName":"firefox","version":"4"}
{"platform":"OS X 10.9","browserName":"firefox","version":"5"}
{"platform":"OS X 10.9","browserName":"firefox","version":"6"}
{"platform":"OS X 10.9","browserName":"firefox","version":"7"}
{"platform":"OS X 10.9","browserName":"firefox","version":"8"}
{"platform":"OS X 10.9","browserName":"firefox","version":"9"}
{"platform":"OS X 10.9","browserName":"firefox","version":"10"}
...
Note that BrowserStackTunnel requires that the BROWSERSTACK_ACCESS_KEY
and BROWSERSTACK_USERNAME
environment variables exist and are set to a user's account access key and username. The other tunnels do not (currently) require authentication to request an environment list.
Dig Dug is a JS Foundation project offered under the New BSD license.
© SitePen, Inc. and its contributors
FAQs
Dig Dug. A simple abstraction library for downloading and launching WebDriver service tunnels.
The npm package digdug receives a total of 3,306 weekly downloads. As such, digdug popularity was classified as popular.
We found that digdug demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers 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.