
Security News
Node.js TSC Votes to Stop Distributing Corepack
Corepack will be phased out from future Node.js releases following a TSC vote.
Dig Dug. A simple abstraction library for downloading and launching WebDriver service tunnels.
ディグダグ
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 2,742 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.
Security News
Corepack will be phased out from future Node.js releases following a TSC vote.
Research
Security News
Research uncovers Black Basta's plans to exploit package registries for ransomware delivery alongside evidence of similar attacks already targeting open source ecosystems.
Security News
Oxlint's beta release introduces 500+ built-in linting rules while delivering twice the speed of previous versions, with future support planned for custom plugins and improved IDE integration.