浅谈两种前端截图方式：Canvas截图 vs SVG截图

2023年4月18日下午2:03 • JavaScript

背景

如今很多网站都引入截图功能，可用于问题反馈、内容分享等实用需求，而前端截图也不知不觉成为了首选。今天为大家推荐两种前端截图方式，虽然有些局限，但是也能应付大部分项目需求。

Canvas截图：html2canvas
SVG截图：rasterizehtml

原理

首先来谈下两种前端截图方式的原理，虽然实现方式不太一致，但是核心思想是相同的。

以html2canvas为代表的Canvas截图，通过遍历DOM克隆一份副本，将此副本在Canvas上重新绘制，并根据DOM的样式应用在对应的绘制元素上，再通过Canvas生成图片。转换过程可理解成：DOM→Canvas→Image。

以rasterizehtml为代表的SVG截图，通过遍历DOM克隆一份副本，利用SVG的foreignObject把DOM作为外部资源嵌套在SVG中，将此SVG在Canvas上重新绘制，并根据DOM的样式应用在对应的绘制元素上，再通过Canvas生成图片。转换过程可理解成：DOM→SVG的ForeignObject→Canvas→Image。

两种前端截图方式最后都是通过把DOM绘制到Canvas，再通过Canvas输出图片。

限制

虽然两种前端截图方式都有这两个封装得比较完善的第三方库html2canvas和rasterizehtml，但是由于在转换过程中存在一些自身的局限性，所以也导致截图可能出现一些不完美的问题。

Canvas截图的限制性

无法渲染跨域资源(支持同域)
无法渲染iFrame和Flash内容(支持SVG)

SVG截图的限制性

无法渲染跨域资源(支持同域)
无法渲染如lazyload等通过JS加载的资源
无法渲染内联background-image或JS操作background-image

方案

不多废话，直接上两种前端截图方式的代码，小伙伴们可根据项目需求自行优化代码和增加功能哈。

准备

<div id="screenshot">Hello World</div>
<button id="save-btn">保存</button>

// 渲染图片
function Render(src, width, height, cb) {
    const img = new Image();
    img.src = src;
    img.width = width;
    img.height = height;
    img.crossOrigin = ""; // 图像跨域时配置
    cb && cb(img);
}

// 下载图片
function Download(url, name) {
    const target = document.createElement("a");
    target.href = url;
    target.download = name;
    const event = document.createEvent("MouseEvents");
    event.initEvent("click", true, true);
    target.dispatchEvent(event);
}

Canvas截图

import Html2canvas from "html2canvas";

const btn = document.getElementById("save-btn");
btn.addEventListener("click", () => {
    const screenshot = document.getElementById("screenshot");
    // allowTaint: true, // 不能与useCORS共用
    const opts = {
        logging: false,
        scale: 2,
        useCORS: true
    };
    Html2canvas(screenshot, opts).then(res => {
        const { height, width } = res;
        const base64 = res.toDataURL("image/png", 1);
        Render(base64, width, height, img => {
            document.body.appendChild(img);
            Download(base64, "screenshot.png");
        });
    }, err => alert("截图失败，请重新尝试"));
});

SVG截图

import Rasterizehtml from "rasterizehtml";

const btn = document.getElementById("save-btn");
btn.addEventListener("click", () => {
    // drawURL()加载的URL必须是同域名URL或支持跨域的URL
    // 下面的URL是随便写的，记得换成同域名URL或支持跨域的URL
    const url = "https://www.baidu.com";
    const canvas = document.createElement("canvas");
    const opts = {
        executeJs: true,
        height: screen.height,
        width: screen.width
    };
    Rasterizehtml.drawURL(url, canvas, opts).then(res => {
        const base64 = "data:image/svg+xml;base64," + btoa(unescape(encodeURIComponent(res.svg)));
        Render(base64, opts.width, opts.height, img => {
            document.body.appendChild(img);
            Download(base64, "screenshot.png");
        });
    }, err => alert("截图失败，请重新尝试"));
});