新闻中心

J*aScript中处理API返回二进制数据及Base64转换的教程

2025-11-15
浏览次数:
返回列表

JavaScript中处理API返回二进制数据及Base64转换的教程

本教程详细介绍了在j*ascript中如何使用`fetch` api正确处理从服务器返回的二进制数据,特别是当api返回如图片生成服务(如novelai)的zip文件时。文章解释了为何直接使用`response.text()`会导致数据损坏,并提供了通过`response.arraybuffer()`获取原始二进制数据,以及将其高效转换为base64编码字符串的实用方法和示例代码,确保数据完整性和可用性。

理解API二进制数据响应

在与Web API交互时,我们通常会遇到JSON或纯文本格式的响应。然而,对于某些特定服务,例如图像生成、文件下载或流媒体API,服务器可能会直接返回二进制数据。如果未能正确处理这些二进制响应,可能会导致数据损坏或无法使用。

例如,在使用NovelAI等图像生成API时,API通常会返回一个包含生成图像的ZIP文件。尝试使用fetch API的response.text()方法来处理这种二进制响应,会导致数据被误解析为UTF-8文本,从而破坏其原始二进制结构。结果是接收到一个看似乱码的字符串,即使将其保存为文件并更改扩展名,也无法正常解压或使用,因为其内部数据已损坏。

正确获取二进制数据:使用response.arrayBuffer()

为了正确获取API返回的原始二进制数据,fetch API提供了response.arrayBuffer()方法。这个方法会异步地将响应体读取为ArrayBuffer,这是一个通用的、固定长度的原始二进制数据缓冲区。

以下是如何在J*aScript中使用fetch API请求NovelAI图像生成服务并正确获取其二进制响应的示例:

