---
title: "用 JavaScript 和 Node.js 进行货币换算"
description: "用 fetch 获取汇率，用 JSON 结果换算金额，再用 currency.js 处理金额和格式。"
canonical: "https://exchangerate.dev/zh/learn/javascript-currency-conversion"
---

# 用 JavaScript 和 Node.js 进行货币换算

用 fetch 获取汇率，用 JSON 结果换算金额，再用 currency.js 处理金额和格式。

2026年10月1日 · 阅读 6 分钟

浏览器可以从匿名调用开始。Node.js 或服务器应用应把密钥放在环境变量中，同时保留汇率的来源和观测时间。

- Node 18+、Deno、Bun 和现代浏览器都支持 fetch。
- 不要把账户密钥放进浏览器代码。
- currency.js 处理金额和格式，不负责获取汇率。
- 检查 HTTP 状态，收到 429 时遵循 Retry-After。
- 需要解释时显示 source 和 effective_at。

## 从浏览器发起请求

小型计算器或测试可以使用无密钥调用。只请求需要的 symbols，并设置超时。

## 把密钥移到服务器

生产应用应从 Node.js、Route Handler 或其他服务器服务调用。密钥只能留在服务器环境。

## 计算并格式化金额

currency.js 适合金额、精度和格式；先从 API 获取汇率，再计算金额。

## 读取新鲜度和错误

检查 `sources`、`effective_at`、`source` 和 `market_session`。429 需要退避，汇率是指示性数据而非可执行报价。

## 常见问题

```javascriptnokey title="javascript · no key"
const response = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP", {
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}; Retry-After: ${response.headers.get("Retry-After")}`);
const data = await response.json();
console.log(data.rates.EUR);
console.log(data.sources.EUR, data.effective_at.EUR);
console.log(data.market_session);
```

```javascriptauthenticatedcallwitherrorhandling title="javascript · authenticated call with error handling"
// Node.js server only. Never put an account key in browser code.
const KEY = process.env.EXCHANGERATE_API_KEY;
if (!KEY) throw new Error("Set EXCHANGERATE_API_KEY on your server");

async function getLatest(base = "USD") {
  const response = await fetch(`https://api.exchangerate.dev/v1/latest/${encodeURIComponent(base)}`, {
    headers: { Authorization: `Bearer ${KEY}` },
    redirect: "error",
    signal: AbortSignal.timeout(10_000),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}; Retry-After: ${response.headers.get("Retry-After")}`);
  return response.json();
}

const data = await getLatest("USD");
console.log(data.rates.GBP, data.effective_at.GBP);
```

```javascriptconvertusdtoeur title="javascript · convert 100 USD to EUR"
// Node.js server only.
const KEY = process.env.EXCHANGERATE_API_KEY;
if (!KEY) throw new Error("Set EXCHANGERATE_API_KEY on your server");
const response = await fetch("https://api.exchangerate.dev/v1/convert/USD/EUR/100", {
  headers: { Authorization: `Bearer ${KEY}` },
  redirect: "error",
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}; Retry-After: ${response.headers.get("Retry-After")}`);
const data = await response.json();
console.log(data.rate, data.converted);
```

```javascriptcurrencyjs title="JavaScript · currency.js"
import currency from "currency.js";

const response = await fetch("https://api.exchangerate.dev/v1/latest/USD?symbols=EUR", {
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
const rate = data.rates.EUR;
if (!Number.isFinite(rate) || rate <= 0) throw new Error("Invalid rate");
const euros = currency("100.00", { precision: 2, symbol: "€" }).multiply(rate);
console.log(euros.format());
```

## 常见问题

### 需要安装 HTTP 库吗？

不需要。Node 18+、Deno、Bun 和现代浏览器都有 fetch。

### 可以从浏览器发送密钥吗？

不可以。任何人都能读取它，请从服务器发起请求。

### currency.js 会获取汇率吗？

不会。它只帮助处理已获取的金额。

## 继续阅读

- [用 Python 获取汇率](https://exchangerate.dev/zh/learn/python-exchange-rates)
- [历史汇率与时间序列数据](https://exchangerate.dev/zh/learn/historical-fx-time-series)

Source: https://exchangerate.dev/zh/learn/javascript-currency-conversion
