Socket
Socket
Sign inDemoInstall

supports-hyperlinks

Package Overview
Dependencies
2
Maintainers
3
Versions
7
Alerts
File Explorer

Advanced tools

Install Socket

Protect your apps from supply chain attacks

Install

supports-hyperlinks

Detect if your terminal emulator supports hyperlinks

    3.0.0latest
    GitHub
    npm

Version published
Maintainers
3
Weekly downloads
15,999,067
increased by3.13%

Weekly downloads

Package description

What is supports-hyperlinks?

The supports-hyperlinks npm package is used to check if the terminal environment supports hyperlinks. This is useful for developers who want to include clickable links in their terminal applications, but need to ensure compatibility with the user's terminal emulator.

What are supports-hyperlinks's main functionalities?

Checking if hyperlinks are supported

This feature allows you to check if the standard output (stdout) and standard error (stderr) streams of the terminal support hyperlinks. The package exports an object with two properties: stdout and stderr, which are booleans indicating support.

const supportsHyperlinks = require('supports-hyperlinks');

if (supportsHyperlinks.stdout) {
  console.log('Terminal supports hyperlinks');
} else {
  console.log('Terminal does not support hyperlinks');
}

if (supportsHyperlinks.stderr) {
  console.log('Stderr supports hyperlinks');
}

Other packages similar to supports-hyperlinks

Readme

Source

Detect whether a terminal emulator supports hyperlinks

Terminal emulators are starting to support hyperlinks. 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 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

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.

  • hyperlinker: Write hyperlinks for the Terminal.

License

MIT © James Talmage

Keywords

FAQs

Last updated on 08 Mar 2023

Did you know?

Socket installs a GitHub app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc