目錄
npm-view
選擇 CLI 版本
目錄
概要
npm view [<package-spec>] [<field>[.subfield]...]aliases: info, show, v
說明
此指令會顯示套件的資料並將其列印至標準輸出。
例如,若要檢視登錄中 connect
套件的資訊,您會執行
npm view connect
如果未指定,預設版本為 "latest"
。
可以在套件描述符之後指定欄位名稱。例如,若要顯示版本 0.3.5
的 ronn
套件的相依項,您可以執行下列動作
npm view ronn@0.3.5 dependencies
預設情況下,npm view
會顯示關於目前專案內容的資料(透過尋找 package.json
)。若要顯示目前專案的欄位資料,請使用檔案路徑(例如 .
)
npm view . dependencies
你可以透過句點分隔子欄位來檢視子欄位。若要檢視 npm
最新版本的 git 儲存庫網址,你可以執行以下指令
npm view npm repository.url
這使得透過一點 shell 指令碼就能輕鬆檢視依賴項目的資訊。例如,若要檢視 ronn
所依賴的 opts
版本的所有資料,你可以撰寫以下內容
npm view opts@$(npm view ronn dependencies.opts)
對於陣列欄位,要求非數字欄位將會傳回清單中物件的所有值。例如,若要取得 express
套件的所有貢獻者電子郵件地址,你可以執行
npm view express contributors.email
你也可以在方括弧中使用數字索引來特別選取陣列欄位中的項目。若要取得清單中第一個貢獻者的電子郵件地址,你可以執行
npm view express contributors[0].email
如果你查詢的欄位值是物件的屬性,你應該執行
npm view express time'[4.8.0]'
可以指定多個欄位,並且會一個接著一個印出。例如,若要取得所有貢獻者的姓名和電子郵件地址,你可以執行以下操作
npm view express contributors.name contributors.email
如果會顯示為物件,則「人員」欄位會顯示為字串。因此,例如,這將會以縮寫字串格式顯示 npm
貢獻者的清單。(請參閱 package.json
以取得更多相關資訊。)
npm view npm contributors
如果提供了版本範圍,則會為套件的每個相符版本印出資料。這將會顯示 yui3
的每個相符版本所需要的 jsdom
版本
npm view yui3@'>0.5.4' dependencies.jsdom
若要顯示 connect
套件的版本記錄,你可以執行以下操作
npm view connect versions
組態
json
- 預設值:false
- 類型:布林值
是否要輸出 JSON 資料,而不是一般輸出。
- 在
npm pkg set
中,它會在將設定值儲存到package.json
之前,使用 JSON.parse() 來分析設定值。
並非所有 npm 指令都支援。
工作區
- 預設值
- 類型:字串(可設定多次)
在當前專案設定的工作空間中執行指令,同時根據此設定選項只執行由該設定選項定義的工作空間。
workspace
設定的有效值為
- 工作空間名稱
- 工作空間目錄路徑
- 父工作空間目錄路徑(將選取該資料夾中的所有工作空間)
設定為 npm init
指令時,可設定為尚未存在的資料夾,以建立資料夾並將其設定為專案中的全新工作空間。
此值不會匯出至子程式的環境。
工作區
- 預設值:null
- 類型:null 或布林值
設定為 true 以在所有設定的工作空間中執行指令。
明確設定為 false 將導致 install
等指令完全忽略工作空間。未明確設定時
- 在
node_modules
樹狀結構中執行的指令(install、update 等)會將工作空間連結至node_modules
資料夾。- 執行其他操作的指令(test、exec、publish 等)會在根專案中執行,除非在workspace
設定中指定一個或多個工作空間。
此值不會匯出至子程式的環境。
包含工作區根目錄
- 預設值:false
- 類型:布林值
在指令中啟用工作空間時,包含工作空間根目錄。
為 false 時,透過 workspace
設定指定個別工作空間,或透過 workspaces
旗標指定所有工作空間,將導致 npm 只在指定的工作空間中執行,而不在根專案中執行。
此值不會匯出至子程式的環境。
輸出
如果只輸出單一版本單一字串欄位,則不會為其加上色彩或引號,以利將輸出導向其他指令。如果欄位為物件,則會以 JavaScript 物件文字輸出。
如果提供 --json
旗標,輸出的欄位將為 JSON。
如果版本範圍符合多個版本,則每個印出的值前面都會加上其適用的版本。
如果要求多個欄位,則每個欄位都加上欄位名稱前綴。