2. 程式人生 > >NodeJS學習筆記 (24)本地路徑處理-path(ok)

NodeJS學習筆記 (24)本地路徑處理-path(ok)

阿新 • • 發佈：2018-06-18
ali 合成 ase 拼接 RF aaa con ID git

模塊概覽

在nodejs中，path是個使用頻率很高，但卻讓人又愛又恨的模塊。部分因為文檔說的不夠清晰，部分因為接口的平臺差異性。

將path的接口按照用途歸類，仔細琢磨琢磨，也就沒那麽費解了。

獲取路徑/文件名/擴展名

  • 獲取路徑：path.dirname(filepath)
  • 獲取文件名：path.basename(filepath)
  • 獲取擴展名：path.extname(filepath)

獲取所在路徑

例子如下：

var path = require(‘path‘);
var filepath = ‘/tmp/demo/js/test.js‘;

// 輸出：/tmp/demo/js
console.log( path.dirname(filepath) );


獲取文件名

嚴格意義上來說，path.basename(filepath) 只是輸出路徑的最後一部分，並不會判斷是否文件名。

但大部分時候，我們可以用它來作為簡易的“獲取文件名“的方法。

var path = require(‘path‘);

// 輸出：test.js
console.log( path.basename(‘/tmp/demo/js/test.js‘) );

// 輸出：test
console.log( path.basename(‘/tmp/demo/js/test/‘) );

// 輸出：test
console.log( path.basename(‘/tmp/demo/js/test‘) );

如果只想獲取文件名，單不包括文件擴展呢？可以用上第二個參數。

// 輸出：test
console.log( path.basename(‘/tmp/demo/js/test.js‘, ‘.js‘) );

獲取文件擴展名

簡單的例子如下：

var path = require(‘path‘);
var filepath = ‘/tmp/demo/js/test.js‘;

// 輸出：.js
console.log( path.extname(filepath) );

更詳細的規則是如下：（假設 path.basename(filepath) === B ）

  • 從B的最後一個.開始截取，直到最後一個字符。
  • 如果B中不存在.
    ，或者B的第一個字符就是.，那麽返回空字符串。

直接看官方文檔的例子

path.extname(‘index.html‘)
// returns ‘.html‘

path.extname(‘index.coffee.md‘)
// returns ‘.md‘

path.extname(‘index.‘)
// returns ‘.‘

path.extname(‘index‘)
// returns ‘‘

path.extname(‘.index‘)
// returns ‘‘


路徑組合

  • path.join([...paths])
  • path.resolve([...paths])

path.join([...paths])

把paths拼起來，然後再normalize一下。這句話反正我自己看著也是莫名其妙，可以參考下面的偽代碼定義。

例子如下：

var path = require(‘path‘);

// 輸出 ‘/foo/bar/baz/asdf‘
path.join(‘/foo‘, ‘bar‘, ‘baz/asdf‘, ‘quux‘, ‘..‘);

path定義的偽代碼如下：

module.exports.join = function(){
  var paths = Array.prototye.slice.call(arguments, 0);
  return this.normalize( paths.join(‘/‘) );
};

path.resolve([...paths])

這個接口的說明有點啰嗦。你可以想象現在你在shell下面，從左到右運行一遍cd path命令，最終獲取的絕對路徑/文件名，就是這個接口所返回的結果了。

比如 path.resolve(‘/foo/bar‘, ‘./baz‘) 可以看成下面命令的結果

cd /foo/bar
cd ./baz

更多對比例子如下：

var path = require(‘path‘);

// 假設當前工作路徑是 /Users/a/Documents/git-code/nodejs-learning-guide/examples/2016.11.08-node-path

// 輸出 /Users/a/Documents/git-code/nodejs-learning-guide/examples/2016.11.08-node-path
console.log( path.resolve(‘‘) )

// 輸出 /Users/a/Documents/git-code/nodejs-learning-guide/examples/2016.11.08-node-path
console.log( path.resolve(‘.‘) )

// 輸出 /foo/bar/baz
console.log( path.resolve(‘/foo/bar‘, ‘./baz‘) );

// 輸出 /foo/bar/baz
console.log( path.resolve(‘/foo/bar‘, ‘./baz/‘) );

// 輸出 /tmp/file
console.log( path.resolve(‘/foo/bar‘, ‘/tmp/file/‘) );

// 輸出 /Users/a/Documents/git-code/nodejs-learning-guide/examples/2016.11.08-node-path/www/js/mod.js
console.log( path.resolve(‘www‘, ‘js/upload‘, ‘../mod.js‘) );


路徑解析

path.parse(path)

path.normalize(filepath)

