/** * This code is mostly from the old Etherpad. Please help us to comment this code. * This helps other people to understand this code better and helps them to improve it. * TL;DR COMMENTS ON THIS FILE ARE HIGHLY APPRECIATED */ /** * Copyright 2009 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS-IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ 'use strict'; const Security = require('./security'); /** * Generates a random String with the given length. Is needed to generate the Author, Group, * readonly, session Ids */ const randomString = (len) => { const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'; let randomstring = ''; len = len || 20; for (let i = 0; i < len; i++) { const rnum = Math.floor(Math.random() * chars.length); randomstring += chars.substring(rnum, rnum + 1); } return randomstring; }; const padutils = { escapeHtml: (x) => Security.escapeHTML(String(x)), uniqueId: () => { const pad = require('./pad').pad; // Sidestep circular dependency // returns string that is exactly 'width' chars, padding with zeros and taking rightmost digits const encodeNum = (n, width) => (Array(width + 1).join('0') + Number(n).toString(35)).slice(-width); return [ pad.getClientIp(), encodeNum(+new Date(), 7), encodeNum(Math.floor(Math.random() * 1e9), 4), ].join('.'); }, // e.g. "Thu Jun 18 2009 13:09" simpleDateTime: (date) => { const d = new Date(+date); // accept either number or date const dayOfWeek = (['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'])[d.getDay()]; const month = ([ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec', ])[d.getMonth()]; const dayOfMonth = d.getDate(); const year = d.getFullYear(); const hourmin = `${d.getHours()}:${(`0${d.getMinutes()}`).slice(-2)}`; return `${dayOfWeek} ${month} ${dayOfMonth} ${year} ${hourmin}`; }, findURLs: (text) => { // copied from ACE const _REGEX_WORDCHAR = new RegExp(`[${[ '\u0030-\u0039', '\u0041-\u005A', '\u0061-\u007A', '\u00C0-\u00D6', '\u00D8-\u00F6', '\u00F8-\u00FF', '\u0100-\u1FFF', '\u3040-\u9FFF', '\uF900-\uFDFF', '\uFE70-\uFEFE', '\uFF10-\uFF19', '\uFF21-\uFF3A', '\uFF41-\uFF5A', '\uFF66-\uFFDC', ].join('')}]`); const _REGEX_URLCHAR = new RegExp(`([-:@a-zA-Z0-9_.,~%+/?=()$]|${_REGEX_WORDCHAR.source})`); const _REGEX_URL = new RegExp( '(?:(?:https?|s?ftp|ftps|file|nfs)://|(about|geo|mailto|tel):)' + `${_REGEX_URLCHAR.source}*(?![:.,;])${_REGEX_URLCHAR.source}`, 'g'); // returns null if no URLs, or [[startIndex1, url1], [startIndex2, url2], ...] const _findURLs = (text) => { _REGEX_URL.lastIndex = 0; let urls = null; let execResult; while ((execResult = _REGEX_URL.exec(text))) { urls = (urls || []); const startIndex = execResult.index; const url = execResult[0]; urls.push([startIndex, url]); } return urls; }; return _findURLs(text); }, escapeHtmlWithClickableLinks: (text, target) => { let idx = 0; const pieces = []; const urls = padutils.findURLs(text); const advanceTo = (i) => { if (i > idx) { pieces.push(Security.escapeHTML(text.substring(idx, i))); idx = i; } }; if (urls) { for (let j = 0; j < urls.length; j++) { const startIndex = urls[j][0]; const href = urls[j][1]; advanceTo(startIndex); // Using rel="noreferrer" stops leaking the URL/location of the pad when clicking links in // the document. Not all browsers understand this attribute, but it's part of the HTML5 // standard. https://html.spec.whatwg.org/multipage/links.html#link-type-noreferrer // Additionally, we do rel="noopener" to ensure a higher level of referrer security. // https://html.spec.whatwg.org/multipage/links.html#link-type-noopener // https://mathiasbynens.github.io/rel-noopener/ // https://github.com/ether/etherpad-lite/pull/3636 pieces.push( ''); advanceTo(startIndex + href.length); pieces.push(''); } } advanceTo(text.length); return pieces.join(''); }, bindEnterAndEscape: (node, onEnter, onEscape) => { // Use keypress instead of keyup in bindEnterAndEscape. Keyup event is fired on enter in IME // (Input Method Editor), But keypress is not. So, I changed to use keypress instead of keyup. // It is work on Windows (IE8, Chrome 6.0.472), CentOs (Firefox 3.0) and Mac OSX (Firefox // 3.6.10, Chrome 6.0.472, Safari 5.0). if (onEnter) { node.keypress((evt) => { if (evt.which === 13) { onEnter(evt); } }); } if (onEscape) { node.keydown((evt) => { if (evt.which === 27) { onEscape(evt); } }); } }, timediff: (d) => { const pad = require('./pad').pad; // Sidestep circular dependency const format = (n, word) => { n = Math.round(n); return (`${n} ${word}${n !== 1 ? 's' : ''} ago`); }; d = Math.max(0, (+(new Date()) - (+d) - pad.clientTimeOffset) / 1000); if (d < 60) { return format(d, 'second'); } d /= 60; if (d < 60) { return format(d, 'minute'); } d /= 60; if (d < 24) { return format(d, 'hour'); } d /= 24; return format(d, 'day'); }, makeAnimationScheduler: (funcToAnimateOneStep, stepTime, stepsAtOnce) => { if (stepsAtOnce === undefined) { stepsAtOnce = 1; } let animationTimer = null; const scheduleAnimation = () => { if (!animationTimer) { animationTimer = window.setTimeout(() => { animationTimer = null; let n = stepsAtOnce; let moreToDo = true; while (moreToDo && n > 0) { moreToDo = funcToAnimateOneStep(); n--; } if (moreToDo) { // more to do scheduleAnimation(); } }, stepTime * stepsAtOnce); } }; return {scheduleAnimation}; }, makeShowHideAnimator: (funcToArriveAtState, initiallyShown, fps, totalMs) => { let animationState = (initiallyShown ? 0 : -2); // -2 hidden, -1 to 0 fade in, 0 to 1 fade out const animationFrameDelay = 1000 / fps; const animationStep = animationFrameDelay / totalMs; const animateOneStep = () => { if (animationState < -1 || animationState === 0) { return false; } else if (animationState < 0) { // animate show animationState += animationStep; if (animationState >= 0) { animationState = 0; funcToArriveAtState(animationState); return false; } else { funcToArriveAtState(animationState); return true; } } else if (animationState > 0) { // animate hide animationState += animationStep; if (animationState >= 1) { animationState = 1; funcToArriveAtState(animationState); animationState = -2; return false; } else { funcToArriveAtState(animationState); return true; } } }; const scheduleAnimation = padutils.makeAnimationScheduler(animateOneStep, animationFrameDelay).scheduleAnimation; return { show: () => { animationState = -1; funcToArriveAtState(animationState); scheduleAnimation(); }, quickShow: () => { // start showing without losing any fade-in progress if (animationState < -1) { animationState = -1; } else if (animationState > 0) { animationState = Math.max(-1, Math.min(0, -animationState)); } funcToArriveAtState(animationState); scheduleAnimation(); }, hide: () => { if (animationState >= -1 && animationState <= 0) { animationState = 1e-6; scheduleAnimation(); } }, }; }, _nextActionId: 1, uncanceledActions: {}, getCancellableAction: (actionType, actionFunc) => { let o = padutils.uncanceledActions[actionType]; if (!o) { o = {}; padutils.uncanceledActions[actionType] = o; } const actionId = (padutils._nextActionId++); o[actionId] = true; return () => { const p = padutils.uncanceledActions[actionType]; if (p && p[actionId]) { actionFunc(); } }; }, cancelActions: (actionType) => { const o = padutils.uncanceledActions[actionType]; if (o) { // clear it delete padutils.uncanceledActions[actionType]; } }, makeFieldLabeledWhenEmpty: (field, labelText) => { field = $(field); const clear = () => { field.addClass('editempty'); field.val(labelText); }; field.focus(() => { if (field.hasClass('editempty')) { field.val(''); } field.removeClass('editempty'); }); field.blur(() => { if (!field.val()) { clear(); } }); return { clear, }; }, getCheckbox: (node) => $(node).is(':checked'), setCheckbox: (node, value) => { if (value) { $(node).attr('checked', 'checked'); } else { $(node).removeAttr('checked'); } }, bindCheckboxChange: (node, func) => { $(node).change(func); }, encodeUserId: (userId) => userId.replace(/[^a-y0-9]/g, (c) => { if (c === '.') return '-'; return `z${c.charCodeAt(0)}z`; }), decodeUserId: (encodedUserId) => encodedUserId.replace(/[a-y0-9]+|-|z.+?z/g, (cc) => { if (cc === '-') { return '.'; } else if (cc.charAt(0) === 'z') { return String.fromCharCode(Number(cc.slice(1, -1))); } else { return cc; } }), }; let globalExceptionHandler = null; padutils.setupGlobalExceptionHandler = () => { if (globalExceptionHandler == null) { globalExceptionHandler = (e) => { let type; let err; let msg, url, linenumber; if (e instanceof ErrorEvent) { type = 'Uncaught exception'; err = e.error || {}; ({message: msg, filename: url, lineno: linenumber} = e); } else if (e instanceof PromiseRejectionEvent) { type = 'Unhandled Promise rejection'; err = e.reason || {}; ({message: msg = 'unknown', fileName: url = 'unknown', lineNumber: linenumber = -1} = err); } else { throw new Error(`unknown event: ${e.toString()}`); } const errorId = randomString(20); let msgAlreadyVisible = false; $('.gritter-item .error-msg').each(function () { if ($(this).text() === msg) { msgAlreadyVisible = true; } }); if (!msgAlreadyVisible) { const txt = document.createTextNode.bind(document); // Convenience shorthand. const errorMsg = [ $('
') .append($('').text('Please press and hold Ctrl and press F5 to reload this page')), $('
') .text('If the problem persists, please send this error message to your webmaster:'), $('