html.js 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326
  1. /**
  2. * @fileoverview HTML reporter
  3. * @author Julian Laval
  4. */
  5. "use strict";
  6. //------------------------------------------------------------------------------
  7. // Helpers
  8. //------------------------------------------------------------------------------
  9. const encodeHTML = (function() {
  10. const encodeHTMLRules = {
  11. "&": "&",
  12. "<": "&#60;",
  13. ">": "&#62;",
  14. '"': "&#34;",
  15. "'": "&#39;"
  16. };
  17. const matchHTML = /[&<>"']/ug;
  18. return function(code) {
  19. return code
  20. ? code.toString().replace(matchHTML, m => encodeHTMLRules[m] || m)
  21. : "";
  22. };
  23. }());
  24. /**
  25. * Get the final HTML document.
  26. * @param {Object} it data for the document.
  27. * @returns {string} HTML document.
  28. */
  29. function pageTemplate(it) {
  30. const { reportColor, reportSummary, date, results } = it;
  31. return `
  32. <!DOCTYPE html>
  33. <html>
  34. <head>
  35. <meta charset="UTF-8">
  36. <title>ESLint Report</title>
  37. <link rel="icon" type="image/png" sizes="any" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAACXBIWXMAAAHaAAAB2gGFomX7AAAAGXRFWHRTb2Z0d2FyZQB3d3cuaW5rc2NhcGUub3Jnm+48GgAABD1JREFUWMPFl11sk2UUx3/nbYtjxS1MF7MLMTECMgSTtSSyrQkLhAj7UBPnDSEGoxegGzMwojhXVpmTAA5iYpSoMQa8GBhFOrMFk03buei6yRAlcmOM0SEmU9d90b19jxcM1o5+sGnsc/e+z/l6ztf/HFFVMnns6QieeOCHBePGsHM+wrOtvLG2C4WRVDSSygNV7sCjlspxwDnPB44aols/DXk+mbMBmx/6OseITF1CuOtfevkPh2Uu+/jbdX8lujSScRlT5r7/QDlAfsRmfzmpnkQ/H3H13gf6bBrBn1uqK8WylgEnU8eZmk1repbfchJG1TyKyIKEwuBHFd3lD3naY3O1siiwXsVoBV2VgM1ht/QQUJk2ByqKghsQziYQ8ifKgexIXmuyzC4r67Y7R+xPAfuB/Nn3Cpva+0s7khpQVtZtd4bt51BWxtBYAiciprG7c7D4SixzU9PYalDL6110Ifb/w8W9eY7JqFeFHbO8fPGyLHwwFHJNJTSgwtVTB9oaw9BlQ+tO93vOxypoaQnfEYlI43SeCHDC4TDq9+51/h5fxr33q0ZfV9g04wat9Q943rjJgCp3952W2i8Bi6eDvdsfKj0cK/DYMRyXL4/sUJUmIHd2zYMezsvLaamp4WpcWN3BXSiHpuMwbGbZlnZ8tXY4rgosy+G7oRwQ0cAsd28YGgqfU5UjCZQDLALxDg+Hv/P5Rqvj4hwrS8izXzWb4spwc1GgENFnkpWRzxeuB+ssUHgLdb9UVdt8vpGdKQpze7n7y1U3DBChNRUuqOo9c+0+qpKKxyZqtAIYla7gY4JszAAQri93BSsMRZoyBcUC+w3Q3AyOA4sNhAOZ0q7Iq0b2vUNvK5zPgP+/H8+Zetdoa6uOikhdGurxebwvJY8Iz3V1rTMNAH+opEuQj5KTT/qA1yC+wyUjBm12OidaUtCcPNNX2h0Hx2JG69VulANZAJZJwfU7rzd/FHixuXniTdM0m4GtSQT7bTartqEh9yfImUEzkwKZmTwmo5a5JwkYBfcDL01/RkR5y8iWhtPBknB8ZxwtU9UjwOrrKCeizzc25nTGg1F/turEHoU9wMLpDvWKf8DTmNCAKnd/tqUTF4ElMXJ+A5rWDJS+41WsGWzALhJ+ErBWrLj9g+pqojHxlXJX8HGUg0BsR/x1yhxf3jm4cSzpQFLp6tmi6PEE7g1ZhtZ91ufpSZUAFa6gC+UoQslNaSmypT1U8mHKiUgEKS8KfgF4EpYunFI16tsHin+OG0LcgQK7yj7g6cSzpva2D3hKVNG0Y3mVO1BkqfSlmJrHBQ4uvM12gJHc6ETW8HZVfMRmXvyxxNC1Z/o839zyXlDuCr4nsC11J+MXueaVJWn6yPv+/pJtc9oLTNN4AeTvNGByd3rlhE2x9s5pLwDoHCy+grDzWmOZ95lUtLYj5Bma126Y8eX0/zj/ADxGyViSg4BXAAAAAElFTkSuQmCC">
  38. <link rel="icon" type="image/svg+xml" href="data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PScwIDAgMjk0LjgyNSAyNTguOTgyJyB4bWxucz0naHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmcnPg0KPHBhdGggZmlsbD0nIzgwODBGMicgZD0nTTk3LjAyMSw5OS4wMTZsNDguNDMyLTI3Ljk2MmMxLjIxMi0wLjcsMi43MDYtMC43LDMuOTE4LDBsNDguNDMzLDI3Ljk2MiBjMS4yMTEsMC43LDEuOTU5LDEuOTkzLDEuOTU5LDMuMzkzdjU1LjkyNGMwLDEuMzk5LTAuNzQ4LDIuNjkzLTEuOTU5LDMuMzk0bC00OC40MzMsMjcuOTYyYy0xLjIxMiwwLjctMi43MDYsMC43LTMuOTE4LDAgbC00OC40MzItMjcuOTYyYy0xLjIxMi0wLjctMS45NTktMS45OTQtMS45NTktMy4zOTR2LTU1LjkyNEM5NS4wNjMsMTAxLjAwOSw5NS44MSw5OS43MTYsOTcuMDIxLDk5LjAxNicvPg0KPHBhdGggZmlsbD0nIzRCMzJDMycgZD0nTTI3My4zMzYsMTI0LjQ4OEwyMTUuNDY5LDIzLjgxNmMtMi4xMDItMy42NC01Ljk4NS02LjMyNS0xMC4xODgtNi4zMjVIODkuNTQ1IGMtNC4yMDQsMC04LjA4OCwyLjY4NS0xMC4xOSw2LjMyNWwtNTcuODY3LDEwMC40NWMtMi4xMDIsMy42NDEtMi4xMDIsOC4yMzYsMCwxMS44NzdsNTcuODY3LDk5Ljg0NyBjMi4xMDIsMy42NCw1Ljk4Niw1LjUwMSwxMC4xOSw1LjUwMWgxMTUuNzM1YzQuMjAzLDAsOC4wODctMS44MDUsMTAuMTg4LTUuNDQ2bDU3Ljg2Ny0xMDAuMDEgQzI3NS40MzksMTMyLjM5NiwyNzUuNDM5LDEyOC4xMjgsMjczLjMzNiwxMjQuNDg4IE0yMjUuNDE5LDE3Mi44OThjMCwxLjQ4LTAuODkxLDIuODQ5LTIuMTc0LDMuNTlsLTczLjcxLDQyLjUyNyBjLTEuMjgyLDAuNzQtMi44ODgsMC43NC00LjE3LDBsLTczLjc2Ny00Mi41MjdjLTEuMjgyLTAuNzQxLTIuMTc5LTIuMTA5LTIuMTc5LTMuNTlWODcuODQzYzAtMS40ODEsMC44ODQtMi44NDksMi4xNjctMy41OSBsNzMuNzA3LTQyLjUyN2MxLjI4Mi0wLjc0MSwyLjg4Ni0wLjc0MSw0LjE2OCwwbDczLjc3Miw0Mi41MjdjMS4yODMsMC43NDEsMi4xODYsMi4xMDksMi4xODYsMy41OVYxNzIuODk4eicvPg0KPC9zdmc+">
  39. <style>
  40. body {
  41. font-family:Arial, "Helvetica Neue", Helvetica, sans-serif;
  42. font-size:16px;
  43. font-weight:normal;
  44. margin:0;
  45. padding:0;
  46. color:#333
  47. }
  48. #overview {
  49. padding:20px 30px
  50. }
  51. td, th {
  52. padding:5px 10px
  53. }
  54. h1 {
  55. margin:0
  56. }
  57. table {
  58. margin:30px;
  59. width:calc(100% - 60px);
  60. max-width:1000px;
  61. border-radius:5px;
  62. border:1px solid #ddd;
  63. border-spacing:0px;
  64. }
  65. th {
  66. font-weight:400;
  67. font-size:medium;
  68. text-align:left;
  69. cursor:pointer
  70. }
  71. td.clr-1, td.clr-2, th span {
  72. font-weight:700
  73. }
  74. th span {
  75. float:right;
  76. margin-left:20px
  77. }
  78. th span:after {
  79. content:"";
  80. clear:both;
  81. display:block
  82. }
  83. tr:last-child td {
  84. border-bottom:none
  85. }
  86. tr td:first-child, tr td:last-child {
  87. color:#9da0a4
  88. }
  89. #overview.bg-0, tr.bg-0 th {
  90. color:#468847;
  91. background:#dff0d8;
  92. border-bottom:1px solid #d6e9c6
  93. }
  94. #overview.bg-1, tr.bg-1 th {
  95. color:#f0ad4e;
  96. background:#fcf8e3;
  97. border-bottom:1px solid #fbeed5
  98. }
  99. #overview.bg-2, tr.bg-2 th {
  100. color:#b94a48;
  101. background:#f2dede;
  102. border-bottom:1px solid #eed3d7
  103. }
  104. td {
  105. border-bottom:1px solid #ddd
  106. }
  107. td.clr-1 {
  108. color:#f0ad4e
  109. }
  110. td.clr-2 {
  111. color:#b94a48
  112. }
  113. td a {
  114. color:#3a33d1;
  115. text-decoration:none
  116. }
  117. td a:hover {
  118. color:#272296;
  119. text-decoration:underline
  120. }
  121. </style>
  122. </head>
  123. <body>
  124. <div id="overview" class="bg-${reportColor}">
  125. <h1>ESLint Report</h1>
  126. <div>
  127. <span>${reportSummary}</span> - Generated on ${date}
  128. </div>
  129. </div>
  130. <table>
  131. <tbody>
  132. ${results}
  133. </tbody>
  134. </table>
  135. <script type="text/javascript">
  136. var groups = document.querySelectorAll("tr[data-group]");
  137. for (i = 0; i < groups.length; i++) {
  138. groups[i].addEventListener("click", function() {
  139. var inGroup = document.getElementsByClassName(this.getAttribute("data-group"));
  140. this.innerHTML = (this.innerHTML.indexOf("+") > -1) ? this.innerHTML.replace("+", "-") : this.innerHTML.replace("-", "+");
  141. for (var j = 0; j < inGroup.length; j++) {
  142. inGroup[j].style.display = (inGroup[j].style.display !== "none") ? "none" : "table-row";
  143. }
  144. });
  145. }
  146. </script>
  147. </body>
  148. </html>
  149. `.trimLeft();
  150. }
  151. /**
  152. * Given a word and a count, append an s if count is not one.
  153. * @param {string} word A word in its singular form.
  154. * @param {int} count A number controlling whether word should be pluralized.
  155. * @returns {string} The original word with an s on the end if count is not one.
  156. */
  157. function pluralize(word, count) {
  158. return (count === 1 ? word : `${word}s`);
  159. }
  160. /**
  161. * Renders text along the template of x problems (x errors, x warnings)
  162. * @param {string} totalErrors Total errors
  163. * @param {string} totalWarnings Total warnings
  164. * @returns {string} The formatted string, pluralized where necessary
  165. */
  166. function renderSummary(totalErrors, totalWarnings) {
  167. const totalProblems = totalErrors + totalWarnings;
  168. let renderedText = `${totalProblems} ${pluralize("problem", totalProblems)}`;
  169. if (totalProblems !== 0) {
  170. renderedText += ` (${totalErrors} ${pluralize("error", totalErrors)}, ${totalWarnings} ${pluralize("warning", totalWarnings)})`;
  171. }
  172. return renderedText;
  173. }
  174. /**
  175. * Get the color based on whether there are errors/warnings...
  176. * @param {string} totalErrors Total errors
  177. * @param {string} totalWarnings Total warnings
  178. * @returns {int} The color code (0 = green, 1 = yellow, 2 = red)
  179. */
  180. function renderColor(totalErrors, totalWarnings) {
  181. if (totalErrors !== 0) {
  182. return 2;
  183. }
  184. if (totalWarnings !== 0) {
  185. return 1;
  186. }
  187. return 0;
  188. }
  189. /**
  190. * Get HTML (table row) describing a single message.
  191. * @param {Object} it data for the message.
  192. * @returns {string} HTML (table row) describing the message.
  193. */
  194. function messageTemplate(it) {
  195. const {
  196. parentIndex,
  197. lineNumber,
  198. columnNumber,
  199. severityNumber,
  200. severityName,
  201. message,
  202. ruleUrl,
  203. ruleId
  204. } = it;
  205. return `
  206. <tr style="display:none" class="f-${parentIndex}">
  207. <td>${lineNumber}:${columnNumber}</td>
  208. <td class="clr-${severityNumber}">${severityName}</td>
  209. <td>${encodeHTML(message)}</td>
  210. <td>
  211. <a href="${ruleUrl ? ruleUrl : ""}" target="_blank" rel="noopener noreferrer">${ruleId ? ruleId : ""}</a>
  212. </td>
  213. </tr>
  214. `.trimLeft();
  215. }
  216. /**
  217. * Get HTML (table rows) describing the messages.
  218. * @param {Array} messages Messages.
  219. * @param {int} parentIndex Index of the parent HTML row.
  220. * @param {Object} rulesMeta Dictionary containing metadata for each rule executed by the analysis.
  221. * @returns {string} HTML (table rows) describing the messages.
  222. */
  223. function renderMessages(messages, parentIndex, rulesMeta) {
  224. /**
  225. * Get HTML (table row) describing a message.
  226. * @param {Object} message Message.
  227. * @returns {string} HTML (table row) describing a message.
  228. */
  229. return messages.map(message => {
  230. const lineNumber = message.line || 0;
  231. const columnNumber = message.column || 0;
  232. let ruleUrl;
  233. if (rulesMeta) {
  234. const meta = rulesMeta[message.ruleId];
  235. if (meta && meta.docs && meta.docs.url) {
  236. ruleUrl = meta.docs.url;
  237. }
  238. }
  239. return messageTemplate({
  240. parentIndex,
  241. lineNumber,
  242. columnNumber,
  243. severityNumber: message.severity,
  244. severityName: message.severity === 1 ? "Warning" : "Error",
  245. message: message.message,
  246. ruleId: message.ruleId,
  247. ruleUrl
  248. });
  249. }).join("\n");
  250. }
  251. /**
  252. * Get HTML (table row) describing the result for a single file.
  253. * @param {Object} it data for the file.
  254. * @returns {string} HTML (table row) describing the result for the file.
  255. */
  256. function resultTemplate(it) {
  257. const { color, index, filePath, summary } = it;
  258. return `
  259. <tr class="bg-${color}" data-group="f-${index}">
  260. <th colspan="4">
  261. [+] ${encodeHTML(filePath)}
  262. <span>${encodeHTML(summary)}</span>
  263. </th>
  264. </tr>
  265. `.trimLeft();
  266. }
  267. /**
  268. * Render the results.
  269. * @param {Array} results Test results.
  270. * @param {Object} rulesMeta Dictionary containing metadata for each rule executed by the analysis.
  271. * @returns {string} HTML string describing the results.
  272. */
  273. function renderResults(results, rulesMeta) {
  274. return results.map((result, index) => resultTemplate({
  275. index,
  276. color: renderColor(result.errorCount, result.warningCount),
  277. filePath: result.filePath,
  278. summary: renderSummary(result.errorCount, result.warningCount)
  279. }) + renderMessages(result.messages, index, rulesMeta)).join("\n");
  280. }
  281. //------------------------------------------------------------------------------
  282. // Public Interface
  283. //------------------------------------------------------------------------------
  284. module.exports = function(results, data) {
  285. let totalErrors,
  286. totalWarnings;
  287. const metaData = data ? data.rulesMeta : {};
  288. totalErrors = 0;
  289. totalWarnings = 0;
  290. // Iterate over results to get totals
  291. results.forEach(result => {
  292. totalErrors += result.errorCount;
  293. totalWarnings += result.warningCount;
  294. });
  295. return pageTemplate({
  296. date: new Date(),
  297. reportColor: renderColor(totalErrors, totalWarnings),
  298. reportSummary: renderSummary(totalErrors, totalWarnings),
  299. results: renderResults(results, metaData)
  300. });
  301. };