從官方文檔的描述來看，path.normalize(filepath) 應該是比較簡單的一個API，不過用起來總是覺得沒底。

為什麽呢？API說明過於簡略了，包括如下：

  • 如果路徑為空，返回.，相當於當前的工作路徑。
  • 將對路徑中重復的路徑分隔符（比如linux下的/)合並為一個。
  • 對路徑中的.、..進行處理。（類似於shell裏的cd ..）
  • 如果路徑最後有/，那麽保留該/。

感覺stackoverflow上一個兄弟對這個API的解釋更實在，原文鏈接。

In other words, path.normalize is "What is the shortest path I can take that will take me to the same place as the input"

代碼示例如下。建議讀者把代碼拷貝出來運行下，看下實際效果。

var path = require(‘path‘);
var filepath = ‘/tmp/demo/js/test.js‘;

var index = 0;

var compare = function(desc, callback){
  console.log(‘[用例%d]：%s‘, ++index, desc);
  callback();
  console.log(‘\n‘);
};

compare(‘路徑為空‘, function(){
  // 輸出 .
  console.log( path.normalize(‘‘) );
});

compare(‘路徑結尾是否帶/‘, function(){
  // 輸出 /tmp/demo/js/upload
  console.log( path.normalize(‘/tmp/demo/js/upload‘) );

  // /tmp/demo/js/upload/
  console.log( path.normalize(‘/tmp/demo/js/upload/‘) );
});

compare(‘重復的/‘, function(){
  // 輸出 /tmp/demo/js
  console.log( path.normalize(‘/tmp/demo//js‘) );
});

compare(‘路徑帶..‘, function(){
  // 輸出 /tmp/demo/js
  console.log( path.normalize(‘/tmp/demo/js/upload/..‘) );
});

compare(‘相對路徑‘, function(){
  // 輸出 demo/js/upload/
  console.log( path.normalize(‘./demo/js/upload/‘) );

  // 輸出 demo/js/upload/
  console.log( path.normalize(‘demo/js/upload/‘) );
});

compare(‘不常用邊界‘, function(){
  // 輸出 ..
  console.log( path.normalize(‘./..‘) );

  // 輸出 ..
  console.log( path.normalize(‘..‘) );

  // 輸出 ../
  console.log( path.normalize(‘../‘) );

  // 輸出 /
  console.log( path.normalize(‘/../‘) );
  
  // 輸出 /
  console.log( path.normalize(‘/..‘) );
});

感興趣的可以看下 path.normalize(filepath) 的node源碼如下：傳送門

文件路徑分解/組合

  • path.format(pathObject)：將pathObject的root、dir、base、name、ext屬性，按照一定的規則，組合成一個文件路徑。
  • path.parse(filepath)：path.format()方法的反向操作。

我們先來看看官網對相關屬性的說明。

首先是linux下

┌─────────────────────┬────────────┐
│          dir        │    base    │
├──────┬              ├──────┬─────┤
│ root │              │ name │ ext │
"  /    home/user/dir / file  .txt "
└──────┴──────────────┴──────┴─────┘
(all spaces in the "" line should be ignored -- they are purely for formatting)

然後是windows下

┌─────────────────────┬────────────┐
│          dir        │    base    │
├──────┬              ├──────┬─────┤
│ root │              │ name │ ext │
" C:\      path\dir   \ file  .txt "
└──────┴──────────────┴──────┴─────┘
(all spaces in the "" line should be ignored -- they are purely for formatting)

path.format(pathObject)

閱讀相關API文檔說明後發現，path.format(pathObject)中，pathObject的配置屬性是可以進一步精簡的。

根據接口的描述來看，以下兩者是等價的。

  • root vs dir：兩者可以互相替換，區別在於，路徑拼接時，root後不會自動加/，而dir會。
  • base vs name+ext：兩者可以互相替換。
var path = require(‘path‘);

var p1 = path.format({
  root: ‘/tmp/‘, 
  base: ‘hello.js‘
});
console.log( p1 ); // 輸出 /tmp/hello.js

var p2 = path.format({
  dir: ‘/tmp‘, 
  name: ‘hello‘,
  ext: ‘.js‘
});
console.log( p2 );  // 輸出 /tmp/hello.js

path.parse(filepath)

path.format(pathObject) 的反向操作，直接上官網例子。

四個屬性，對於使用者是挺便利的，不過path.format(pathObject) 中也是四個配置屬性，就有點容易搞混。

path.parse(‘/home/user/dir/file.txt‘)
// returns
// {
//    root : "/",
//    dir : "/home/user/dir",
//    base : "file.txt",
//    ext : ".txt",
//    name : "file"
// }

獲取相對路徑

接口：path.relative(from, to)

描述：從from路徑，到to路徑的相對路徑。

邊界：

  • 如果from、to指向同個路徑，那麽，返回空字符串。
  • 如果from、to中任一者為空，那麽，返回當前工作路徑。

上例子：

var path = require(‘path‘);

var p1 = path.relative(‘/data/orandea/test/aaa‘, ‘/data/orandea/impl/bbb‘);
console.log(p1);  // 輸出 "../../impl/bbb"

var p2 = path.relative(‘/data/demo‘, ‘/data/demo‘);
console.log(p2);  // 輸出 ""

var p3 = path.relative(‘/data/demo‘, ‘‘);
console.log(p3);  // 輸出 "../../Users/a/Documents/git-code/nodejs-learning-guide/examples/2016.11.08-node-path"

平臺相關接口/屬性

以下屬性、接口，都跟平臺的具體實現相關。也就是說，同樣的屬性、接口，在不同平臺上的表現不同。

  • path.posix：path相關屬性、接口的linux實現。
  • path.win32：path相關屬性、接口的win32實現。
  • path.sep：路徑分隔符。在linux上是/，在windows上是\。
  • path.delimiter：path設置的分割符。linux上是:，windows上是;。

註意，當使用 path.win32 相關接口時，參數同樣可以使用/做分隔符，但接口返回值的分割符只會是\。

直接來例子更直觀。

> path.win32.join(‘/tmp‘, ‘fuck‘)
‘\\tmp\\fuck‘
> path.win32.sep
‘\\‘
> path.win32.join(‘\tmp‘, ‘demo‘)
‘\\tmp\\demo‘
> path.win32.join(‘/tmp‘, ‘demo‘)
‘\\tmp\\demo‘

path.delimiter

linux系統例子：

console.log(process.env.PATH)
// ‘/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin‘

process.env.PATH.split(path.delimiter)
// returns [‘/usr/bin‘, ‘/bin‘, ‘/usr/sbin‘, ‘/sbin‘, ‘/usr/local/bin‘]

windows系統例子：

console.log(process.env.PATH)
// ‘C:\Windows\system32;C:\Windows;C:\Program Files\node\‘

process.env.PATH.split(path.delimiter)
// returns [‘C:\\Windows\\system32‘, ‘C:\\Windows‘, ‘C:\\Program Files\\node\\‘]

相關鏈接

官方文檔：https://nodejs.org/api/path.html#path_path

NodeJS學習筆記 (24)本地路徑處理-path(ok)

相關推薦

NodeJS學習筆記 (24)本地路徑處理-path(ok)

ali 合成 ase 拼接 RF aaa con ID git 模塊概覽 在nodejs中，path是個使用頻率很高，但卻讓人又愛又恨的模塊。部分因為文檔說的不夠清晰，部分因為接口的平臺差異性。 將path的接口按照用途歸類，仔細琢磨琢磨，也就沒那麽費解了。 獲取路徑/文件

nodejs學習筆記——使用buffer類處理二進位制資料

1. 建立buffer物件：new Buffer(size) buf.fill(value,[offset],[end])第一個引數指需要被寫入的值，第二個引數指定從第幾個位元組處開始寫入被指定的數值，預設為0。第三個引數是指定將數值一直寫到第幾位元組處，預設Buffer物件的大小。 其中n

nodejs學習筆記（五）——處理get和post請求

上一章介紹瞭如何在nodejs中構造httpserver以及在nodejs中如何構造httpclient來訪問httpserver，接下來說一下nodejs在http互動中是如何處理請求的。首先我們回顧一下上一章最後的例子： server程式碼（server把請求頭資訊處

NodeJS學習筆記 (13)數據加密-crypto(OK)

tor html uri aes256 nds audio ext HA known 寫在前面 本章節寫得差不多了，不過還需要再整理一下（TODO）。 hash例子 hash.digest([encoding])：計算摘要。encoding可以是hex、latin1或者

NodeJS學習筆記 (18)基礎調試-console(ok)

實用 log ger 擴展 rtu ML class cti right 模塊概覽 console模塊提供了基礎的調試功能。使用很簡單，常用的API主要有 console.log()、console.error()。 此外，可以基於Console類，方便的擴展出自己的con

python學習筆記(24) 異常處理

erro error finall python學習 error: ret 是否 執行 fin try: except ValueError:　　 except IndexError:　　#支持多分支 except Exception:　　#萬能異常 後面可以跟else

python學習筆記8：異常處理

mage 可能 str 裏的 tro 信息 學習筆記 異常信息 常見 一、異常處理 　　在程序運行過程中，總會遇到各種各樣的錯誤。 　　程序一出錯就停止運行了，那我們不能讓程序停止運行吧，這時候就需要捕捉異常了，通過捕捉到的異常，我們再去做對應的處理。 　　如下，寫段代碼，

【轉】Nodejs學習筆記（一）--- 簡介及安裝Node.js開發環境

ack 目錄 javascrip 難度 時間 網站開發 clas jetbrains 常用 目錄 學習資料 簡介 安裝Node.js npm簡介 開發工具 Sublime Node.js開發環境配置 擴展：安裝多版本管理器 學習資料 　　1.深入淺出Node.j

NodeJS學習筆記

error erro 模塊 ext hosts 文件 學習 host body 初學，簡單的實現，為進行優化。 1. 假設NodeJS服務端監聽3000端口 2. Apache反向代理設置 a. 在httpd.conf配置文件中開啟代理模塊 Loa

Nodejs學習筆記(二)

src 創建 return 解釋器 observer 等待 檢測 clas 數據接收 Node.js 回調函數 Node.js 異步編程的直接體現就是回調。 異步編程依托於回調來實現，但不能說使用了回調後程序就異步化了。 回調函數在完成任務後就會被調用，Node 使用了大量

Nodejs學習筆記（四）-----Buffer

pretty 成員 保存 n) tin 設置 amp 個數 普通 Node.js Buffer(緩沖區) JavaScript 語言自身只有字符串數據類型，沒有二進制數據類型。 但在處理像TCP流或文件流時，必須使用到二進制數據。因此在 Node.js中，定義了一個 Buf

Nodejs學習筆記（六）----- 模塊系統和函數

參數 spa 而且 split response 另一個 簡約 也有 方法 Node.js模塊系統------->有開發基礎很好理解 為了讓Node.js的文件可以相互調用，Node.js提供了一個簡單的模塊系統。 模塊是Node.js 應用程序的基本組成部分，文件和

Nodejs學習筆記（二）--- 操作MongoDB數據庫

效果 view asc erro eve mongdb splay play 所有 最近看了一些關於mongodb的文章，然後就想知道nodeJS是怎麽連接的所以我就嘗試去了解了一波（這個菜鳥驛站這個網站還不錯，雖然知識文檔不是最新的，但是還是蠻好的； 　　順便官網地址是

python學習筆記(十五)-異常處理

nbsp gpo calc pre 異常 AC pan 必須 ror money = input(‘輸入多少錢：‘) months = input(‘還幾個月：‘) try: res = calc(int(money),int(months)) except Ze

Python+Selenium學習筆記9 - 警告框處理

XP from 通過 quit IT bsp body class acc 如下圖所示，這種窗口是不能通過前端工具對其進行定位的，這裏可以通過switch_to_alert()方法去接受這個彈窗 1 # coding = utf-8 2 3 from sel

微信小程序開發：學習筆記[9]——本地數據緩存

程序開發 空間 java 用途 持久化 數據緩存 tex 示例 ext 微信小程序開發：學習筆記[9]——本地數據緩存 快速開始 說明 　　本地數據緩存是小程序存儲在當前設備上硬盤上的數據，本地數據緩存有非常多的用途，我們可以利用本地數據緩存來存儲用戶在小程序上產生的操作，

NodeJS學習筆記 (14)URL查詢字符串-querystring(ok)

學習筆記 option ons span none 官方 ID name 參數解析 模塊概述 在nodejs中，提供了querystring這個模塊，用來做url查詢參數的解析，使用非常簡單。 模塊總共有四個方法，絕大部分時，我們只會用到 .parse()、 **.stri

NodeJS學習筆記 (15)二進制數據-buffer(ok)

int 無符號 cee safe type abc 例子 zed 需要 模塊概覽 Buffer是node的核心模塊，開發者可以利用它來處理二進制數據，比如文件流的讀寫、網絡請求數據的處理等。 Buffer的API非常多，本文僅挑選 比較常用/容易理解 的API進行講解，包括

Nodejs學習筆記（五）—Express安裝入門與模版引擎ejs

num routes 項目目錄 其中 bubuko 執行 ctrl+ ica 開發經驗 前言 　　前面也學習了一些Node.js的基本入門知道，現在開始進入Web開發的部分； 　　Node.js提供了http模塊，這個模塊中提供了一些底層接口，可以直接使用，但是直接開發網站

Nodejs學習筆記（七）—Node.js + Express 構建網站簡單示例

ren 結構 crypto 中間件 實現 cmd ews path releases 前言 　　上一篇學習了一些構建網站會用到的一些知識點：https://www.cnblogs.com/flyingeagle/p/9192936.html 　　這一篇主要結合前面講到的知識