Which GitHub page are you on? Is it an issue? Is it a list? Perfect for your WebExtension or userscript.
Battle-tested by and extracted from the Refined GitHub extension.
- Try the live demo
- See the code and expected URLs for every detection
npm install github-url-detection// This package is pure ESM
import * as pageDetect from 'github-url-detection';const href = 'https://github.com/refined-github/github-url-detection/issues/1';
if (pageDetect.isIssue(new URL(href))) { // Pass the URL as an `URL` object
alert('The passed URL is of an issue!')
}
if (pageDetect.isRepo()) { // Uses `window.location.href` by default
alert('You’re looking at a repo!')
}
if (pageDetect.isIssueOrPRList()) {
alert('You’re looking at a issues and PRs list!')
}Most detections are URL-based while others need access to the current document. You can determine which ones are URL-based by looking at their signature: URL-based functions have a url parameter.
By default, URL-based detections use the location global if you don't pass a url argument.
if (pageDetect.isIssueOrPRList()) {
alert('You’re looking at a issues or PRs list!')
}if (pageDetect.isIssueOrPRList(new URL('https://github.com/refined-github/github-url-detection/pulls'))) {
alert('You’re looking at a issues or PRs list!')
}Notice that the url parameter is not a plain string but it has to be a proper URL or location object.
By default, document-based detections use the document global, which means they can only be used if you have the whole page, you can't just test any random URL string.
if (pageDetect.isOrganizationProfile()) {
alert('You’re on an organization profile, like https://github.com/babel')
}- github-reserved-names - Get a list, or check if a user or organization name is reserved by GitHub.
- shorten-repo-url - Shorten GitHub links like GitHub shortens Issues and Commit links.
MIT © Federico Brigante