You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
48 lines
2.2 KiB
48 lines
2.2 KiB
# supports-hyperlinks [](https://travis-ci.org/jamestalmage/supports-hyperlinks) [](https://codecov.io/gh/jamestalmage/supports-hyperlinks?branch=master) |
|
|
|
> Detect whether a terminal emulator supports hyperlinks |
|
|
|
Terminal emulators are [starting to support hyperlinks](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda). While many terminals have long detected URL's and linkified them, allowing you to Command-Click or Control-Click them to open a browser, you were forced to print the long unsightly URL's on the screen. As of spring 2017 [a few terminals](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda) began supporting HTML like links, where the link text and destination could be specified separately. |
|
|
|
This module allows you to detect if hyperlinks are supported in the current Terminal. |
|
|
|
As this is a new development, we anticipate the list of supported Terminals to grow rapidly. Please open an issue or submit a PR as new Terminals implement support. |
|
|
|
## Install |
|
|
|
``` |
|
$ npm install supports-hyperlinks |
|
``` |
|
|
|
|
|
## Usage |
|
|
|
```js |
|
const supportsHyperlinks = require('supports-hyperlinks'); |
|
|
|
if (supportsHyperlinks.stdout) { |
|
console.log('Terminal stdout supports hyperlinks'); |
|
} |
|
|
|
if (supportsHyperlinks.stderr) { |
|
console.log('Terminal stderr supports hyperlinks'); |
|
} |
|
``` |
|
|
|
## API |
|
|
|
Returns an `Object` with a `stdout` and `stderr` property for testing either streams. Each property is a `boolean`, indicating whether or not hyperlinks are supported. |
|
|
|
## Info |
|
|
|
Obeys the `--no-hyperlinks`, `--hyperlink=always`, and `--hyperlink=never` CLI flags. |
|
|
|
Can be overridden by the user with the flags `--hyperlinks=always` and `--no-hyperlinks`. For situations where using those flags are not possible, add the environment variable `FORCE_HYPERLINK=1` to forcefully enable hyperlinks or `FORCE_HYPERLINK=0` to forcefully disable. The use of `FORCE_HYPERLINK` overrides all other hyperlink support checks. |
|
|
|
## Related |
|
|
|
* [`hyperlinker`](https://github.com/jamestalmage/hyperlinker): Write hyperlinks for the Terminal. |
|
|
|
## License |
|
|
|
MIT © [James Talmage](https://github.com/jamestalmage)
|
|
|