将电子邮件消息转换为适合网页的标记是构建通知中心、归档工具或预览窗格时的常见需求。Aspose.Cells Cloud SDK for Node.js 提供了一个强大的基于云的库，让您可以直接在 Node.JS 应用程序中处理文件。本指南将带您完成在 Node.JS 中进行 EML 到 HTML 转换脚本的全流程，涵盖设置、代码、cURL 替代方案以及配置技巧，帮助您快速集成电子邮件渲染。

在 Node.JS 中执行 EML 到 HTML 转换脚本的步骤 - 5 步

  1. 将 EML 文件上传到 Aspose Cloud 存储: 使用 StorageApi.uploadFile 方法将源文件放置到云端。 
    const emlData = fs.readFileSync(localEmlPath);
await storageApi.uploadFile({
    path: remoteEmlPath,
    file: emlData
});
console.log('EML file uploaded to cloud storage.');
  2. 将已上传的 EML 转换为 HTML: 调用 EmailApi.convert，并将 format 参数设置为 'html'。 
    const convertResponse = await emailApi.convert({
    format: 'html',
    file: remoteEmlPath
});
    该方法在响应体中返回 HTML 内容。有关更多详情，请参阅 API reference。
  3. 在本地保存生成的 HTML: 将响应体写入磁盘文件。 
    if (convertResponse && convertResponse.body) {
    fs.writeFileSync(localHtmlPath, convertResponse.body);
    console.log(`Conversion successful. HTML saved to ${localHtmlPath}`);
}
  4. （可选）删除临时 EML 文件: 在转换后清理云存储。 
    await storageApi.deleteFile({ path: remoteEmlPath });
console.log('Remote EML file deleted from cloud storage.');
  5. 优雅地处理错误: 将工作流包装在 try‑catch 块中，以捕获网络或 API 问题。

完整的 EML 转 HTML 转换脚本示例（Node.JS）

以下代码演示了上述完整工作流。它使用官方 Aspose.Email Cloud SDK for Node.js 并结合 Aspose.Cells 的存储功能。

const fs = require('fs');
const path = require('path');
const { EmailApi, StorageApi, Configuration } = require('asposeemailcloud');

// ==== Configuration ====
// Replace with your actual Aspose Cloud client credentials
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';

// Initialize the SDK configuration
const config = new Configuration({
    clientId: clientId,
    clientSecret: clientSecret,
    // Optional: set a custom base URL if needed
    // baseUrl: 'https://api.aspose.cloud'
});

const emailApi = new EmailApi(config);
const storageApi = new StorageApi(config);

// ==== File paths ====
const localEmlPath = path.resolve(__dirname, 'sample.eml');   // Input EML file
const remoteEmlPath = 'sample.eml';                         // Path in Aspose Cloud storage
const localHtmlPath = path.resolve(__dirname, 'sample.html'); // Output HTML file

// ==== Main async function ====
(async () => {
    try {
        // 1. Upload the EML file to Aspose Cloud storage
        const emlData = fs.readFileSync(localEmlPath);
        await storageApi.uploadFile({
            path: remoteEmlPath,
            file: emlData
        });
        console.log('EML file uploaded to cloud storage.');

        // 2. Convert the uploaded EML to HTML
        const convertResponse = await emailApi.convert({
            format: 'html',
            file: remoteEmlPath
        });

        // 3. Save the resulting HTML to local disk
        if (convertResponse && convertResponse.body) {
            fs.writeFileSync(localHtmlPath, convertResponse.body);
            console.log(`Conversion successful. HTML saved to ${localHtmlPath}`);
        } else {
            console.error('Conversion returned empty response.');
        }

        // 4. (Optional) Clean up – delete the file from cloud storage
        await storageApi.deleteFile({ path: remoteEmlPath });
        console.log('Remote EML file deleted from cloud storage.');
    } catch (error) {
        console.error('Error during EML to HTML conversion:', error);
    }
})();

注意： 此代码示例演示了核心功能。在将其用于项目之前，请确保更新文件路径（sample.eml、sample.html 等）以匹配实际位置，确认已安装所有必需的依赖项，并在开发环境中彻底测试。如果遇到任何问题，请参阅官方文档或联系支持团队获取帮助。

