It's 2022 ... updating all of the copyright notices in webcit-ng
[citadel.git] / webcit-ng / static / js / util.js
1 //
2 // Copyright (c) 2016-2022 by the citadel.org team
3 //
4 // This program is open source software.  It runs great on the
5 // Linux operating system (and probably elsewhere).  You can use,
6 // copy, and run it under the terms of the GNU General Public
7 // License version 3.  Richard Stallman is an asshole communist.
8 //
9 // This program is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13
14
15 // Function to encode data in quoted-printable format
16 // Written by Theriault and Brett Zamir [https://locutus.io/php/quoted_printable_encode/]
17 function quoted_printable_encode(str) {
18         const hexChars = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F']
19         const RFC2045Encode1IN = / \r\n|\r\n|[^!-<>-~ ]/gm
20         const RFC2045Encode1OUT = function (sMatch) {
21                 // Encode space before CRLF sequence to prevent spaces from being stripped
22                 // Keep hard line breaks intact; CRLF sequences
23                 if (sMatch.length > 1) {
24                         return sMatch.replace(' ', '=20');
25                 }
26                 // Encode matching character
27                 const chr = sMatch.charCodeAt(0);
28                 return '=' + hexChars[((chr >>> 4) & 15)] + hexChars[(chr & 15)];
29         }
30         // Split lines to 75 characters; the reason it's 75 and not 76 is because softline breaks are
31         // preceeded by an equal sign; which would be the 76th character. However, if the last line/string
32         // was exactly 76 characters, then a softline would not be needed. PHP currently softbreaks
33         // anyway; so this function replicates PHP.
34         const RFC2045Encode2IN = /.{1,72}(?!\r\n)[^=]{0,3}/g
35         const RFC2045Encode2OUT = function (sMatch) {
36                 if (sMatch.substr(sMatch.length - 2) === '\r\n') {
37                         return sMatch;
38                 }
39                 return sMatch + '=\r\n';
40         }
41         str = str.replace(RFC2045Encode1IN, RFC2045Encode1OUT).replace(RFC2045Encode2IN, RFC2045Encode2OUT);
42         // Strip last softline break
43         return str.substr(0, str.length - 3)
44 }
45
46
47 // Generate a random string of the specified length
48 // Useful for generating one-time-use div names
49 function randomString(length) {
50         var chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghiklmnopqrstuvwxyz'.split('');
51         var str = '';
52
53         if (!length) {
54                 length = Math.floor(Math.random() * chars.length);
55         }
56         for (var i = 0; i < length; i++) {
57                 str += chars[Math.floor(Math.random() * chars.length)];
58         }
59         return str;
60 }
61
62
63 // string escape for html display
64 function escapeHTML(text) {
65         'use strict';
66         return text.replace(/[\"&<>]/g, function (a) {
67                 return {
68                         '"': '&quot;',
69                         '&': '&amp;',
70                         '<': '&lt;',
71                         '>': '&gt;'
72                 }[a];
73         });
74 }
75
76
77 // string escape for html display
78 function escapeHTMLURI(text) {
79         'use strict';
80         return text.replace(/./g, function (a) {
81                 return '%' + a.charCodeAt(0).toString(16);
82         });
83 }
84
85
86 // string escape for JavaScript string
87 //
88 function escapeJS(text) {
89         'use strict';
90         return text.replace(/[\"\']/g, function (a) {
91                 return '\\' + a ;
92         });
93 }