Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sindresorhus/new-github-issue-url
Generate a URL for opening a new GitHub issue with prefilled title, body, and other fields
https://github.com/sindresorhus/new-github-issue-url
github github-issues npm-package url
Last synced: 1 day ago
JSON representation
Generate a URL for opening a new GitHub issue with prefilled title, body, and other fields
- Host: GitHub
- URL: https://github.com/sindresorhus/new-github-issue-url
- Owner: sindresorhus
- License: mit
- Created: 2018-11-06T07:53:14.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2021-10-18T11:44:17.000Z (about 3 years ago)
- Last Synced: 2024-12-01T01:37:23.353Z (12 days ago)
- Topics: github, github-issues, npm-package, url
- Language: JavaScript
- Homepage:
- Size: 17.6 KB
- Stars: 240
- Watchers: 4
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# new-github-issue-url
> Generate a URL for opening a new GitHub issue with prefilled title, body, and other fields
GitHub supports prefilling a new issue by setting [certain search parameters](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-an-issue#creating-an-issue-from-a-url-query). This package simplifies generating such URL.
## Install
```sh
npm install new-github-issue-url
```
## Usage
```js
import newGithubIssueUrl from 'new-github-issue-url';
import open from 'open';
const url = newGithubIssueUrl({
user: 'sindresorhus',
repo: 'new-github-issue-url',
body: '\n\n\n---\nI\'m a human. Please be nice.'
});
//=> 'https://github.com/sindresorhus/new-github-issue-url/issues/new?body=%0A%0A%0A---%0AI%27m+a+human.+Please+be+nice.'
// Then open it
await open(url);
```
[Try the URL](https://github.com/sindresorhus/new-github-issue-url/issues/new?body=%0A%0A%0A---%0AI%27m+a+human.+Please+be+nice.)\
*(Don't click the "Submit new issue" button!)*
If you use Electron, check out `electron-util`'s [`openNewGitHubIssue()` method](https://github.com/sindresorhus/electron-util#opennewgithubissueoptions).
## API
### newGithubIssueUrl(options)
Returns a URL string.
#### options
Type: `object`
You are required to either specify the `repoUrl` option or both the `user` and `repo` options.
##### repoUrl
Type: `string`
The full URL to the repo.
##### user
Type: `string`
GitHub username or organization.
##### repo
Type: `string`
GitHub repo.
##### body
Type: `string`
The issue body.
##### title
Type: `string`
The issue title.
##### template
Type: `string`
Use an [issue template](https://help.github.com/articles/manually-creating-a-single-issue-template-for-your-repository/).
For example, if you want to use a template at `ISSUE_TEMPLATE/unicorn.md`, you would specify `unicorn.md` here.
##### labels
Type: `string[]`
The labels for the issue.
*Requires the user to have the permission to add labels.*
##### milestone
Type: `string`
The milestone for the issue.
*Requires the user to have the permission to add milestone.*
##### assignee
Type: `string`
The user to assign to the issue.
*Requires the user to have the permission to add assignee.*
##### projects
Type: `string[]`
The projects to add the issue to.
The project reference format is `user/repo/`, for example, if the URL to the project is `https://github.com/sindresorhus/some-repo/projects/3`, the project reference would be `sindresorhus/some-repo/3`.
*Requires the user to have the permission to add projects.*
## Related
- [new-github-release-url](https://github.com/sindresorhus/new-github-release-url) - Generate a URL for opening a new GitHub release with prefilled tag, body, and other fields