Registry / devops / node-jira

node-jira

JSON →
library0.2.0jsnpmunverified

A Node.js library for interacting with Atlassian JIRA's REST API. Version 0.2.0 is the current stable release, though the package appears to be in early development with limited updates. It provides basic authentication and simple issue operations. Compared to more robust alternatives like 'jira-connector' or '@atlassian/jira-client', this library has minimal features and documentation, making it suitable only for simple use cases.

devops
npm install node-jira
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · NODE-JIRA
N
node-jira
devopsjavascriptv0.2.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

JiraApi
✓ const JiraApi = require('node-jira');
✗ import JiraApi from 'node-jira';
Package does not ship ESM; use CommonJS require. No default export.
JiraApi constructor
✓ const jira = new JiraApi('username', 'password', { host: 'jira.example.com' });
✗ const jira = new JiraApi({ host: 'jira.example.com' });
Constructor expects username and password as first two arguments, host in options object.
getIssue
✓ jira.getIssue('PROJ-123', function(err, issue) { ... });
✗ jira.getIssue('PROJ-123').then(issue => ...);
Uses callbacks, not promises. No promise support in this version.

Demonstrates initializing JiraApi with basic auth and fetching an issue via callback.

const JiraApi = require('node-jira'); const jira = new JiraApi('username', 'password', { host: 'jira.example.com', protocol: 'https', port: 443, apiVersion: '2', strictSSL: true }); jira.getIssue('PROJ-123', function(err, issue) { if (err) { console.error('Error:', err); return; } console.log('Issue summary:', issue.fields.summary); });
Debug
Known issues
gotchaNo promise support; all async operations use callbacks.
fix
Wrap callbacks in promises manually or switch to a promise-based library like 'jira-connector'.
affects: <=0.2.0
gotchaLimited API coverage: only basic issue operations (get, create, update) and search.
fix
Use a more complete JIRA client for advanced features like project management or agile boards.
affects: >=0.0.0
gotchaAuthentication only supports basic auth (username/password). No OAuth or token-based auth.
fix
Use environment variables for credentials securely, or switch to a library with token support.
affects: <=0.2.0
Errors
Common errors & fixes
Cannot find module 'node-jira'
Package not installed or misspelled in require.
fix
Run 'npm install node-jira' and ensure require path is 'node-jira'.
JiraApi is not a constructor
Using wrong import style (e.g., ES6 import), or package not installed correctly.
fix
Use 'const JiraApi = require('node-jira');' (CommonJS).
TypeError: jira.getIssue is not a function
JiraApi instance not created properly (missing or incorrect arguments).
fix
Ensure you call 'new JiraApi(username, password, options)' with correct parameters.
Upgrade
Version history
0.2.0latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
4 hits · last 30 days
node
4
Resources
githubhttps://github.com/stefanmayer13/node-jira ↗
packagenode-jira ↗
homepagehttps://github.com/stefanmayer13/node-jira#readme ↗
node-jira — npm install node-jira · libregistry