The definitive source of the best
JavaScript libraries, frameworks, and plugins.

  • ×

    Autolink Js

    Tiny little tool to find URLs in a string of text and hyperlink them
    Filed under  › 

    • 🔾20%Overall
    • 290
    • 61.2 days
    • 🕩58
    • 👥10

    autolink-js is a small (about half a kilobyte), simple, and tested JavaScript tool that takes a string of text, finds URLs within it, and hyperlinks them.

    Why bother releasing such a tiny little method?

    I recently needed to find and hyperlink URLs in user-submitted text and was surprised to find that doing what seemed like such a simple task wasn't already a Solved Problem. Different regex solutions led to different unwanted side effects, and other utilities were far, far more complex and feature rich than I needed.

    Basic Usage

    autolink-js adds an autoLink() method to JavaScript's String prototype, so you can use it on any JavaScript string. Take a look at the tests, but essentially, after including either autolink.js or autolink-min.js to your page, it works like this:

    // Input
    "This is a link to Google".autoLink()
    // Output
    "This is a link to Google <a href=''></a>"

    Additional Options

    You can pass any additional HTML attributes to the anchor tag with a JavaScript object, like this:

    // Input
    "This is a link to Google".autoLink({ target: "_blank", rel: "nofollow", id: "1" })
    // Output
    "This is a link to Google <a href='' target='_blank' rel='nofollow' id='1'></a>"


    Callback option can be used to redefine how links will be rendered.

    // Input
    "This is a link to image".autoLink({
      callback: function(url) {
        return /\.(gif|png|jpe?g)$/i.test(url) ? '<img src="' + url + '">' : null;
    // Output
    "This is a link to image <img src=''>"


    Open example/example.html in your web browser and view the source for a simple but full-featured example of using with jQuery.

    Running the tests

    After cloning this repository, simply open test/suite.html in your web browser. The tests will run automatically.

    Show All