@npmcli/ci-detect

WebJar for @npmcli/ci-detect

License

License

ISC
Categories

Categories

CLI User Interface
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

npmcli__ci-detect
Last Version

Last Version

1.3.0
Release Date

Release Date

Type

Type

jar
Description

Description

@npmcli/ci-detect
WebJar for @npmcli/ci-detect
Project URL

Project URL

https://www.webjars.org
Source Code Management

Source Code Management

https://github.com/npm/ci-detect

Download npmcli__ci-detect

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/npmcli__ci-detect/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>npmcli__ci-detect</artifactId>
    <version>1.3.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/npmcli__ci-detect/
implementation 'org.webjars.npm:npmcli__ci-detect:1.3.0'
// https://jarcasting.com/artifacts/org.webjars.npm/npmcli__ci-detect/
implementation ("org.webjars.npm:npmcli__ci-detect:1.3.0")
'org.webjars.npm:npmcli__ci-detect:jar:1.3.0'
<dependency org="org.webjars.npm" name="npmcli__ci-detect" rev="1.3.0">
  <artifact name="npmcli__ci-detect" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='npmcli__ci-detect', version='1.3.0')
)
libraryDependencies += "org.webjars.npm" % "npmcli__ci-detect" % "1.3.0"
[org.webjars.npm/npmcli__ci-detect "1.3.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

@npmcli/ci-detect

Detect what kind of CI environment the program is in

Build Status Coverage Status

USAGE

const ciDetect = require('@npmcli/ci-detect')
// false if not in CI
// otherwise, a string indicating the CI environment type
const inCI = ciDetect()

CIs Detected

Returns one of the following strings, or false if none match, by looking at the appropriate environment variables.

  • 'gerrit' Gerrit
  • 'gitlab' GitLab
  • 'circleci' Circle-CI
  • 'semaphore' Semaphore
  • 'drone' Drone
  • 'github-actions' GitHub Actions
  • 'tddium' TDDium
  • 'jenkins' Jenkins
  • 'bamboo' Bamboo
  • 'gocd' GoCD
  • 'wercker' Oracle Wercker
  • 'netlify' Netlify
  • 'now-github' Zeit.co's Now for GitHub deployment service
  • 'now-bitbucket' Zeit.co's Now for BitBucket deployment service
  • 'now-gitlab' Zeit.co's Now for GitLab deployment service
  • 'now' Zeit.co's Now service, but not GitHub/BitBucket/GitLab
  • 'azure-pipelines' Azure Pipelines
  • 'bitrise' Bitrise
  • 'buddy' Buddy
  • 'buildkite' Buildkite
  • 'cirrus' Cirrus CI
  • 'dsari' dsari CI
  • 'strider' Strider CI
  • 'taskcluster' Mozilla Taskcluster
  • 'hudson' Hudson CI
  • 'magnum' Magnum CI
  • 'nevercode' Nevercode
  • 'render' Render CI
  • 'sail' Sail CI
  • 'shippable' Shippable
  • 'heroku' Heroku
  • 'codeship' CodeShip
  • Anything that sets the CI_NAME environment variable will return the value as the result. (This is how CodeShip is detected.)
  • 'travis-ci' Travis-CI - A few other CI systems set TRAVIS=1 in the environment, because devs use that to indicate "test mode", so this one can get some false positives, and is tested later in the process to minimize this effect.
  • 'aws-codebuild' AWS CodeBuild
  • 'builder' Google Cloud Builder - This one is a bit weird. It doesn't really set anything that can be reliably detected except BUILDER_OUTPUT, so it can get false positives pretty easily.
  • 'custom' anything else that sets CI environment variable to either '1' or 'true'.

Caveats

Note that since any program can set or unset whatever environment variables they want, this is not 100% reliable.

Also, note that if your program does different behavior in CI/test/deployment than other places, then there's a good chance that you're doing something wrong!

But, for little niceties like setting colors or other output parameters, or logging and that sort of non-essential thing, this module provides a way to tweak without checking a bunch of things in a bunch of places. Mostly, it's a single place to keep a note of what CI system sets which environment variable.

org.webjars.npm

npm

node package manager

Versions

Version
1.3.0
1.2.0