简介
Node.js 是一种基于 Chrome V8 引擎的 JavaScript 运行时，可用于构建快速、可扩展的网络应用程序。npm（Node Package Manager）是 Node.js 中的包管理器，可以使 JavaScript 代码的分享、重用和安装变得更加简单。其中，node-ftps-promise 是 npm 上的一个包，用于在 Node.js 中与 FTPS 服务器交互，并支持 Promise 返回。
本文将详细介绍 node-ftps-promise 包的使用方法，包括安装、基本操作、高级用法和示例代码，旨在为前端开发者提供可操作性强的学习资料和实用指导。
安装
在使用 node-ftps-promise 之前，需要确保在项目中已安装 Node.js 和 npm。打开终端（命令行界面），输入以下命令即可安装 node-ftps-promise：
--- ------- -----------------
基本操作
完成 node-ftps-promise 的安装后，就可以开始对 FTPS 服务器进行操作。首先，在项目中导入 node-ftps-promise 包：
----- --- - -----------------------------
其中，Ftp 是一个构造函数，可以使用 new 关键字来创建一个 Ftp 实例：
----- ------ - - ----- ------------------ ----- --- --------- ------ ----- ----------- --------- ----------- -- ----- --- - --- ------------
其中，config 对象用于存放 FTPS 服务器的配置信息，包括主机名 host、端口号 port、协议 protocol、用户名 user 和密码 password。创建 Ftp 实例后，就可以使用其提供的方法来对 FTPS 服务器进行操作。
登录
首先，需要在 FTPS 服务器上进行登录。node-ftps-promise 提供了两种登录方式：
使用 config 对象配置的用户名和密码进行登录：
------------
指定用户名和密码进行登录：
----------- ----- ----------- --------- ----------- ---
在登录成功之后，就可以对 FTPS 服务器进行其他操作。
下载
使用 node-ftps-promise 可以方便地下载 FTPS 服务器上的文件。例如，下载文件 test.txt 并保存到本地 target 目录下：
------------------------- ---------------------
其中，第一个参数是 FTPS 服务器上的文件路径，第二个参数是本地保存路径。
上传
与下载类似，上传文件也是使用 node-ftps-promise 的常见操作之一。例如，上传本地文件 example.txt 到 FTPS 服务器的 /uploads 目录下：
--------------------------- ------------------------
其中，第一个参数是本地文件路径，第二个参数是 FTPS 服务器上的目标路径。
列出目录
使用 node-ftps-promise 可以列出 FTPS 服务器上指定目录的文件列表。例如，列出 FTPS 服务器根目录下的所有文件：
---------- ----------- -- ------------------- ---------- -- --------------------
如果要列出指定目录的文件列表，也可以传入目录路径作为参数：
-------------------- ----------- -- ------------------- ---------- -- --------------------
其中，list 方法返回一个 Promise，可使用 then 和 catch 方法处理返回结果或错误。
删除文件
使用 node-ftps-promise 可以方便地删除 FTPS 服务器上的文件。例如，删除文件 test.txt：
----------------------------
其中，deleteFile 方法的参数是 FTPS 服务器上的文件路径。
创建目录
使用 node-ftps-promise 可以方便地在 FTPS 服务器上创建目录。例如，创建目录 /uploads/new：
--------------------------
其中，mkdir 方法的参数是 FTPS 服务器上的目录路径。
删除目录
使用 node-ftps-promise 可以方便地删除 FTPS 服务器上的目录。例如，删除目录 /uploads/new：
--------------------------
其中，rmdir 方法的参数是 FTPS 服务器上的目录路径。
关闭连接
在完成 FTPS 服务器上的操作之后，需要关闭连接以释放资源。例如：
------------
高级用法
Promise 链
由于 node-ftps-promise 的大部分方法都返回 Promise，因此可以使用 Promise 链来进行复杂的操作。例如，下载 FTPS 服务器上指定目录下的所有 .txt 文件：
-------------------- ----------- -- ----------------- -- -------------------------- -------------- -- -------------------------------- -- ---------------------------------------- ------------------------------ -------- -- ---------------- -------- ---------- -- --------------------
其中，第一个 then 方法过滤出 .txt 文件，第二个 then 使用 Promise.all 方法下载所有 .txt 文件，并使用 then 处理下载结果。最后，使用 catch 方法处理错误。
自定义操作
如果 node-ftps-promise 中提供的方法无法满足需求，还可以使用 FTP 操作模块 node-ftp 进行自定义操作。例如，使用 node-ftp 的 put 方法上传本地文件：
----- --- - -----------------------------
----- ------ - ---------------
----- ------ - -
----- ------------------
----- ---
--------- ------
----- -----------
--------- -----------
--
----- --- - --- ------------
-------------
-------- -- -
----- ------ - --------------
------ --- ----------------- ------- -- -
--------------------------- ----------------------- --- -- -
-- ----- ------------
---- ----------
---
---
--
-------- -- ------------------- --------------
---------- -- -------------------
----------- -- -------------其中，使用 connect 方法连接 FTPS 服务器，并通过 ftpClient 属性获取 node-ftp 的 Client 实例。然后，使用 put 方法上传本地文件，并使用 Promise 和回调函数进行包装。最后，使用 then 和 catch 方法处理上传结果或错误，finally 方法关闭连接。
示例代码
以下是一个完整的示例代码，展示了使用 node-ftps-promise 连接 FTPS 服务器、上传本地文件、列出 FTPS 服务器目录和下载文件等常见操作：
----- --- - -----------------------------
----- ------ - -
----- ------------------
----- ---
--------- ------
----- -----------
--------- -----------
--
----- -------- ------ -
----- --- - --- ------------
--- -
----- --------------
----- --------------------------- ------------------------
----- ----- - ----- ---------------------
-------------------
----- ------------------------------------ ------------------------
---------------------
- ----- ----- -
-------------------
- ------- -
------------
-
-
-------在上述示例代码中，使用 Promise 和 async/await 在上传完成后列出目录和下载文件，并使用 Promise 和 try/catch/finally 处理错误和关闭连接。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/60055a9881e8991b448d813a