Package Exports
- jira.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (jira.js) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
JavaScript JIRA API Client
Installation
Install with the npm:
$ npm install jira.js
Install with the yarn:
$ yarn add jira.js
Examples
Create the JIRA client
// ES5
var { Client } = require("jira.js");
// ES6
import { Client } from "jira.js";
// Initialize
var client = new Client({
host: "https://jira.somehost.com"
});
Get all projects
// 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
const client = new Client({
host: "https://jira.somehost.com",
authentication: {
basic: {
username: "MyUsername",
apiToken: "My Password or API Token"
}
}
});
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"
}
});
Documentation
Can't find what you need in the readme? Check out our documentation here: https://mrrefactoring.github.io/jira.js/
Road map
- Response models
- Method names reducing
Changelog
1.1.0
- FEATURE:
strictGDPR
property added to Config. Allows use only GDPR-compliant functionality - FEATURE:
users.getAllUsersDefault
added - FEATURE:
issueCustomFieldOptions.updateCustomFieldOptions
added as experimental - DEPRECATION:
projectRoleActors.getActorsCountForProjectRole
are deprecated (Removed from official API). Will be removed in next major version
1.0.3
- DEPRECATION:
permissionsSchemes
andissueAttachment
are deprecated - IMPROVEMENT: agile api typings improved
- IMPROVEMENT: dependencies update
- FIX: Authorization parameter excluded for agile API in the request body
1.0.2
- FIX: JWT Authentication default expire time added
- IMPROVEMENT: modified
atlassian-jwt
(removed lodash from dependencies, bundle size decreased) - IMPROVEMENT: small tests for authentication added
1.0.1
- FIX: documentation link fixed
1.0.0
- RELEASE