single-file 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. #!/usr/bin/env node
  2. /*
  3. * Copyright 2010-2019 Gildas Lormeau
  4. * contact : gildas.lormeau <at> gmail.com
  5. *
  6. * This file is part of SingleFile.
  7. *
  8. * The code in this file is free software: you can redistribute it and/or
  9. * modify it under the terms of the GNU Affero General Public License
  10. * (GNU AGPL) as published by the Free Software Foundation, either version 3
  11. * of the License, or (at your option) any later version.
  12. *
  13. * The code in this file is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
  16. * General Public License for more details.
  17. *
  18. * As additional permission under GNU AGPL version 3 section 7, you may
  19. * distribute UNMODIFIED VERSIONS OF THIS file without the copy of the GNU
  20. * AGPL normally required by section 4, provided you include this license
  21. * notice and a URL through which recipients can access the Corresponding
  22. * Source.
  23. */
  24. /* global require */
  25. const fileUrl = require("file-url");
  26. const args = require("yargs")
  27. .wrap(null)
  28. .command("$0 <url> [output]", "Save a page into a single HTML file.", yargs => {
  29. yargs.positional("url", { description: "URL or path on the filesystem of the page to save", type: "string" });
  30. yargs.positional("output", { description: "Output filename", type: "string" });
  31. })
  32. .default({
  33. "browser-headless": true,
  34. "browser-executable-path": "",
  35. "browser-width": 1280,
  36. "browser-height": 720,
  37. "browser-load-max-time": 60000,
  38. "browser-wait-until": "load",
  39. "browser-debug": false,
  40. "browser-extensions": [],
  41. "browser-scripts": [],
  42. "compress-CSS": true,
  43. "compress-HTML": true,
  44. "filename-template": "",
  45. "group-duplicate-images": true,
  46. "load-deferred-images": true,
  47. "load-deferred-images-max-idle-time": 1500,
  48. "max-resource-size-enabled": false,
  49. "max-resource-size": 10,
  50. "remove-hidden-elements": true,
  51. "remove-unused-styles": true,
  52. "remove-unused-fonts": true,
  53. "remove-imports": true,
  54. "remove-scripts": true,
  55. "remove-audio-src": true,
  56. "remove-video-src": true,
  57. "remove-alternative-fonts": true,
  58. "remove-alternative-medias": true,
  59. "remove-alternative-images": true,
  60. "save-raw-page": false,
  61. "web-driver-executable-path": ""
  62. })
  63. .options("browser-headless", { description: "Run the browser in headless mode" })
  64. .boolean("browser-headless")
  65. .options("browser-executable-path", { description: "Path to chrome/chromium executable" })
  66. .string("browser-executable-path")
  67. .options("browser-width", { description: "Width of the browser viewport in pixels" })
  68. .number("browser-width")
  69. .options("browser-height", { description: "Height of the browser viewport in pixels" })
  70. .number("browser-height")
  71. .options("browser-load-max-time", { description: "Maximum delay of time to wait for page loading (in ms)" })
  72. .number("browser-load-max-time")
  73. .options("browser-wait-until", { description: "When to consider the page is loaded" })
  74. .choices("browser-wait-until", ["networkidle0", "networkidle2", "load", "domcontentloaded"])
  75. .options("browser-debug", { description: "Enable debug mode" })
  76. .boolean("browser-debug")
  77. .options("browser-extensions", { description: "List of extension paths separated by a space and relative to maff2html folder" })
  78. .array("browser-extensions")
  79. .options("compress-CSS", { description: "Compress CSS stylesheets" })
  80. .boolean("compress-CSS")
  81. .options("compress-HTML", { description: "Compress HTML content" })
  82. .boolean("compress-HTML")
  83. .options("filename-template", { description: "Template used to generate the output filename (see help page of the extension for more info)" })
  84. .string("filename-template")
  85. .options("group-duplicate-images", { description: "Group duplicate images into CSS custom properties" })
  86. .boolean("group-duplicate-images")
  87. .options("load-deferred-images", { description: "Load deferred (a.k.a. lazy-loaded) images" })
  88. .boolean("load-deferred-images")
  89. .options("load-deferred-images-max-idle-time", { description: "Maximum delay of time to wait for deferred images (in ms)" })
  90. .number("load-deferred-images-max-idle-time")
  91. .options("max-resource-size-enabled", { description: "Enable removal of embedded resources exceeding a given size" })
  92. .boolean("max-resource-size-enabled")
  93. .options("max-resource-size", { description: "Maximum size of embedded resources (i.e. images, stylesheets, scripts and iframes) (in MB)" })
  94. .number("max-resource-size")
  95. .options("remove-frames", { description: "Remove frames" })
  96. .boolean("remove-frames")
  97. .options("remove-hidden-elements", { description: "Remove HTML elements which are not displayed" })
  98. .number("remove-hidden-elements")
  99. .options("remove-unused-styles", { description: "Remove unused CSS rules and unneeded declarations" })
  100. .number("remove-unused-styles")
  101. .options("remove-unused-fonts", { description: "Remove unused CSS font rules" })
  102. .number("remove-unused-fonts")
  103. .options("remove-imports", { description: "Remove HTML imports" })
  104. .number("remove-imports")
  105. .options("remove-scripts", { description: "Remove JavaScript scripts" })
  106. .number("remove-scripts")
  107. .options("remove-audio-src", { description: "Remove source of audio elements" })
  108. .number("remove-audio-src")
  109. .options("remove-video-src", { description: "Remove source of video elements" })
  110. .number("remove-video-src")
  111. .options("remove-alternative-fonts", { description: "Remove alternative fonts to the ones displayed" })
  112. .number("remove-alternative-fonts")
  113. .options("remove-alternative-medias", { description: "Remove alternative CSS stylesheets" })
  114. .number("remove-alternative-medias")
  115. .options("remove-alternative-images", { description: "Remove images for alternative sizes of screen" })
  116. .number("remove-alternative-images")
  117. .options("save-raw-page", { description: "Save the original page without interpreting it into the browser" })
  118. .number("save-raw-page")
  119. .options("web-driver-executable-path", { description: "Path to Selenium WebDriver executable" })
  120. .string("web-driver-executable-path")
  121. .argv;
  122. args.compressCSS = args.compressCss;
  123. args.compressHTML = args.compressHtml;
  124. if (!/^(https?|file):\/\//.test(args.url)) {
  125. args.url = fileUrl(args.url);
  126. }
  127. require("./back-ends/webdriver-gecko.js").getPageData(args).then(pageData => {
  128. if (args.output) {
  129. require("fs").writeFileSync(args.output, pageData.content);
  130. } else {
  131. if (args.filenameTemplate) {
  132. require("fs").writeFileSync(pageData.filename, pageData.content);
  133. } else {
  134. console.log(pageData.content); // eslint-disable-line no-console
  135. }
  136. }
  137. });