🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more
Socket
Book a DemoInstallSign in
Socket

with-server

Package Overview
Dependencies
Maintainers
1
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

with-server

start server, run command, stop server

2.1.0
latest
Source
npm
Version published
Maintainers
1
Created
Source

with-server (1)

Command line utility to start/stop a local server in order to execute end-to-end tests once the server is ready.

How the server is started

The server is started by running an npm script from the project's package.json. By default the start script is used but you can specify another script using the --run <script> option.

Picking a port

The server is expected to listen on the local TCP port specified by the $PORT environment variable. If the var isn't set, with-server will pick a free random port and expose it as $PORT.

After starting the server with-server tries to connect to $PORT and waits until it becomes available.

Running the tests

Once the server is listening the given command is executed. Inside the tests $PORT or $SERVER_URL can be used to access the server.

When the test are finished the server is gracefully shut down and with-server will exit with the test command's exit code.

Redirecting the server output

By default the server's stdout is redirected to stderr so it doesn't get mixed up with the actual test output.

You can use the --redirect stdout option to write it to stdout instead or --redirect null to silence the output completely.

Usage

with-server [options] command

Options

  • --run The npm script to run (defaults to start)
  • --redirect Redirect the server's output to stdout, stderr or null (defaults to stderr)

Example

Lets say you have the following script in your package.json:

{
  "scripts": {
    "start": "react-scripts start",
    "test:e2e": "with-server cypress"
  }
}

Then npm run test:e2e will launch a server, expose its URL as $SERVER_URL and invoke cypress once the server is listening.

API

You can also use with-server programmatically:

const withServer = require("with-server");

const exitCode = await withServer("cypress", {
  run: "start",
  redirect: "stdout",
});

License

MIT

FAQs

Package last updated on 06 Jul 2021

Did you know?

Socket

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.

Install

Related posts