Img 标签 src 调用 API 返回 base64 字符串的解决办法

在前端开发过程中，我们经常会遇到动态加载图片的需求。一种常见的方法是通过 JavaScript 向后端 API 发送请求，获取图片数据并将其转换为 Base64 字符串来显示。本文将详细介绍如何实现这一功能，并提供多个示例代码片段来帮助开发者更好地理解这一过程。

基本概念与作用

在 Web 开发中，<img> 标签用于展示图像。当图像源（src 属性）指向一个 Base64 编码的字符串时，浏览器会直接解析该字符串并在页面上显示对应的图像。这种方式非常适用于较小的图像文件，如图标、Logo 或者简单的图形，因为可以减少 HTTP 请求的数量，从而提高页面加载速度。

示例一：使用 Fetch API 获取 Base64 图像

代码示例

// 示例：使用 Fetch API 从服务器获取 Base64 编码的图像数据
async function fetchImage() {
  const response = await fetch('https://api.example.com/image');
  if (!response.ok) {
    throw new Error(`Failed to fetch image: ${response.statusText}`);
  }

  // 将 Blob 对象转换为 Base64 字符串
  const blob = await response.blob();
  const urlCreator = window.URL || window.webkitURL;
  const imageUrl = urlCreator.createObjectURL(blob);

  // 在 <img> 标签中显示图像
  const imgElement = document.createElement('img');
  imgElement.src = imageUrl;
  document.body.appendChild(imgElement);
}

fetchImage().catch(console.error);

说明

这段代码使用了 Fetch API 来请求图像数据，并将响应体转换为 Blob 对象。Blob 对象接着被转换成一个 URL，这个 URL 可以直接设置为 <img> 元素的 src 属性。

示例二：使用 XMLHttpRequest 获取 Base64 图像

代码示例

function fetchImageXhr() {
  const xhr = new XMLHttpRequest();
  xhr.open('GET', 'https://api.example.com/image', true);
  xhr.responseType = 'blob';

  xhr.onload = function () {
    if (xhr.status === 200) {
      const blob = xhr.response;
      const urlCreator = window.URL || window.webkitURL;
      const imageUrl = urlCreator.createObjectURL(blob);

      const imgElement = document.createElement('img');
      imgElement.src = imageUrl;
      document.body.appendChild(imgElement);
    }
  };

  xhr.onerror = function () {
    console.error('Error fetching the image.');
  };

  xhr.send();
}

fetchImageXhr();

说明

此示例展示了如何使用传统的 XMLHttpRequest 来获取 Blob 数据，并创建一个临时 URL 来显示图像。

示例三：使用 Fetch API 并直接处理 Base64 字符串

代码示例

async function fetchBase64Image() {
  const response = await fetch('https://api.example.com/image');
  if (!response.ok) {
    throw new Error(`Failed to fetch image: ${response.statusText}`);
  }

  // 直接读取 Blob 的文本内容
  const blobText = await response.text();

  // 在 <img> 标签中显示图像
  const imgElement = document.createElement('img');
  imgElement.src = `data:image/png;base64,${blobText}`;
  document.body.appendChild(imgElement);
}

fetchBase64Image().catch(console.error);

说明

在这个示例中，我们直接将 Blob 的文本内容赋值给 <img> 元素的 src 属性。这种方法适用于 API 直接返回 Base64 字符串的情况。

示例四：使用 AJAX 获取 Base64 字符串并更新图片

代码示例

function updateImageWithBase64() {
  const xhr = new XMLHttpRequest();
  xhr.open('GET', 'https://api.example.com/image', true);
  xhr.onreadystatechange = function () {
    if (xhr.readyState === 4 && xhr.status === 200) {
      const imgElement = document.getElementById('image');
      imgElement.src = `data:image/png;base64,${xhr.responseText}`;
    }
  };

  xhr.send();
}

updateImageWithBase64();

说明

这里展示了如何使用 AJAX 请求获取 Base64 字符串，并更新页面上已存在的 <img> 元素。

示例五：使用 async/await 和 Blob 处理大型图像

代码示例

async function fetchLargeImage() {
  const response = await fetch('https://api.example.com/large-image');
  if (!response.ok) {
    throw new Error(`Failed to fetch large image: ${response.statusText}`);
  }

  // 将 Blob 对象转换为 Base64 字符串
  const blob = await response.blob();
  const reader = new FileReader();
  reader.onloadend = function () {
    const base64Data = reader.result;
    const imgElement = document.createElement('img');
    imgElement.src = base64Data;
    document.body.appendChild(imgElement);
  };
  reader.readAsDataURL(blob);
}

fetchLargeImage().catch(console.error);

说明

对于较大的图像文件，使用 FileReader 读取 Blob 数据并转换为 Base64 字符串是一个更好的选择。这可以避免内存溢出的问题。

