Dangerous bits

To use Danger JS with BitBucket Cloud: you’ll need to create a new account for Danger to use, then set the following environment variables on your CI:

We need UUID for updating comment, you can get it from the link on your home page of bitbucket.org. Then replace %7B with { and %7D with }.

For example, the UUID of https://bitbucket.org/%7Bzzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz%7D/ will be {zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz}

  • DANGER_BITBUCKETCLOUD_UUID = The uuid for the account used to comment.

You could use either username with password or OAuth key with OAuth secret.

For username and password, you need to set.

  • DANGER_BITBUCKETCLOUD_USERNAME = The username for the account used to comment, as shown on https://bitbucket.org/account/
  • DANGER_BITBUCKETCLOUD_PASSWORD = The password for the account used to comment, you could use App passwords with Read Pull Requests Permission.

For OAuth key and OAuth secret, you can get them from.

  • Open BitBucket Cloud Website
  • Navigate to Settings > OAuth > Add consumer
  • Put https://bitbucket.org/site/oauth2/authorize for Callback URL, and enable Pull requests Permission.

  • DANGER_BITBUCKETCLOUD_OAUTH_KEY = The consumer key for the account used to comment, as show as Key on the website.

  • DANGER_BITBUCKETCLOUD_OAUTH_SECRET = The consumer secret for the account used to comment, as show as Secret on the website.

Then in your Dangerfiles you will have a fully fleshed out danger.bitbucket_cloud object to work with. For example:

import { danger, warn } from "danger"

if (danger.bitbucket_cloud.pr.title.includes("WIP")) {
  warn("PR is considered WIP")

The DSL is expansive, you can see all the details inside the [Danger JS Reference][ref], but the TLDR is:


  /** The pull request and repository metadata */
  metadata: RepoMetaData
  /** The PR metadata */
  pr: BitBucketCloudPRDSL
  /** The commits associated with the pull request */
  commits: BitBucketCloudCommit[]
  /** The comments on the pull request */
  comments: BitBucketCloudPRComment[]
  /** The activities such as OPENING, COMMENTING, CLOSING, MERGING or UPDATING a pull request */
  activities: BitBucketCloudPRActivity[]

Got improvements? Help improve this document via sending PRs.