npm 包 webup-plugin-external-images 使用教程-JavaScript中文网-JavaScript教程资源分享门户

在 Web 开发过程中，我们经常需要为网页添加一些外部图片资源。webup-plugin-external-images 是一个基于 Node.js 平台的 npm 包，它可以帮助我们快速地将外部图片资源下载并嵌入到我们的网页中，提高网页加载速度，减轻服务器负载。在本篇文章中，我们将详细地介绍 webup-plugin-external-images 的使用方法，并提供示例代码以便读者更好地理解和使用。

什么是 webup-plugin-external-images？

webup-plugin-external-images 是一个基于 Node.js 平台的 npm 包，它可以帮助我们从外部网站下载图片资源，并将这些图片资源嵌入到我们的本地网页中。webup-plugin-external-images 提供了灵活的配置选项，可以满足不同的需求。它支持多线程下载，可以提高下载效率，节省时间。webup-plugin-external-images 还支持各种图片格式的下载，包括 JPG、PNG、GIF 等。

如何使用 webup-plugin-external-images？

安装 webup-plugin-external-images

在命令行中输入如下命令：
```
npm install -D webup-plugin-external-images
```
引入 webup-plugin-external-images

在 webpack.config.js 中引入 webup-plugin-external-images：
```
const WebupExternalImagesPlugin = require('webup-plugin-external-images');
```
添加 WebupExternalImagesPlugin 到 plugins 中

在 webpack.config.js 中添加：
```
plugins: [
  new WebupExternalImagesPlugin({
    // 配置选项
  }),
],
```
配置选项

webup-plugin-external-images 支持以下配置选项：
- paths：指定需要下载的图片资源所在的路径，可以是一个字符串，也可以是一个数组。默认值为 []。
- extensions：指定需要下载的图片资源的后缀名，可以是一个字符串，也可以是一个数组。默认值为 ['jpg', 'jpeg', 'png', 'gif']。
- output：指定图片资源下载后的输出路径。默认值为 "./"。
- base：指定图片资源的基础 URL，用于拼接完整的图片路径。默认值为 ""。
- limit：指定图片资源的大小限制，超过限制的图片资源将不会被下载。默认值为 4096（4MB）。
- threads：指定下载图片资源的线程数。默认值为 5。
下面是一些常用的配置示例：
```
new WebupExternalImagesPlugin({
  paths: 'https://example.com/images', // 下载指定路径的图片资源
  extensions: ['jpg', 'png'], // 下载指定后缀名的图片资源
  output: './images/', // 将图片资源保存到指定的文件夹中
  base: 'https://example.com/', // 图片资源的基础 URL
  limit: 2048, // 限制图片资源的大小为 2MB
  threads: 10, // 使用 10 个线程下载图片资源
})
```
在 HTML 文件中引入图片资源

下载成功后的图片资源会存储在指定的输出路径中。我们可以在 HTML 文件中使用这些图片资源：
```
<body>
  <img src="./images/my-image.jpg">
</body>
```

示例代码

下面是一个完整的 webpack.config.js 示例代码：

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

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

总结

webup-plugin-external-images 是一个非常实用的 Node.js 包，可以帮助我们快速地将外部图片资源下载到本地，并嵌入到我们的网页中。本文介绍了 webup-plugin-external-images 的使用方法，包括安装、引入、配置选项等。阅读完本文后，读者可以掌握如何使用 webup-plugin-external-images 从外部网站下载图片资源，提高网页加载速度和用户体验。

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