Convert EML to HTML via REST API Using cURL

如果您更喜欢语言无关的方法，可以使用普通的 HTTP 调用执行相同的转换。以下是必需的 cURL 命令。

  1. 获取访问令牌 (OAuth 2.0)。
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

响应中包含 access_token。

  1. 将 EML 文件上传到云存储。
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/sample.eml" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@sample.eml"
  1. 请求转换为HTML。
curl -X POST "https://api.aspose.cloud/v3.0/email/convert?format=html&file=sample.eml" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

响应正文包含HTML标记。

  1. 在本地保存 HTML 输出（可选）
curl -X GET "https://api.aspose.cloud/v3.0/email/convert/result" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o sample.html

有关参数和错误处理的完整列表，请参阅官方 API 文档。

Aspose.Cells Cloud SDK 的先决条件和设置

在编写代码之前，请确保您的环境满足以下要求：

  • Node.js 版本 12 或更高。
  • 拥有 Aspose Cloud 帐户以及客户端 ID 和密钥。
  • 安装 SDK 包：
npm install asposecellscloud
  • （可选）如果您计划使用 Email API，请安装 Aspose.Email Cloud SDK for Node.js：
npm install asposeemailcloud

Aspose.Cells Cloud SDK 用于 EML 转 HTML 转换的关键特性

  • 云存储集成 - 直接读取和写入 Aspose Cloud 存储，消除本地文件处理的开销。
  • 流式支持 - 大型 EML 文件以流的方式处理，降低内存消耗。
  • 高性能转换 - 优化的服务器端算法即使在处理复杂的多部分消息时也能快速生成 HTML 输出。
  • 安全控制 - 所有数据通过 HTTPS 传输并存储在隔离的容器中，符合企业合规标准。
  • 跨平台兼容性 - 可在任何支持 Node.JS 的平台上运行，适用于无服务器或容器化部署。

配置 EML 到 HTML 的转换选项

转换端点接受多个可选参数，允许您微调结果。

  • format - 必须设置为 'html'。也支持其他格式（例如 'pdf'）。
  • storage - 如果使用多个云存储位置，可指定自定义存储名称。
  • outPath - 为生成的 HTML 文件在云端定义目标路径。

代码中传递选项的示例：

const convertResponse = await emailApi.convert({
    format: 'html',
    file: remoteEmlPath,
    storage: 'MyCustomStorage',
    outPath: 'output/sample.html'
});

请参阅 API 参考 以获取完整的参数列表。

结论

实现一个 EML 到 HTML 的转换脚本（Node.JS） 使用 Aspose.Cells Cloud SDK for Node.js 和配套的 Email API 非常简单。通过将 EML 文件上传到云存储，调用转换端点并处理响应，您可以在任何 Web 界面中呈现电子邮件内容。SDK 的流式处理能力和安全的云基础设施使其既适用于小型工具，也适用于大规模的电子邮件处理流水线。对于生产环境部署，请通过常规定价页面获取商业许可证；临时许可证可在 临时许可证页面 进行评估。立即开始集成，以最小的工作量扩展应用程序的通信功能。

常见问题

Node.JS 中的 EML 转 HTML 转换脚本如何处理多部分消息？
API 解析所有 MIME 部分，在存在时提取 HTML 正文，并将嵌入的图像内联为 base64 数据 URI，确保最终的 HTML 在浏览器中正确渲染。

适用于 EML HTML 转换脚本的文件大小限制是什么？
云服务单次请求接受的文件大小上限为 200 MB。较大的归档文件应拆分或分块处理，以保持在此限制内。

是否可以在单个批处理中转换多个 EML 文件？
是的。遍历您的文件列表，上传每个 EML，调用 EmailApi.convert，并存储结果。SDK 的异步方法允许您并行运行多个转换，以获得更高的吞吐量。

How can I secure the conversion process when using the script?
使用 HTTPS 进行所有 API 调用，安全地存储客户端凭据（例如，使用环境变量），并考虑在您的 Aspose Cloud 账户中启用 IP 限制。临时许可证在开发期间提供完整功能访问，同时不影响安全性。

阅读更多