使用技巧与分析

• 性能考虑：虽然使用 Base64 编码可以减少 HTTP 请求，但也会增加文件大小。因此，只适用于较小的图像。
• 缓存策略：如果图片经常变化，可以考虑使用 ETag 或 Last-Modified 头来控制缓存。
• 错误处理：在发送请求时，要确保有适当的错误处理机制，以便及时告知用户或采取其他补救措施。
• 兼容性问题：在某些较旧的浏览器中可能不支持 Fetch API 或 Blob 对象，这时需要使用 XMLHttpRequest 作为备选方案。

通过上述示例，你可以看到如何有效地处理 API 返回的 Base64 图像数据，并将其正确地显示在网页上。这些示例不仅适用于初学者，也可以为有经验的开发者提供参考。

欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

---

推荐：DTcode7的博客首页。
一个做过前端开发的产品经理，经历过睿智产品的折磨导致脱发之后，励志要翻身农奴把歌唱，一边打入敌人内部一边持续提升自己，为我们广大开发同胞谋福祉，坚决抵制睿智产品折磨我们码农兄弟！

---

专栏系列（点击解锁）	学习路线(点击解锁）	知识定位
《微信小程序相关博客》	持续更新中~	结合微信官方原生框架、uniapp等小程序框架，记录请求、封装、tabbar、UI组件的学习记录和使用技巧等
《AIGC相关博客》	持续更新中~	AIGC、AI生产力工具的介绍，例如stable diffusion这种的AI绘画工具安装、使用、技巧等总结
《HTML网站开发相关》	《前端基础入门三大核心之html相关博客》	前端基础入门三大核心之html板块的内容，入坑前端或者辅助学习的必看知识
	《前端基础入门三大核心之JS相关博客》	前端JS是JavaScript语言在网页开发中的应用，负责实现交互效果和动态内容。它与HTML和CSS并称前端三剑客，共同构建用户界面。 通过操作DOM元素、响应事件、发起网络请求等，JS使页面能够响应用户行为，实现数据动态展示和页面流畅跳转，是现代Web开发的核心
	《前端基础入门三大核心之CSS相关博客》	介绍前端开发中遇到的CSS疑问和各种奇妙的CSS语法，同时收集精美的CSS效果代码，用来丰富你的web网页
	《canvas绘图相关博客》	Canvas是HTML5中用于绘制图形的元素，通过JavaScript及其提供的绘图API，开发者可以在网页上绘制出各种复杂的图形、动画和图像效果。Canvas提供了高度的灵活性和控制力，使得前端绘图技术更加丰富和多样化
《Vue实战相关博客》	持续更新中~	详细总结了常用UI库elementUI的使用技巧以及Vue的学习之旅
《python相关博客》	持续更新中~	Python，简洁易学的编程语言，强大到足以应对各种应用场景，是编程新手的理想选择，也是专业人士的得力工具
《sql数据库相关博客》	持续更新中~	SQL数据库：高效管理数据的利器，学会SQL，轻松驾驭结构化数据，解锁数据分析与挖掘的无限可能
《算法系列相关博客》	持续更新中~	算法与数据结构学习总结，通过JS来编写处理复杂有趣的算法问题，提升你的技术思维
《IT信息技术相关博客》	持续更新中~	作为信息化人员所需要掌握的底层技术，涉及软件开发、网络建设、系统维护等领域的知识
	《信息化人员基础技能知识相关博客》	无论你是开发、产品、实施、经理，只要是从事信息化相关行业的人员，都应该掌握这些信息化的基础知识，可以不精通但是一定要了解，避免日常工作中贻笑大方
	《信息化技能面试宝典相关博客》	涉及信息化相关工作基础知识和面试技巧，提升自我能力与面试通过率，扩展知识面
《前端开发习惯与小技巧相关博客》	持续更新中~	罗列常用的开发工具使用技巧,如 Vscode快捷键操作、Git、CMD、游览器控制台等
《photoshop相关博客》	持续更新中~	基础的PS学习记录，含括PPI与DPI、物理像素dp、逻辑像素dip、矢量图和位图以及帧动画等的学习总结
日常开发&办公&生产【实用工具】分享相关博客》	持续更新中~	分享介绍各种开发中、工作中、个人生产以及学习上的工具，丰富阅历，给大家提供处理事情的更多角度，学习了解更多的便利工具，如Fiddler抓包、办公快捷键、虚拟机VMware等工具

吾辈才疏学浅，摹写之作，恐有瑕疵。望诸君海涵赐教。望轻喷，嘤嘤嘤
非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。愿斯文对汝有所裨益，纵其简陋未及渊博，亦足以略尽绵薄之力。倘若尚存阙漏，敬请不吝斧正，俾便精进！