async function generateImageAndGetBinaryData(accessToken, query) {
    const model = "nai-diffusion-3"; // 示例模型
    const apiUrl = "https://api.novelai.net/ai/generate-image";

    try {
        const response = await fetch(apiUrl, {
            method: "POST",
            headers: {
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${accessToken}`,
                'Accept': "*/*" // 接受所有类型响应
            },
            body: JSON.stringify({
                "input": `masterpiece, best quality, ${query}`,
                "model": model,
                "action": "generate",
                "parameters": {
                    "width": 768,
                    "height": 512,
                    "scale": 11,
                    "sampler": "k_dpmpp_2m",
                    "steps": 28,
                    "seed": Math.floor(Math.random() * 10000000000), // 随机种子
                    "n_samples": 1,
                    "ucPreset": 0,
                    "qualityToggle": true,
                    "sm": false,
                    "sm_dyn": false,
                    "dynamic_thresholding": false,
                    "controlnet_strength": 1,
                    "legacy": false,
                    "add_original_image": false,
                    "negative_prompt": "lowres, bad anatomy, bad hands, text, error, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality, normal quality, jpeg artifacts, signature, watermark, username, blurry"
                }
            })
        });

        if (!response.ok) {
            const errorText = await response.text();
            throw new Error(`API error: ${response.status} - ${errorText}`);
        }

        // 关键一步:使用 response.arrayBuffer() 获取原始二进制数据
        const arrayBuffer = await response.arrayBuffer();
        console.log("Received ArrayBuffer:", arrayBuffer);
        return arrayBuffer;

    } catch (error) {
        console.error("Error generating image:", error);
        throw error;
    }
}

// 示例调用 (假设accessToken和query已定义)
// generateImageAndGetBinaryData(myAccessToken, "a beautiful landscape")
//     .then(buffer => {
//         // 在这里处理 arrayBuffer,例如转换为Base64或保存为文件
//     })
//     .catch(err => console.error(err));

将ArrayBuffer转换为Base64编码字符串

在许多场景下,例如将图像嵌入到HTML/CSS中(data: URI)、通过JSON传输二进制数据,或者在某些数据库中存储,将ArrayBuffer转换为Base64编码字符串会非常有用。Base64编码将二进制数据表示为ASCII字符串,使其可以在文本环境中安全传输。

Visla Visla

AI视频生成器,快速轻松地将您的想法转化为视觉上令人惊叹的视频。

Visla 100 查看详情 Visla

以下是一个将ArrayBuffer转换为Base64字符串的实用函数:

/**
 * 将 ArrayBuffer 转换为 Base64 编码的字符串。
 * @param {ArrayBuffer} buffer 要转换的 ArrayBuffer。
 * @returns {string} Base64 编码的字符串。
 */
function arrayBufferToBase64(buffer) {
    let binary = '';
    const bytes = new Uint8Array(buffer);
    const len = bytes.byteLength;
    for (let i = 0; i < len; i += 1) {
        binary += String.fromCharCode(bytes[i]);
    }
    return btoa(binary); // btoa() 函数用于将二进制字符串编码为 Base64
}

将上述转换函数集成到fetch响应处理中,即可直接获取Base64编码的图像ZIP数据:

// ... (fetch 请求部分保持不变) ...
    ).then(async (response) => {
        if (!response.ok) {
            const errorText = await response.text();
            throw new Error(`API error: ${response.status} - ${errorText}`);
        }
        // 获取 ArrayBuffer
        const arrayBuffer = await response.arrayBuffer();
        // 将 ArrayBuffer 转换为 Base64 字符串
        const base64Data = arrayBufferToBase64(arrayBuffer);

        // 在此处处理 base64Data,例如发送给客户端或保存
        console.log("Received Base64 data (first 100 chars):", base64Data.substring(0, 100) + "...");

        // 如果是在服务器端(如Koa/Express)处理,可以设置响应体
        // ctx.status = response.status;
        // ctx.body = base64Data;

        return base64Data;
    }).catch(error => {
        console.error("Failed to fetch or process image data:", error);
        throw error;
    });

注意事项:

  • btoa()函数只能处理ASCII字符串。如果ArrayBuffer中的字节值超出了ASCII范围,String.fromCharCode()可能会产生非ASCII字符,导致btoa()报错。然而,对于二进制数据(如图片、ZIP文件),String.fromCharCode(byte)通常是安全的,因为它只是将每个字节值映射到对应的Unicode码点,然后btoa再对这个“二进制字符串”进行编码。
  • 对于大型文件,直接将整个文件加载到内存并转换为Base64可能会消耗大量内存。在这种情况下,可以考虑使用response.blob()来获取Blob对象,然后利用FileReader进行分块读取或直接创建下载链接。

总结

正确处理API返回的二进制数据是Web开发中的一项基本技能。通过理解fetch API的response.arrayBuffer()方法,我们可以有效地获取原始二进制内容,避免数据损坏。结合arrayBufferToBase64这样的实用工具函数,可以进一步将二进制数据转换为Base64编码,以满足不同的应用场景需求。在与NovelAI等图像生成API交互时,务必记住其返回的是一个名为images.zip的ZIP文件,其中包含image_0.png,因此需要按照二进制文件进行处理。

以上就是J*aScript中处理API返回二进制数据及Base64转换的教程的详细内容,更多请关注其它相关文章!


# 如何推广网站方案  # 弹出  # 在与  # 通常会  # 如何实现  # 保存为  # 复选框  # 徐州沛县网站优化报价  # 电子商务关键词排名  # 将其  # 装修网站建设定制  # 大学城seo电话  # 旅游推广营销活动  # 网赚推广类网站  # 网站的网络营销与推广  # seo岗是什么意思  # 韶关网站优化推广案例  # css  # 正确处理  # 转换为  # 二进制数  # ai  # 工具  # access  # 字节  # app  # 编码  # json  # git  # js  # html  # java  # javascript 


相关栏目: 【 科技资讯46185 】 【 网络学院92790


相关推荐: 微信网页版官方入口直达 微信网页版网页版登录使用方法  JUnit5/Mockito:优雅测试内部依赖与异常处理的实践  谷歌浏览器浏览体验优化_谷歌浏览器新版直连永久可用提示  Safari怎么安装扩展程序 浏览器插件安装与管理方法【详解】  如何修改开机登录密码_Windows账户安全设置超详细教程【必学】  微信群消息显示延迟如何解决 微信群消息刷新优化方法  Angular Material 垂直步进器:实现底部到顶部排序的教程  fishbowl官网免费版 fishbowl养鱼网站入口  React Router 嵌套组件中 URL 重定向问题的解决方案  深入理解Go语言中Map值与方法接收器的交互:为什么需要临时变量  Go语言中动态执行代码字符串的策略与实践  Excel中VLOOKUP的第四个参数是干什么用的_Excel VLOOKUP第四参数作用解析  1688商家版怎样分析买家画像精准供货_1688商家版分析买家画像精准供货【供货策略】  蛙漫正版漫画平台入口_蛙漫免费阅读全站漫画资源  Win10怎么设置静态IP地址 Win10手动配置IP地址步骤【指南】  基于动态规划的房屋花卉种植最小成本算法详解  Typer应用中动态命令行参数的解析与处理  三星ZFold5多任务卡顿_Samsung ZFold5流畅度提升  Pyrogram与g4f集成:异步编程实践与常见错误解决  qq浏览器打开空白页怎么办 qq浏览器启动后显示白屏的解决教程  优化Log4j2控制台输出性能:解决异步日志瓶颈  铃兰之剑为这和平的世界希里技能组及加点推荐  PrimeNG Sidebar背景色自定义指南:CSS覆盖与主题化实践  整合Supabase认证与Django模型:跨模式迁移的解决方案  电脑安装程序提示“错误1722”怎么办_Windows Installer服务问题解决【教程】  在J*a中如何使用Exception包装底层异常_异常包装与信息传递方法说明  斑马英语APP如何开启夜间护眼阅读_斑马英语APP夜间模式与低蓝光设置教程  Gmail邮箱申请注册直达_Gmail邮箱免费注册PC版官网入口2025  Tabulator表格日期时间排序问题及自定义解决方案  谷歌推RCS信息存档功能:公司可监控员工私密信息!  WordPress插件开发:正确注册卸载钩子与避免常见陷阱  C++的std::forward_list怎么用_C++ STL中单向链表容器的特点与应用  python3时间如何用calendar输出?  J*a最大堆Heapify方法修复:索引计算与边界条件深度解析  邮编格式怎么匹配地址_根据邮编格式快速匹配详细地址的技巧  QQ邮箱正确登录入口_QQ邮箱官方网站使用地址  AO3镜像入口大全 AO3网页版内容访问全集  特斯拉自动驾驶房车计划曝光 原型车将于2027年亮相  如何为你的Composer包编写自动化测试_集成PHPUnit到Composer的scripts工作流  sublime侧边栏怎么增强功能_SideBarEnhancements for sublime安装与配置  晋江读书网页版在线登录 晋江读书电脑版官网  vivo云服务网页版登录 怎么登录vivo云服务网页版  Golang如何实现微服务鉴权与权限控制_Golang微服务鉴权与权限管理实践  网易大神怎么保存别人动态的图片_网易大神动态图片保存方法  Lar*el表单中优雅地处理“返回”按钮以规避验证:最佳实践指南  qq游戏大厅官方下载_qq游戏免费下载安装入口  qq音乐在线播放入口_qq音乐电脑版登录链接  Win11截图该按哪些键 Win11截屏完整流程解析【教程】  qq游戏网页版直接玩_qq游戏免下载快速入口  J*aScript数据结构转换:将对象数组按类别分组 

搜索