Scripts.html

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>

<script>
    // constants
    var REFRESH_INTERVAL = 1000; // update selected text inspector every 1 second
    var TIMEOUT = 20000; // timout of 20s for fetching recommendations

    // global variables
    var lastSelectedText;
    var lastSearchedKeywords;
    var searchResultList;

    /**
     * On document load.
     */
    $(function() {
        // init search bar
        $("#eexcess-search").keyup(function (e) {
            if (e.keyCode == 13) { // Enter keycode
                $('#btn-search').click();
            }
        });

        $('#btn-search').click(getRecommendationsFromSearchBarInput);

        // init search results list
        searchResultList = new SearchResultList();

        $('#settings-button').click(openSettings);

        inspectSelectedText();
    });

    function openSettings() {
        google.script.run.openSettingsDialog();
    }

    /**
     * Runs a server-side function to get the recommendations for the user-entered text entered into the search bar and
     * updates the sidebar UI with the results from the privacy proxy.
     */
    function getRecommendationsFromSearchBarInput() {
        var searchInput = $("#eexcess-search").val();

        var subStrings = searchInput.split('"');
        var keywords = [];

        for (var subStringIdx = 0; subStringIdx < subStrings.length; subStringIdx++) {
            var str = subStrings[subStringIdx].trim();

            if ((subStringIdx % 2) == 1) { // odd -> string
                str = removePunctuationMarks(str);

                if (str !== "")
                    keywords.push(str);
            } else { // even -> single keyword(s)
                var singleWords = str.split(' ');

                for (var singleWordIdx = 0; singleWordIdx < singleWords.length; singleWordIdx++) {
                    var word = singleWords[singleWordIdx];
                    word = removePunctuationMarks(word);

                    if (word !== "")
                        keywords.push(word);
                }
            }
        }

        if (keywords.length === 0) {
            searchResultList.showError('<?!= msg('SEARCHBAR_EMPTY') ?>');
        } else {
            this.disabled = true;
            fetchAndDisplayRecommendations(keywords, this);
        }
    }

    /**
     * Removes punctuation marks from the given term.
     *
     * @param {String}  term
     * @return {String} term without punctuation marks
     */
    function removePunctuationMarks(term) {
        return term.replace(/[\.,#-\/!$%\^&\*;:{}=\-_`~()“”]/g,"");
    }

    /**
     * Checks if the current selected text in the document has changed. If it changed automatically a search request
     * will be submitted to the recommender.
     */
    function inspectSelectedText() {
        google.script.run
                .withSuccessHandler(
                function(selectedText) {
                    if (selectedText.length > 0 && !arraysEqual(selectedText, lastSelectedText)) {
                        lastSelectedText = selectedText;

                        // extract keywords
                        var keywords = [];

                        // Split the text into keywords
                        for (var selectedTextIdx = 0; selectedTextIdx < selectedText.length; selectedTextIdx++) {
                            var text = selectedText[selectedTextIdx];
                            var words = text.split(" ");

                            for (var wordIdx = 0; wordIdx < words.length; wordIdx++) {
                                var word = words[wordIdx];
                                word = removePunctuationMarks(word);

                                if (word !== "")
                                    keywords.push(word);
                            }
                        }

                        if (keywords.length > 0) {
                            var keywordString = keywords[0];
                            for (var keywordIdx = 1; keywordIdx < keywords.length; keywordIdx++) {
                                keywordString += " " + keywords[keywordIdx];
                            }

                            $("#eexcess-search").val(keywordString);
                        }
                    }
                })
                .withFailureHandler(
                function() {
                    // ignore errors
                })
                .getSelectedText();

        window.setTimeout(inspectSelectedText, REFRESH_INTERVAL);
    }

    /**
     * Runs a server-side function to fetch the recommendations for the given text and updates the sidebar UI with the
     * results from the privacy proxy  or displays and error message in the sidebar.
     *
     * @param {String} or {Array<String>} text  text for which the recommendations should be fetched
     * @param button    disabled button which triggered the action or undefined if action was not triggered by a button
     */
    function fetchAndDisplayRecommendations(keywords, button){
        searchResultList.showAjaxLoader();

        var responded = false;
        var timeout = false;
        lastSearchedKeywords = keywords;

        setTimeout(function() {
            if(!responded) {
                timeout = true;

                if (lastSearchedKeywords == keywords)
                    searchResultList.showError("<?!= msg('TIMEOUT') ?>");

                if (button)
                    button.disabled = false;
            }
        }, TIMEOUT);

        google.script.run
                .withSuccessHandler(
                function(recommendations, button) {
                    if(!timeout && lastSearchedKeywords == keywords){
                        responded = true;
                        searchResultList.showResults(recommendations);

                        if (button)
                            button.disabled = false;
                    }
                })
                .withFailureHandler(
                function(errorMsg, button) {
                    if(!timeout && lastSearchedKeywords == keywords) {
                        responded = true;
                        searchResultList.showError(errorMsg);

                        if (button)
                            button.disabled = false;
                    }
                })
                .withUserObject(button)
                .fetchRecommendations(keywords);
    }

    /**
     * Compares two 1-dimensional arrays by their content.
     *
     * @param a array 1
     * @param b array 2
     */
    function arraysEqual(a, b) {
        if (a === b)
            return true;

        if (a == null || b == null)
            return false;

        if (a.length != b.length)
            return false;

        for (var i = 0; i < a.length; ++i) {
            if (a[i] !== b[i])
                return false;
        }

        return true;
    }
</script>