webcit-ng/static/js/util.js

   1 // Copyright (c) 2016-2023 by the citadel.org team
   2 //
   3 // This program is open source software.  Use, duplication, or
   4 // disclosure are subject to the GNU General Public License v3.
   5
   6
   7 // Function to encode data in quoted-printable format
   8 // Written by Theriault and Brett Zamir [https://locutus.io/php/quoted_printable_encode/]
   9 function quoted_printable_encode(str) {
  10         const hexChars = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F']
  11         const RFC2045Encode1IN = / \r\n|\r\n|[^!-<>-~ ]/gm
  12         const RFC2045Encode1OUT = function (sMatch) {
  13                 // Encode space before CRLF sequence to prevent spaces from being stripped
  14                 // Keep hard line breaks intact; CRLF sequences
  15                 if (sMatch.length > 1) {
  16                         return sMatch.replace(' ', '=20');
  17                 }
  18                 // Encode matching character
  19                 const chr = sMatch.charCodeAt(0);
  20                 return '=' + hexChars[((chr >>> 4) & 15)] + hexChars[(chr & 15)];
  21         }
  22         // Split lines to 75 characters; the reason it's 75 and not 76 is because softline breaks are
  23         // preceeded by an equal sign; which would be the 76th character. However, if the last line/string
  24         // was exactly 76 characters, then a softline would not be needed. PHP currently softbreaks
  25         // anyway; so this function replicates PHP.
  26         const RFC2045Encode2IN = /.{1,72}(?!\r\n)[^=]{0,3}/g
  27         const RFC2045Encode2OUT = function (sMatch) {
  28                 if (sMatch.substr(sMatch.length - 2) === '\r\n') {
  29                         return sMatch;
  30                 }
  31                 return sMatch + '=\r\n';
  32         }
  33         str = str.replace(RFC2045Encode1IN, RFC2045Encode1OUT).replace(RFC2045Encode2IN, RFC2045Encode2OUT);
  34         // Strip last softline break
  35         return str.substr(0, str.length - 3)
  36 }
  37
  38
  39 // generate a random string -- mainly used for generating one-time-use div names
  40 function randomString() {
  41         return Math.random().toString(36).replace('0.','ctdl_' || '');
  42 }
  43
  44
  45 // string escape for html display
  46 function escapeHTML(text) {
  47         'use strict';
  48         return text.replace(/[\"&<>]/g, function (a) {
  49                 return {
  50                         '"': '&quot;',
  51                         '&': '&amp;',
  52                         '<': '&lt;',
  53                         '>': '&gt;'
  54                 }[a];
  55         });
  56 }
  57
  58
  59 // string escape for html display FIXME can this be replaced with encodeURI() from the standard library?
  60 function escapeHTMLURI(text) {
  61         'use strict';
  62         return text.replace(/./g, function (a) {
  63                 return '%' + a.charCodeAt(0).toString(16);
  64         });
  65 }
  66
  67
  68 // string escape for JavaScript string
  69 function escapeJS(text) {
  70         'use strict';
  71         return text.replace(/[\"\']/g, function (a) {
  72                 return '\\' + a ;
  73         });
  74 }
  75
  76
  77 // Convert a UNIX timestamp to the browser's local time
  78 // See also: https://timestamp.online/article/how-to-convert-timestamp-to-datetime-in-javascript
  79 // format should be: 0=full (date+time), 1=brief (date if not today, time if today)
  80 function string_timestamp(timestamp, format) {
  81         var ts = new Date(timestamp * 1000);
  82         if (format == 1) {
  83                 var now_ts = new Date(Date.now());
  84                 if (ts.toLocaleDateString() == now_ts.toLocaleDateString()) {
  85                         return(ts.toLocaleTimeString());
  86                 }
  87                 else {
  88                         return(ts.toLocaleDateString());
  89                 }
  90         }
  91         else {
  92                 return(ts.toLocaleString());
  93         }
  94 }
  95
  96
  97 // An old version of string_timestamp() did it the hard way.
  98 // It used https://gist.github.com/kmaida/6045266 as a reference.
  99 // check git history prior to 2022-jul-03 if you want to see it.
 100
 101
 102 // Get the value of a cookie from the HTTP session
 103 // Shamelessly swiped from https://stackoverflow.com/questions/5639346/what-is-the-shortest-function-for-reading-a-cookie-by-name-in-javascript
 104 const getCookieValue = (name) => (
 105         document.cookie.match('(^|;)\\s*' + name + '\\s*=\\s*([^;]+)')?.pop() || ''
 106 )
 107
 108