npm 包 tw-exchange 使用教程

阅读时长 4 分钟读完

介绍

tw-exchange 是一个针对台湾地区的货币汇率转换 npm 包。它支持转换多种货币之间的汇率,并且可以自动从网络获取最新的汇率数据。使用 tw-exchange 可以方便地在前端应用中实现货币间的转换,而无需自己去维护汇率数据。

安装

你可以通过 npm 安装 tw-exchange:

开始使用

基本使用

tw-exchange 提供了一个 Exchange 类,通过实例化该类可以进行货币汇率转换。例如,要将 USD(美元)转换为 TWD(新台币),可以这样做:

输出结果为:

上述代码中,exchange 方法接受 3 个参数,分别表示要转换的金额、原货币和目标货币。该方法返回一个对象,包含转换前的金额和货币,以及转换后的金额和货币。

获取最新汇率

tw-exchange 默认从网络上获取最新的汇率数据,并将其缓存到本地。如果需要手动强制更新汇率数据,可以调用 update 方法:

支持的货币

tw-exchange 支持转换的货币如下:

  • 新台币(TWD)
  • 美元(USD)
  • 港元(HKD)
  • 英镑(GBP)
  • 澳元(AUD)
  • 加元(CAD)
  • 新加坡元(SGD)
  • 瑞士法郎(CHF)
  • 日元(JPY)
  • 南非兰特(ZAR)
  • 瑞典克朗(SEK)
  • 纽元(NZD)
  • 泰铢(THB)
  • 菲律宾比索(PHP)
  • 印尼卢比(IDR)
  • 欧元(EUR)
  • 韩元(KRW)
  • 越南盾(VND)
  • 阿拉伯酋长国迪拉姆(AED)

自定义汇率数据源

tw-exchange 默认从 https://tw.rter.info/ 获取汇率数据。如果需要使用自定义的数据源,可以通过构造函数传入 options:

其中 source 表示数据源 URL,interval 表示更新间隔。

异常处理

如果转换过程中出现任何异常,比如传入了非法的货币代码,或者没有获取到最新汇率数据,exchange 方法会抛出异常。为了捕捉到异常并进行处理,可以使用 try-catch 语句:

-- -------------------- ---- -------
----- - --------- ------------- - - -----------------------

----- -------- - --- -----------
--- -
  ----- ------ - ---------------------- ------ -------
- ----- ----- -
  -- ---- ---------- -------------- -
    ------------------------- -- ------- --------- ---
  - ---- -
    -------------------- -------- -----
  -
-

上述代码中,当传入了未知的货币代码时,exchange 方法会抛出 ExchangeError 异常,并附带错误消息。可以通过 instanceof 判断异常类型,从而进行不同的处理。

结语

tw-exchange 是一个非常方便实用的货币汇率转换 npm 包,它免去了自己维护汇率数据的繁琐工作。通过本文的介绍,你已经了解了如何使用 tw-exchange 进行货币汇率转换,并且掌握了一些细节和异常处理方法。希望对你有所帮助!

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055ead81e8991b448dc282

纠错
反馈