Node.js - path.relative() 方法

---

---

Node.js 的 path 模組提供了各種與作業系統相關的實用程式方法和屬性。

path 模組的 Node.js path.relative() 方法根據當前工作目錄，返回從一個描述的路徑 (from) 到另一個路徑 (to) 的相對 path。當 from 和 to 解析到相同的路徑（在對每個路徑呼叫 path.resolve() 之後）時，將返回零長度字串。如果任何 零長度字串 傳遞給路徑，則此方法將列印 零長度字串。如果任何描述的 path 不是 字串，則會丟擲 TypeError。

語法

以下是 path 模組的 Node.js path.relative() 方法的語法：

path.relative(from, to)

引數

• from − 此引數包含一個 字串 檔案 路徑，表示一個 基路徑。

• to − 此引數是一個 字串 檔案 路徑，將用於從 基路徑 查詢 相對路徑。

返回值

此方法返回從一個指定的路徑 from 到另一個指定的路徑 to 的 相對路徑。

示例

如果 from 和 to 引數之間存在相對路徑，則 path.relative() 方法將返回相對路徑。

在下面的示例中，我們向方法的 from 和 to 引數提供 路徑。

const path = require('path');

var path1 = path.relative('C:/Users/Lenovo/Desktop/JavaScript/nodefile.js', 'C:/Users/Lenovo/Desktop/JavaScript/file/bose.html')

console.log(path1);

輸出

當我們在線上編譯器 (POSIX) 中執行上述程式碼時，輸出如下：

../file/bose.html

當我們在 WINDOWS 作業系統上執行上述程式碼時，輸出如下：

..\file\bose.html

示例

如果 from 和 to 路徑之間不存在相對路徑，則 path.relative() 方法將返回完整的 to 路徑。

在下面的程式中，我們將不同的檔案路徑傳遞給 path.relative() 方法的 from 和 to 引數。

const path = require('path');
var path1 = path.relative('C:/Users/Lenovo/Desktop/JavaScript/nodefile.js', "E:/programs/file")
console.log(path1);

輸出

在線上編譯器 (POSIX) 中執行上述程式後，path.relative() 方法將完整的 'to' 路徑返回到輸出，因為不存在相對路徑。

../../../../../../E:/programs/file

當我們在 WINDOWS 作業系統上執行上述程式碼時，輸出如下：

E:\programs\file

示例

如果 from 和 to 路徑都是零長度字串，則 path.relative() 方法 將返回零長度 字串。

在下面的示例中，我們將空 字串 傳遞給 path.relative() 方法的 from 和 to 引數。

const path = require('path');
var path1 = path.relative('', '');
console.log(path1);

輸出

如果我們編譯並執行上述程式，則 path.relative() 方法將返回零長度 字串 到輸出，因為沒有給出路徑。

''

示例

如果我們將不是 字串 型別的值傳遞給 from 和 to 引數，則 path.relative() 方法將丟擲 TypeError。

在給定的示例中，我們將一個 物件 的例項而不是 字串 傳遞給方法的 from 和 to 引數。

const path = require('path');
var path1 = path.relative({}, {});
console.log(path1);

TypeError

正如我們在下面的輸出中看到的，path.relative() 方法丟擲 TypeError，因為 from 和 to 引數不是 字串 值。

path.js:39
   throw new ERR_INVALID_ARG_TYPE('path', 'string', path);
   ^
   
TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received type object
   at assertPath (path.js:39:11)
   at Object.relative (path.js:1172:5)
   at Object.<anonymous> (/home/cg/root/63a02f1595a95/main.js:3:18)
   at Module._compile (internal/modules/cjs/loader.js:702:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:713:10)
   at Module.load (internal/modules/cjs/loader.js:612:32)
   at tryModuleLoad (internal/modules/cjs/loader.js:551:12)
   at Function.Module._load (internal/modules/cjs/loader.js:543:3)
   at Function.Module.runMain (internal/modules/cjs/loader.js:744:10)
   at startup (internal/bootstrap/node.js:238:19)