Skip to content

magr0s/jira.js

Repository files navigation

JavaScript / TypeScript JIRA API Client

A JavaScript / TypeScript wrapper for the JIRA REST API

NPMDownloadsMinizipped sizeDependencies StatusDevDependencies StatusBuild status

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";// Initializeconstclient=newClient({host: "https://jira.somehost.com"});

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

// Callbacksclient.projects.getAllProjects({},(err,data)=>{if(err){throwerr;}console.log(data);});// ES5/ES6client.projects.getAllProjects().then(projects=>console.log(projects)).catch(error=>console.log(error));// ES7asyncfunctiongetProjects(){constprojects=awaitclient.projects.getAllProjects();console.log(projects);returnprojects;}

Authorization

Basic authorization

With API token
constclient=newClient({host: "https://jira.somehost.com",authentication: {basic: {username: "MyUsername",apiToken: "API_Token"}}});
With password
constclient=newClient({host: "https://jira.somehost.com",authentication: {basic: {username: "MyUsername",password: "MyPassword"}}});

JWT authentication

constclient=newClient({host: 'https://jira.somehost.com',authentication: {jwt: {iss: 'id',secret: 'secret key'}}});

OAuth1.0 authentication

constclient=newClient({host: "https://jira.somehost.com",authentication: {oauth1: {consumerKey: "your consumer key",consumerSecret: "-----BEGIN RSA PRIVATE KEY-----\n"+"some private key\n"+"-----END RSA PRIVATE KEY-----",accessToken: "your access token",tokenSecret: "your token secret"}}});

OAuth2.0 authentication

constclient=newClient({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";constclient=newClient({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";constclient=newClient({host: "https://jira.somehost.com",middlewares: {onError: (error)=>{console.error(error);throwerror;},onResponse: (data)=>{console.log(data);returndata;}}});

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

MrRefactoringjayreeSwapnullvioline1101
MrRefactoringjayreeSwapnullvioline1101

Road map

Latest version changelog

1.8.0

  • Authentication: Added OAuth 1.0 authentication method
  • CI: Migrated from Travis CI to Github CI

About

A JavaScript/TypeScript wrapper for the JIRA REST API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript100.0%