前言
在前端开发中，经常会使用到许多第三方库，而 npm 是目前最受欢迎的包管理工具之一。今天我们要介绍的是一个基于 npm 的金价查询包 goldquote。该包可以方便地获取各类黄金的实时价格信息。本文主要分为以下部分：
- npm 包 goldquote 的介绍；
- goldquote 的使用教程；
- 金价实时查询的原理；
- 结语与参考资料。
npm 包 goldquote 的介绍
npm 包 goldquote 主要提供以下功能：
- 支持获取全球黄金价格；
- 支持根据地区（如中国、美国等）查询黄金价格，包括实时价格、变化幅度等信息；
- 支持查询指定时间段内的黄金价格趋势；
- 使用方便，无需手动解析 JSON 数据。
该包的 GitHub 主页为：https://github.com/cjjin/Goldquote 。我们可以通过安装该包来在前端应用中方便地使用它提供的功能。
goldquote 的使用教程
安装
要使用 goldquote，我们首先需要使用 npm 工具来安装该包。在命令行中输入以下命令即可：
npm install goldquote --save
使用
在安装完 goldquote 后，我们就可以在代码中使用它提供的功能了。示例代码如下：
-- -------------------- ---- -------
----- --------- - ---------------------
-- --------
---------------------------- -- -
--------------------
---
-- --------
---------------------------------------- -- -
--------------------
---
-- --------
-----------------
------ -------------
---- ------------
-------------- -- -
--------------------
---上述代码包含三个示例，分别是获取全球黄金价格、查询中国黄金价格和查询黄金价格趋势。这些示例使用了 goldquote 包中的三个函数，即 gold()、countryPrice() 和 trend()。
函数说明
gold()
该函数用于获取全球黄金价格。
goldquote.gold().then(result => {
console.log(result);
});函数返回值为包含以下信息的对象：
{
price: 1781.12, // 当前黄金价格
change: -4.02, // 价格变化量
change_rate: -0.22 // 价格变化率
}countryPrice(code)
该函数用于查询指定国家/地区的黄金价格。参数 code 指定了查询的国家/地区代码，可以参考 goldquote 包中的 countries.json 文件获取不同国家的代码。
goldquote.countryPrice('CN').then(result => {
console.log(result);
});函数返回值为包含以下信息的对象：
{
country: 'CN', // 国家/地区代码
price: 320.57, // 当前黄金价格
change: -4.17, // 价格变化量
change_rate: -1.28 // 价格变化率
}trend(options)
该函数用于查询指定时间段内的黄金价格趋势。参数 options 为包含以下属性的对象：
- start：查询起始日期，格式为 YYYY-MM-DD；
- end：查询截止日期，格式为 YYYY-MM-DD。
goldquote.trend({
start: '2021-06-01',
end: '2021-07-01'
}).then(result => {
console.log(result);
});函数返回值为包含一个数组的对象，数组中的每个元素表示一个日期的黄金价格信息：
-- -------------------- ---- -------
-
-
----- -------------
------ --------
------- ------
------------ -----
--
-
----- -------------
------ --------
------- -------
------------ -----
--
-- --
-金价实时查询的原理
goldquote 包的实现原理比较简单，它通过访问一个数据接口来获取金价信息。具体来说，它使用了以下两个数据接口：
- 获取全球黄金价格：https://www.goldpreis.de/api/v1/live
- 获取指定国家的黄金价格：https://www.goldpreis.de/api/v1/countries/[country_code]/live
其中，[country_code] 表示国家或地区的代码。例如，查询中国黄金价格时，我们需要访问链接：https://www.goldpreis.de/api/v1/countries/CN/live 。
这两个接口返回的都是 JSON 格式的数据，包含各类金价信息。在 goldquote 包中，它们被封装成了上面介绍的三个函数，供开发者方便地调用。
结语与参考资料
通过本文，我们了解了 npm 包 goldquote 的使用教程，并深入了解了实时查询金价的原理。goldquote 包是一个相对简单但实用的工具，它可以帮助我们轻松获取各类黄金价格信息。祝大家在前端开发中使用愉快！以下是本文参考的资料：
- Goldquote 包 GitHub 主页：https://github.com/cjjin/Goldquote
- Goldpreis.de API 文档：https://www.goldpreis.de/api/v1/docs
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066e6e255dee6beeee7429