本教程详细阐述了如何从 html canvas 中正确提取图像的 base64 数据。核心内容包括理解图像加载的异步特性，确保在图像完全加载并绘制到 canvas 后再调用 `todataurl` 方法。同时，文章强调了处理跨域图像时的 cors 配置，通过设置 `crossorigin` 属性来避免 canvas 被“污染”，从而成功获取图像数据。
在现代 Web 开发中，HTML Canvas 元素为在网页上动态绘制图形提供了强大的能力。其中一个常见的需求是获取 Canvas 上绘制内容的 Base64 编码数据，这通常通过 canvas.toDataURL() 方法实现。然而，开发者在使用此方法时，尤其是在处理外部图像时，常常会遇到一些问题，例如获取到的数据不正确或 Canvas 被“污染”。本教程将深入探讨这些问题及其解决方案。
理解图像加载的异步性
在使用 JavaScript 将图像绘制到 Canvas 上时，一个常见的错误是未能充分理解图像加载的异步性质。当通过 new Image() 创建一个图像对象并设置其 src 属性时，浏览器会异步加载该图像。这意味着在图像完全加载完成之前，尝试将其绘制到 Canvas 或获取 Canvas 的数据，都可能导致不期望的结果。
常见错误示例：
以下代码展示了一个典型错误，即在图像尚未加载完成时就尝试获取 Canvas 的 Base64 数据：
在上述代码中，context.drawImage(base_image, 0, 0); 和随后的 canvas.toDataURL(...) 都可能在 base_image 尚未完全加载时执行。结果是 drawImage 可能绘制一个空白图像，而 toDataURL 则会返回一个空 Canvas 的 Base64 数据。
正确处理异步加载：
为了确保在图像加载完成后再进行绘制和数据提取，必须将相关的操作放入图像对象的 onload 事件处理函数中。
function make_base_correct() {
var canvas = document.getElementById('viewport');
var context = canvas.getContext('2d');
var base_image = new Image();
base_image.src = 'https://picsum.photos/200'; // 使用一个示例图片
base_image.onload = function() {
// 图像加载完成后，再将其绘制到 Canvas
context.drawImage(base_image, 0, 0);
// 图像绘制完成后，再获取 Canvas 的 Base64 数据
const base64Canvas = canvas.toDataURL("image/jpeg").split(';base64,')[1];
console.log(base64Canvas);
// 或者在页面上显示
// document.write('@@##@@');
};
}
// make_base_correct(); // 在实际应用中调用此函数通过将 drawImage 和 toDataURL 放在 onload 回调中，我们保证了这些操作只有在图像数据可用时才会执行。
处理跨域图像：CORS 配置
当您尝试将来自不同源（例如，不同的域名、协议或端口）的图像绘制到 Canvas 上时，可能会遇到跨域资源共享（CORS）问题。出于安全考虑，如果一个 Canvas 被“污染”（tainted）了来自不同源且未正确配置 CORS 的图像，那么 toDataURL() 或 getImageData() 等方法将无法正常工作，通常会抛出安全错误或返回一个空白图像数据。
“污染”的 Canvas：
当 Canvas 上绘制了任何来自不同源且未正确配置 CORS 的内容时，该 Canvas 就会被标记为“污染”。一旦 Canvas 被污染，其像素数据就无法被脚本读取，以防止恶意脚本读取用户可能无意中加载的敏感信息。
解决方案：crossOrigin 属性
为了允许从不同源加载图像并保持 Canvas “干净”，您需要在设置图像 src 属性之前，将 Image 对象的 crossOrigin 属性设置为 "anonymous"。
var base_image = new Image(); base_image.crossOrigin = "anonymous"; // 必须在设置 src 之前设置 base_image.src = 'https://picsum.photos/200'; // 示例跨域图片
设置 crossOrigin = "anonymous" 会告诉浏览器以匿名模式发送跨域请求，这意味着不会发送用户凭据（如 cookies 或 HTTP 认证）。为了使这种方式奏效，图像所在的服务器也必须配置为允许 CORS 请求，通常通过在响应头中包含 Access-Control-Allow-Origin 来实现。如果服务器未配置 CORS，即使设置了 crossOrigin 属性，Canvas 仍可能被污染。
完整示例代码
以下是一个结合了异步处理和 CORS 配置的完整示例，演示了如何从 Canvas 中正确获取 Base64 图像数据：
从 Canvas 获取图像 Base64 数据
从 Canvas 获取图像 Base64 数据教程
以下示例将加载一张跨域图片到 Canvas，然后提取其 Base64 数据并在页面上显示。
生成的图片预览:
Base64 数据片段:
正在加载...
