Node.JS 中的 EML 轉 HTML 轉換腳本

將電子郵件訊息轉換為網頁友好標記是建立通知中心、歸檔工具或預覽窗格時的常見需求。 Aspose.Cells Cloud SDK for Node.js 提供一個強大的雲端庫，讓您可以直接從 Node.JS 應用程式操作檔案。本指南將帶您完成一個端到端的 EML 轉換為 HTML 的 Node.JS 腳本，涵蓋設定、程式碼、cURL 替代方案以及配置技巧，讓您快速整合電子郵件渲染。

在 Node.JS 中執行 EML 轉 HTML 轉換腳本的步驟 - 5 步驟

將 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.');

將上傳的 EML 轉換為 HTML：呼叫 EmailApi.convert，並將 format 設為 'html'。
```
const convertResponse = await emailApi.convert({
    format: 'html',
    file: remoteEmlPath
});
```
此方法會在回應主體中返回 HTML 負載。詳情請參閱 API 參考。

將產生的 HTML 本地保存：將回應主體寫入磁碟上的檔案。

if (convertResponse && convertResponse.body) {
    fs.writeFileSync(localHtmlPath, convertResponse.body);
    console.log(`Conversion successful. HTML saved to ${localHtmlPath}`);
}

（可選）刪除暫存的 EML 檔案：轉換完成後清理雲端儲存。

await storageApi.deleteFile({ path: remoteEmlPath });
console.log('Remote EML file deleted from cloud storage.');

優雅地處理錯誤：將工作流程包裹在 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 等）以符合實際位置，驗證已安裝所有必要的相依性，並在開發環境中徹底測試。若遇到任何問題，請參閱官方文件或聯繫支援團隊以獲得協助。

使用 cURL 透過 REST API 將 EML 轉換為 HTML

如果您偏好語言無關的方法，亦可使用純 HTTP 呼叫執行相同的轉換。以下是必要的 cURL 指令。

取得存取權杖 (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。

將 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"

請求轉換為 HTML。

curl -X POST "https://api.aspose.cloud/v3.0/email/convert?format=html&file=sample.eml" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

回應主體包含 HTML 標記。

將 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 或更高。
具有客戶端 ID 和密鑰的 Aspose Cloud 帳戶。
安裝 SDK 套件：

npm install asposecellscloud

(可選) 安裝 Aspose.Email Cloud SDK for Node.js，如果您打算使用 Email API：

npm install asposeemailcloud

從下載頁面下載最新的 SDK 二進位檔。

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 參考以取得完整的參數清單。

結論

在 Node.JS 中的 EML 轉 HTML 轉換腳本 非常簡單，只需搭配 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 的非同步方法允許您平行執行多個轉換，以提升吞吐量。

如何在使用腳本時確保轉換過程的安全性？
使用 HTTPS 進行所有 API 呼叫，安全地儲存您的客戶端憑證（例如，環境變數），並考慮在您的 Aspose Cloud 帳戶中啟用 IP 限制。臨時許可證在開發期間提供完整功能存取，且不會影響安全性。

在 Node.JS 中執行 EML 轉 HTML 轉換腳本的步驟 - 5 步驟#

完整的 EML 轉 HTML 轉換腳本示例（Node.JS）#

使用 cURL 透過 REST API 將 EML 轉換為 HTML#

Aspose.Cells Cloud SDK 的先決條件與設定#

Aspose.Cells Cloud SDK 用於 EML 轉 HTML 轉換的主要功能#

設定 EML 轉換為 HTML 的選項#

結論#

常見問題#

Read More#