What is is-ci?
The is-ci npm package is designed to detect if your code is running in a Continuous Integration (CI) environment. It provides a simple interface to check whether the current execution context is within a CI service by checking environment variables that are typically set by CI services.
What are is-ci's main functionalities?
Detect CI environment
This feature allows you to detect if your application or script is running in a CI environment. The package exports a boolean value that is true if it detects a CI environment based on environment variables. This is useful for altering behavior, such as skipping interactive prompts or enabling more verbose logging, when running in CI.
"use strict";\nconst isCI = require('is-ci');\n\nif (isCI) {\n console.log('Running in a CI environment');\n} else {\n console.log('Not running in a CI environment');\n}
Other packages similar to is-ci
ci-info
Similar to is-ci, ci-info provides information about the CI environment the code is running in. It offers more detailed information compared to is-ci, such as the name of the CI service and whether the environment is a pull request. This makes ci-info a more versatile choice if you need more than just a boolean check.
is-ci-cli
is-ci-cli extends the basic functionality of is-ci by providing a command-line interface (CLI). This allows users to check for a CI environment directly from the command line without writing any JavaScript code. While is-ci is primarily used within scripts, is-ci-cli can be used directly in shell scripts or CI configuration files.
is-ci
Returns true
if the current environment is a Continuous Integration
server.
Please open an issue if your
CI server isn't properly detected :)
Installation
npm install is-ci --save
Programmatic Usage
const isCI = require('is-ci')
if (isCI) {
console.log('The code is running on a CI server')
}
CLI Usage
For CLI usage you need to have the is-ci
executable in your PATH
.
There's a few ways to do that:
- Either install the module globally using
npm install is-ci -g
- Or add the module as a dependency to your app in which case it can be
used inside your package.json scripts as is
- Or provide the full path to the executable, e.g.
./node_modules/.bin/is-ci
is-ci && echo "This is a CI server"
Supported CI tools
Officially supported CI servers:
Other CI tools using environment variables like BUILD_ID
or CI
would
be detected as well.
License
MIT