JavaScript / TypeScript JIRA API Client

A JavaScript / TypeScript wrapper for the JIRA REST API

Installation

Install with the npm:

npm install jira.js

Install with the yarn:

yarn add jira.js

Examples

Create the JIRA client

import { Client } from "jira.js";

// Initialize
const client = new Client({
  host: "https://jira.somehost.com"
});

Working with API (How to get a list of all projects, for example)

// Callbacks
client.projects.getAllProjects({}, (err, data) => {
  if (err) {
    throw err;
  }

  console.log(data);
});


// ES5/ES6
client.projects
  .getAllProjects()
  .then(projects => console.log(projects))
  .catch(error => console.log(error));

// ES7
async function getProjects() {
  const projects = await client.projects.getAllProjects();

  console.log(projects);

  return projects;
}

Authorization

Basic authorization

With API token

const client = new Client({
  host: "https://jira.somehost.com",
  authentication: {
    basic: {
      username: "MyUsername",
      apiToken: "API_Token"
    }
  }
});

With password

const client = new Client({
  host: "https://jira.somehost.com",
  authentication: {
    basic: {
      username: "MyUsername",
      password: "MyPassword"
    }
  }
});

JWT authentication

const client = new Client({
  host: 'https://jira.somehost.com',
  authentication: {
    jwt: {
      iss: 'id',
      secret: 'secret key'
    }
  }
});

OAuth2.0 authentication

const client = new Client({
  host: "https://jira.somehost.com",
  authentication: {
    accessToken: "my access token"
  }
});

Base request config

If you want to add headers, timeout, withCredentials or other data for each of the requests that will be called, then pass them to baseRequestConfig.

Full list of properties for baseRequestConfig you can find here: https://github.com/axios/axios#request-config

import { Client } from "jira.js";

const client = new Client({
  host: 'https://jira.somehost.com',
  baseRequestConfig: {
    timeout: 20000,
    headers: {
      'Content-Type': 'application/json',
    },
    timeoutErrorMessage: 'Error message',
    withCredentials: false,
    responseType: 'arraybuffer',
    maxContentLength: 100,
    // and others properties
  },
});

Set middleware for Jira’s responses and errors

import { Client } from "jira.js";

const client = new Client({
  host: "https://jira.somehost.com",
  middlewares: {
    onError: (error) => {
      console.error(error);
      throw error;
    },
    onResponse: (data) => {
      console.log(data);
      return data;
    }
  }
});

Documentation

Library based on Jira API v2 and Jira Agile API

Can’t find what you need in the readme? Check out our documentation here: https://mrrefactoring.github.io/jira.js/

Contributors

MrRefactoring	Swapnull	violine1101

Road map

• Response models (Check 2.0 version PR)
• Method names reducing (Check 2.0 version PR)

Latest version changelog

1.7.3

• DEPENDENCIES: atlassian-jwt installed from npm instead git
• DEPENDENCIES: Updated dependencies versions
• README: Contributors section added, small redesign

1.7.2

• FIX: console.log removed

1.7.1

• FIX: Headers fixes

1.7.0

• IMPROVEMENT: Readme examples updated

• IMPROVEMENT: Config typings refactored
• DEPRECATION: Property timeout deprecated in Config

• FEATURE: Property middlewares added to Config

• FEATURE: Property baseRequestConfig added to Config

• FEATURE: Method getOptionsForContext added to IssueCustomFieldOptions Jira documentation
• FEATURE: Method deleteCustomFieldOption added to IssueCustomFieldOptions Jira documentation

• FEATURE: Method changeOrderOfIssueTypes added to IssueTypeSchemes Jira documentation

• FEATURE: Method assignWorkflowSchemeToProject added to WorkflowSchemeProjectAssociations Jira documentation

• FEATURE: New API ScreenSchemes added. Jira documentation.
• FEATURE: New API ScreenTabFields added Jira documentation
• FEATURE: New API ScreenTabs added Jira documentation

• FEATURE: Added models for new endpoints