linkhunter

A library to deal with links that real users actually type.

Usage no npm install needed!

<script type="module">
  import linkhunter from 'https://cdn.skypack.dev/linkhunter';
</script>

README

linkhunter

A library to deal with links that real users actually type.

Note: if you want a 100% bullet proof solution, have a look at linkify-it and node-tlds.

Introduction

In theory, matching an url is quite easy as it is supposed to start by whether http:// or https://. But in a real world scenario, users are more likely to omit the protocol and simply type site.com. That's where linkhunter comes into play, it is focused on dealing with links from users inputs.

The library is able to match:

  • http://twitter.com/ from Have a look at http://twitter.com/
  • github.com from Feel free to submit an issue on github.com!
  • someone@domain.com from Should I contact someone@domain.com?
  • twitter.com from Did you visit twitter? (twitter.com)

Installation

  • npm install linkhunter --save

Change log

5.0.2 - 2016-10-27

  • Fix regexp to match accents as well

5.0.1 - 2016-08-03

  • Fix package.json's main entry point

5.0.0 - 2016-07-12

The whole api has been redesigned to make things simpler and more flexible. Please have a look at the documentation for the detailed changes.

4.0.0 - 2016-04-08

  • linkhunter.replaceLinks doesn't support the context argument anymore
  • The workflow has been simplified, leading to less bloat in both the minified and non-minified versions
  • The documentation has been updated and moved to the README.md
  • linkhunter is now available as a npm package: npm install linkhunter --save

3.1.2 - 2016-04-05

  • Fix cleanUp to be case insensitive

3.1.1 - 2015-09-11

  • Fix hasProtocol to be case insensitive

3.1.0 - 2015-07-30

  • Improved regular expressions to avoid matching trailing punctuation marks and wrappers. Meaning it's now able to match:
    • site.com in (site.com), site.com., site.com..., site.com!, and so on.
    • site.com in Some string ((whatever(site.com)some stuff) there
    • someone@domain.com in Whatever (stuff((there(or(someone@domain.com)So weird) string...
  • Improved user-typed url regexp to match github.com/angular.js (urls with punctuation marks)
  • Improved regexp to match protocoled urls, no matter what's preceding it. It's now able to match http://site.com in What?http://site.com
  • Fixed urls regexps to avoid matching sub paths that do not start by a slash. It's no more matching site.com)whatever but site.com/whatever

3.0.2 - 2015-07-07

  • Fixed angular linky filter name.

3.0.1 - 2015-07-07

  • Renamed the angular filter to linkhunterLinky.

3.0.0 - 2015-07-06

  • The usage of linkhunter as a constructor made no sense so it's now just an object exposing the whole API.
  • The LinkClass has been removed and each of its method has been transferred to linkhunter. It means that chaining operation is now much more simple and there's less concepts to learn.
  • linkhunter.linky()'s operation option has been replaced by individual properties that alter the link's display value (see documentation for more details).
  • The angular wrapper has been updated (module, service and filter renamed).
  • Added support for non-browser environment by following the UMD pattern.

2.0.1 - 2015-07-04

  • Update README.md on usage.
  • Update bower's ignore.

2.0.0 - 2015-07-04

  • mailto: is now considered to be emails' protocol, meaning Link('email@domain.com').withProtocol() now returns mailto:email@domain.com.
  • The targetBlank option of .linky() is replaced by target to allow any target value.
  • Improved the email matching.
  • It's now using the "domain pattern" regexp and match properly firstname.lastname@email.address-site.com.
  • Added more tests to the specs.
  • .getLinks() now ignore emails by default.
  • .looksLikeALink() now ignore emails by default.
  • Added the forceCleanUp option to .shorten() (true by default).
  • linkhunter is now available as a bower component: bower install linkhunter.

1.1.0 - 2015-06-30

  • Lots of improvements in the regexp
    • Regular urls (the ones with a protocol) now also benefit from the domain pattern. Which means that everything that's before the first slash must looks like a domain name so http://. is no more matched for example.
    • Partial urls are no more matched by the "user typed" regexp. Meaning github.com/angular is no more matched from github.com/angular.js. In such case the url is completely dropped because:
      1. Matching partial urls is pointless and would surely lead to mistakes.
      2. We can't be sure whether what's behind the punctuation mark (the dot in this case) is part of the url or not.
  • Added a .replaceLinks(callback) method so your could benefit from linkhunter's regexps to replace links the way you want to. This is method is now also used by .linky().
  • .linky() now supports more options like beautify, shorten and clean up.
  • Every link object has now a .originalHasProtocol property which is true when the original url has a protocol.
  • linkhunter is now also available as an Angular module.
  • Fixed an issue where .getLinks() wasn't setting emails' type to "email".

1.0.0 - 2015-06-28

First release.