mirror_xterm.js/dist/addons/linkify/linkify.js

/**
 * Methods for turning URL subscrings in the terminal's content into links (`a` DOM elements).
 * @module xterm/addons/linkify/linkify
 * @license MIT
 */
(function (linkify) {
    if (typeof exports === 'object' && typeof module === 'object') {
        /*
         * CommonJS environment
         */
        module.exports = linkify(require('../../xterm'));
    }
    else if (typeof define == 'function') {
        /*
         * Require.js is available
         */
        define(['../../xterm'], linkify);
    }
    else {
        /*
         * Plain browser environment
         */
        linkify(window.Terminal);
    }
})(function (Xterm) {
    'use strict';
    var exports = {}, protocolClause = '(https?:\\/\\/)', domainCharacterSet = '[\\da-z\\.-]+', negatedDomainCharacterSet = '[^\\da-z\\.-]+', domainBodyClause = '(' + domainCharacterSet + ')', tldClause = '([a-z\\.]{2,6})', ipClause = '((\\d{1,3}\\.){3}\\d{1,3})', portClause = '(:\\d{1,5})', hostClause = '((' + domainBodyClause + '\\.' + tldClause + ')|' + ipClause + ')' + portClause + '?', pathClause = '(\\/[\\/\\w\\.-]*)*', negatedPathCharacterSet = '[^\\/\\w\\.-]+', bodyClause = hostClause + pathClause, start = '(?:^|' + negatedDomainCharacterSet + ')(', end = ')($|' + negatedPathCharacterSet + ')', lenientUrlClause = start + protocolClause + '?' + bodyClause + end, strictUrlClause = start + protocolClause + bodyClause + end, lenientUrlRegex = new RegExp(lenientUrlClause), strictUrlRegex = new RegExp(strictUrlClause);
    /**
     * Converts all valid URLs found in the given terminal line into
     * hyperlinks. The terminal line can be either the HTML element itself
     * or the index of the termina line in the children of the terminal
     * rows container.
     *
     * @param {Xterm} terminal - The terminal that owns the given line.
     * @param {number|HTMLDivElement} line - The terminal line that should get
     *								  		 "linkified".
     * @param {boolean} lenient - The regex type that will be used to identify links. If lenient is
     *                            false, the regex requires a protocol clause. Defaults to true.
     * @param {string} target -  Sets target="" attribute with value provided to links.
     *                           Default doesn't set target attribute
     * @emits linkify
     * @emits linkify:line
     */
    exports.linkifyTerminalLine = function (terminal, line, lenient, target) {
        if (typeof line == 'number') {
            line = terminal.rowContainer.children[line];
        }
        else if (!(line instanceof HTMLDivElement)) {
            var message = 'The "line" argument should be either a number';
            message += ' or an HTMLDivElement';
            throw new TypeError(message);
        }
        if (typeof target === 'undefined') {
            target = '';
        }
        else {
            target = 'target="' + target + '"';
        }
        var buffer = document.createElement('span'), nodes = line.childNodes;
        for (var j = 0; j < nodes.length; j++) {
            var node = nodes[j], match;
            /**
             * Since we cannot access the TextNode's HTML representation
             * from the instance itself, we assign its data as textContent
             * to a dummy buffer span, in order to retrieve the TextNode's
             * HTML representation from the buffer's innerHTML.
             */
            buffer.textContent = node.data;
            var nodeHTML = buffer.innerHTML;
            /**
             * Apply function only on TextNodes
             */
            if (node.nodeType != node.TEXT_NODE) {
                continue;
            }
            var url = exports.findLinkMatch(node.data, lenient);
            if (!url) {
                continue;
            }
            var startsWithProtocol = new RegExp('^' + protocolClause), urlHasProtocol = url.match(startsWithProtocol), href = (urlHasProtocol) ? url : 'http://' + url, link = '<a href="' + href + '" ' + target + '>' + url + '</a>', newHTML = nodeHTML.replace(url, link);
            line.innerHTML = line.innerHTML.replace(nodeHTML, newHTML);
        }
        /**
         * This event gets emitted when conversion of all URL susbtrings
         * to HTML anchor elements (links) has finished, for a specific
         * line of the current Xterm instance.
         *
         * @event linkify:line
         */
        terminal.emit('linkify:line', line);
    };
    /**
     * Finds a link within a block of text.
     *
     * @param {string} text - The text to search .
     * @param {boolean} lenient - Whether to use the lenient search.
     * @return {string} A URL.
     */
    exports.findLinkMatch = function (text, lenient) {
        var match = text.match(lenient ? lenientUrlRegex : strictUrlRegex);
        if (!match || match.length === 0) {
            return null;
        }
        return match[1];
    };
    /**
     * Converts all valid URLs found in the terminal view into hyperlinks.
     *
     * @param {Xterm} terminal - The terminal that should get "linkified".
     * @param {boolean} lenient - The regex type that will be used to identify links. If lenient is
     *                            false, the regex requires a protocol clause. Defaults to true.
     * @param {string} target -  Sets target="" attribute with value provided to links.
     *                           Default doesn't set target attribute
     * @emits linkify
     * @emits linkify:line
     */
    exports.linkify = function (terminal, lenient, target) {
        var rows = terminal.rowContainer.children;
        lenient = (typeof lenient == "boolean") ? lenient : true;
        for (var i = 0; i < rows.length; i++) {
            var line = rows[i];
            exports.linkifyTerminalLine(terminal, line, lenient, target);
        }
        /**
         * This event gets emitted when conversion of  all URL substrings to
         * HTML anchor elements (links) has finished for the current Xterm
         * instance's view.
         *
         * @event linkify
         */
        terminal.emit('linkify');
    };
    /**
     * Extend Xterm prototype.
     */
    /**
     * Converts all valid URLs found in the current terminal linte into
     * hyperlinks.
     *
     * @memberof Xterm
     * @param {number|HTMLDivElement} line - The terminal line that should get
     *								  		 "linkified".
     * @param {boolean} lenient - The regex type that will be used to identify links. If lenient is
     *                            false, the regex requires a protocol clause. Defaults to true.
     * @param {string} target -  Sets target="" attribute with value provided to links.
     *                           Default doesn't set target attribute
     */
    Xterm.prototype.linkifyTerminalLine = function (line, lenient, target) {
        return exports.linkifyTerminalLine(this, line, lenient, target);
    };
    /**
     * Converts all valid URLs found in the current terminal into hyperlinks.
     *
     * @memberof Xterm
     * @param {boolean} lenient - The regex type that will be used to identify links. If lenient is
     *                            false, the regex requires a protocol clause. Defaults to true.
     * @param {string} target -  Sets target="" attribute with value provided to links.
     *                           Default doesn't set target attribute
     */
    Xterm.prototype.linkify = function (lenient, target) {
        return exports.linkify(this, lenient, target);
    };
    return exports;
});
//# sourceMappingURL=linkify.js.map